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.

Mobile View > Form Data Tab

Mobile View > Repeating Data Tab

Mobile View > Task Options Tab

Good to Know

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

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.

How to Start

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

Procedure

On the Form Data tab, complete these fields:

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

To enter the fields to show on the mobile device, do the following:

Click Add.
In the Display Name field, enter the label you want to display on the mobile device.

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

Click the Repeating Data tab.

On the Repeating Data tab, complete these fields:

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

Click Schema.
On the Select XPath from Attributes Window, select Employee.

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

Click the Task Options tab.

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