(Example) Show an eForm in More Than One Language (Multi-Language Forms)

This example shows how to show an eForm in more than one language at runtime.

Background and Setup

Prerequisites

Good to Know

  • This example shows how to show the New Customer Request form in more than one language. You can use the same procedure to show all other forms in more than language in Customer Request app.
  • These form controls are not supported in multilingual eForms.
    • Chart form control
    • Raw HTML form control
    • Credit Card form control
    • Chart form control
  • These form controls do not support Inline List Options in multilingual eForms.
    • Multi-Select List Box form control
    • Auto-Suggest form control
  • In Data Grid form control the Data Type Enum is not supported in multilingual eForms.
  • When this procedure is complete, a runtime app user can change the language of an eForm when the app runs.

Step 1: Create a New Language

First, create a language for translation on a multilingual eForm in Manage Center.

How to Start

  1. Click Manage.

    Click Manage
  2. In the Manage Center, click App Builder > eForms Settings.

    Click eForms Settings
  3. On the eForms Settings screen, click Language.

    Click Language Eform Settings
  4. On the Language Editor screen, click Add a New Language Add a New Language icon.

    Click Add New Language icon

Procedure

  1. On the Add a New Language screen, in the Select a Language field, select Hindi - hi.

    Select Language
  2. In the Language Name field, enter Hindi.

    When you select the language from the Select a Language field, this field show the language name by default.


    Enter Language Name
  3. In the Description field, enter a description.

    Enter Description
  4. Click Next.
  5. On the Language Editor > Standard tab screen, click Save.

    Click Save

Step 2: Enable More than One Language for an eForm

Next, enable more than one language in the eForm in eForm Builder.

How to Start

  1. Click App Builder.

    Build Apps screen
  2. On the App Explorer screen, on the My App pane, click Customer Request App > App Model & Resources > Forms > New Form > New Customer Request.

    Click Customer Request Form
  3. On the eForm Builder screen, click Settings.

    Click Form Settings
  4. On the Form Settings screen, click the Advanced tab.

    Click Form Settings

Procedure

  1. On the Advanced tab, select these fields:
    • Enable Multiple Languages on the form
    • Allow user to switch form language

    Select These Fields
  2. To save the changes, click Close Screen Close Screen icon.

Step 3: Configure Translation for a Multilingual eForm

Next, configure the translation for a multilingual eForm.

How to Start

  1. On the eForm Builder screen, click Rules > Translator.

    Click Translator

Procedure

  1. On the Translator screen, in the Select Language field, select English (United States)

    Select Language
  2. Click Save.
  3. In the Select Language field, select Hindi

    Select Language
  4. On the Library tab, click the form control to expand.

    Expand Form Control
  5. In the Label field, enter the text for the target translation language.

    Enter Translation
  6. Configure other form controls with the translation text as required.

    Configure Form Controls
  7. Click the Form tab.

    Click Form Tab
  8. On the Form tab, in the Select Form field, select New Customer Request.

    Select Form
  9. In the Action Buttons section, enter the text for the target translation language.

    Enter Button Translation
  10. Click Save.

Step 4: (Optional) Save the Eform

Next, save the eForm.

Procedure

  1. On the eForm Builder screen, click Save > Save and Check In.

    Save and Check In

Step 6: (Optional) Change the Language at Runtime

Next, change the language on the eForm at runtime.

Good to Know

  • If the eForm is configured for multilingual display, AgilePoint NX first tries to show the language that specified in the form user's profile. If a translation is not available for the user's language preference, the system shows the language that is set as the default for the eForm.

How to Start

  1. Click Work Center.

    Click Work Center
  2. In the left pane, click My Apps.

    Click My Apps

Procedure

  1. On the My Apps screen, click Customer Request App.

    Click An App
  2. On the view form, click Add New Record.

    Click Add New Record

    The eForm opens and shows the text in the language that is specified in the form user's profile or the language that is set as the default for the eForm.


    Default Language
  3. To change the language on the eForm, in the right side, select Hindi from the list.

    Select Language

    The eform shows the text in Hindi.

How to Get the App

This example is based on the Customer Request app from the AgilePoint NX App Store. Use this procedure to get the app.

Prerequisites

Good to Know

  • This procedure is optional. It is provided so you can test the example with an out-of-the-box app.
  • This is part of the Background and Setup procedures, but many users preferred this step to appear after the example, not before it.

Procedure

  1. Click App Store App Store icon.

    App Store
  2. In the PRODUCT section, click Form Based App.

    AgilePoint NX Home Page Screen
  3. Click the Customer Request app.

    Customer Request App
  4. On the Customer Request screen, click Add.

    Customer Request Screen
  5. On the Trust App screen, click Trust it.
  6. Click Return to site.