This tutorial shows how to work with the user documentation that is part of the client application.
Documentation elements
You can use the following documentation elements:
- USER_LONG_HELP: Field tooltip
- USER_WFSTEP_DESCRIPTION: Workflow step title for UI steps (visible to users)
- DEV_INTERNAL: Internal note for modeler/developer
- RULE_EXCEPTION_MESSAGE: Additional exception message for rules
- EXAMPLE: General example of use
- EXAMPLE_JSON: Example of JSON input or output used in APIs
- EXAMPLE_XML: Example of XML used in transformations or workflows
Documentation Modification
If you want to create documentation for a specific object, you must first select it in the Model Browser.
Remember: documentation elements are linked to the object selected in the Model Browser, not in the Property editor.
Once you’ve selected the object, all available documentation elements appear in the right panel under the Documentation tab. If the panel is not visible, you can activate it in the main menu under View / Documentation.
You can now fill in all the desired elements, placing each one on a separate line:
To delete an element, select and remove the entire line.
When you’re finished, don’t forget to save your changes.
The documentation editor has its own save button that must be used:
Client Application
Here are some examples showing how documentation elements appear in the client application.
Tooltip:
Workflow step:
Other topics
Source file
The content of your documentation elements is stored in an XML file located at:
your_project/model/package/.origamDoc
file
Translations
Documentation texts are part of the localization file and are exported along with screen labels and other elements.
If you need to translate any of the documentation elements, add their names to the OrigamSettings.config
file: