Import a language translation for the Screens used in a Process.
Import language translations for Screen used in a Process that have been exported from the same ProcessMaker Platform version or later. In doing so, the selected Process imports all Screens used in that Process only in the language from which those Screens were previously exported for this Process. Screens cannot be imported for other than the selected Process.
Use caution when importing language translations for a Process in which its Screens are partially translated because existing translations may be overwritten upon import. Importing translations use the following protocol:
If the importing language translation contains a string that corresponds with a Screen control's translated string, the importing string overwrites the existing string for that control. For example, if the Screen control contains a translation for Full Name
, the importing translation overwrites the existing translation.
If the importing language translation contains a string that corresponds with a Screen control not containing a translated string, the importing string imports to that control's translation. For example, if there is no translation for Full Name
, the importing translation becomes the control's translation.
If the importing language translation contains a string that corresponds with a Screen control in which its value is null
, then the importing string does not import for that control's translation.
Follow these steps to import translated Screens for a selected Process:
Configure general settings for the Process in which to import its Screen translations. The Configuration tab displays.
Click the Translations tab. Languages to which the Process's Screens have been translated display.
Click the Import button. The Import Process Translation page displays.
Click the Select file from computer link to locate the language translation of a Process's Screens to import. Translations have the .json
file extension. ProcessMaker Platform evaluates the file to import. If the language translations was not exported from the same or later ProcessMaker Platform version as being imported, that language translation may not import.
The Import Process Translation page displays the Process's Screens previously translated to the language shown in the summary.
Click the Import button. The following message displays: The Process Translation was imported successfully. The Translations tab displays to indicate that the language translation imported correctly unless that language translation already existed in this ProcessMaker Platform instance.
Export the Process's Screen translations for one selected language to which those Screens are translated. This function does not export all translations for all languages to which the Process's Screens have been translated.
Follow these steps to export the language translations for the Screens used in a Process:
Configure general settings for the Process in which to export its Screen translations. The Configuration tab displays.
Click the Translations tab. Languages to which the Process's Screens have been translated display.
Click Export.
By default, ProcessMaker Platform exports the language translation using the Process name except spaces in the name are replaced with underscores (_
), suffixed with the language name. The file has the file extension .json
. Rename the default file name if necessary, though do not change the file extension. As a best practice, specify in the file name that this is an exported language translation for that Process's Screens to distinguish it from other exported assets.
Specify a directory location to save the file. ProcessMaker Platform exports the .json
file to your local computer. The following message displays when the language translation exports successfully: The translation for the process was exported.
Click the menu for a language translation to export, and then select the Export Translation option. The Export Process Translation page displays.
Edit the translations for the Screens used in a Process.
Follow these steps to search Screen translations for a Process:
Configure general settings for the Process in which to search its Screen translations. The Configuration tab displays.
Click the Translations tab. Languages to which the Process's Screens have been translated display.
Enter in the Search setting the text to filter language into which Screens have been completely translated. This search does not filter against languages in which Screens are in progress of being translated.
As you enter text into the Search setting, languages display that match your entered text. This search does not filter for languages in which Screen are in the progress of being translated.
If there are no search results, the following message displays: No Results.
Follow these steps to edit Screen translations for a Process:
Configure general settings for the Process in which to edit its Screen translations. The Configuration tab displays.
Click the Translations tab. Languages to which the Process's Screens have been translated display.
From the Screen drop-down menu, select from which Screen to translate its control labels.
Do one of the following:
Manually translate all or only untranslated strings from the original control labels by clicking the Translation Options button, and then selecting one of the following options:
Automatically translate all strings in this Screen: Select the Auto Translate All option to automatically translate all original control labels for the selected Screen. In doing so, all manually translated strings are automatically overwritten.
Automatically translate only strings with no current translations: Select the Auto Translate Empty option to only automatically translate those strings which have translations for the original control labels.
Click the Translate button. Strings based on your selection are automatically translated.
Manually translate all strings for the selected Screen's control labels. To enter a translation for a string, click into the field from the Translation column for that control label. The field becomes editable. Enter the string as necessary.
After finalizing the translations for each control label for all Screens, click Save Translation.
Follow these steps to delete Screen translations for a Process:
Configure general settings for the Process in which to delete any of its Screen translations. The Configuration tab displays.
Click the Translations tab. Languages to which the Process's Screens have been translated display.
Click Confirm. The following message displays: The Process Translation was deleted.
Configure and manage the Screen translations for a Process.
Harness the power of ProcessMaker AI to translate the contents of every screen in your process at once. The Process Translation feature supports multiple languages and provides both automatic and manual translation for screens in a process.
Users automatically see screens in their local language based on their user profile or browser settings. Screen translations are generated automatically using ProcesssMaker AI and can be later modified manually as well, if needed.
Screens are translated dynamically as they are displayed to users during a request. Translations are not visible in design mode within the Screen Builder.
As the original screen is not directly translated, other ProcessMaker Platform assets, such as Collections, remain unaffected by the translated screens.
Process translations are imported and exported with processes.
Logged-in users can view screen translations in the following languages supported by ProcessMaker Platform:
English
French
German
Spanish
The screen translation displayed for logged-in users is based on the language selected in their profile settings. Follow these steps to see a translated screen for a logged-in user:
Screens displayed through anonymous web entries can be translated into a wider range of languages, as they are not dependent on the supported languages in the Platform.
For anonymous web entries, the screen translation is determined by the web browser's language preference setting. Follow these steps to see a translated screen through an anonymous web entry link:
Ensure that the language preference in the user's web browser is set to the selected language.
Follow these steps to view all translations for a Process:
Configure general settings for the Process where the translation has to be added. The Configuration tab displays.
Click the Translations tab. Languages to which the Process's Screens have been translated display.
The Translations tab displays the following information in tabular format about language translations for the selected Process:
Target Language: The Target Language column displays the language the Screens are translated to.
Created: The Created column displays the date and time the translation was created.
Modified: The Modified column displays the date and time the translation was last modified. Note: All time zone settings are according to the ProcessMaker Platform instance unless your user profile's Time zone setting is specified.
Follow these steps to start translating Screens used by a Process:
Click the +Translation button. The Add Process Translation screen displays.
From the Select a target language drop-down menu, select the language for translation.
Click the Translate Process button.
When translation for the Process's Screens complete, the selected language displays in the Translations tab.
Process participants will now be able to see translated screens when completing tasks in requests.
Follow these steps to select which Screen control labels to translate manually:
Click the +Translation button. The Add Process Translation screen displays.
From the Select a target language drop-down menu, select the language for translation.
Select the Manual translation option. Control labels for all screens in the process are displayed showing the following information:
String: The String column displays that Screen controls' labels in the original language.
Translation: The Translation column displays the translation for each control's label in the target, translated language. By default, when translating manually, there are no translations for these strings.
From the Screen drop-down menu, select a screen to view controls from only that screen.
Manually translate all strings for the selected Screen's control labels. To enter a translation for a string, click into the field from the Translation column for that control label. The field becomes editable. Enter the string as necessary.
Select Translation Options to view the following options:
Select the Auto Translate All option to automatically translate all original control labels for the selected Screen. In doing so, all manually translated strings are automatically overwritten.
Select the Auto Translate Empty option to automatically translate only those strings which do not currently have translations available.
Click the Translate button. Strings based on your selection are automatically translated.
After finalizing the translations for each control label for all Screens, click Save Translation.
Process participants will now be able to see translated screens when completing tasks in requests.
Use the Search setting to filter which language translations that display.
Click the Import button. See Import Language Translations for Screens Used in a Process.
Optionally, click the menu for a language with partial Screen control translations, and then select the Retry Empty Translations option. ProcessMaker Platform automatically restarts the translation procedure to translate those controls that have no language translations.
Click the menu, and then select the Edit Translation option for the Screen translations of the targeted language to edit. ProcessMaker Platform retrieves the control labels for those Screens.
Click the menu, and then select the Delete Translation option for the Screen translations of a target language to delete. The Caution screen displays to confirm the deletion of the language translation.
Click the menu, and then select the Edit Translation option. See Edit Screen Translations for a Process.
Click the menu for a language with partial Screen control translations, and then select the Retry Empty Translations option. ProcessMaker Platform automatically restarts the translation procedure to translate those controls that have no language translations.
Click the menu, and then select the Export option. See Export Language Translations for Screens Used in a Process.
Click the menu, and then select the Delete Translation option. See Delete Language Translations for Screens Used in a Process.