Add a New Language
- In Designer, right click in your workspace and select Translations from the dropdown. The Translatable Terms window will open.
- Select the Earth
- Select a new language from the dropdown. That's all there is to it! You can create as many languages as you need for your project.
Add Global Translation Terms
Creating global translations is always a good first choice over the component level translation because most of your translated terms will be used across all projects unless you want one particular term to be different from the global translated term.
There are a couple of ways to add terms to the Translation Manager. You can add new terms directly to the Translation Manager or by selecting terms from the Translation Terms Panel.
Let's add some terms directly to the Translation Manager.
- From the menu bar at the top, go to Tools > Translation Manager.
- The Translation Manager window will open, and you can view all the translatable terms. This example has terms that were already added and translated.
- On the right side of the window, there is a list of icons where you can add, delete, import, export, and edit the Translation settings.
- To add a new global term, click on the Add icon. Enter the term (Tanks), and click Save.
- Double click on the row of the new term, and under Spanish translation, enter the word "Deposito." Click Save.
- To view all the global terms added to a project, go to Tools > Translation Manager. If you want to provide a translation to a term that has not been translated, double click on the row of the term, enter the translation, and click Save.
- Now test it out. Drag a Language Selector component to your window. Go into Preview Mode, and toggle the languages. You will see the languages for the text switch between English and Spanish for these two components.
Add Component Level Translation Terms
Component level translation terms are only available in Vision.
What's nice about adding component translation terms is that the Translatable Terms panel provides all the terms for that component on the window. All you have to do is add the translations. The Translatable Terms Panel is a central place to manage all the translations associated with a specific component. One important reason to use a component level term is if it is going to be different from the global term. Just remember, that because a term is translated at the component level doesn't mean that other components get to use it. Typically, it is used for that component only.
- In Designer, drag a Multi-State Indicator from the Component Palette in to your workspace.
Right click on the component and scroll down to Translations. The Translatable Terms panel will open and display all the terms for the specific component. Alternatively, you can right-click on the Root Container of a window and select Translations. The Translatable Terms Panel will display all the terms for all the components on the window.
Translatable Term Options
In the Translatable Terms Panel, you have the option of adding your translation to the Component, Translation Manager global database, or marking it for translation at a later time. You'll notice under the Component Terms section of the Translatable Terms window that there are four columns; Component Description, Key, Component translation, and Global translation.
You'll see below, all the terms for the Multi-State Button, and none of the terms have translations added. If you don't see the language you want your terms translated to, click the Earth icon , and select the language (i.e., Spanish). You will then see a column for your component translation and global translation.
To add translations for your component terms, double click the row of your term (i.e. ON). In the Spanish Component box, enter the translation (i.e, EN). You also have the option of creating a global translation on the Translatable Terms Panel as well. Then, click the Back link, and repeat this step for all your terms.
- Once you entered the translations for all your terms, you will see them on the Translatable Terms Panel in the Spanish (Component) column. If a term doesn't have a translation, you can select the term and mark it for translation by clicking the Earth with a green plus icon. This adds the term(s) to the translation database for someone else to add the translation.
In this example, you'll notice several things about each of the terms so look closely at them. You'll find examples of both component and global level terms, a component level term, a global term, a component term that overrides a global term, and terms marked for translation.
- To test it out, drag a Language Selector component from the Component Palette to your workspace. Go to Preview Mode, select Spanish from the dropdown to see the text change from English to Spanish for these two components.
Import Terms into Ignition's Translation Manager
- Go to Tools > Translation Manager, and select the Import Terms icon from the right side of the Translation Manager window.
Navigate to the folder where your exported files reside, and choose the English file from the Open window, and click Open.
You have the option of importing selected terms or all terms. Click either Import All or Import Selected depending on what terms you want to import.
Repeat this step to import each translation file. This example imports the Spanish translation file.
Imported Terms Overwrite Existing Terms
Be aware that existing terms will be overwritten by the imported term.
- Check to see that all your terms were imported into the Translation Manager by going to Tools > Translation Manager.