Creating approval groups and workflow types
How to build the groups of approvers and the workflow types that decide which levels a job passes through, including Cascade and Parallel modes.
How to build the groups of approvers and the workflow types that decide which levels a job passes through, including Cascade and Parallel modes.
This is for System Admin and HR users, who can create, edit and delete approval groups and workflow types under Settings > Approval Workflows. Members and Agency users cannot open the page. Create groups first, because a workflow type needs groups to point at.
Approval groups
A group is the set of people who can approve at one level of a workflow. Any approver in the group can approve on behalf of the whole group.
- Open the Approval Groups tab and select + Add Group. The group is created straight away with a placeholder name, so rename it before you do anything else.
- Enter a Group Name (up to 255 characters) and, if you want, a Description (up to 2,000 characters).
- Under Members, use Add member... to pick people one at a time. Use the bin icon next to a name to remove them.
- Select Save.
Members must be existing users of your organisation. Agency users cannot be added. In an organisation that belongs to a group of companies, eligible users from the parent company can also be added. If you try to save someone who does not qualify, the save fails with a message saying members must be existing, non agency users of this organisation.
A group with no members cannot be used. Submitting a job that reaches an empty group fails with "Approval group ... has no members. Add members before submitting for approval."
Deleting and hiding groups
The badge on a group in the list shows how many workflows and approval steps use it. A group that is in use cannot be deleted, and the Delete button is greyed out. That includes groups used only by jobs that were approved long ago.
A group can be marked Hidden. A hidden group is left out of the group list and out of the group pickers when you set up a workflow level or submit a job, and jobs already using it carry on as normal. Its members can still approve. To see hidden groups, turn on Show hidden groups under the list, which shows how many there are in brackets. The switch only appears when at least one group is hidden. Hidden groups carry a Hidden badge. Select one to see a notice, then choose Unhide group to bring it back. System Admin and HR users can unhide a group, but nobody can hide one from this page.
Workflow types
A workflow type defines the levels a job passes through. Submitters choose one on the Approvals step of job creation, so create one for each route you need, for example a standard route and a senior hire route.
- Open the Workflow Types tab and select + Add Workflow. It is created straight away with a placeholder name and one empty level.
- Enter a Workflow Name and, if you want, a Description.
- Choose the Workflow Mode (see the next section).
- Under Approval Levels, fill in each level. Use Add Level for more. A workflow can have up to 20 levels.
- Select Save.
Each level has these settings:
- Level Label: the name approvers and submitters see, such as "Finance sign-off". Up to 255 characters.
- Default Group: the group that approves this level. When you choose one, the submitter cannot change it. It shows with a padlock and the hint that the workflow decides which group approves. Leave it empty and the submitter picks a group for that level when they submit.
- Can Edit: when on, members of that level's group can edit the job while it is waiting at that level, as well as approve it. The submitter sees this as a Can edit + approve badge on the level. When off, the badge reads Approve only.
The list has no reorder control. To change the order of levels, remove them and add them again in the order you want. Use the cross at the end of a level's row to remove one.
A workflow with no levels cannot be used to submit a job. Like groups, a workflow that has been used by any job cannot be deleted. The delete button is greyed out and the page says the workflow is referenced by jobs.
Workflow Mode: Cascade or Parallel
Workflow Mode decides how the levels of a job run.
- Cascade: levels are approved in order, one after another. Level 1 first, then level 2, and so on. A later level opens only once the one before it has approved, and its group is emailed at that point.
- Parallel: all levels can be approved at the same time. Every level's group is emailed when the job is submitted or restarted, and each group can approve or reject without waiting for the others. The job counts as fully approved when no level is left waiting. Approvers see every step still waiting on their group in their approvals list.
The mode is stored on each job's approval round when the job is submitted or restarted. Changing it on a workflow affects jobs submitted from then on. Rounds already in progress are not changed. Day to day steps for approvers are in "Approving or rejecting a job".