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).
Note: We recommend first configuring a Form Design Version to test forms, then completing all translation steps in a new version.
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:
- Activate languages in your Vault
- Update Form Languages
- Translate answers and form fields
- Translate form field labels
- Translate static text
- Run the Approve Version action to finalize translations
Note: Depending on your Vault’s creation date and which features are currently enabled and configured, some of the steps described in this article may be unavailable or already complete in your Vault.
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:
- Navigate to Business Admin > Objects > Form Languages.
- 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.
- 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.
- 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.
- Save the updated CSV files.
- 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:
- Navigate to Business Admin > Objects > Form Design Versions > [Form Design Version].
- Select Edit.
- For Language, select all applicable active languages.
- Select Save. Vault adds a file to the Attachments section.
- Navigate to the Attachments section and download the generated CSV file.
- 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.
- Save the updated CSV file.
- 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__sysand Key values containingonline_safety_form - Notification Messages: All rows for related notification templates
Note: Any translations imported with this tool apply to your entire Vault, not just Web Intake Forms.
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.