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

Prerequisites

• This example uses the Customer Request app from the AgilePoint NX App Store.

  For more information, refer to How to Get the App

• You must be a member of a role with access right to Add, Remove, and Modify Global Application Resources.

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.

How to Start

1. Click Manage.

   
   
   

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

   
   
   

3. On the eForms Settings screen, click Language.

   
   
   

4. On the Language Editor screen, click Add a New Language.

   
   
   

Procedure

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

   
   
   

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.

   
   
   

3. In the Description field, enter a description.

   
   
   

4. Click Save.

   
   
   

How to Start

1. Click App Builder.

   
   
   

2. On the App Builder Home screen, click All Apps.

   
   
   

3. On the All Apps screen, on the Customer Request app, click Edit .

   
   
   

4. On the App Details screen, hover over the New Customer Request form, and click Edit .

   
   
   

5. On the eForm Builder screen, click Settings.

   
   
   

6. On the Form Settings screen, click the Advanced tab.

   
   
   

Procedure

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

   
   
   

2. To save the changes, click Close Screen .

How to Start

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

   
   
   

Procedure

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

   
   
   

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

   
   
   

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

   
   
   

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

   
   
   

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

   
   
   

7. Click the Form tab.

   
   
   

8. On the Form tab, in the Action Buttons section, enter the text for the target translation language.

   
   
   

9. Click Save.

Next, save, check in, and publish the form-based app.

For more information, refer to (Example) Save, Check In, and Publish a Form-Based App

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.

   
   
   

2. In the left pane, click My Apps.

   
   
   

Procedure

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

   
   
   

2. On the view form, 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.

   
   
   

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

   
   
   

   The eform shows the text in Hindi.

Prerequisites

• AgilePoint NX OnDemand (public cloud), or AgilePoint NX PrivateCloud or AgilePoint NX OnPremises v7.0 or higher.

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.

   
   
   

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

   
   
   

3. Click the Customer Request app.

   
   
   

4. On the Customer Request screen, click Add.

   
   
   

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