This activity creates user approval(s) when executed, one or more, depending on the parameters specified.

The result value is the final approval disposition that depends on the actions taken by the approvers and the approval conditions specified in the When approved and When rejected 

The activity can be completed with one of two results:

Input variables 

NameDescription
NameCustomized activity name.
DescriptionBrief activity description. It is displayed on the activity block on the canvas if provided.
TableSelect a table to be processed by this activity.
Run Conditions

Specify conditions that must be met for generating approvals; whenever they are not met, then the activity is skipped.

Approval type

Specify the approval type (). Available options:

  • Automatically;
  • Manual.
UsersSelect user or users from the dictionary; selected users will be the recipients for the approvals.
GroupsSpecify a group or groups whose members will receive these approvals.
AdvancedSelect this checkbox to specify a script to evaluate.
Script

If the Advanced checkbox is selected, then this script is called to determine if any additional approvals to be created.

The script needs to set the variable answer to a comma-separated list of user ids and group ids or an array of user and group ids to add as approvers.

For example:

answer = [];
       answer.push('id1');
       answer.push('id2');


When approved

This field is displayed when the Approval Type is chosen to "automatically".

In this choice field, you can define the approval logic. Available choice options:

  • Anyone to approve - any user can approve; the first received approval causes the activity to complete with the result of Approved;
  • Everyone to approve - all the users must approve; otherwise, the activity will not proceed further;
  • The first response from anyone - when selected this option, the first response from any user will complete the activity;
  • Most answers - when selected this option, the activity will be completed with the Approved result if there were received more approvals than rejects;
  • Conditions based on script - Each time a user approves or rejects, the Script is called to determine if the activity should complete.
When rejected

This field is displayed when the Approval Type is chosen to "automatically".

In this choice field, you can define the rejection logic. Available choice options:

  • Anyone to reject - any user can reject; the first received reject causes the activity to complete with the result of Rejected;
  • Everyone to reject - all the users must reject; otherwise, the activity will not proceed further;
  • The first response from anyone - when selected this option, the first response from any user will complete the activity;
  • Most answers - when selected this option, the activity will be completed with the Rejected result if there were received more rejects than approvals;
  • Conditions based on script - Each time a user approves or rejects, the Script is called to determine if the activity should complete.
Conditions approved

This field is displayed when the Approval Type is chosen to "manual".

Specify the conditions to meet before the activity will complete with the result of Approved. If you have specified more that one condition, then they will proceed downhill.

Conditions rejected

This field is displayed when the Approval Type is chosen to "manual".

Specify the conditions to meet before the activity will complete with the result of Rejected. If you have specified more that one condition, then they will proceed downhill.