查阅项字段使您能够在数据列表之间或数据列表与审批表单之间创建关联关系。 使用此关联,您将能够从同一应用中的另一个数据列表或不同应用中的数据列表中查找数据。 这种数据映射是使用数据ID 完成的。 您添加到数据列表中的每条数据都会生成一个ID作为后端参考以完成数据同步。 当您填写表单时,查阅项字段将显示已添加到相关数据列表中的数据。 当您在查阅项字段中选择一条数据并提交当前表单时,数据列表间的映射或审批表单与所选数据列表的映射就被创建起来了。 这种数据映射是使用数据 ID 完成的。
假设您有 2 个数据列表:用于管理类别的“产品类别”数据列表和用于管理每个产品信息的“产品”列表。 “产品”列表包括一个名为“产品类别”的查阅项字段,它允许用户选择存储在“产品类别”列表中的数据。

然后,您有一个表单可以允许用户在已选类别中选择产品类别以及产品。您可以在表单上使用2个查阅项字段,分别关联“产品类别”列表和“产品”列表。然后设置产品查阅项字段的数据过滤条件为只能选择所选类别下的产品。
同时,当用户选择了一个产品,您还想在表单上用其他字段显示产品的相关信息(比如单价),这些信息被存储在“产品”列表中。您可以在查阅项设置中,将相关信息绑定到当前表单中的其他字段上。

使用查阅项的其他优点
查阅项帮助您:
- 减少您在应用中创建表单的数量。
例如,您的教育机构有员工登记表,假设您想要按部门收集员工的出勤情况。 您可以为每个部门创建一个表单,其中包含员工的详细信息,以便他们单独登记自己的出勤,这可能会导致您创建多个表单(假设您有 15 个部门,您将创建 15 个表单)。 相反,您可以创建一个单独的部门数据列表来存储15 个部门,并创建一个员工数据列表来存储员工数据。 然后您可以创建一个出勤登记表单,您可以在其中用查阅项字段查找部门和员工。 这样您就可以为所有员工创建一个通用的考勤名册,同时根据部门对他们进行分类,从而减少表单的数量。
- 数据建模
使用查阅项字段,您将能够在数据之间建立关系。 这允许您的表单、数据列表及其数据相互交互,使您能够构建结构化和统一的数据存储。 这种统一提供了链接数据和创建更简单且易于管理的流程的途径。
- 参考另一个数据列表中的相关数据
您将能够获取存储在另一个数据列表中的数据,通过其与当前表单的同步。
定义
数据ID
您在数据列表中添加的每条数据都会生成一个数据ID。查阅项字段将被识别成其所关联的数据源的数据ID。
数据源
数据源是查阅项的数据来源。查阅项所关联的数据源可以来自您Yeeflow账户中的任何应用中的数据列表。
目标数据&表单
目标数据&表单是您使用查阅项来返回值的目标。目标表单可以是审批表单也可以是数据列表的数据表单。
如何添加查阅项字段
首先,在控件面板中找到查阅项控件,然后将其拖拽到您表单中合适的区域或容器中。

提示:
在您的目标表单上使用查阅项,您首先需要有一个数据源。通常,如果您的目标表单是数据列表的数据表单,该数据源不应该在您当前所在的同一个数据列表中。
查阅项字段的基础设置
打开内容>基础设置面板进行字段的标题设置。关于更多字段标题的信息,请参考:
为查阅项字段设置关联变量。当您新增了一个字段,系统会随之自动创建一个默认变量。您可以单击编辑按钮来更新变量标识和变量名称,或者单击重置按钮将该字段绑定到系统中已有的某个变量上。关于更多信息,请参考:
先选择应用,在下拉选项中选择当前应用或者其他应用。
再选择列表,在所选应用下选择一个数据列表作为数据源。
点击数据过滤的过滤条件按钮来设置所选列表数据的过滤条件。
通过首要排序和次要排序进行数据的排序设置。

提示:
数据过滤和过滤条件
默认情况下,查阅项会显示源数据列表中存储的所有数据。在某些情况下,您可能需要过滤掉源数据列表中的一些数据。
为查阅项设置过滤时:
- 只能从源数据中选择索引字段作为过滤条件。 了解如何设置索引字段。
- 部分字段类型,如:复选框、多选元数据、附件、图片、多行文本和富文本不支持设置为过滤条件。
- Yeeflow 提供了一个表达式编辑器来定义过滤条件。
- 您可以添加多个过滤条件。 只有满足所有条件的数据才能被返回。

多选的显示
打开内容>显示面板进行查阅项字段的外观和布局设置。
占位符:为字段设置占位符文字。
多选:打开此选项以允许用户可以选择多条数据。
列:选择要将数据源中的哪一列(字段)的值显示在查阅项字段上
提示:设置提示是可选的,提示会显示在字段上方。

设置查阅项:单击“设置”按钮以设置将在查阅项数据选择窗口中显示的字段。
- 字段:在相关数据列表的字段列表中,点击复选框选择字段,并选择各个字段的显示顺序。 选中的字段将按顺序列出并显示在查阅窗口中。
- 关联字段:您可以将关联数据列表中的任意字段值赋值到当前表单上的字段。 为此,您应该让两个关联字段共享相同的数据类型。 例如。 此目标表单中的用户字段应与源数据中的用户字段相关联。

显示标题:选择显示或隐藏字段的标题。
允许评论:打开开关将允许用户在该字段上添加评论。
动态显示规则:如果您设置了动态显示规则,该字段将会根据设置的条件与规则动态显示。请参考:创建动态显示规则

查阅项的验证
打开内容>验证面板来设置查阅项的属性。
只读
打开该开关会使字段处于只读模式。
必填项
必填字段将确保用户提供响应。 当一个字段是必填项时,错误消息将显示在该字段下方和表单的右上方,在将值添加到字段之前,将无法提交表单。
必填字段会在标签旁边以红色星号 (*) 表示。 默认情况下,字段是非必填的。
请注意:只有表单上的可见字段才会触发必填项验证。
自定义验证
设置自定义验证规则后,如果规则被满足,一个错误信息将会显示在该字段下。您可以为一个字段创建多条自定义验证规则。更多信息请参考:自定义验证
查阅项的动作唤起
打开内容>动作面板来唤起一个已定义好的动作。当查阅项字段的值发生变更时,这个动作将会被触发。

设置查阅项字段样式
打开样式>字段-可编辑面板来设置查阅项字段在可编辑状态下的样式。
1. 排版:为查阅项字段中的文本设置排版样式。
2. 常规/焦点:为查阅项字段的常规以及焦点状态设置不同的样式。以下样式支持常规与焦点状态下的分开设置。
- 颜色:设置字段内所填文字的颜色。
- 背景颜色:为字段设置背景色。背景色默认为透明。
- 边框类型:选择边框类型,可选择:无边框、实线、双实线、点线、虚线、凹槽。
- 边框半径:设置边框半径来控制圆角。
- 阴影:设置阴影显示。
3. 操作按钮:为操作按钮设置样式。
- 颜色:设置操作按钮文字的颜色。
- 背景色:设置操作按钮的背景色。
4. 占位符颜色:对占位符进行颜色设置。
5. 对齐:设置字段内文字的对齐方式。可选择左对齐、居中或者右对齐。
6. 内边距:设置字段的内边距。
7. 字段宽度:设置字段的字段宽度,可按PX或%进行设置。
8. 字段对齐:设置字段对齐。该设置只有当字段宽度小于外层宽度时才生效。
9. 选中项:设置查阅项字段的选中项样式:
- 外边距:设置每个选中项的外边距,可按PX或%进行设置。
- 内边距:设置每个选中项的内边距,可按PX或%进行设置。
- 排版:设置选中项文字的排版样式。
- 颜色:设置选中项的文字。
- 背景颜色:设置选中项的背景颜色。
- 边框类型:设置选中项的边框类型,可选择:无边框、实线、双实线、点线、虚线、凹槽。
- 边框半径:设置边框半径来控制圆角。
- 阴影:设置阴影。
10. 错误消息:为错误消息设置样式:
- 排版:为错误消息设置排版。
- 颜色:为错误消息文字设置颜色。
字段-只读
打开样式>字段-只读面板来设置字段在只读状态下的样式。
选中项:设置查阅项的选中项在只读模式下的样式。
- 外边距:设置每个选中项的外边距,可按PX或%进行设置。
- 内边距:设置每个选中项的内边距,可按PX或%进行设置。
- 排版:设置选中项文字的排版样式。
- 颜色:设置选中项的文字。
- 背景颜色:设置选中项的背景颜色。
- 边框类型:设置选中项的边框类型,可选择:无边框、实线、双实线、点线、虚线、凹槽。
- 边框半径:设置边框半径来控制圆角。
- 阴影:设置阴影。

高级设置
控件的高级设置请参考:高级设置