(Example) Configure the User List Form Control

This example shows how to configure the User List form control.

Background and Setup

Result

This example shows how to configure the User List form control that is configured in the Travel Reimbursement form to show the list of names in the Reporting Manager field.


Travel Reimbursement form

Prerequisites

Good to Know

  • Travel Reimbursement is an app that requests reimbursement for your official travel expenses. This app provides a Travel Reimbursement form to enter the details of the travel.

    For the use case in this example, configure the User List form control in the Travel Reimbursement form to list the names, so the user can select the Reporting Manager name from the list to get approval.

Step 1: Configure the User List Form Control

First, configure the User List form control in the Travel Reimbursement form.

Prerequisites

How to Start

  1. Click App Builder.

    Click App Builder
  2. On the App Builder Home screen, click All Apps.

    Click All Apps
  3. On the All Apps screen, on the Travel Reimbursement app, click Edit Edit icon.

    Click Edit
  4. On the App Details screen, hover over the Travel Reimbursement Form, and click Edit Edit icon.

    Click Edit

Procedure

  1. On the Travel Reimbursement form, put your cursor over the Reporting Manager form control, and the form control toolbar shows.

    User List form control
  2. Click Edit Properties Edit Properties icon.

    Edit User List form control
  3. On the Field Setting - User List screen, in the Label field, enter Reporting Manager.

    Reporting Manager

    When you click the Internal Name field, this field complete by default based on the value you enter in the Label field.


    ReportingManager
  4. Click the Configure tab.

    Configure tab
  5. On the Configure tab, in the Select People Source field, select Registered Users.

    Registered Users
  6. In the Map Properties for Name and Value - Name field, select Full Name.

    This field is to specify the label for the user information. The value you select in this field shows in the form control.


    Full Name
  7. In the Map Properties for Name and Value - Value field, select UserName.

    This field is to give the value for the user information. The value you select in this field does not show in the form control.


    UserName
  8. Click Close.

    The Travel Reimbursement Form shows.


    Reporting Manager

Step 2: (Optional) Check Your Configured Form Control

Next, check the User List form control in the Travel Reimbursement Form.

Procedure

  1. Click Preview Perspective View icon > PC Browser PC Browser icon.

    PC Browser

    The Travel Reimbursement form opens in a new tab of your browser.


    Travel Reimbursement form
  2. In the Travel Reimbursement form, click the Reporting Manager field.

    This field shows the list of users to select.


    Travel Reimbursement form

Step 4: (Optional) Run the App

Next, run the app.

For more information, refer to My Apps screen

How to Get the App

This example is based on the Travel Reimbursement app from the AgilePoint NX App Store. Use this procedure to get the app..

Good to Know

  • This procedure is optional. It is provided so you can test the example with an out-of-the-box app.
  • This is part of the Background and Setup procedures, but many users preferred this step to appear after the example, not before it.

Get the App

  1. Click App Store.

    App Store
  2. Click Filter

    App Store screen
  3. In the CATEGORY section, click Finance.

    App Store screen
  4. Click the Travel Reimbursement app.

    Finance Apps screen
  5. On the Travel Reimbursement screen, click Add.

    Travel Reimbursement screen
  6. On the Trust App screen, click Trust it.
  7. Click Return to site.