Skip to main content

Field Value Relationship Analysis

Introduction

In complex forms, a field's value may be affected by formulas, data linkage, front-end events, and other configurations. When fields reference one another across multiple levels, checking each configuration individually can be time-consuming.

The Field Value Relationship Diagram visualizes value assignment relationships between fields based on the current form design. Admins can trace the value sources of a field and identify other fields directly affected by it, helping troubleshoot incorrect values and maintain form configurations.


Use Cases

  • Troubleshooting Incorrect Field Values: Identify the fields and rules involved in value assignment to narrow down the cause.

  • Adjusting Field Configurations: Review dependencies before modifying formulas or data linkage conditions to avoid overlooking related fields.

  • Assessing the Impact of Changes: Identify fields directly affected before modifying or deleting a field.

  • Taking Over Existing Forms: Use the diagram to understand complex value assignment logic and existing form configurations.


What Does It Look Like?

Take the Overall Discount Rate field in a Quotation form as an example. The left side of the diagram shows upstream relationships, while the right side shows downstream relationships.

Click a connecting line to view the corresponding value assignment rule and adjust it as needed, as shown below:


Prerequisites

The creator, system admin, or app admin needs to enable Field Value Relationship Analysis in App Management > Labs before using this feature, as shown below:


How to Use It

Step 1 Finding the entry

This feature supports all field types except Subform (subfields within a Subform are supported), Related Subform, Divider, Query Data, and Multi-Tab.

Go to the form design page, select the target field, and click the Field Value Relationship Diagram icon in the upper-right corner of the field to open the diagram.

Step 2 Viewing the Relationship Diagram

The diagram is centered on the selected field and displays value assignment relationships from left to right:

  • Left: Upstream fields that affect the value of the current field.

  • Center: The currently selected field.

  • Right: Downstream fields directly affected by the current field.

  • Connecting Lines: Value assignment relationships between fields, labeled with their relationship types, such as Formula and Data Linkage.

1) Upstream Relationships

The left side shows the value sources of the current field. If an upstream field is also affected by other fields, the diagram continues tracing its upstream relationships to the left.

For example, Overall Discount Rate is affected by Discount Amount and Subtotal. Subtotal is further affected by Unit Price and Quantity, as shown below:

2) Downstream Relationships

The right side shows the fields directly affected by the current field. Only one level of downstream relationships is displayed, without further expansion to the right.

For example, Overall Discount Rate affects the values of Discounted Unit Price and Discounted Total, as shown below:

3) Relationship Details

The labels on connecting lines indicate the relationship types between fields, mainly including:

  • Front-End Event

  • Formula

  • Data Linkage

  • OCR (Text Recognition)

  • Calculation Field

  • Select Data – Field Filling

  • Lookup – Field Filling

  • AI Field Shortcuts: Summarization, Translation, Information Extraction, Auto Generation, and Smart Selection

Click a connecting line to view the corresponding value assignment rule details on the right, such as formula content, data linkage conditions, or field filling rules.

To adjust the rules, click Go to Modify in the relationship details to navigate to the corresponding field or front-end event configuration.

4) Keyboard Shortcuts

You can use keyboard shortcuts when viewing the relationship diagram. The available shortcuts are shown below:


Notes

  1. When the same field appears in multiple relationship branches, it is displayed separately in each branch, with a folded-corner indicator in the upper-right corner of the node.

  2. The diagram shows the configuration relationships within the form, rather than actual execution records or field values from a specific form submission.

  3. Only one level of downstream relationships is displayed. To explore the impact of a downstream field further, locate that field in the form and view its relationship diagram.

  4. Only enabled Front-End Events are included in the relationship diagram.

Did this answer your question?