GEI-100793 Resource Translation Manager User
Total Page:16
File Type:pdf, Size:1020Kb
GEI-100793A 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 Information – This document contains non-sensitive information 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 2011 © 2011 - 2016 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 [email protected] Public Information Document Updates Location Description Removed references specifically to Windows 7 to allow for System Requirements additional operating systems. Removed references specifically to Windows 7 to allow for additional operating systems. Configure RTM Updated the error message that displays for a missing Assembly Linker to contain the correct URL to download the Windows SDK. Added display language instructions for Windows 2012R2 and Windows 10. Display Language Removed instructions for Windows XP because we no longer support that operating system. 2 GEI-100793A Resource Translation Manager Public Information Contents 1 Overview ....................................................................................................................................................4 2 Terms .........................................................................................................................................................4 3 System Requirements ....................................................................................................................................4 4 Display Language .........................................................................................................................................5 5 Configure RTM............................................................................................................................................6 6 Dictionary File Format................................................................................................................................. 11 7 Language Name Conventions........................................................................................................................ 12 User Guide GEI-100793A 3 Public Information 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 The subdirectory that contains the Dictionary and resource DLLs for the selected application and language. 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-100793A Resource Translation Manager Public Information 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 2. 6. 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-100793A 5 Public Information 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. https://www.microsoft.com/en-us/download/developer-tools.aspx 6 GEI-100793A Resource Translation Manager Public Information 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-100793A 7 Public Information 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-100793A Resource Translation Manager Public Information 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