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, Approved or Rejected.
Activity fields
| Name | Mandatory | Description |
|---|---|---|
| Name | N | Customized activity name. |
| Description | N | Brief activity description. It is displayed on the activity block on the canvas if provided. |
| Table | Y | Select a table to be processed by this activity. |
| Run Conditions | N | Specify conditions that must be met for generating approvals; whenever they are not met, then the activity is skipped. |
| Approval Type | N | Specify the approval type (here you can define conditions of the block exit, i.e. activity completing). Available options:
|
| Non-Mandatory Participants | N | Select this checkbox to authorize the participants whose approvals are not mandatory to vote. When this checkbox is selected, the Non-Mandatory Participants tab appears. |
| Mandatory participants tab | ||
| Employees | N | Select a responsible person or persons from the dictionary. These ones are recipients of the approvals. |
| Groups | N | Specify a group or groups whose members will be the approvers. |
| Roles | N | Specify a role or roles whose owners will be the approvers. |
| Advanced | N | Select this checkbox to specify a script to evaluate. |
| Script | N | If the Advanced checkbox is selected, then this script is called to determine if any additional approvals to be created. The script is intended to set the answer variable to a comma-separated list of user IDs to add as approvers. The code example below implements logic as described below:
Script example const incidentCaller = current.getValue('caller')
const callerGroupsIds = []
const callerIsMemberOfGroups = new SimpleRecord('sys_user_group')
callerIsMemberOfGroups.addQuery('user_id', incidentCaller)
callerIsMemberOfGroups.selectAttributes(['group_id'])
callerIsMemberOfGroups.query()
while (callerIsMemberOfGroups.next()) {
callerGroupsIds.push(callerIsMemberOfGroups.getValue('group_id'))
}
const callerGroups = new SimpleRecord('sys_group')
callerGroups.addQuery('sys_id', 'IN', callerGroupsIds)
callerGroups.selectAttributes(['responsible'])
callerGroups.query()
while (callerGroups.next()) {
if (callerGroups.getValue('responsible')) {
answer.push(callerGroups.getValue('responsible'))
}
}
You can pass values to the answer variable either as a string or as an array, for example: answer = ['100000000000000001', '160017550418345219', '159974538715046822'] answer = '100000000000000001, 160017550418345219, 159974538715046822' |
| When Approved | N | This field is displayed when the Approval Type is chosen to "Automatically". In this field, you can define the approval logic. Available choice options:
|
| Conditions Approved | Y | 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 than one condition, then they will proceed downhill. |
| Conditions Rejected | Y | 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 than one condition, then they will proceed downhill. |
Non-mandatory participants tab. This tab appears when you select the Non-Mandatory Participants checkbox | ||
| Employees | N | Specify the employees who are participants of the approval process but their approval is not mandatory. |
Groups | N | Specify the groups whose members are participants of the approval process but their approval is not mandatory. |
Roles | N | Specify the roles whose owners are participants of the approval process but their approval is not mandatory. |
Advanced | N | Select this checkbox to specify a script to evaluate. |
| Script | N | If the Advanced checkbox is selected, then this script is called to determine if any additional approvals to be created. The script is intended to set the answer variable to a comma-separated list of user IDs to add as approvers. See an example and clarifications above. |
Consider Non-Mandatory Participants | N | When selected, non-mandatory participants are able to vote in approval tickets. |
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, Approved or Rejected. Activity fields Specify conditions that must be met for generating approvals; whenever they are not met, then the activity is skipped. Specify the approval type (here you can define conditions of the block exit, i.e. activity completing). Available options: If the Advanced checkbox is selected, then this script is called to determine if any additional approvals to be created. The script is intended to set the answer variable to a comma-separated list of user IDs to add as approvers. The code example below implements logic as described below: You can pass values to the answer variable either as a string or as an array, for example: answer = ['100000000000000001', '160017550418345219', '159974538715046822'] answer = '100000000000000001, 160017550418345219, 159974538715046822' This field is displayed when the Approval Type is chosen to "Automatically". In this field, you can define the approval logic. Available choice options: 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 than one condition, then they will proceed downhill. 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 than one condition, then they will proceed downhill. Non-mandatory participants tab. This tab appears when you select the Non-Mandatory Participants checkbox Groups Roles Advanced If the Advanced checkbox is selected, then this script is called to determine if any additional approvals to be created. The script is intended to set the answer variable to a comma-separated list of user IDs to add as approvers. See an example and clarifications above. Consider Non-Mandatory Participants When selected, non-mandatory participants are able to vote in approval tickets.Name Mandatory Description Name N Customized activity name. Description N Brief activity description. It is displayed on the activity block on the canvas if provided. Table Y Select a table to be processed by this activity. Run Conditions N Approval Type N Non-Mandatory Participants N Select this checkbox to authorize the participants whose approvals are not mandatory to vote. When this checkbox is selected, the Non-Mandatory Participants tab appears. Mandatory participants tab Employees N Select a responsible person or persons from the dictionary. These ones are recipients of the approvals. Groups N Specify a group or groups whose members will be the approvers. Roles N Specify a role or roles whose owners will be the approvers. Advanced N Select this checkbox to specify a script to evaluate. Script N const incidentCaller = current.getValue('caller')
const callerGroupsIds = []
const callerIsMemberOfGroups = new SimpleRecord('sys_user_group')
callerIsMemberOfGroups.addQuery('user_id', incidentCaller)
callerIsMemberOfGroups.selectAttributes(['group_id'])
callerIsMemberOfGroups.query()
while (callerIsMemberOfGroups.next()) {
callerGroupsIds.push(callerIsMemberOfGroups.getValue('group_id'))
}
const callerGroups = new SimpleRecord('sys_group')
callerGroups.addQuery('sys_id', 'IN', callerGroupsIds)
callerGroups.selectAttributes(['responsible'])
callerGroups.query()
while (callerGroups.next()) {
if (callerGroups.getValue('responsible')) {
answer.push(callerGroups.getValue('responsible'))
}
}
When Approved N Conditions Approved Y Conditions Rejected Y Employees N Specify the employees who are participants of the approval process but their approval is not mandatory. N Specify the groups whose members are participants of the approval process but their approval is not mandatory. N Specify the roles whose owners are participants of the approval process but their approval is not mandatory. N Select this checkbox to specify a script to evaluate. Script N N
