Workflows

Workflow transitions are the movement of records from one state to another. Transitions are configured in the workflow definition in the Workflow Builder. 

Approvals are only required on workflow transitions of type Approval Transition. When the from state on a record is transitioned to the specified to state, the approval process is initiated. Learn more in Workflow transition triggers.

Approval options

Once a record has been submitted for approval, the system generates and sends a notification or email to each of the designated approvers for the record. The route of delivery is configured in the Approval & Notification Definitions application. The approvers can then view the approval request through the Approval Requests application, or access the record directly. Messages can also be optionally configured to notify the appropriate recipients once the approval request has been accepted or rejected. Learn more in Configure messages for workflow transitions, approvals, or rejections. 

Authorized approvers and configuration options, such as length of time a request is active or number of required approvers, are configured in the Approval & Notification Definitions application. The person or people who can approve the workflow transition can be specified by:

  • Name—For example, an Inventory Manager has to approve adjustments to ensure the transaction is accurate before a transaction can transition to a workflow state of Processed. The name of the Inventory Manager would be specified as the approver. 
  • Role—For example, someone on the accounting team must approve before an expense report can transition to a workflow state of Posted. The Accountant role would be specified as the approver, so anyone with that role could approve the transition. 
  • Decisions/Logic Blocks—For example, a buyer who is new to the organization may only be able to transition a purchase order to a workflow status of Purchased if the goods and/or services are under $10,000. If they have a purchase order that exceeds their maximum allowed order cost, they would need an approver to approve the transition. You could use a logic block or decision definition to dictate which person receives the approval request depending on how large the order is, such as:
    • Greater than $100,000 - Manager of Procurement
    • Greater than $500,000 - Director of Supply Chain Operations
    • Greater than $1,000,000 - CFO
    • Greater than $5,000,000 - CFO & CEO both

Approval applications

There are several applications used for approval configuration:

  • Workflow Builder—Configure your workflow definition. The definition must include transition triggers of type Approval Transition, an Action of type Approval Required, and the approval definition referenced in the Action Details field. 
  • Approval & Notification Definitions application—Configure your approval definition. Define the recipients, notification method, and other configuration options, and reference the workflow definition. 
  • Approval Cycles application—Review information about approval definitions such as the name of the table which holds the business record that the associated approval is for, the status of the approval, and whether the record is to be automatically approved.
  • Approval Request application—View the status of an individual request, the name of the user who requested the approval, and the assigned approvers.
  • Message Event Definitions, Message Template Definitions, and Message Definitions applications—Configure the system to automatically send messages to internal or external recipients when an approval is approved or rejected. Reference the message event definition in the approval definition. 

 Learn more in Configure workflow approvals.

Configure workflow approvals

Application developers use the Approval & Notification Definitions and Workflow Builder applications to configure workflow approvals which allow authorized users to accept or reject a request to transition a record from one workflow state to another. 

After you've created a basic workflow in the Workflow Builder application, you can create an approval definition for your workflow approval. 

You can also configure notifications or emails that are sent out when certain workflow transitions occur. See the Configure messages for workflow transitions, approvals, or rejections topic for more information. 

Create an approval definition

Use the Approval & Notification Definitions application to specify who can approve a record transition through a workflow process. Approvers can be defined individually, by their role, by a logic block, or by a Decision record that dynamically determines the list of approvers. For more information see the topic.  

Create a transition with an approval 

A workflow that contains an approval-based process must have the following transitions: 

  • A transition to initiate the approval request
  • A transition to move the process forward because the transition was approved 
  • A transition to move the process forward because the transition was rejected

In the Workflow Builder application, open the workflow you want to configure approvals in. 

For the transition that initiates the approval request, configure the following fields:

FieldsValues
Action TypeApproval Required
Action Definition NameThe approval definition you want to initiate when this transition occurs.
To State TypePending

For the transitions that approve and reject the request, configure the following fields:

FieldsValues
From StateThe To State value from the transition that sends the approval request.
From State TypeThe To State Type value from the transition with the approval request.
Transition TriggerApproval

If the transition is for an approved record transition, configure the following fields:

FieldsValues
To State and To State TypeThe state and state type that the record should transition to when it has been approved.
Workflow ConditionApproval Approved

If the transition is for a rejected record transition, configure the following fields:

FieldsValues
To State and To State TypeThe state and state type that the record should transition to when it has been rejected.
Workflow ConditionApproval Rejected

Additionally an approval request can be withdrawn, but only the person who initiated the approval request is authorized to withdraw it. 

If the transition is to withdraw an approval request, configure the following fields:

FieldsValues
To State and To State TypeThe state and state type that the record should transition to when it has been recalled.
Workflow ConditionApproval Withdrawn

Notifications

To configure notifications when transitions, approvals, or rejections occur, see the Configure messages for workflow transitions, approvals, or rejections topic. 

Approval backup configuration

System administrators use the Backup Approvers Setup application to create a list of backup approvers for an approval request. The list is then attached to the approval record in the Approval & Notification Definitions application.

Prerequisites

Ensure the approvers are included in the Directory table and configured with the directory user link in the Directory User Tenant Setup application.

Backup Approvers Setup

In the Backup Approvers Setup application:

  • Create a new record and give it a unique identifying name. For example, you can give it a name, such as Expense Report Approvers, that would describe the purpose of backup approvers list.
  • In the Approval Backups subtable, enter the users you want as backup approvers.

For more information see Backup Approvers Configuration application.

Approval & Notification Definitions

In the Approval & Notification Definitions application:

  • Open the approval definition you want to add backup approvers to.
  • In the Approvers section, enter the name of the backup approvers list you created in the Backup Approvers Setup application. 
  • After you enter the backup approver list, the user assigned the approval request for the record can have the users on the list approve on their behalf. You can you reuse this backup approver list for other users as needed.

Approval Requests application

Use the Approval Requests application to view, approve, or reject the list of approval requests assigned to you. You can also view or withdraw any requests which you have initiated.

Use the View Transaction Record row action to review a record assigned to you for approval. If you make a change to a record before you approve it, you must save your changes before you can approve the record.

Use the Approve or Reject field to approve or reject a request if you are an assigned approver. 

If you have more than one approval request assigned to you, select the Multi-Row Approval row action on one of the records. Multi-Row Approval shows the total number of requests assigned to you and allows you to approve them all at once.

A withdrawal can only be done by the requestor, but only if the record has not yet been approved. If you do withdraw a request, you must give a reason.