Skip to main content

Workflow

Administration → Workflow — configure the approval flows used across ZapHRMS. Requires workflow:manage (approving definitions requires workflow:approve).

Workflow Setup pageWorkflow Setup page
Workflow Setup — every workflow, its version and status

Built-in workflows​

The standard flows ship ready to use:

  • Leave Approval — leave applications.
  • Attendance Approval — attendance corrections / regularization.
  • Resignation Approval — resignations, routed to manager/HR.
  • Asset Request Approval — asset requests.
  • Additional Reviewer Approval — an employee's request to add an appraisal reviewer.
  • Timesheet Approval — weekly timesheets.
  • Shift Change Approval and Shift Swap Approval — requests raised from My Shifts.
  • …plus any custom workflows your organization adds with New Workflow.

The summary cards show Total / Active / Drafts / Pending counts. Search by code, name or description, or filter by status.

Row actions​

IconAction
PencilEdit a draft in the designer
EyeView an active workflow read-only
SendSubmit a draft for approval
CopyCreate a new version of an active workflow
ClockVersion history — every version, who submitted it and who approved it
BinDelete a draft

The designer​

Opening a workflow shows its steps as boxes on a canvas, joined by lines.

Workflow designer canvasWorkflow designer canvas
The designer — Start, an approval step and the Approved / Rejected end steps
  • Start box — the workflow's entry point. Its connection says which step runs first.
  • Step boxes — each approval step shows who decides (for example Dynamic · Reporting Manager, a role or a named person).
  • Final steps — Approved and Rejected end the workflow.
  • Lines — a step has an Approve line and a Reject line to the step that follows each outcome. A line can also go back to an earlier step, for a return for rework.

On a draft you can:

  • Drag a box to move it; boxes snap and align to their neighbours. Arrow keys nudge the selected box (hold Shift for a larger move) and Esc cancels a drag.
  • Add a step by dragging it from the palette — drop it onto a line to insert it between two steps.
  • Connect steps by dragging from a box's handle, or by clicking a handle and then the target. Select a line to remove it.
  • Use the toolbar to zoom, pick an automatic layout (Left to right, Top to bottom or Wrap into rows) — dragging a box switches to Placed by hand — and choose the line style (Curved, Right-angled or Straight).
  • Select a box to edit its properties in the panel on the right: the step name and who approves. An approver is an Employee, a Role, a Group or a Dynamic rule — Reporting Manager, Skip Level Manager, Requester's Manager, Initiator (Self) or Other Party (the colleague on a shift swap).

On an active (published) workflow the same canvas is read-only; the right panel shows the workflow's code, name, description, version and who created, submitted and approved it.

:::note Where box positions are kept Workflows do not store a layout on the server, so the positions of boxes are remembered in your browser for each workflow. Another browser or person sees the automatic layout. Moving a box never changes how the workflow runs; only adding, removing or reconnecting steps does. :::

Versioning model​

Workflows are versioned.

  1. Click New Version on a workflow to create an editable draft (the current version keeps running).
  2. Configure the draft in the designer — the approval steps, who approves at each step, and where each outcome leads.
  3. Submit the draft; once approved, it becomes the active version. Versions shows every previous version with who submitted and approved it.

Changes never affect requests already in flight — they complete on the version they started with.

Click the i icon for the in-app help on the designer.