Workflow/Transition Documentation
General information
Available since v. 3.2.*
How many times do you need to check all workflow transitions and see how they work and what functions are used?. Workflow documentation allows you to generate complete workflow documentation including all information such as diagram, statuses, transitions, all functions (Conditions, Validators, Post Functions), screens, properties (for statuses and transitions), etc.
… and you can do it with just one click in Jira
Where you can generate Workflow documentation
On the Workflows page
1) Click the small doc icon in the Actions column to generate documentation, for a Workflow (for Active workflows, a live version will be generated)
or
2) Click Generate documentation and choose the workflow for which you want to generate documentation (includes drafts)
On the Workflow Text page
Click Documentation on the Workflow Text page (documentation will be generated for the current workflow you are viewing, live or draft)
Where you can generate Transition documentation
On the Workflow Text or Diagram page
Click the Documentation icon on the Workflow Text or Diagram page (documentation will be generated for the selected workflow transition)
Direct link documentation
Open a new browser tab and paste url
{JIRA_URL}/secure/WorkflowBoosterDocumentation.jspa?workflowName={WORKFLOW_NAME}&mode={WORKFLOW_MODE}
where:
{JIRA_URL}
- your Jira url address
{WORKFLOW_NAME}
- Workflow name
{WORKFLOW_MODE}
- Workflow mode, “draft” or “live”
Change the documentation view
You can change the documentation view by adding parameters to the URL, such as
&collapse={COLLAPSE_ITEMS}
to hide certain elements where {COLLAPSE_ITEMS}
- tocSubMenu, transitionDetails or screenDetails
You can configure this directly in the GUI by clicking the icon in the top right corner, where you can choose additional configuration items.
Additionally, you can save a new view as default for any documentation.
Parameter transition
(transition id or name) allows you to see only the documentation for that transition. Example:
{JIRA_URL}/secure/WorkflowBoosterDocumentation.jspa?workflowName=test&transition=1
{JIRA_URL}/secure/WorkflowBoosterDocumentation.jspa?workflowName=test&transition=Create
Export documentation as a file (PDF/JPG/PNG)
You have several options to export the documentation, as a single PDF file (Print as a PDF file) or as multiple files, with each piece of important data (e.g., transitions, diagrams) exported separately
Example - one PDF File:
Example - several PDF Files
Example - several JPG Files