List Page Type

Last updated 02/12/2021

Five's Lists

Five has three types of lists. When you add a field to a form you can either include a field in the list or not.

Lookup List

A lookup list is located in a field. The first field included in the list of the referenced form will be available in the lookup list.

Figure 1 - Lookup list

The Record List

A record list is located in each view when you select a menu item referencing a form. The first two fields included in the list will become the column headers for the list.

Figure 2 - Record list

A List Page Type

A List page type is located on a form. All fields selected to be included in the list will be available in this list.

Figure 3 - List page type

Default

• true for the first field.
• false for all other fields.

Add a List Page

A list of records will be the first element displayed when a user clicks the tab to navigate to a list page. This list will hold all the records for the referenced form, and the Add button to add new records.

What Will be Included in the List

All the fields that you flag 'Include In List' on the referenced form will be the titles of the columns and the values will be represented beneath. For lists that have a lot of fields included, a horizontal scroll bar will be positioned at the base of the list to scroll through the fields.

Example

In the Production application, we will add a Cars list page to the Motor Dealer form so we can assign cars to a motor dealer.

Prerequisite

The form being referenced must be saved in Five.

Steps

1. Select the required form record you are attaching the list page to. For this example, the Motor Dealers form.
2. Click the Pages tab.

Figure 1 - Select the required form record

3. Click the Add Pages button.

Figure 2 - Add Pages button

4. Type a caption in the Caption field. For this example, Cars.
5. Use the lookup icon in the Page Type field and select List.
6. Use the lookup icon in the Action field and select the form Action ID to reference. For this example, the Cars (Form).
7. Click the Save button in the form app bar.

Figure 3 - Add the list page

8. Click the Save button in the form app bar above the list.

Figure 4 - Save the form

How to Include Fields in the List

1. Click the Fields tab.
2. Select or create a field record.
3. Click the Include in List switch to a true state.

Figure 5 - Include In List switch

tip

When using the Form Wizard, check the List checkbox for the field to be included in the list.

info

The first field you save for a form will be included in the list by default. You can unselect this field, however, at least one field will need to be included in the list.

How This Will Look in Your End-User Application

1. Select the menu item refencing the form that holds the list page.
2. Select a record in the list, or
3. Click the Add Item button in the list app bar.
4. Click the tab to be navigated to the list page. For this example, the Cars tab.

Figure 6 - Include In List switch

5. Click the Add button in the list to have a new form available.

Figure 7 - List page