Workflow Setup

The Workflow Setup page is where administrators create, configure, and manage business process workflows. DocView Web uses a visual BPMN 2.0 editor (powered by the bpmn-js library) that lets you design complex approval chains, routing logic, and automated actions with a drag-and-drop interface.

Opening the Designer

1. Navigate to Workflow in the left sidebar.
2. Click Workflow Setup (visible to administrators only).
3. You will see a list of existing workflows. Click Create Workflow to start a new one, or click an existing workflow to edit it.
4. The BPMN canvas opens with a toolbar on the left and a properties panel on the right.

Building a Workflow

• Start Event – Every workflow begins with a start event (green circle). Drag it onto the canvas from the palette.
• Activities – Add task shapes to represent each step in the process (e.g. “Manager Review”, “Finance Approval”, “Send Notification”).
• Sequence Flows – Draw arrows between activities to define the order of execution.
• Gateways – Add decision points (exclusive gateways) to branch the workflow based on conditions (e.g. “If PO value > £5000, require director approval”).
• End Event – Every workflow must end with an end event (red circle).

Workflow Properties

Click any element on the canvas to configure its properties in the right panel:

• Name – A human-readable label for the step.
• Assignee – The user or role responsible for completing this step.
• Actions – The available actions at this step (Approve, Reject, Complete, or custom actions).
• Integrations – Connect to external systems via SMTP (email), SQL queries, or DLL-based integrations.

Workflow Variables

Workflows can use variables to pass data between steps. Variables can be created, edited, and deleted from the Variables section. They support text, number, date, and boolean data types and can be referenced in conditions and email templates.

Workflow Forms

The Form Builder lets you design custom forms that are presented to users during workflow steps. Forms can include text fields, dropdowns, date pickers, checkboxes, and rich-text areas. Responses are stored as workflow data and can influence subsequent steps.

Publishing a Workflow

After designing the workflow, click Publish to make it active. Published workflows can be triggered automatically (e.g. when a document is uploaded to a specific type) or manually from a document record.

WARNING

Editing a published workflow creates a new version. Running instances continue using the version under which they were started.