Appearance
关联记录
关联记录字段表示对另外一张表数据数据的引用。关联记录表示的是模型之间的一对一关系。
说明
| 说明项 | 内容 |
|---|---|
| 分类 | 关联关系 |
| 是否可排序 | 是 |
| 是否支持过滤 | 是 |
| 支持过滤器类型 | 包含、不包含、等于、不等于、等于空、不等于空、在列表中、不在列表中 |
设置项
| 设置项 | 说明 |
|---|---|
| 允许不填写 | 设置该字段是否必填 |
| 未填写时在表单中的占位符 | 在该字段未输入信息时展示在输入框内的文字信息 |
| 关联表 | 选择该字段需要关联的数据表模块 |
| 关联记录显示名称字段 | 关联数据展示的名字 |
| 关联记录存储的字段 | 数据关联后关联信息存储的字段，默认 id 字段。存储的字段会作为关联记录的唯一标识 |
| 显示样式 | 可设置该字段的显示样式 选项值： 默认、纯文本 |
| 搜索行为 | 可设置该字段搜索框的打开方式 选项值： 在表格对话框中搜索、在下拉框中搜索 |
| 使用自动化返回搜索结果 | 开启后可使用自动化返回可选数据列表 |
| 点击搜索后调用的自动化 | 使用自动化返回搜索结果开启后,用户点击搜索调用的自动化。使用示例可参照 |
| 操作控制 | 说明 |
|---|---|
| 点击后打开关联记录的表单页面 | 设置是否允许点击该字段打开关联的记录的表单页面 |
| 在表单页面使用标签页显示子表单 | 可设置是否以标签页的方式在本记录中显示关联记录的表单页面 |
| 编辑操作控制 | 可控制该字段是否允许通过创建直接设置记录和是否允许清空已选的值：隐藏创建按钮、隐藏清空按钮 |
| 搜索页设置 | 说明 |
|---|---|
| 搜索页面的宽度 | 可设置搜索面的展示宽度，范围：300~1500 |
| 表格样式 | 可设置搜索页中表格的样式，支持多选 选项值： 显示序号、显示边框、显示条纹、隐藏表头 |
| 子对象字段 | 可选择一个关联表中的子对象字段，设置了子对象字段后，表格将显示为树形表格 |
| 仅允许选择满足条件的记录 | 可通过表达式编写条件，使得表格中满足条件的数据才能被选择 |
| 展示以下字段 | 可设置搜索页中表格需要展示的字段 |
| 数据过滤 | 可通过表达式设置搜索页中显示的数据需满足的条件；可设置搜索页中返回的字段列表 |
| 使用以下字段作为搜索条件 | 可针对搜索页表格设置搜索搜索条件，支持字段搜索与模糊搜索两种方式 |
| 默认排序 | 可选择字段与排序方式作为表格数据的默认排序方式 |
| 单元格格式 | 可通过规则设定字段中表格的单元格格式，支持设置多个规则 |
在数据库中的存储格式
| 存储字段类型 | 字段类型 | 说明 |
|---|---|---|
| 字符串 | varchar(64) | 可变长字符串,最多64个字符 |
| 整数 | int8 | 整数 |
引用表记录被删除时的动作
关联记录引用的数据表记录如果删除时，会根据引用表的删除设置触发不同的行为
被引用时不允许删除如果被引用表设置了此选项，则删除被引用表数据的时候，如果有关联记录引用了记录，则不允许删除被引用表的记录删除后同时设置引用数据中的关联记录为空或者删除关联列表中被引用的数据如果被引用表设置了此选项，则会将关联记录的内容设置为null
显示名称
在自动化或者脚本中查询记录数据时，关联记录类型的字段会连带的返回设置的名称字段，例如 A 表中的关联记录字段 field1 引用了 B 表，并且设置了显示名称为 B 表的title字段，则 A 表查询返回的数据如下
json
{
"id": "recordId",
"field1": "B表的记录ID",
"field1_name": "B表的title字段值"
}TIP
在使用自动化更新表单记录时，为了能让关联记录字段显示的名称正确，应当同步的设置字段的名称
显示样式
存储字段
在关联记录中，支持选择对应的子表记录并存储指定子表记录字段的值，如下方的图示中，我们分别存储了记录ID和记录姓名字段的值。
TIP
默认为存储记录ID
搜索行为
使用自动化返回搜索结果
调用自动化返回可选的数据记录列表
使用场景
- 依据当前表单数据用户可选择的数据列表
- 依据应用上下文(用户角色、权限等)控制用户可选择的数据列表
使用说明
- 自动化返回值结构中需要包含
list和count两个属性 - 自动化返回值的
list属性为 Array<Record>类型，表示返回的数据列表；count属性为Integer类型，表示满足条件的数量。 - 自动化返回值中若不包含
count属性则使用list属性的长度作为默认值 - 用户点击搜索后调用自动化将默认传入
QueryCondition结构数据
使用示例
加入有如下数据模型
问题表 question，字段如下
| 标识符 | 字段 | 类型 |
|---|---|---|
| name | 问题名称 | 单行文本 |
| descs | 问题说明 | 多行文本 |
问题拆分表 questionDetail，字段如下
| 标识符 | 字段 | 类型 |
|---|---|---|
| name | 名称 | 单行文本 |
| descs | 说明 | 多行文本 |
| questionRel | 所属问题 | 关联记录 |
在问题拆分表字段设置使用自动化返回搜索结果
字段设置
自动化
使用模拟数据
返回数据来自数据表
界面展示
问题表数据
问题明细表数据
对于关联记录、关联列表也支持在视图过滤条件中启用“自动化待选值”
过滤条件待选值
界面展示
表单数据联动子表数据搜索
在一些场景下，我们希望我们填写的表单数据发生变化时，关联记录可选的内容也会发生变化，这种情况，我们可以通过搜索页面设置，完成表单与关联 记录可选列表的联动。
下方我们将演示调整姓名字段的值，过滤【表单内可选数据过滤】字段的可选数据
