{"type":"doc","content":[{"type":"paragraph","content":[{"type":"status","attrs":{"color":"blue","style":"bold","text":"SINCE VERSION 9.0","localId":"b0e0b11d-f71a-4eed-9588-b722cef0c8bd"}},{"text":" ","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"d38cfd90-ccba-4bc3-866e-47fb9ecd1c76"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"8e2dd9e1-0bea-4664-890f-17c957a89d6f"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"What is Internationalization (i18n)?","type":"text"}]},{"type":"paragraph","content":[{"text":"Internationalization","type":"text","marks":[{"type":"strong"}]},{"text":" (often abbreviated as ","type":"text"},{"text":"i18n","type":"text","marks":[{"type":"strong"}]},{"text":", where \"18\" stands for the number of letters between the first 'i' and the last 'n' in \"internationalization\") refers to the process of designing and developing a software application so that it can be easily adapted to various languages and regions without requiring engineering changes to the source code. This approach allows the same software to be used globally, supporting multiple languages, character sets, and cultural conventions.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"How does it work in PIPEFORCE?","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Enable i18n per app","type":"text"}]},{"type":"paragraph","content":[{"text":"Because of performance reasons, customized i18n on app level is disabled by default.","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to enable it, you have to set ","type":"text"},{"text":"\"i18n\": true","type":"text","marks":[{"type":"code"}]},{"text":" in your app config. For example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"title\": \"My app\",\n \"i18n\": true\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Language key (locale) detection","type":"text"}]},{"type":"paragraph","content":[{"text":"Whenever the UI is loaded in the portal, the application will in first step check for the currently selected language key (= locale) in this order (first finding wins):","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"There is a request parameter ","type":"text"},{"text":"locale","type":"text","marks":[{"type":"strong"}]},{"text":" (for example ","type":"text"},{"text":"?locale=en","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The currently logged-in user has the attribute ","type":"text"},{"text":"locale","type":"text","marks":[{"type":"strong"}]},{"text":" set in IAM (for example ","type":"text"},{"text":"locale:en","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The default language of the browser is used.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"i18n URI (key)","type":"text"}]},{"type":"paragraph","content":[{"text":"After the locale was detected, it will be used to translate all i18n URIs in the UI having a format like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:i18n://","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"Is optional and represents the name of the app which contains the i18n translation messages. If missing, the ","type":"text"},{"text":"io.pipeforce.common","type":"text","marks":[{"type":"code"}]},{"text":" app will be used as default.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Represents a specific group of translation messages. This way, messages can be better organized. Is optional for common i18n keys and If missing, the name ","type":"text"},{"text":"portal","type":"text","marks":[{"type":"code"}]},{"text":" is used here. For app specific i18n keys, the context is mandatory and must be individually given.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"The key of the translation message.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Let’s assume for example an i18n URI like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:i18n:com.acme.myapp/form/hello_world","type":"text"}]},{"type":"paragraph","content":[{"text":"This example defines these sections:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"com.acme.myapp","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"form","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"hello_world","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"Here is another example with key only (no app and no context are given):","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:i18n:hello_world","type":"text"}]},{"type":"paragraph","content":[{"text":"This example defines these sections:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"io.pipeforce.common","type":"text","marks":[{"type":"code"}]},{"text":" (default since none is given in uri)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"portal","type":"text","marks":[{"type":"code"}]},{"text":" (default since none is given in uri)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"hello_world","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"And some last example with context and key but no app is given: ","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:i18n:form/hello_world","type":"text"}]},{"type":"paragraph","content":[{"text":"This example defines these sections:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"io.pipeforce.common","type":"text","marks":[{"type":"code"}]},{"text":" (default since none is given in uri)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"form","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"hello_world","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"i18n message resources","type":"text"}]},{"type":"paragraph","content":[{"text":"The translation (i18n) messages are defined in JSON format having a simple key-value structure:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"key\": \"value\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"And the file name of the JSON is the same as the locale of the language.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example ","type":"text"},{"text":"de.json","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"hello_world\": \"Hallo Welt\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"For example ","type":"text"},{"text":"en.json","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"hello_world\": \"Hello World\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"These i18n JSON properties are stored inside the same app, they belong to, below the ","type":"text"},{"text":"i18n","type":"text","marks":[{"type":"code"}]},{"text":" folder. For example:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"global/","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"app/","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"com.acme.myapp/","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"i18n/","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"75a39d97-a9ba-49ef-95e5-64cb63eb2a23"}},{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"default-de.json","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"default-en.json","type":"text","marks":[{"type":"code"}]}]}]}]}]}]}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"In this example, the i18n URI ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"eb6f4a9d-07fa-451b-90e7-7f2ddce2c893"}}]},{"text":"$uri:i18n:com.acme.myapp/default/hello_world","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"eb6f4a9d-07fa-451b-90e7-7f2ddce2c893"}},{"type":"code"}]},{"text":" with a detected locale of ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"eb6f4a9d-07fa-451b-90e7-7f2ddce2c893"}}]},{"text":"de","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"eb6f4a9d-07fa-451b-90e7-7f2ddce2c893"}},{"type":"code"}]},{"text":" would finally return the translated text ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"eb6f4a9d-07fa-451b-90e7-7f2ddce2c893"}}]},{"text":"Hello World","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"eb6f4a9d-07fa-451b-90e7-7f2ddce2c893"}},{"type":"code"}]},{"text":" to be displayed in the UI.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"eb6f4a9d-07fa-451b-90e7-7f2ddce2c893"}}]}]},{"type":"paragraph","content":[{"text":"Using a context, you can group multiple i18n message JSONs in a structured way. Lets assume we will have the two custom groups ","type":"text"},{"text":"form","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"report","type":"text","marks":[{"type":"code"}]},{"text":", then we could have a structure of i18n messages in the app like this:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"global/","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"app/","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"com.acme.myapp/","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"i18n/","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"form-de.json","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"form-en.json","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"report-de.json","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"report-en.json","type":"text","marks":[{"type":"code"}]}]}]}]}]}]}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Inside the ","type":"text"},{"text":"form-","type":"text","marks":[{"type":"code"}]},{"text":"* JSON properties, all translations for all forms could be placed and inside ","type":"text"},{"text":"report-","type":"text","marks":[{"type":"code"}]},{"text":"* JSON properties all translations related to reportings could be placed. Whether you use contexts and how you name those contexts (groups) is up to you.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, the i18n URI ","type":"text"},{"text":"$uri:i18n:com.acme.myapp/form/hello_world","type":"text","marks":[{"type":"code"}]},{"text":" with a detected locale of ","type":"text"},{"text":"de","type":"text","marks":[{"type":"code"}]},{"text":" would expect the i18n translation to reside inside the property ","type":"text"},{"text":"global/app/com.acme.myapp/i18n/form-de.json","type":"text","marks":[{"type":"code"}]},{"text":" with a key-value-pair in it like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"hello_world\": \"Hallo Welt\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"The ","type":"text"},{"text":"i18n.message","type":"text","marks":[{"type":"code"}]},{"text":" command","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to return the messages for a given app, context and locale via remote API call or inside a data pipeline, you can use the command ","type":"text"},{"text":"i18n.message","type":"text","marks":[{"type":"code"}]},{"text":". This command is also used in the portal UI.","type":"text"}]},{"type":"paragraph","content":[{"text":"The commands supports these parameters:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d1fc0f50-9098-4820-8c31-aa7baa4ebb8b"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest, #F4F5F7)","rowspan":1,"colwidth":[415.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"app","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[415.0]},"content":[{"type":"paragraph","content":[{"text":"The name of the app to load the messages from inside its ","type":"text"},{"text":"i18n","type":"text","marks":[{"type":"code"}]},{"text":" folder. If null or empty, the default ","type":"text"},{"text":"io.pipeforce.common","type":"text","marks":[{"type":"code"}]},{"text":" will be used.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"context","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[415.0]},"content":[{"type":"paragraph","content":[{"text":"The context name to be used to select the messages inside the i18n folder. If null or empty, the value ","type":"text"},{"text":"default","type":"text","marks":[{"type":"code"}]},{"text":" will be used.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"locale","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[415.0]},"content":[{"type":"paragraph","content":[{"text":"The language locale to be used. If null or empty, the value ","type":"text"},{"text":"en","type":"text","marks":[{"type":"code"}]},{"text":" will be used as default.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"For example when calling the command ","type":"text"},{"text":"i18n.messages","type":"text","marks":[{"type":"code"}]},{"text":" like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - i18n.messages:\n app: \"com.acme.myapp\"\n context: \"portal\"\n locale: \"de\"","type":"text"}]},{"type":"paragraph","content":[{"text":"… it will try to load the messages from a JSON property ","type":"text"},{"text":"global/app/com.acme.myapp/i18n/portal-en","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"It will load the JSON from this property and embed it into a JSON envelope.","type":"text"}]},{"type":"paragraph","content":[{"text":"The resulting JSON document, returned by the command ","type":"text"},{"text":"i18n.messages","type":"text","marks":[{"type":"code"}]},{"text":" will then look similar to this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"locale\": \"de\",\n \"app\": \"com.acme.myapp\",\n \"context\": \"portal\",\n \"messages\": {\n \"hello\": \"Hallo\",\n \"world\": \"Welt\"\n }\n}","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"In case ","type":"text"},{"text":"no specific locale message could","type":"text","marks":[{"type":"strong"}]},{"text":" be found, the message from the ","type":"text"},{"text":"en","type":"text","marks":[{"type":"code"}]},{"text":" resource will be returned as default. ","type":"text"}]},{"type":"paragraph","content":[{"text":"In case there is also ","type":"text"},{"text":"no i18n key","type":"text","marks":[{"type":"strong"}]},{"text":" in the default ","type":"text"},{"text":"en","type":"text","marks":[{"type":"code"}]},{"text":" resource, the key itself will be returned as translation text. No error.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Frontend locations supported for i18n","type":"text"}]},{"type":"paragraph","content":[{"text":"In case i18n is enabled in your app, then in these frontend resource locations you can use custom i18n URIs like ","type":"text"},{"text":"$uri:i18://","type":"text","marks":[{"type":"code"}]},{"text":" so they will be automatically replaced by the translated text depending on currently selected locale.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"App Config","type":"text"}]},{"type":"paragraph","content":[{"text":"You can translate:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The title of the app","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The description of the app","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"title\": \"$uri:i18n:com.acme.myapp/title\",\n \"description\": \"$uri:i18n:com.acme.myapp/description\",\n \"i18n\": true\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The i18n settings in this example are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"com.acme.myapp","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"portal","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"title","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"description","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"i18n property path = ","type":"text"},{"text":"global/app/com.acme.myapp/i18n/portal-","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Form Schema","type":"text"}]},{"type":"paragraph","content":[{"text":"You can translate:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The title of a field ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The description of a field","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n\t\"type\": \"object\",\n\t\"properties\": {\n\t\t\"firstName\": {\n\t\t\t\"type\": \"string\",\n\t\t\t\"title\": \"$uri:i18n:com.acme.myapp/firstName\",\n\t\t\t\"description\": \"$uri:i18n:com.acme.myapp/firstNameDesc\",\n\t\t\t\"maxLength\": 1000\n\t\t},\n\t\t...\n\t}\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The i18n settings in this example are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"com.acme.myapp","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"portal","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"firstName","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"firstNameDesc","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"i18n property path = ","type":"text"},{"text":"global/app/com.acme.myapp/i18n/portal-","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Form Config","type":"text"}]},{"type":"paragraph","content":[{"text":"You can translate:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The title of the form","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The description of the form","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Validation Messages","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"title\": \"$uri:i18n:com.acme.myapp/form/title\",\n \"description\": \"$uri:i18n:com.acme.myapp/form/description\", \n ...\n \"layout\": {\n \"items\": [\n {\n \"field\": \"firstName\", \n \"validation\":[\n { \n \"type\":\"js\", \n \"rule\":\"!!val\", \n \"message\": \"$uri:i18n:com.acme.myapp/validation/required\" \n },\n { \n \"type\":\"js\", \n \"rule\":\"val.length > 2\", \n \"message\": \"$uri:i18n:com.acme.myapp/validation/must_longer_than_2\" \n }\n ]\n },\n ...\n ]\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The i18n settings in this example are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"com.acme.myapp","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"form","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"validation","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"title","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"description","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"required","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"must_longer_than_2","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"i18n property path = ","type":"text"},{"text":"global/app/com.acme.myapp/i18n/form-","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"global/app/com.acme.myapp/i18n/validation-","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"List Config","type":"text"}]},{"type":"paragraph","content":[{"text":"You can translate:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The title of the list","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The description of the list","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"title\": \"$uri:i18n:com.acme.myapp/list/title\",\n \"description\": \"$uri:i18n:com.acme.myapp/list/description\",\n ...\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The i18n settings in this example are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"com.acme.myapp","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"list","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"approval","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"description","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"i18n property path = ","type":"text"},{"text":"global/app/com.acme.myapp/i18n/list-","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Task Name","type":"text"}]},{"type":"paragraph","content":[{"text":"You can translate:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The display name of a task","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In order to translate the name of a workflow task, you have to specify the i18n URI in the first line of the ","type":"text"},{"text":"description","type":"text","marks":[{"type":"strong"}]},{"text":" of the task as this example shows:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":701,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":701,"alt":"image-20240806-061419.png","id":"1f5314f9-2022-43a9-9ae2-6d08a777a7f6","collection":"contentId-2549088261","type":"file","height":375},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph","content":[{"text":"Everywhere in the UI where this task is displayed (for example in the task list), the translation for the task name is shown depending on the currently active locale.","type":"text"}]},{"type":"paragraph","content":[{"text":"The i18n settings in this example are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"com.acme.myapp","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"myworkflow","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"approval","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"i18n property path = ","type":"text"},{"text":"global/app/com.acme.myapp/i18n/myworkflow-","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Workflow Name","type":"text"}]},{"type":"paragraph","content":[{"text":"You can translate:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The name of the workflow","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If you want to translate the name of a workflow, you have to create a i18n messages property of type ","type":"text"},{"text":"application/json","type":"text","marks":[{"type":"code"}]},{"text":" using this path:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app//i18n/-","type":"text"}]},{"type":"paragraph","content":[{"text":"Replace ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" by the name where the workflow property (BPMN) resides in.","type":"text"}]},{"type":"paragraph","content":[{"text":"Replace ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" by the name of the workflow, which is currently shown in UI and you would like to provide a translation for.","type":"text"}]},{"type":"paragraph","content":[{"text":"Replace ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" by the locale key (for example ","type":"text"},{"text":"en","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"de","type":"text","marks":[{"type":"code"}]},{"text":") of the translation you would like to provide.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/io.pipeforce.myapp/i18n/myworkflow-en","type":"text"}]},{"type":"paragraph","content":[{"text":"Place the i18n messages JSON inside this property having the field processDefinitionName:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n\t\"processDefinitionName\": \"English Name of Workflow\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Whenever the workflow is loaded or shown in the UI using the command ","type":"text"},{"text":"workflow.process.find","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/api.html#/Command%20API%20-%20workflow/post_api_v3_command_workflow_process_find"}}]},{"text":" or ","type":"text"},{"text":"workflow.definition.details.find","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/api.html#/Command%20API%20-%20workflow/post_api_v3_command_workflow_definition_details_find"}}]},{"text":" with parameter ","type":"text"},{"text":"locale","type":"text","marks":[{"type":"code"}]},{"text":", the translated name will be picked-up and returned with the response.","type":"text"}]},{"type":"paragraph","content":[{"text":"In case no translation message or translation field exists for a given language, the common workflow name will be returned instead.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Common i18n messages (Portal)","type":"text"}]},{"type":"paragraph","content":[{"text":"There are global (common) i18n messages which are used inside the portal across all apps. These i18n resources are located inside ","type":"text"},{"text":"global/app/io.pipeforce.common/i18n","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"In case an i18n key doesn’t contain an app name like this example, the translation will be searched inside the common path mentioned above:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$uri:i18n:hello","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example an i18n message resource like this is expected to exist (if ","type":"text"},{"text":"locale=en","type":"text","marks":[{"type":"code"}]},{"text":" or as fallback):","type":"text"}]},{"type":"codeBlock","content":[{"text":"global/app/io.pipeforce.common/i18n/portal-en.json","type":"text"}]},{"type":"paragraph","content":[{"text":"… with an key-value entry like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"hello\": \"Hello\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The translations for the portal UI are located at:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"global/","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"app/","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"io.pipeforce.common/","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"i18n/","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"portal-de.json","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"portal-en.json","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"…","type":"text"}]}]}]}]}]}]}]}]}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported