Configuring a References on a Form

Overview

Reference element in a standard form indicates that an object is referenced to other objects through a relationship. Administrators can configure how the information is displayed, as well as what tasks end-users can do through the Reference element. You must add a form's object type to a relationship on another object type before adding a reference to a form.  

The data available in the Reference element belongs to the object type(s) where the relationship was initially created. For example, if the Vehicle object type is saved in a relationship with the Incident object type, the data displayed on the form will be from the Incident object type.


User Account Requirements

The user account you use to log into Resolver must have Administrator permission to configure a reference on a Standard Form.


Related Information/Setup

Please refer to the Add Reference to an Object Type for more information on References.

Please refer to the Standard Form Elements section for more information on creating a configurable form.

Please refer to the Add a Relationship to an object type for more information on adding a relationship to an object type.

Please refer to the Archive Data section for more information on Archiving Data.


Navigation

  1. From the Home screen, click the Administration icon.

Administration Icon

  1. From the Admin Overview screen, click the Configurable Forms tile on the Views section.

Object Types Tile

  1. From the Admin: Configurable Forms screen, enter a keyword in the Search field to narrow the forms list.

Search Field

  1. Click on the Name of the form you want to configure.

Select a Form Name

Configure a Reference on a Standard Form

References that are not named will not appear on the relationship & Reference table. For References to appear on the relationship & Reference table, they require a name.

  1. From the Admin: Edit Configurable Forms screen, click the More icon next to the References link in the Form Elements section. You may have to scroll to find the References link.

More Icon

  1. Drag and drop a Reference from the References link onto the Form canvas to add it to the Form.

Drag and Drop a Reference

  1. Hover your cursor over the Reference and click the Edit icon. 

Edit Icon

  1. From the Edit Component Display pop-up, click the Display Long Name radio button to display the relationship's long name on the form. Relationship Long Names are added on the Edit Relationship pop-up when creating a relationship.

Display Long Name Radio Button

  1. Select formatting options from the Format section:
  • Enable Search: End-users can search for existing reference objects.
  • Include Archived Data in Search Results: End-users can search for or view archived objects through the form element. This option will only be visible if the Enable Search option is enabled.  See the Archived Data section for more information. 
  • Enable Create: End-users can create new objects through the reference.
  • Enable Unlink: End-users can remove objects from the reference on the form and unlink them from the reference object.
  • Enable Advanced: Displays the advanced user interface for the form reference. When this option is enabled, clicking Add Existing [Object] will open a palette that allows users to search for and select one or more objects or assessment objects (if any) to add to the reference.

Format Section

  1. Select a View Relationship as option:
  • Dropdown: The Dropdown option display the relationship as a dropdown menu. This option is selected by default.
  • Table: The Table option displays the relationship as a table.
    • Build the Relationship Table: The Build the Relationship Table section will appear when selecting the Table option. Click data points (properties and fields) from the list to include on the table as columns (e.g., if the Vehicle object type is referenced in a relationship on the Incident object type, you can display properties and fields from Incident in the table). Columns will appear on the table in the order they are selected.

Note:
Reference tables with more than 10,000 rows of data will not load correctly. For larger data sets, it's recommended that a Form Action element is added to a form to redirect users to view the data in a report
.

Build the Relationship Table Section

  • Display: The Display section will appear when selecting the Table option.
    • Display colored cells: Displays formula and select list cells as text with a background color.
    • Display colored ovals: Displays formula or select list cells as text with colored circles instead of a background color.
    • Display no color: Displays formula and select list cells as text with no background color.

Display Options

  • Map: The Map option displays the relationship as a map. This option will display a map with pins representing any recorded locations of the relationship object or reference objects. If location data is not enabled or recorded, the map will not display any data. For more information on locations, refer to the Locations section.

Note:
Selecting the Map option disables the Enable Create and Enable Advanced format options.

  1. The Object Type Forms section will appear when selecting either the Dropdown or Table options under the View Relationship as section. Select the form the users will complete if they create a new object through the reference from the dropdown list.

Object Type Forms Dropdown

Note:
If no configurable form(s) have been created for the relationship's object type(s), the default form will be selected automatically.

  1. Click the Close button when finished.