Configuring a "Related Records" Field

Article Number:040552

To display a list of related records, place a "Related records" field in an app and specify the following:

  • An app to be referenced (You can specify either a different app or the same app.)
  • Fields to be used as a fetch criteria (When the values of the specified fields match, the source app's records with a matching value are displayed in the list of related records.)
  • Fields to be displayed in the list of related records

This article provides an example of how to retrieve information from the "Lead Management" app and display the information in the list of related records in the "Customer Management" app. In this example, you will associate "Company Name" fields included in the two apps and display lead data (e.g. "Lead Title" and "Estimated Purchase Date") for the company with a matching name in the list of related records. Image

  1. Open the "Customer Management" app (the app on which you wish to display related records).

  2. Click the App Settings icon (the gear-shaped icon) at the upper right of the "View" screen.
    Screenshot: The "App Settings" icon is highlighted

  3. On the "App Settings" screen, click Form tab.

  4. Place a "Related records" field on the form.

  5. Hover your cursor over the Field Settings icon (the gear-shaped icon) at the upper right of the "Related records" field that you placed, then click Settings.

  6. Enter the field name.
    In this example, enter "Leads" as the field name. Image

  7. For Datasource App, select an app to be referenced.
    In this example, select the "Lead Management" app. Image

  8. For Fetch Criteria, select a field in the current app and the corresponding field in the source app. When you enter a keyword, relevant fields appear as options.
    Since you want to display lead information for a customer whose name appears in both apps, set the criteria as follows: "Company Name" (in the current app) = "Company Name" (in the source app). Image For information on the types of fields that can be specified, refer to the following page.
    Field that Can Be Specified for the "Fetch Criteria" Setting in Related Records
    Records with a matching "Company Name" field value are displayed in the list of related records.

  9. If you want to add more conditions, specify them in Filter.
    In this example, leave All records selected.

  10. In Datasource App Fields to Display, select the fields you want to display in the list of related records.
    In this example, select "Lead Title," "Probability," "Estimated Purchase Date," "Total Price," and "Sales Representative." Image
    Some fields cannot be selected under Datasource App Fields to Display. For details, refer to the following section.
    Fields that cannot be displayed in lists of related records

  11. Select a sort order in Display Order, and then select the number of records you want to display at a time in Max Records to Display at a Time.

  12. Specify Field Code as needed.

  13. Click Save.

  14. Click Save Form on the upper left side of the screen.

  15. Click Update App at the upper right of the screen.

  16. On the confirmation dialog, click Update App.

The following field types cannot be set under Datasource App Fields to Display in the settings of "Related records" fields.

  • Related records
  • Table
  • Field group
  • Label
  • Blank space
  • Border