Configuring Translations in Goal Management

Objective

After completing this lesson, you will be able to configure translations in Goal Management

Translations in Manage Templates

Watch this video to learn how to configure translations for the Goal Plan template in Manage Templates

Note

Not all configuration options are supported in Manage Templates, so you might need to complete some configurations directly in the XML.

Translations in XML

The following translations can be completed in both Manage Templates and the Goal Plan XML template.

  • <obj-plan-name>. The name of the Goal Plan.
  • <text-replacement for="Instructions">. The instructional text that can be added in Manage Templates.
  • <category-name>. The category name label.
  • <field-label>. The label for goal plan fields.
  • <enum-label>. The label for the drop-down options in status or any other enum field type.
  • <column-label>. The column label for the table field types.

The following translations can only be completed from the Goal Plan XML template.

  • <text-replacement>. Any other options beyond the Instructions cannot be completed in Manage Templates, like the Category.
  • <field-description>. Description of the fields which do not display in the UI and are only relevant for the XML editor.
  • <table-row-label>. For table field only. this is different from the column-label, as this is used for add/edit/delete button/icon.
  • <column-description>. Description of the columns in the table fields which do not display in the UI and are only relevant for the XML editor.
  • <state-label>. The Goal Plan state label.
  • <action-label>. The target Goal Plan state visible to the role with change-state permission.

Configure Translations in XML

To translate labels for the Goal Plan XML template, complete the following steps:

Steps

  1. Copy the tag.

  2. Add the relevant language tag (for example, lang="de_DE" for German).

  3. Check all areas, including the goal plan name, categories, field labels, and so on.

Example

The XML template below shows language tags for field labels and field descriptions. 

Goal Library Import File

For translated libraries to show, you need to add the goal library ID to the XML in addition to the name. Although the US English library is automatically included with Goal Management, you may have to reload it to get the translated version to show correctly.

In this example, the Import/Export Goal Library tool shows several goal libraries in different languages. Each one of them share the same GUID, which means that they will all be available in the same Goal Plan and the end user will be able to create a goal from the library in their own language.

Localize a Goal Plan

Business Example

You have been asked to localize the goal plan from Manage Templates and XML. Your instance already includes the language pack Dutch (nl_NL), and the translated Goal Library in the same language.

Learn how to use translation functionality to change the language in a Goal Plan.

Steps

  1. Explore the goal plan in Dutch, then switch the language to English.

    1. Log into the instance and navigate to Name MenuSettingsChange Language.

    2. Enable Dutch, and select Switch.

    3. Navigate to Main MenuGoalsSelect your training goal plan.

    4. Answer the following question: What has been translated by the system?

    5. Navigate to Name MenuInstellingenAndere taal kiezen.

    6. Set English US as the system language.

    7. Select Wisselen.

  2. Localize the goal plan in Manage Templates. Change the language from default to Dutch and enter the data in the following table:

    FieldValue
    Title[Your Initials] [Year] Doelstellingen Plan
    InstructionsGebruik dit werkblad om doelen te creëren en te bewerken. Om een nieuw doel snel te maken, klik op de knop Nieuw Doel.
    1. Navigate to Manage Templates using Action Search, and select your Goal Plan template from the list.

    2. In the General Settings section, change the language from default to Dutch.

    3. Enter the data from the table.

  3. In the Customer category, change the language from default to Dutch and change the category label to Klant.

    1. Expand the Edit Categories section.

    2. Select the Customer category.

    3. In Change Language, select Nederlands (Dutch) from the dropdown list.

    4. Change the category label to Klant.

  4. For the Goal Name field, change the language from default to Dutch and change the field label to Doel Naam.

    1. Expand the Edit Fields section.

    2. Select the Goal Name field.

    3. In Change Language, select Nederlands (Dutch) from the drop down list.

    4. Change the field label to Doel Naam.

  5. For the Weight field, change the language from default to Dutch and change the field label to Gewicht.

    1. Expand the Edit Fields section.

    2. Select the Weight field.

    3. In Change Language, select Nederlands (Dutch) from the drop down list.

    4. Change the field label to Gewicht.

  6. Export your training goal plan..

    1. Navigate to ProvisioningSelect your companyManaging Plan TemplateImport/Update/Export Objective Plan Template.

    2. Export your training goal plan

  7. Edit the goal plan template with an XML editor, category, change the language from default to Dutch and change the category label to Doel Classificatie. Save and upload the template after you complete your changes.

    1. Edit the goal plan template in an XML editor.

    2. In your goal plan template XML, locate <text-replacement for="category">

    3. Change the field label to Doel Classificatie by adding the following code :

      <text lang="nl_NL"><![CDATA[Doel Classificatie]]></text>
    4. Save and upload the goal plan.

  8. Test your goal plan in Dutch and add a new goal from the library.

    1. Log into the instance and navigate to Name MenuSettingsChange Language.

    2. Select Nederlands (Dutch) and click Switch.

    3. Navigate to Main MenuGoalsSelect your training goal plan.

    4. Verify that all text translated by you is displayed as expected.

    5. Create a new goal from the Goal Library. Select Goal makenUit bibliotheek maken.

    6. Expand the categories by selecting Klantenservice and Klantentevredenheid en loyaliteit.

    7. Select any goal(s) of your choice. You can select up to 10 goals at a time.

    8. Choose Volgende. You will navigate to the step 2 Doelstelligen bewerken. Select Volgende again.

    9. In the step 3 Maken, select Opslaan.

    10. Verify that you can now display the goal(s) in your Goal Plan in Dutch language.

  9. Set back the system language to English.

    1. Navigate to Name MenuInstellingenAndere taal kiezen.

    2. Select English US as the system language.

    3. Select Wisselen.

Log in to track your progress & complete quizzes