Overview

You can use the Manage Translations page to manage all the translatable strings that are displayed throughout GE Digital APM for all GE Digital APM Security Users whose GE Digital APM Culture setting corresponds to a set of installed translation files. You can access this page from the Configuration Manager.

Any changes that you make to translations using this tool will be applied wherever the affected translations are used.

Database string and application string translations are stored in GE Digital APM as MTM files. You can download the translations to your local machine, where they will be converted to Microsoft Excel files so that you can work with the translations. After you are finished, you can upload the Microsoft Excel file, and the GE Digital APM system will create or update the MTM files stored in the GE Digital APM as needed. The information in this section of the documentation provides details on the Microsoft Excel file.

The name of each Microsoft Excel file appears as <Language>.xls, where, <Language> is the language into which the application or database content is translated.

When you open a Microsoft Excel file containing translations for a language, you should modify only the strings that are stored in the Translated Word column. Before you do so, you should review the following guidelines:

• If a string includes {0}, {1}, {2}, and so on, you should not modify the numeric value or remove the brackets { }. These values are used by GE Digital APM system.
• If a string includes an ampersand (&), such as (&S), you should not remove the & symbol, change the letter of the alphabet that appears beside the & symbol, or remove the parentheses that appear around the & symbol and the letter of the alphabet. These values are used by GE Digital APM system.
• If a string includes special characters such as a colon (:) or ellipsis (...), you should not remove these characters. These characters are used by GE Digital APM system.

The translation files are named according to the abbreviation for the culture associated with the language that is stored in that file. For example, the Spanish translation file is named es.MTM, where es is the abbreviation for Spanish.

If you customize baseline translations or add new translations, custom translation files will be created automatically to store those translations. For example, suppose that for Spanish, you want to modify the translation for the baseline string Equipment. Suppose that the same string Equipment appears both as a button label (application string) and as a datasheet caption (database string).

To modify a translation, you can download to your local machine the translations stored in the appropriate translation file from the GE Digital APM. These translations will be downloaded to a Microsoft Excel file, which you can use to modify the translations. After you are finished, you can upload the Microsoft Excel file, and the GE Digital APM system will automatically convert that file to a translation file (i.e., with the extension MTM) and save it.

The GE Digital APM system will display only the strings that are stored in translation files on the GE Digital APM. If you have uploaded custom translation files, the GE Digital APM system will use your custom translations instead of the baseline translations.

When you create or customize database string translations, a custom database string translation file will be created automatically in the GE Digital APM. If you want custom translations to appear in the GE Digital APM, you will need to upload your custom database string translations to the GE Digital APM.

You can translate database strings from the following locations:

• The Manage Translations page in the Configuration Manager: From this location, you can download the baseline database string translations to a Microsoft Excel file, modify the translations, and then upload the Microsoft Excel file to the GE Digital APM. You can also use this tool to download your custom database string translations, customize the translations, and then upload the modified file..
• The Localize <Strings> window, which is accessible from the buttons that appears throughout GE Digital APM wherever you can translate a database string. From this location, you can add or modify database string translations using a grid, and they will be uploaded to GE Digital APM automatically.

Custom translation files will be used instead of the baseline translation files. Because only one custom database string translation file can exist per language, after you create a custom database string translation file, if you want to make further changes, you should download your custom database string translation file, customize the translations, and then upload it again. The most recent file that you upload will be the file that is used by the GE Digital APM system.

Database strings are case sensitive. This means that if the database string translation file contains a translated string that contains a capital letter, and you create a translation for the same string except it contains a lowercase letter, the string with the lowercase letter will be considered a new custom string (because it did not already exist in a translation file). For example, if the string Produce (capitalized) exists in a translation file, and then you create a query named produce (lowercase) and translate it, the string produce and its translations will be added to a custom translation file.

The following lists identify the database strings that can be translated using the features described in the previously. You can use these lists as a reference when you are translating database strings.

You can modify the baseline application string translations using the Manage Translations page in the Configuration Manager. On this page, you can download the baseline application string translations to a Microsoft Excel file, customize the translations, and then upload the Microsoft Excel file to the GE Digital APM. When you do so, a custom application string translation file will be created automatically, and will contain all the application string translations, including your custom translations. This custom translation file will be used instead of the baseline translation file.

If you delete a custom application string translation file, the GE Digital APM system will automatically use the baseline application string translation file.