Set Up a Multi-Language Form

With the Multi-Language feature, you can create a single form and provide it to your field users in multiple languages. It’s simple to set up a Multi-Language Form A Multi-Language Form is a form that’s set up with different translations so that field users can choose their preferred language. Translated content includes page and section names, question text, help text, and other form content. and an associated output Document. Simply download Excel files that contain the strings to translate, add translations, upload the files, and activate the languages. This topic describes the steps to set up a Multi-Language Form.

Tip:You can set up an existing form with multiple languages—you don’t have to create a new form.

Available as an add-on to the Advanced and Enterprise tiers:

Contents

• Set Up a Multi-Language Form
  • Prerequisites
  • Steps to set up a Multi-Language Form
  • Options-based question translations
    • Manually-defined options
    • Data Source options
  • Conditional logic rules that use selected language

Prerequisites

• Your TrueContext account must be on the Advanced or Enterprise tier and have the Multi-Language Forms Multi-Language add-on.

• You must be either a TrueContext Admin user or a member of a FormSpace FormSpaces are where forms are stored and organized in the TrueContext Web Portal. A TrueContext Team may have multiple FormSpaces, depending on their needs. Admins can set FormSpace permissions to control which users have access to the forms in that FormSpace. group with Can Create permissions.

Tip:The Form Builder supplies a default Unique ID A Unique ID refers to the specific identifier of a question, form page, form section, or Data Destination. Unique IDs are used as reference points when pulling data for conditional logic, Analytics projects, Data Destinations, and Documents. when you add a page, section, question, answer exception, or other element to the form. We recommend that you change these to IDs that will help you easily identify these elements in the translation files. The following example shows how a translation file displays the unique IDs in the key_name column.

Steps to set up a Multi-Language Form

1. From the Forms & Integrations menu, create or edit a Mobile App form.

   • To create a new form:

     Forms & Integrations > Create New Form > Build a Mobile Form

     Enter a name and description, and then save the form.

   • To edit a form:

     Forms & Integrations > List Forms > FormName > Edit Form

     where FormName is the form that you want to edit.

   Tip:You can choose a new or existing form; you don’t have to build a new one.

2. Go to Settings > Form Information.

3. In the Languages section, select Enable multiple languages.

   Result: The Languages section expands to display additional setup options.

   

4. Select the language that the form is built in (the source language). The system uses this language to generate the strings for translation.

   Tip:The source language is also the fallback language for any missing translations.

5. In the Additional Languages section, select a language from the list.

6. Select Download to get an Excel file that contains the translation strings for all translatable form content.

   Result: The system generates a translation file (.xlsx) that contains all translatable text in the form.

   The translation file has the structure shown in the following illustration.

   

   Info:The topic How Multi-Language Translation Files Work: Translation file details provides guidelines and tips for working with the translation files.

7. Add comments for your translator (optional) to provide more information about a translation string. For example, you could provide the translator with synonyms to make the meaning clear. Send the file for translation.

8. Once the translation file is complete, Upload the file. To make the form available to your field users in the additional language, set the language to Active.

   Note:To upload the translation files successfully, you must keep all five column headings exactly the same as in the downloaded file.

9. Repeat steps 5-8 for each additional language up to a maximum of 10, and then Save and Deploy the form.

   Result: The system creates a new form version.

   Note: Users must reconcile to get the new form version.

   Test your output documents to make sure the results are what you expected.

   Info:You can set up a PDF, Microsoft Word, or HTML output document for translated content and link it to the form. The topic Steps to Set Up Translations for a Multi-Language Document describes this procedure in detail.