Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Configure and manage the Screen translations for a Process.
Understand how Screen Translations work within a Process.
Use Process Translations to translate all Screens that a selected Process may use during its Requests. The original Screen is not translated directly, so that other ProcessMaker Platform assets, such as other Processes or Collections, are not affected by a translated Screen into a language not intended to display content. Instead, ProcessMaker Platform only translates Screens at the time of their use, and only for Requests. They are not translated for use in Collections.
ProcessMaker Platform evaluates how to display the Screen at the time of its use in the following way:
If the Screen is translated to a natural language that ProcessMaker Platform supports, then that Screen displays in the logged on user's language as determined by the profile setting.
For anonymous Web entry, the Web browser language preference setting determines which translated Screen to display.
If the Screen is translated to a natural language that ProcessMaker Platform does not support, then the Screen displays in the translated language at the time it renders.
When a Process is exported, and then imported to another ProcessMaker Platform instance, those Screens that have natural languages translations also export and import with that Process.
View the languages to which the Screens for a Process are translated.
Follow these steps to view all translations for a Process:
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 to which target language the Screens for the Process are translated.
ProcessMaker Platform displays all translations for a Process's Screens in one location. These Screens are rendered in the translated language only for that Process's Requests, and only at the time of their use in a Request. See for more information about how Screens are rendered for translation.
See the permissions or ask your Administrator for assistance.
.
. The Configuration tab displays.
Created: The Created column displays the date and time the translation was created. The time zone setting to display the time is according to the ProcessMaker Platform instance unless your Time zone setting is specified.
Modified: The Modified column displays the date and time the translation was last modified. The time zone setting to display the time is according to the ProcessMaker Platform instance unless your Time zone setting is specified.
Use the setting to filter which language translations that display.
Click the +Translation button. See .
Click the Import button. See .
Click the ellipses icon, and then select the Edit Translation option. See .
Click the ellipses icon 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 ellipses icon, and then select the Export option. See .
Click the ellipses icon, and then select the Delete Translation option. See .
Translate all Screens that are used in a Process.
Follow these steps to start translating Screens used by a Process:
Click the Translations tab. Languages to which the Process's Screens have been translated display.
Click the +Translation button. The Add Process Translation screen displays.
Do one of the following:
Manually translate Screens: Select the Manual translation checkbox to manually translate the control labels for each Screen the Process uses.
Click the Translate Process button. See one of the following sections depending on whether Screens are automatically or manually translated:
Follow these steps to automatically translate Screens a Process uses:
Screens are translating: While the Screens are translating, the following message displays: Translation in Progress. A percentage of completion displays following this message.
Screen translation error: If a Screen translation error occurs, the following message displays: An error occurred while calling OpenAI endpoint.
When translation for the Process's Screens complete, the selected language displays in the Translations tab.
Follow these steps to select which Screen control labels to translate manually:
When the control labels for those strings are retrieved, they display in tabular format:
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 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.
See the permissions or ask your Administrator for assistance.
.
. The Configuration tab displays.
Automatically translate Screens: From the Select a target language drop-down menu, select to which language to translate all Screens this Process may use in any Request. Screen translations are only rendered at the time of use. See for more information about how Screens are rendered for translation.
. One of the following occurs during automatic translation:
Optionally, .
. ProcessMaker Platform retrieves the control labels for those Screens.
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.
Your user account or group membership must have the following permissions to import Screen translations for a Process unless your user account has the Make this user a Super Admin setting selected:
Processes: Import Processes
Processes: View Processes
See the Processes permissions or ask your Administrator for assistance.
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.
Search for a language translation for Screens used in a Process.
Your user account or group membership must have the following permissions to search for Screen translations for a Process unless your user account has the Make this user a Super Admin setting selected:
Processes: Edit Processes
Processes: View Processes
See the Processes permissions or ask your Administrator for assistance.
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.
Edit the translations for the Screens used in a Process.
Your user account or group membership must have the following permissions to edit Screen translations for a Process unless your user account has the Make this user a Super Admin setting selected:
Processes: Edit Processes
Processes: View Processes
See the Processes permissions or ask your Administrator for assistance.
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.
Export a selected language translation for the Screens used in a Process.
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:
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.
Delete a selected language translation for the Screens used in a Process.
Follow these steps to delete Screen translations for a Process:
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.
Optionally, click the ellipses icon 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 ellipses icon, 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.
See the permissions or ask your Administrator for assistance.
.
. The Configuration tab displays.
Click the ellipses icon for a language translation to export, and then select the Export Translation option. The Export Process Translation page displays.
See the permissions or ask your Administrator for assistance.
.
. The Configuration tab displays.
Click the ellipses icon, 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.