Work with Localization
This topic provides information about localizing presentation objects.
Modify or Delete Individual Localization Keys and Variables
Semantic Modeler automatically creates localization keys and name variables for all subject areas and presentation objects. You can modify or delete these keys and variables. You can also manually add description variables.
- On the Home page, click Navigator and then click Semantic Models.
- In the Semantic Models page, click a semantic model to open it.
- Click Presentation Layer
.
- In the Presentation Layer pane locate and double-click a subject area or the presentation table that you want to modify keys and variables for.
- In the subject area or presentation table page, click the Localization tab.
- Optional: To update a localization key, do one of the following:
- For a subject area, click the Localization Key field and delete or modify its value.
- For a presentation table, locate an object and double-click its table row. Click the object's Localization Key field and delete or modify its value.
- Optional: To update a description value, do one of the following:
- For a subject area, click the Name Variable or Description Variable field and delete or modify its value.
- For a presentation table, locate an object and double-click its table row. Click the object's Localization Key field or Description Variable and modify or delete its value.
- Click Save.
Clear All Name and Description Variables
You can clear name and description variables for a subject area only, for a subject area and all of its child objects, or for a presentation table and all of its objects.
- On the Home page, click Navigator and then click Semantic Models.
- In the Semantic Models page, click a semantic model to open it.
- Click Presentation Layer
.
- In the Presentation Layer pane locate and double-click a subject area or the presentation table that you want to clear variables for.
- In the subject area or presentation table, click the Localization tab.
- To clear variables, do one of the following:
- For a subject area, click Clear Variables and select which variables to clear, and then specify if you want to clear variables for the subject area object only or the subject area and all of its child objects.
- For a presentation table, click Clear Variables and select which variables to clear.
- Click Clear.
- Click Save.
Generate Localization Keys and Name and Description Variables
You can generate localization keys and name and description variables for a subject area only, for a subject area and all of its child objects, or for a presentation table and all of its objects.
- On the Home page, click Navigator and then click Semantic Models.
- In the Semantic Models page, click a semantic model to open it.
- Click Presentation Layer
.
- In the Presentation Layer pane locate and double-click a subject area or the presentation table that you want to generate localization keys and variables for.
- In the subject area or presentation table, click the Localization tab.
- To generate variables, do one of the following:
- For a subject area, click Generate Variables and select which variables to generate, and then specify if you want to generate variables for the subject area object only or the subject area and all of its child objects.
- For a presentation table, click Clear Variables and select which variables to generate.
- Click Generate.
- Click Save.
Externalize Strings for a Subject Area
You can externalize strings for a subject area, its presentation tables, hierarchies, columns, and their descriptions. Externalizing strings for the subject area outputs a CSV file.
- On the Home page, click Navigator and then click Semantic Models.
- In the Semantic Models page, click a semantic model to open it.
- Click Presentation Layer
.
- In the Presentation Layer pane locate and right-click the subject area you want to externalize strings for.
- Click Externalize Strings.
- In the Name field, enter a name for the outputted CSV file.
- Click Externalize.
Externalize Strings for All Subject Areas
You can externalize strings for all of the presentation layer's subject area, their presentation tables, hierarchies, columns, and their descriptions. Externalizing strings for all subject areas outputs a CSV file.
- On the Home page, click Navigator and then click Semantic Models.
- In the Semantic Models page, click a semantic model to open it.
- Click Presentation Layer
.
- In the header, click Page Menu and then click Externalize Strings.
- In the Name field, enter a name for the outputted CSV file.
- Click Externalize.
Translate Strings
After you externalized translation keys and strings, you can use the resulting files to translate the strings for the presentation objects.
-
The first column contains the actual semantic model object names with a prefix indicating its object type.
-
The second column contains the session variables that correspond to the name of each object or description, with a default prefix of CN_ for custom names and CD_ for custom descriptions.
-
The third column contains the translation keys that correspond to the name of each object.
- Open each string file Add a fourth column called Language. In this column, specify the code for the language in which the name was translated, such as de.
- Load each string file into a database table.
- In the Semantic Modeler, import the table into the physical layer.
- Load the translated strings using row-wise initialization blocks. Ensure that you set the target of the initialization block to Row-wise initialization and that the execution precedence is set correctly. For example:
- Click Save.