Resource Translation Manager User Guide

Transcription

1 GEI A Resource Translation Manager User Guide These instructions do not purport to cover all details or variations in equipment, nor to provide for every possible contingency to be met during installation, operation, and maintenance. The information is supplied for informational purposes only, and GE makes no warranty as to the accuracy of the information included herein. Changes, modifications, and/or improvements to equipment and specifications are made periodically and these changes may or may not be reflected herein. It is understood that GE may make changes, modifications, or improvements to the equipment referenced herein or to the document itself at any time. This document is intended for trained personnel familiar with the GE products referenced herein. Public This document is approved for public disclosure. GE may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not provide any license whatsoever to any of these patents. GE provides the following document and the information included therein as is and without warranty of any kind, expressed or implied, including but not limited to any implied statutory warranty of merchantability or fitness for particular purpose. For further assistance or technical information, contact the nearest GE Sales or Service Office, or an authorized GE Sales Representative. Revised: Sept 2016 Issued: Apr General Electric Company. * Indicates a trademark of General Electric Company and/or its subsidiaries. All other trademarks are the property of their respective owners. We would appreciate your feedback about our documentation. Please send comments or suggestions to controls.doc@ge.com

2 Document Updates Location System Requirements Configure RTM Display Language Description Removed references specifically to Windows 7 to allow for additional operating systems Added display language instructions for Windows 2012R2 and Windows 10. Removed instructions for Windows XP because we no longer support that operating system. 2 GEI A Resource Translation Manager

3 Contents 1 Overview Terms System Requirements Display Language Configure RTM Dictionary File Format Language Name Conventions User Guide GEI A 3

4 1 Overview The ControlST* Software Suite (V04.03 and higher) provides the ability to display specific applications in selected non-english languages. The Resource Translation Manager (RTM) utility manages strings in the multi-language applications included with ControlST. The utility exports English strings and translated string pairs to a Dictionary text file for translation. Additionally, the utility can import updated English/translated string pairs from the Dictionary file and create the resource Dynamic Link Libraries (DLLs) used by applications, such as the WorkstationST* Alarm Viewer and Trender. 2 Terms Assembly Linker The Microsoft application (AL.exe) installed with the Windows SDK that creates the resource DLLs. The RTM uses this application to convert the translated text in the dictionary file to the resource DLLs for the selected application and language. Dictionary File The collection of English and translated string pairs in a text file. DLL Dynamic Link Library, a.exe file that allows programs to share code and resources and included as part of an application. Language Directory language. The subdirectory that contains the Dictionary and resource DLLs for the selected application and Resource DLLs The collection of DLLs that contain the translated string for display in a specific language. RTM Resource Translation Manager 3 System Requirements Prerequisites to run the RTM include: User must be an administrator and the RTM must be started using the Windows Explorer File menu option Run as Administrator. ControlST V04.03 or higher must be installed. Currently, the only applications that display text in the Windows display language are: WorkstationST Alarm Viewer, Trender, and WorkstationST Status Monitor. Windows Software Development Kit (SDK) for the specific Windows operating system must be installed on all Windows operating systems. This kit, which is downloaded from the Microsoft web site, contains the Assembly Linker tool (Al. exe) that creates the resource DLLs. 4 GEI A Resource Translation Manager

5 4 Display Language To enable the application to display text in the Windows selected language 1. Install the language pack on the operating system that is to be displayed or use a native language Windows operating system (such as Spanish). 2. Select the Windows display language as follows: For Windows 2012R2 and Windows 10, from the Control Panel, select Region, Languages preferences, and Add a language, then select a language. For Windows 7, from the Control Panel, select Region and Language, Keyboards and Languages, and Display Language, then select a language. When the display language has been installed, log off, then log on again to the appropriate Windows account. 3. Start one of the supported applications. 4. From the Help menu, select About. Locate the Platform Information section to display the selected computer and the display language. Windows Display Language Selected displays what was selected in the Control Panel. Windows Display Language Installed displays the installation language of the operating system. For example, a French version of the Windows operating system displays as French (France) [fr-fr]. The text displayed in the [ ] brackets indicates the name of the language directory that must be used to select the language in the RTM. 5. Start the RTM utility and select the application and language for translation matching the Display Language defined in step Translate the strings. 7. Create the resource DLLs. 8. Copy the language subdirectory including all of the resource DLLs under the installation directory for the application translated. When the application is run, the application displays the text in the language selected. User Guide GEI A 5

6 When the translated application is run, it searches for the proper language directory using the following rules: 1. The translated application determines the selected display language from the Control Panel. It looks for the subdirectory, such as fr-fr, and, if found, uses the resource DLLs in that directory. 2. If a resource DLL is not found, the translated application searches for the subdirectory named fr and, if found, uses the resource DLLs in that directory. 3. If a resource DLL is not found, the translated application displays the text in English (all other language directories are ignored). 5 Configure RTM The RTM.exe file is located in the Resource Translation Manager folder, which is located within the GE Energy folder at: C:\\Program Files\GE Energy\Resource Translation Manager. Computers must run the RTM.exe file using the Windows Explorer File menu option Run as Administrator. If the RTM is run without this selection, the following error message displays. Once started, the RTM utility tries to locate the assembly linker (al.exe) application. If the assembly linker cannot be found, the following error message displays. 6 GEI A Resource Translation Manager

7 The RTM displays as follows: To select an application for translation 1. From the RTM Tree View, right-click and select Add Application. 2. From the Open dialog box, locate the installation directory of the application for translation. User Guide GEI A 7

8 Note The RTM must be used to create independent language folders for each supported application. If a selected application is not supported, an error icon displays next to the application in the Tree View. 8 GEI A Resource Translation Manager

9 The RTM can export strings or create resource DLLs based on the contents of the Dictionary file. To export strings 1. From the Resource Translation Manager, select desired options from the Sort Direction, Sort On Column, and Default Translation Text drop-down boxes. 2. Select Export To Dictionary. The Dictionary file for the selected application is written to the destination directory. It can now be edited and the translated strings reviewed or changed by the translator. Save the updated file in the same location. Note The updated file must be saved prior to creating the resource DLLs. User Guide GEI A 9

10 To create resource DLLs 1. From the RTM utility, select the application (such as WorkstationST Alarm Viewer) and language. 2. Select Create Resource DLLS. The resource DLLs are written to the destination directory. The language directory and all resource DLLs (except for the Dictionary file) must be copied to the installation directory for the application. The application may need to be stopped before the files can be copied. Repeat this for all computers using the WorkstationST Alarm Viewer that are to display the text in the Windows display language. 10 GEI A Resource Translation Manager

11 6 Dictionary File Format The Dictionary file is a UTF8 encoded text file containing: A set of comment lines (starting with the # character) followed by Two column headers (English Text and Text For Translation) followed by The English and translation strings as pairs on the same line. A Tab separator is used to separate the English from the translation string content. An example of a file in a Microsoft Excel spreadsheet is: #Exported Date:2/22/ :00:00 AM #Source Application Version:V B #Language:fr-FR English Text Text For Translation ########################################################### High Speed Periodic Read Establish: {0} High Speed Periodic Read Establish: {0} Periodic Read Establish Request: {0} Periodic Read Establish Request: {0} Periodic Write Establish Request: {0} Periodic Write Establish Request: {0} Periodic Write Message: {0} Periodic Write Message: {0} Process Control Command Request: {0} Process Control Command Request: {0} Received: {0}; Sent: {1}; Total Messages. Received: {0}; Sent: {1}; Total Messages. Software Event Establish Request: {0} Software Event Establish Request: {0} Supported Controller Request: {0} Supported Controller Request: {0} Use the following conventions when editing the Dictionary file: Never edit the English content in the first column. The text is extracted from the application, and is used as the key to associate the translated text. Edit the file using an editor that supports UTF8 format (such as the Excel application) Preserve tabs between the English and the translated text. Preserve leading, embedded, and trailing spaces on each string. Preserve brackets, the content within them, and the single and double quote marks. Example: ("{0}" changed from '{1}' to '{2}' and {0:P0} complete). User Guide GEI A 11

12 7 Language Name Conventions The following table lists the available cultures and subcultures. The Name column contains names used as the Language component of all file names and used as directory names that contain resource files for that culture. Note Right-to-left languages are not supported. Language Cultures and Subcultures Display Name Afrikaans Afrikaans (South Africa) Albanian Albanian (Albania) Alsatian (France) Amharic (Ethiopia) Armenian Armenian (Armenia) Assamese (India) Azeri Azeri (Cyrillic, Azerbaijan) Azeri (Latin, Azerbaijan) Bashkir (Russia) Basque Basque (Basque) Belarusian Belarusian (Belarus) Bengali (Bangladesh) Bengali (India) Bosnian (Cyrillic, Bosnia and Herzegovina) Bosnian (Latin, Bosnia and Herzegovina) Breton (France) Bulgarian Bulgarian (Bulgaria) Catalan Catalan (Catalan) Chinese (Hong Kong S.A.R.) Chinese (Macao S.A.R.) Chinese (People's Republic of China) Chinese (Simplified) Chinese (Singapore) Chinese (Taiwan) Chinese (Traditional) Corsican (France) Croatian Croatian (Latin, Bosnia and Herzegovina) Czech Czech (Czech Republic) Danish Danish (Denmark) Name af af-za sq sq-al gsw-fr am-et hy hy-am as-in az az-cyrl-az az-latn-az ba-ru eu eu-es be be-by bn-bd bn-in bs-cyrl-ba bs-latn-ba br-fr bg bg-bg ca ca-es zh-hk zh-mo zh-cn zh-chs zh-sg zh-tw zh-cht co-fr hr hr-ba cs cs-cz da da-dk 12 GEI A Resource Translation Manager

13 Language Cultures and Subcultures (continued) Display Name Dari (Afghanistan) Dutch Dutch (Belgium) Dutch (Netherlands) English English (Australia) English (Belize) English (Canada) English (Caribbean) English (India) English (Ireland) English (Jamaica) English (Malaysia) English (New Zealand) English (Republic of the Philippines) English (Singapore) English (South Africa) English (Trinidad and Tobago) English (United Kingdom) English (United States) English (Zimbabwe) Estonian Estonian (Estonia) Faroese Faroese (Faroe Islands) Filipino (Philippines) Finnish Finnish (Finland) French French (Belgium) French (Canada) French (France) French (Luxembourg) French (Principality of Monaco) French (Switzerland) Frisian (Netherlands) Galician Galician (Galician) Georgian Georgian (Georgia) German German (Austria) German (Germany) German (Liechtenstein) German (Luxembourg) German (Switzerland) Name prs-af nl nl-be nl-nl en en-au en-bz en-ca en-029 en-in en-ie en-jm en-my en-nz en-ph en-sg en-za en-tt en-gb en-us en-zw et et-ee fo fo-fo fil-ph fi fi-fi fr fr-be fr-ca fr-fr fr-lu fr-mc fr-ch fy-nl gl gl-es ka ka-ge de de-at de-de de-li de-lu de-ch User Guide GEI A 13

14 Language Cultures and Subcultures (continued) Display Name Greek Greek (Greece) Greenlandic (Greenland) Gujarati Gujarati (India) Hausa (Latin, Nigeria) Hindi Hindi (India) Hungarian Hungarian (Hungary) Icelandic Icelandic (Iceland) Igbo (Nigeria) Indonesian Indonesian (Indonesia) Inuktitut (Latin, Canada) Inuktitut (Syllabics, Canada) Irish (Ireland) isixhosa (South Africa) isizulu (South Africa) Italian Italian (Italy) Italian (Switzerland) Japanese Japanese (Japan) Kannada Kannada (India) Kazakh Kazakh (Kazakhstan) Khmer (Cambodia) K'iche (Guatemala) Kinyarwanda (Rwanda) Kiswahili Kiswahili (Kenya) Konkani Konkani (India) Korean Korean (Korea) Kyrgyz Kyrgyz (Kyrgyzstan) Lao (Lao P.D.R.) Latvian Latvian (Latvia) Lithuanian Lithuanian (Lithuania) Lower Sorbian (Germany) Luxembourgish (Luxembourg) Name el el-gr kl-gl gu gu-in ha-latn-ng hi hi-in hu hu-hu is is-is ig-ng id id-id iu-latn-ca iu-cans-ca ga-ie xh-za zu-za it it-it it-ch ja ja-jp kn kn-in kk kk-kz km-kh qut-gt rw-rw sw sw-ke kok kok-in ko ko-kr ky ky-kg lo-la lv lv-lv lt lt-lt dsb-de lb-lu 14 GEI A Resource Translation Manager

15 Language Cultures and Subcultures (continued) Display Name Macedonian Macedonian (Former Yugoslav Republic of Macedonia) Malay Malay (Brunei Darussalam) Malay (Malaysia) Malayalam (India) Maltese (Malta) Maori (New Zealand) Mapudungun (Chile) Marathi Marathi (India) Mohawk (Mohawk) Mongolian Mongolian (Cyrillic, Mongolia) Mongolian (Traditional Mongolian, PRC) Nepali (Nepal) Norwegian Norwegian, Bokmål (Norway) Norwegian, Nynorsk (Norway) Occitan (France) Oriya (India) Pashto (Afghanistan) Polish Polish (Poland) Portuguese Portuguese (Brazil) Portuguese (Portugal) Punjabi Punjabi (India) Quechua (Bolivia) Quechua (Ecuador) Quechua (Peru) Romanian Romanian (Romania) Romansh (Switzerland) Russian Russian (Russia) Sami, Inari (Finland) Sami, Lule (Norway) Sami, Lule (Sweden) Sami, Northern (Finland) Sami, Northern (Norway) Sami, Northern (Sweden) Sami, Skolt (Finland) Sami, Southern (Norway) Sami, Southern (Sweden) Name mk mk-mk ms ms-bn ms-my ml-in mt-mt mi-nz arn-cl mr mr-in moh-ca mn mn-mn mn-mong-cn ne-np no nb-no nn-no oc-fr or-in ps-af pl pl-pl pt pt-br pt-pt pa pa-in quz-bo quz-ec quz-pe ro ro-ro rm-ch ru ru-ru smn-fi smj-no smj-se se-fi se-no se-se sms-fi sma-no sma-se User Guide GEI A 15

16 Language Cultures and Subcultures (continued) Display Name Sanskrit Sanskrit (India) Scottish Gaelic (United Kingdom) Serbian Serbian (Cyrillic, Bosnia and Herzegovina) Serbian (Cyrillic, Montenegro) Serbian (Cyrillic, Serbia and Montenegro (Former)) Serbian (Cyrillic, Serbia) Serbian (Latin, Bosnia and Herzegovina) Serbian (Latin, Montenegro) Serbian (Latin, Serbia and Montenegro (Former)) Serbian (Latin, Serbia) Sesotho sa Leboa (South Africa) Setswana (South Africa) Sinhala (Sri Lanka) Slovak Slovak (Slovakia) Slovenian Slovenian (Slovenia) Spanish Spanish (Argentina) Spanish (Bolivia) Spanish (Chile) Spanish (Colombia) Spanish (Costa Rica) Spanish (Dominican Republic) Spanish (Ecuador) Spanish (El Salvador) Spanish (Guatemala) Spanish (Honduras) Spanish (Mexico) Spanish (Nicaragua) Spanish (Panama) Spanish (Paraguay) Spanish (Peru) Spanish (Puerto Rico) Spanish (Spain) Spanish (United States) Spanish (Uruguay) Spanish (Venezuela) Swedish Swedish (Finland) Swedish (Sweden) Tajik (Cyrillic, Tajikistan) Tamazight (Latin, Algeria) Tamil Name sa sa-in gd-gb sr sr-cyrl-ba sr-cyrl-me sr-cyrl-cs sr-cyrl-rs sr-latn-ba sr-latn-me sr-latn-cs sr-latn-rs nso-za tn-za si-lk sk sk-sk sl sl-si es es-ar es-bo es-cl es-co es-cr es-do es-ec es-sv es-gt es-hn es-mx es-ni es-pa es-py es-pe es-pr es-es es-us es-uy es-ve sv sv-fi sv-se tg-cyrl-tj tzm-latn-dz ta 16 GEI A Resource Translation Manager

17 Language Cultures and Subcultures (continued) Display Name Tamil (India) Tatar Tatar (Russia) Telugu Telugu (India) Thai Thai (Thailand) Tibetan (PRC) Turkish Turkish (Turkey) Turkmen (Turkmenistan) Ukrainian Ukrainian (Ukraine) Upper Sorbian (Germany) Uyghur (PRC) Uzbek Uzbek (Cyrillic, Uzbekistan) Uzbek (Latin, Uzbekistan) Vietnamese Vietnamese (Vietnam) Welsh (United Kingdom) Wolof (Senegal) Yakut (Russia) Yi (PRC) Yoruba (Nigeria) Name ta-in tt tt-ru te te-in th th-th bo-cn tr tr-tr tk-tm uk uk-ua hsb-de ug-cn uz uz-cyrl-uz uz-latn-uz vi vi-vn cy-gb wo-sn sah-ru ii-cn yo-ng User Guide GEI A 17

18