This feature is available in the Enterprise Edition.
You can model your diagrams in multiple languages to allow viewers or modelers, who do not understand your standard diagram language, to read them easily. This supports the collaborative working on diagrams and gives you the ability to appeal to a larger community.
Multilingualism is a feature which is available in the Editor, Collaboration Hub and in the Dictionary. Initially, you have to configure languages in the Explorer.
The following explains how to translate a diagram and the modeling elements. Prerequisite is that the desired language has already been defined in the Explorer.
Changing the language¶
When creating a new diagram, it will be displayed in the default language of the workspace. To change the default language, read the chapter Customizing the workspace.
The current language of a diagram can be switched in the Editor via the little flag symbol on the right side of the upper toolbar:
The language is switched from English to German.
If the flag symbol is not visible for you, it is possible that there are no languages defined for your workspace. As a workspace administrator, you can define a set of available languages in the Explorer’s configuration dialog, which is described in the chapter Customizing the workspace.
Select one of the available languages. The diagram will adapt to the language immediately and may look like the following:
The highlighted elements have not been translated into English, yet.
Diagram elements that were already translated are displayed as usual and in the desired language. In our example, the task ‘Problem lösen’ was already translated. If the label was formatted, this formatting will be kept.
Diagram elements that are not yet translated are highlighted in red - e.g., the incoming message event ‘Received Invoice’ is not available in German, but only in English (thus, the “en_us” in brackets).
The following chapter describes how diagram elements can be translated.
Translating diagrams means defining a translation for each diagram element in each required language, which can include all element labels and documentation.
This chapter describes how diagrams can be translated into other languages. This is especially useful when multiple people are involved on the translation, each translated into one language. Later in this chapter, you will learn how to transalte a diagram in different languages at the same time.
The following example shows a translation from English to German:
- First set in the toolbar in which language you want to translate. Proceed as above explained. Elements that were not yet translated are highlighted in red.
- Double-click an element to define its label.
- Click somewhere on the canvas to accept the new label. The translation will now be stored and can be found in the attribute panel on the right.
- In the attribute pnael, you can also add documentation in the current language.
Translate the remaining diagram elements in the same way. After saving the diagram, it will be accessible in all languages of the workspace.
Translating diagrams into multiple languages at the same time¶
Sometimes, a modeler might want to define a diagram in multiple languages while modeling the diagram. In this case, it is recommended to have the required languages set available while modeling.
- Add languages to the diagram via the language tool of the Editor toolbar.
- Select all the languages you want to work with in your diagram. This will appear on the attribute panel at the right hand side for each element, where both the label and the documentation can be translated.
- Now translate diagram elements into the desired languages simultaneously in the attribute panel by simply entering the translations into the corresponding columns and lines.
- To view the result in the other languages, switch the display language on the flag icon in the toolbar.
Migrating diagrams to a different language¶
It is possible to copy all content of a diagram that was defined in one language to another. Such a migration can be useful whenever a diagram is supposed to be translated into similar languages (like from British English to American English) or if the diagram was created in a different language than the language setting was set to and you now want to correct this.
When opening a diagram, the system will ask you for the diagram language if no default is defined.
To migrate a diagram into another language, proceed as follows:
- Click the flag symbol, then Migrate diagram to a different language in the top toolbar on the right. The corresponding dialog box opens.
- Now choose the source- and the target language for the migration. You can choose between all languages that are defined for the workspace.
- Optionally, you can delete information in the source language. Activate the checkbox Delete original texts for this purpose.
- Click OK. A confirmation prompt is displayed.
- Click Yes to confirm.
In this example a diagram was created without language definitions. The content was defined in German. As the workspaces’ default language is English, the diagram was configured to be in English when the language tools were activated. The content is now supposed to be migrated from German to English and the German contents are supposed to be removed.
Translating diagram, folder and file names¶
Please keep in mind that translations that you make within the framework of this feature are only visible in Collaboration Hub.
- Select the the name of a diagram, folder or file name you want to translate in the Explorer.
- Open the Edit menu and click Change name/description (for files and folders), respectively Rename (for diagrams).
- Now you can add translations of the name in all available languages.
- Click Change name/description respectively Rename to save your settings.