Skip to main content

Field Visibility Relationship Analysis

Introduction

The Field Visibility Relationship Diagram visualizes the upstream and downstream visibility relationships of a field. It also allows you to view, edit, and manage field display rules directly, helping form designers understand and maintain these rules.

  • Upstream Relationships: Which fields and conditions control the visibility of the current field.

  • Downstream Relationships: Which fields are affected by the current field's visibility conditions.


Use Cases

  • Troubleshooting Hidden Fields: Identify the conditions controlling a field's visibility and trace upstream relationships to locate the cause.

  • Adding or Adjusting Display Rules: Review existing visibility relationships before configuring rules to avoid overlooking existing conditions.

  • Modifying or Deleting Fields: Identify which fields are directly affected by a field to assess the impact of changes.

  • Maintaining Forms Collaboratively: Quickly understand display rules configured by other form designers without checking each rule individually.


What Does It Look Like?

Take the Review Result field in a Sales Quotation form as an example. The left side of the diagram shows upstream relationships, while the right side shows downstream relationships. Select a field in the diagram to view its display rule details and adjust the rules as needed, as shown below:


Prerequisites

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


How to Use It

Step 1 Finding the entry

Go to the form design page. If the form already has field display rules, go to Form Properties > Field Display Rules on the right and click Field Visibility Relationship Diagram, as shown below:

Step 2 Selecting a Field

  1. Search for or select the field you want to view in the field selector to display its visibility relationship diagram.

  2. While viewing the diagram, you can switch to another field in the upper-left corner.

Step 3 Viewing the Relationship Diagram

The diagram is centered on the selected field and consists of three areas:

  • Left: Upstream relationships, showing the condition fields that control the visibility of the current field.

  • Center: The currently selected field.

  • Right: Downstream relationships, showing fields whose visibility is directly affected by the current field.

1) Upstream Relationships

The fields that control the visibility of the current field are displayed on the left. If an upstream field is also controlled by other fields, you can continue tracing its upstream relationships to the left.

  • When a rule contains multiple conditions, AND or OR indicates the logical relationship between them.

  • When a field is controlled by multiple rules, the diagram displays multiple rule branches and their merging labels.

2) Downstream Relationships

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

3) Relationship Details

Click a field in the diagram to view its upstream or downstream rules in the details panel on the right.

To adjust the field display rules, you can edit, copy, or delete rules using the actions on the rule cards.

Did this answer your question?