How to create a Group List Applet in Mobile Agent app?


Description

Here is an example on how to create a Grouped List applet. Tapping on a Priority field displays a list of incidents in the respective priority, which in turn can be tapped to display the incident record.

Release or Environment

Orlando Releases.

Instructions

STEP 1: Create a DI with a Group By field associated to it.

a) Open Studio and in the Application Explorer, click the pop-out icon (Pop out icon) next to Data Items to open the data items list.

b) Click the New button to create a new data item.

c) Give your data item a name, select Incident as the table, and click Save.

d) Select 'Priority' in the Group by field, and click Save again.


STEP 2: Create a Group List applet and associate the above DI

a) Click on the pop-out icon (Pop out icon) next to Applet and open the Applet List. 

b) Click the 'Create an Applet' button.

c) Select the 'Grouped List' screen template and Click the Create New button.

e) Enter a name to the Applet. (Example - Group List Applet)

d) In the Data Item field, select the data item you created for the grouped list.


STEP 3: Create a List applet.

a) Click on the pop-out icon (Pop out icon) next to Applet and open the Applet List. 

b) Click the 'Create an Applet' button.

c) Select the 'List' screen template and Click the Create New button.

d) Enter a name to the Applet. (Example - List Applet)

e) Click the + icon next to the Data Item field to create a new data item.

f) Enter the Name of the data item, select Incident as the table, and click Save.

g) In the Parameters section, click the plus icon (Add Parameter icon) to create a new parameter.

h) Enter 'Priority' in the Name field, and click Save.

i) In the Query condition field select <Priority><is>, and then click the reference value icon (Reference value icon) to select the Category Group Param parameter created in the previous steps.

j) Return to the 'List Applet' and use this new data item in the Data Item field.

k) Fill in all the other Field Configuration in List and Form screen.

l) Create a UI Parameter for Priority field. 

Input Type - Choice List

Table Name - Incident

Field Name - Priority

m) Create a mapping between UI Parameter and Input Parameter.


STEP 4: Create a Navigation Function from the Group List applet to the List applet.

a) Click on the pop-out icon (Pop out icon) next to Navigation and open the Navigation List. 

b) In the Name field, enter the Name.

c) In the Destination Screen field, select 'List Applet'.

d) In the Table field, select Incident.

e) Click Submit on the Navigation function form.

f) In the Parameter setting, click on the record and select the Redirection parameter.

Type - Field

Source field - Priority

g) Click on Save.


STEP 5: Now, add the above navigation function to the Group List applet.

a) Go to the first applet which we created i.e the Group List applet.

b) Go to the Functions Tab. 

c) Click on the (Add Parameter icon) icon and select the Navigation Function which was created in STEP 4.

d) Save the form.

Additional Information

How to Configure a Data Item:

https://docs.servicenow.com/csh?topicname=sg-config-parametrized-data-item.html&version=latest

How to configure a List Applet:

https://docs.servicenow.com/csh?topicname=sg-configure-list-screen.html&version=latest