Workflow/Transition Documentation

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)

Screenshot 2021-12-16 at 15.40.28.png

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

ITSM_Incident_Management_workflow_for_Jira_Service_Management_screens.jpg
ITSM_Incident_Management_workflow_for_Jira_Service_Management_statuses.jpg
ITSM_Incident_Management_workflow_for_Jira_Service_Management_transition_1.jpg
ITSM_Incident_Management_workflow_for_Jira_Service_Management_transition_31.jpg
ITSM_Incident_Management_workflow_for_Jira_Service_Management_transition_51.jpg
ITSM_Incident_Management_workflow_for_Jira_Service_Management_transition_91.jpg
ITSM_Incident_Management_workflow_for_Jira_Service_Management_transition_101.jpg
ITSM_Incident_Management_workflow_for_Jira_Service_Management_transition_111.jpg
ITSM_Incident_Management_workflow_for_Jira_Service_Management_transition_121.jpg
ITSM_Incident_Management_workflow_for_Jira_Service_Management_information.jpg