Enabling Sequential Approvals by Multiple Participants

This example demonstrates how to create a task with multiple approvals in an ordered sequence using the Dynamic Sequential Approval AgileShape. This example uses process attributes to loop through a specified list of approvers in sequential order. At runtime, the process does not move forward until all the identified reviewers have approved the activity in the prescribed order.

Instructional Goals

  • Demonstrate how to set up sequential approvals for an activity.

Example Process: Create or Update a Human Resources Policy

Problem Statement

Create or update a human resources (HR) policy within an organization.

Business Requirements

  • The process is initiated when an HR employee submits an update to the company HR policies.
  • The policy must be approved by multiple reviewers in sequential order.

Navigation

  1. In AgilePoint Envision, open a process template.
  2. Navigate to the Premier Extension stencil.
  3. On the Premier Extension stencil, drag the Dynamic Sequential Approval AgileShape, and drop it on the process template.
  4. To view the entire list of properties, in the Design Tasks pane, click Show Properties.

Instructions

  1. On the Dynamic Sequential Approval AgileShape, complete the following fields.
    Field Name Value

    Approvers

    $HRApprovers

    LoopCondition

    $MoreHRApprovers

    Work to Perform

    Your ASP.NET or InfoPath form

  2. On the Premier Extension stencil, drag the Update Custom Attributes AgileShape, and drop it on the process template.
  3. On the Configuration field, click the Ellipses button.
  4. On the Create or Update Custom Attribute window, click Add.
  5. In the AttributeName column, enter HRApprovers.

    You can also click the Schema button to select the HRApprovers attribute from your InfoPath or ASP.NET XML schema.

  6. In the Expression column, enter a C# expression that indicates the list of approvers for your Dynamic Sequential Approval task.
    Field Name Value

    Expression

    Definition:
    Specifies a value that is assigned to the custom attribute at runtime by a code snippet.
    Allowed Values:
    A C# code snippet. The following rules apply:
    • You can specify simple expressions only. For example, assignment, call, increment, decrement, and new object expressions.
    • The string value must be enclosed within the quotation marks. For example, "Name".
    • You cannot leave the Expression field empty.
    Default Value:
    None
    Custom Attributes:
    Yes
    Example:
    • "True"
    • @"AP5\John; AP5\Bob; AP5\Lily; AP5\Fred";
  7. On the Create or Update Custom Attribute window, click Add.
  8. In the AttributeName column, enter MoreHRApprovers.
  9. In the Expression column, enter "True".