Veeva Safety supports custom translations for Web Intake Forms so that when respondents first access a form, they can select any configured language from a drop-down menu on the verification page. Upon making a selection, all subsequent form pages and emails display in the selected language (with the exception of the Name field of the Safety Form Admin, which always displays in the original value).

You must complete the steps in Configuring Web Intake Forms before completing the steps in this article.

Configuration Overview

Configuring your Vault for Web Intake Form translations involves the following steps:

  1. Activate languages in your Vault
  2. Update Form Languages
  3. Translate answers and form fields
  4. Translate form field labels
  5. Translate static text
  6. Run the Approve Version action to finalize translations

Activating Languages

You must activate the supported languages in your Vault for which you want to configure custom translations.

Updating Form Languages

You must associate each applicable Form Language with an activated language by populating each record’s Language field.

Translating Answers & Form Fields

For each Form Language you linked to an active language in your Vault, you can add translations for all Field Answer Selections and certain Form Fields:

  1. Navigate to Business Admin > Objects > Form Languages.
  2. Generate CSV template files for each applicable Form Language:
    • Depending on your action configuration, you can generate CSV files by selecting Generate Language Template from a record’s All Actions menu or by performing a bulk object record action to Bulk Generate Language Template.
    • When the action completes, Vault adds two files to the Attachments section of each applicable record.
  3. Navigate to the Attachments section of the applicable Form Language and download the following CSV files:
    • FieldAnswerSelections_[language-code].csv: Use this file to add translations for Field Answer Selections.
    • FormFields_[language-code].csv: Use this file to add translations for picklist types of Form Fields.
  4. Add translations for the Form Language.
    • In each CSV file, populate the Translation column for each associated Record Name value with up to 128 characters per cell.
    • Do not leave any cell blank. We recommend duplicating the English value in the Record Name column rather than leaving any Translation cell blank.
  5. Save the updated CSV files.
  6. Add the updated files to the record. When you do this, Vault upversions the existing attached files.

Translating Field Labels

For each Form Design Version, you can add translations for all fields in the Section Field Groups for each active language you linked to a Form Language:

  1. Navigate to Business Admin > Objects > Form Design Versions > [Form Design Version].
  2. Select Edit.
  3. For Language, select all applicable active languages.
  4. Select Save. Vault adds a file to the Attachments section.
  5. Navigate to the Attachments section and download the generated CSV file.
  6. Add translations for the Form Design Version.
    • In the CSV file, populate the Field Label Translation column with up to 200 characters per cell.
    • Do not leave any Field Label Translation cell blank. We recommend duplicating the English value in the Field Label column rather than leaving any Field Label Translation cell blank.
    • Optional: Populate the Field Help Text Translation column with up to 300 characters per cell.
  7. Save the updated CSV file.
  8. Add the updated file to the record. When you do this, Vault upversions the existing attached file.

Customizing Translated Static Text

You can customize translations for content displayed on form pages and notification messages. Use the bulk translation tool to translate static text for the applicable active languages. We recommend adding translations for any custom picklist fields and picklist field values you’ve mapped to form fields.

You can add translations for the following items:

  • Field Labels: All rows with Type values of message__sys and Key values containing online_safety_form
  • Notification Messages: All rows for related notification templates

Running the Approve Version Action

Run the Approve Version action on the applicable Form Design Version. When the action runs, Vault validates data in all associated translation CSV files. If applicable, correct any data issues, reimport the files, and try again.

Validating CSV Translation Files

When working with CSV translation files, consider the following guidelines:

  • You must use UTF-8 encoding in all CSV translation files to display all characters correctly.
  • Do not change the file name or type.
  • Do not modify or delete any existing column headers or column order.
  • Do not modify or delete any existing values in the ID columns.
  • Do not add any values that exceed the character limits for that column.
  • Ensure all referenced Language columns in the exported files are active in your Vault.