Skip to content

How to Build Common Workflow Patterns in Sintel Apps ​

Designer › Workflow

Five patterns cover most business processes. Each one lists the statuses and actions to create. To learn how to create them, see Workflow Statuses and Workflow Actions.

For every action in these patterns, set the Audience. A new action is Public: anyone who can edit the item can do it. Approve and Reject actions should go to Specific users.

To use a people field of the form, such as Created By, select the field button next to the audience box and pick the field. It shows with its internal name, for example Created By as {{Author}}.

1. Simple approval ​

One person or team approves or rejects. For example: leave requests, small purchases, access requests.

StatusActionsAudience
Draft (initial)Submit → SubmittedCreated By (the person who created the item)
SubmittedApprove → Approved; Reject → RejectedA group, for example Approvers
Approved, Rejectednone: the process ends

On Reject, turn on Show confirmation popup with Comment set to Required, so the approver gives a reason.

The Workflow tab of a simple approval: Submitted (the initial status) with the actions Approve and Reject, and the statuses Approved and Rejected

2. Approval in levels ​

Several people approve one after the other, for example the manager and then finance.

StatusActionsAudience
Draft (initial)Submit → Manager ReviewCreated By
Manager ReviewApprove → Finance Review; Reject → Rejected{{Manager}}
Finance ReviewApprove → Approved; Reject → RejectedThe Finance group

There is no built-in "manager". Add a Person field Manager to the form, and pick it in the audience with the field button. It shows as {{Manager}}. The requester, or a default value, fills it in.

3. Approval by several people at once ​

A committee or board decides together.

StatusActionsAudienceQuorum
Draft (initial)Submit → ReviewCreated By
ReviewApprove → ApprovedThe committee members or their groupFixed number 2, or Everyone
ReviewReject → RejectedThe sameFixed number 1

With Fixed number 2, any two members move the item. With Everyone, all of them must approve. Everyone works only with Specific users. See Quorum.

4. Approval that depends on a value ​

Large amounts need a director, small ones don't. For example: above £10,000, the director approves too. The form has a Number field Amount.

StatusActions
Draft (initial)Submit → Manager Review
Manager ReviewApprove (High Value) → Director Review; Approve (Low Value) → Approved; Reject → Rejected
Director ReviewApprove → Approved; Reject → Rejected

Then, in the Logic tab, show only the right approve action with two rules:

RuleConditionSteps
High valueField Value Check: Amount is greater than 10000Workflow Action Approve (Low Value): Hidden
Low valueField Value Check: Amount is less than or equal to 10000Workflow Action Approve (High Value): Hidden

Use is less than or equal to in the second rule. With is less than, an amount of exactly 10,000 matches neither rule, and both actions show.

In the form, at Manager Review:

  • Amount £15,000: only Approve (High Value) shows, and the item goes to Director Review.
  • Amount £5,000: only Approve (Low Value) shows, and the item goes straight to Approved.

Tip: to show both as just Approve, add a Buttons widget with two action buttons, one for each action. On each button, turn off Inherit properties from action and set the label to Approve. The Actions menu still lists the actions by their real names. To show only the buttons, set Actions menu behavior to Always hidden (see Actions Menu Behavior).

5. Send back for changes ​

The reviewer returns the item to the requester instead of rejecting it.

StatusActionsAudience
Draft (initial)Submit → SubmittedCreated By
SubmittedApprove → Approved; Send back → DraftApprovers

On Send back, require a comment, so the requester knows what to change. The comment shows in the Workflow History. The requester changes the item and selects Submit again.

Good to know ​

  • Keep the number of statuses small. Each status should be a real stage someone waits for.
  • Test each path with a test item. Do every action yourself, or use a test account in the audience.
  • An email on a status tells people the item has arrived there. See Workflow Email Notifications.

Related: Workflow Tab (Overview), Workflow Actions, Workflow Statuses.