Translating diagrams into other languages¶
This feature is available in the Enterprise Edition.
Diagrams can be created to support several languages, which enables you to present your diagrams to an even larger community.
This feature is integrated in all parts of the Signavio Process Manager. Languages are defined in the Explorer. Diagrams are translated in the Editor and can be viewed in the Collaboration Hub. Dictionary entries can be translated, too.
A workspace has a certain set of available languages which can be defined in the Explorer by a workspace administrator.
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.
At first switch to the language the diagram is supposed to be translated to, by following the steps above.
The following example shows a translation from English to German. Elements that were not yet translated are highlighted in red. Double click an element to define its label:
Translate element labels manually.
Click somewhere on the canvas to accept the new label. The translation will now be stored and can be found in the attribute Editor on the right:
Name and the description can be defined in multiple languages.
The attribute Editor also allows you to add documentation in the current language.
Translate the remaining diagram elements in the same way. After saving the diagram, they will be accessible in the Collaboration Hub too.
Translating diagrams into many 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 flag symbol in the toolbar:
Add a language to the diagram.
Select all the languages you want to work with in your diagram. They will become visible in the attribute Editor on the right, which includes labels and element documentation:
This diagram is available in English, German and French. Currently, it is displayed in German.
If you have set all the necessary languages, you can translate diagram elements into several languages simultaneously in the attribute Editor. Simply enter the translations into the corresponding columns and lines.
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, click the flag symbol, then Migrate diagram to a different language in the top toolbar on the right:
the menu entry to migrate the diagram to a different language
A dialog that allows choosing the source- and the target language for the migration will appear. You can choose between all languages that are defined for the workspace:
A diagram will be migrated from German to English.
It is also possible to delete information in the initial language. In those cases the system will ask you to confirm the process after hitting OK:
security check when deleting contents in the initial langauge
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.