Approval - Group workflow activity

The groups whose approval will be requested.To edit this field, click the lock icon. To select specific groups by name, use the lookup list. To select groups from field values on the current record at runtime, click the tree icon.

Each member of the group will be assigned an individual approval record.

If no group is selected, the activity automatically sets the approval to Approved.

A choice between different approval logics to determine which individual approvals or rejections result in approval or rejection of the activity's approval. Options are:

• An approval from each group: Any user from each group can approve and the first approval from each group causes the activity to complete with a result of approved (see below for how a rejection is handled).
• An approval from any group: Any user from any group can approve and the first approval from any group causes the activity to complete with a result of approved.
• An approval from everyone from all groups: All users from all groups must approve to cause the activity to complete with a result of approved (see below for how a rejection is handled).
• First response from each group: The first approval or rejection from any user in each group is used to indicate the state of the group approval (see below for how a rejection is handled).

Indicate what happens when any user rejects their approval request. Options are:

• Reject the approval: Immediately complete the activity with a result of rejected.
• First response from any group: The first approval or rejection from any user in any group causes the activity to complete with a result of approved or rejected.
• Condition based on script: Each time a user approves or rejects, the Approval script is called to determine if the activity should complete.

If the Wait for variable is set to Condition based on script this script is called to determine how to handle an approval or rejection. The script needs to set the variable answer to approved or rejected to indicate the overall status for this approval.

This script is responsible for setting the approval state for each group that is part of this approval activity before returning the overall approval state for all of the groups.

When called, the following variables are available to the script for all the groups that are part of this approval activity:

``` counts.total = total number of groups that are part of this approval counts.approved = # of groups that approved so far counts.rejected = # of groups that rejected so far counts.requested = # of groups that are pending approval counts.not_requested = # of groups that are not pending approval counts.not_required = # of groups that approval is not required

 And for each group:

 Note: Iterate the groups using:

 Note: Get group object using the following code \(to get things like the group name being iterated on\):

                function fncGetGroupObj(sidGroupApproval)
                {
                var objGroupApproval = new GlideRecord('sysapproval_group');
                objGroupApproval.get(sidGroupApproval);

                var objGroup = new GlideRecord('sys_user_group');
                objGroup.get(objGroupApproval.assignment_group.sys_id);

                return objGroup;
                }

Approval scripts also allow computations. For example, if only half of the approvals are required: if (counts.approved/counts.total > .49) { answer = 'approved'; } else if (counts.rejected/counts.total > .50) { answer = 'rejected'; } ```

A choice between different approval logics to determine which individual rejections result in rejection of the activity's approval. Options are:

• Reject the approval: Immediately complete the activity with a result of rejected.
• Wait for other responses before deciding: Wait until we get other responses before making an approval or rejection decision. This allows users to change their mind until a decision is made.

Note: If Wait for is set to Anyone to approve, then a single approval causes the activity to complete with a result of approved, even if one or more users reject.

Time zoneOnly appears when Time zone based on is set to A specific time zone

.

If the Advanced check box is selected, this script is called to determine any additional group approvals to be created. The script needs to set the variable answer to a comma-separated list of group ids or an array of group ids to add as approver groups. For example:

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