Follow an instance
Check which step each workflow is on, what it's waiting for and what happened, and retry or cancel an instance when needed.
On this page
Every time a workflow runs, an instance is created. From Workflows → Instances you see all of your company's instances and, in the details of each one, the diagram with the step it's on, what it's waiting for and its history.
Before you start
To see instances, you only need View in Workflows. You only see instances for tickets you can see, plus those with no ticket.
To Retry or Cancel an instance, you need Administer in Workflows.
Find an instance
Go to Workflows and open the Instances tab. Next to the tab name you see how many are active.
Filter if you need to:
Status: All, Running, Waiting, Stopped by error, Completed or Cancelled.
Workflow: a specific definition.
Ticket: the ticket number, for example
INC-000123.
Press the workflow name on the row to open the instance.
The table shows the workflow and its version, the status, the ticket, the start and the end, with the most recent first (up to 200).
In Definitions, the Running column shows how many active instances each workflow has. Press that number to see only its instances.
Instance statuses
Status | What it means |
|---|---|
Running | The workflow is moving through automatic steps. |
Waiting | The workflow is waiting for a task, an approval, a timer or something on the ticket. It's the most common status. |
Stopped by error | Something failed and the workflow stopped. Administrators get the "Workflow stopped" notice. |
Completed | The workflow reached an End. |
Cancelled | An administrator cancelled it. |
The instance details
The header shows Instance vN (the version it runs on) and, below it, its status and the ticket, which you can press to open its record.
Diagram: the instance's version, with the steps marked according to the legend: done (green), active (violet) and with error (red). You can move the diagram and select elements, but not change it.
Waiting on: the steps the instance is waiting on now and what type they are (task, timer or message). Press a step to locate it in the diagram. If it's not waiting for anything, it says Nothing pending.
Variables: the workflow data, like the form answers and what the actions left behind. They may include requester data: handle them with care.
History: each event with its date: Start, Entered, Left, Wait, Signal (a completed task, a decided approval or a received message), Action, Error, Cancelled and End. Press a step name to locate it in the diagram.
The page updates on its own as the workflow moves forward.
If the workflow stopped
A Stopped by error instance shows Workflow stopped: at the top with the cause, for example "The approval … has no active approvers." or an invalid parameter in an action.
Fix the cause: record the missing manager, activate the integration, fix the ticket. If the error is in the design, publish a corrected version for new instances.
On the instance, press Retry. You'll see Retrying from the last saved state.
Check the history: the instance goes back to Running and continues from the step that failed.
Retrying doesn't change the instance's version: it keeps the one it started with. If the error is in the diagram, cancel the instance and, if appropriate, start a new one with the corrected version.
Cancel an instance
Cancel an instance when it no longer makes sense for it to continue, for example if the request was voided.
On the instance, press Cancel.
In Cancel the instance, enter the Reason (required).
Press Cancel instance.
You'll see Instance cancelled. The instance's open tasks and approvals are cancelled and disappear from each person's My tasks. The reason is recorded in the audit log. It can't be undone.
Only Running, Waiting or Stopped by error instances can be cancelled.
The Workflow panel on the ticket record
If a ticket has a workflow, its record shows the Workflow panel in the side column, with:
the workflow name and its status;
the open tasks and approvals of that workflow.
If the ticket had several workflows, the panel shows the active one or, if there's none, the latest. To see the details, look up the ticket in Workflows → Instances with the Ticket filter.
For changes, the CAB section of the change record also shows who approved and who's missing.