Show a Human Task on a Mobile Device

This topic provides an example of how to show a human task on a mobile device. This example assumes you are using the AgilePoint mobile apps, but the same would work for any form created in the AgilePoint portal, or any mobile app that uses the AgilePoint REST API.

Example Process: Budget Request

Example Mobile View: CFO Approval

The following image shows the result of this example for the CFO Approval task. The CFO can use this form to approve or reject a budget request.

Prerequisites

• A process model with the following process data variables:
  • SubmitterName - The first and last name of the participant who submitted the budget request.
  • SubmissionDate - The date the participant submitted the budget request.
  • BudgetAmount - The total amount of budget request, adding the per-employee budgets.
  • ManagerResponse - The approver's response to the request.
  • Comment - The approver's comments.
  • Employee - This is a repeating node that represents the budget for each employee. This node includes the following child nodes:
    • Hardware - The amount requested for hardware.
    • Software - The amount requested for software.
    • Telephone - The amount requested for telephone expenses.
    • Subtotal - The subtotal per employee.

Good to Know

• In most text fields, you can use process data variables as an alternative to literal data values.

How to Start

1. Open your Budget Request process model.
2. Select the CFO Approval AgileWork.
3. To view the full list of properties, in the Design Tasks pane, click Show Properties.
4. On the Mobile View field, click the Ellipses button.

Procedure

1. On the Form Data tab, complete these fields:

   Field Name	Value
   Heading to display non-repeating data fields	Budget Request Summary

2. To enter the fields to show on the mobile device, do the following:
   1. Click Add.
   2. In the Display Name field, enter the label you want to display on the mobile device.
   3. In the Value field, enter the value to be displayed. This is usually a variable.

      Repeat this procedure for each of this following fields.

      Display Name	Value
      Submitter Name	SubmitterName
      Submission Date	SubmissionDate
      Budget Amount	BudgetAmount

3. Click the Repeating Data tab.
4. On the Repeating Data tab, complete these fields:

   Field Name	Value
   Heading to display non-repeating data fields	Employee Details

5. Click Schema.
6. On the Select XPath from Attributes Window, select Employee.
7. In the Display Name field, make sure the fields you want to display are selected.

   The following table shows the sample value for the following fields. In this example, the display name and variable name are the same, but in other cases, they could be different, depending upon your variable names.

   Display Name	Value
   Software	Software
   Hardware	Hardware
   Telephone	Telephone
   Subtotal	Subtotal

8. Click the Task Options tab.
9. On the Task Options tab, complete these fields:

   Field Name	Value
   Heading to display form submission options	Request Approval
   Select which action type fits best to complete the task	Approve/Reject
   If _ is _, that means _	If ManagerResponse is Approve, that means True. If ManagerResponse is Reject, that means False.
   Display comments field for submitter	Selected
   Store comments in this process attribute	Comment