字段取值关系图

1. 简介

1.1 功能简介

在复杂表单中，一个字段的值可能受到公式、数据联动、前端事件等多种配置的影响。字段之间层层引用时，逐一查找配置较为繁琐。

字段取值关系图可基于当前表单设计，将字段之间的赋值关系呈现在同一张图中。管理员可以从目标字段出发，追溯其取值来源，也可以查看该字段直接影响的其他字段，从而辅助排查取值异常和维护表单配置。

1.2 使用场景

1.3 预期效果

以报价单中的「整单折扣率」字段为例，关系图左侧展示上游关系，右侧展示下游关系。点击连接线，即可查看具体的赋值规则，并按需调整。效果如下：

2. 使用前提

创建者、系统管理员或应用管理员，需提前在应用后台「实验室」中开启「字段取值关系分析」功能。如下所示：

3. 设置步骤

3.1 使用入口

支持除子表单整体（子表单中的子字段可用）、关联子表、分割线、查询和多标签页以外的字段使用该功能。

进入表单设计页面，选中目标字段，点击字段右上角的「字段取值关系图」图标，即可进入取值关系图。

3.2 查看关系图

取值关系图中会以当前字段为中心，从左到右展示字段取值关系：

3.2.1 上游关系

当前字段左侧展示其取值来源。如果上游字段也受其他字段影响，关系图会继续向左追溯。

例如整单折扣率受优惠金额和销售原价总额影响，销售原价总额受产品需求明细.产品原价总计影响，如下所示：

3.2.2 下游关系

当前字段右侧展示其直接影响的字段。下游关系仅展示一级，不继续向右展开。

例如，整单折扣率的值将影响产品需求明细.实际售价(含税)和产品需求明细.实际售价(不含税)的值，如下所示：

3.2.3 关系详情

连接线上通过标签标注字段间的关系类型，主要包括：

点击连接线，即可在右侧查看对应的赋值规则详情，例如公式内容、数据联动条件或填充规则等。如需调整字段取值规则，可以在关系详情中点击「前往修改」，跳转至对应字段或前端事件配置处进行修改。

3.2.4 快捷键介绍

查看关系图时支持使用快捷键操作。可用快捷键如下图所示：

4. 注意事项

1）当同一字段出现在多条关系分支中时，关系图会在不同分支中分别展示该字段，并通过节点右上角的折角标识。重复展示不一定表示字段关系成环。

2）关系图展示的是表单中的配置关系，而非某次填写时的实际执行记录或取值结果。

3）下游关系仅展示一级。如需继续查看某个下游字段的影响范围，可以在表单中找到该字段，再查看其关系图。

4）仅状态为启用的前端事件会参与关系图展示。