Updated on 2025-08-21 GMT+08:00

Setting the Properties of the Associated Record Widget

This widget links forms in an application and shows them in single or multi-answer mode.

When you export or clone an application, the form links break. You need to set them up again afterward.

Figure 1 Associated record widget

Name

Set the field name shown to users. Click to set Chinese and English names. Click Reference Field to copy another field's value to this field name.

Figure 2 Setting the field name (Chinese and English)
Figure 3 Field reference

Associated Object

Choose a view page. After setting it up, the view permission is assigned to all enterprise member roles. You can set the viewing scope and rules as required.

Set the view page to the form view of the current application or a form view of another application. After the setting, the enterprise member role is granted the view visibility and data operation permissions by default, as shown in Figure 4. Widgets linked to other applications cannot be cloned. After cloning, set up the links again.

Figure 4 Granting view permissions

After setting the associated object, click the add button to filter the records that meet the filter criteria as candidate values.

Figure 5 Setting the filter criteria

Available Records

Set the number of records to select from the associated object as either Single or Multiple.

Display

Set the display mode of the option values for the associated record widget as either Drop-down list or Option list.

Figure 6 Drop-down list
Figure 7 Option list

Verification

Limit the field's length and format to keep data accurate and valid.

  • Mandatory: If checked, the field is required and shows a * next to it.
  • Quantity limit: If Available Records is set to Multiple, you can set a minimum and maximum quantity. For example, if order A is associated with product B and the quantity limit is set to 1 to 10, a user must select 1 to 10 products when creating an order.
    Figure 8 Limiting the number of selected items

Conditions

Set field properties like Read-only, Disable, and Hide.
  • Read-only: If checked, the field is read-only.
  • Disable: If checked, the field shows but cannot be edited.
  • Hide: If checked, the field is hidden on the page.

Width

Width: Widget width as a ratio of the page width. Set the widget width to make the page look better and more professional.

Figure 9 Setting the widget width
  • 1/4: Widget is 1/4 of the page width.
  • 1/3: Widget is 1/3 of the page width.
  • 1/2: Widget is 1/2 of the page width.
  • 2/3: Widget is 2/3 of the page width.
  • 3/4: Widget is 3/4 of the page width.
  • 1: Widget is full page width (default).

Default Value

Set a default value for the widget. This reduces user input, speeds up processes, and ensures data integrity and consistency.

Figure 10 Default value

Guide Prompt

If a user does not set this parameter, the text displayed on the GUI guides the user to perform correct operations.

Figure 11 Setting the guide prompt

Pop-up Message

If a field is unclear, add a Pop-up Message to explain it. This helps users and makes things easier.

After setting, a question mark icon appears next to the field. When filling in the form, click the question mark icon to see the message.

Figure 12 Effect

Description

Set the widget description. Include its functions, use cases, and tips. This helps users understand it better and makes the form clearer.

Figure 13 Effect