This AgileShape can be used when a group of approvers is involved at an activity step, you can configure the AgileWork to require mandatory approvals from certain participants and to move forward based on a certain percentage of approves that have approved.
NOTE: This AgileShape is a specialized sub-type of the AgileWork AgileShape. Refer to the documentation for the AgileWork AgileShape for additional information about the properties and behavior that this sub-type inherits from the AgileWork AgileShape.
Design-Time Properties
NOTE: Since this AgileShape is a specialized sub-type of the AgileWork AgileShape, all of the standard properties supported by the AgileWork AgileShape are also supported by this AgileShape. Since they are already documented elsewhere, the standard AgileWork properties are not documented in this section. Refer to the documentation for the AgileWork AgileShape for information about the standard AgileWork properties. Additional design-time properties (other than the standard AgileWork properties) that are specific to this AgileShape are documented below.
UserDefinedProperties
NOTE: This property has no effect unless custom code or custom modules are created that use the specified values at runtime.
This property allows the process modeler to configure ClientData initial values that will be associated with the AgileShape’s associated task(s) at runtime. This is basically a way of allowing you to specify a set of name/value pairs that are passed to your Web page via an object called a WorkItem. This is an alternative to passing data via URL parameters. In your Web page you can retrieve this data via the ClientData property of the WorkItem. It is then up to you to decide how to use the data.
Click the Ellipses button to open the configuration dialog.
Voting Configuration
This property allows the process modeler to configure data binding to the data schema within a repeating table for which to establish the approval data.
The “Mandatory” option provides an added level of functionality, requiring any participants that have been identified as “Mandatory” to approve, or the final decision will be not-approved. The final result is also configured here by setting a custom attribute to store the final result and specifying the percentage of participants that will need to approve before the final decision is considered as approved. For example, the process designer specifies the voting percentage as 60%. If 60% of the approvers approve the preceding request, then the final decision is considered as approved.
Click the Ellipses button to open the configuration dialog (as shown below).
Debug
Default value: True
For AgileShapes that support it, this property determines whether the AgileShape will log additional progress and debugging messages to the AgilePoint Server log file at runtime. This property can be set to the following specific values:
- False
This value indicates that the AgileShape will not log additional progress and debugging messages to the AgilePoint Server log file at runtime.
- True
This value indicates that the AgileShape will log additional progress and debugging messages to the AgilePoint Server log file at runtime. These messages are often helpful in verifying that the AgileShape is functioning properly and/or with troubleshooting any problems or suspected problems with the AgileShape’s runtime behavior or configuration.
EnabledExchangeServer
Default value: False
This property allows the process modeler to enable the AgileShape to integrate directly with Microsoft Exchange Server so that the AgileShape’s associated task(s) can be viewed directly from Microsoft Outlook’s Task List by the task(s)’s assigned participant(s). Refer to the ExchangeServer property for additional information.
ExchangeServer
This property allows the process modeler to configure the AgileShape’s integration with Microsoft Exchange Server. When properly enabled and configured, the AgileShape will then insert, update, and remove Task items for the task’s assigned participants, so that the tasks can be viewed directly from Microsoft Outlook.
Click the button to open the configuration dialog (as shown below).
Refer to the EnabledExchangeServer property for additional information.