PingOne

Setting up DaVinci Forms for multi-language support

This use case covers how to set up the translatable text in forms with multiple langauges that will be translated based on the language settings in the end user’s browser settings.

To set up forms for translations from English to another languauge:

  1. To set up the desired languages with custom keys in User Experience > Languages:

    1. Enable the languages for which you would like to provide translations, such as French, Chinese, and German. Learn more in Enabling or disabling a language.

    2. Make sure that English is the default language. Learn more in Changing the default language.

    3. Export the default language English page. Learn more in Downloading a language bundle.

    4. Add any additional content in the CSV file for English.

      The Key must start with a forms. prefix and can only contain letters, numbers, dashes, underscores, or dots.

    5. Upload the bundle for English with the added key-value pairs.

    6. Export the content in the bundle for the translated language, such as French, Chinese, and German. Learn more in Uploading a language bundle.

  2. Configure the PingOne Forms connector capabilities in a flow with the selected keys.

    For example, you can select the message keys for:

    • Custom HTML Template Forms using the HTTP connector

      p1 languages html template

      Click the Translation (An image of the universal translation icon.) icon. A modal with a list of the available keys and their default trasnlations opens.

      p1 languages http select

      Select the appropriate Key. To define a unique key and default translation, select Create New Key.

    • PingOne Forms using the PingOne Forms connector

      For more information, see Using translatable keys.

      p1 languages localized string

    • Custom error messages in the Error Message connector

      p1 languages error message

      When added in the flow, you will see the English texts for the keys. However, when the flow is executed in the browser, the texts associated with the keys will render in adherence with the default language of the end-user’s browsers.