跳到主要内容

字段配置说明

通用配置详解​

  • 字段名称：支持中英文。

  • 字段标识：标识不能为空，不能以数字开头，只能包含字母、数字或_，不能输入超过40个字符。

  • 数据类型：即字段类型选择，可参考字段类型设置所需字段设置。

  • 是否必填：该字段是否必填。

  • 是否唯一：该字段的取值是否允许重复，设置为唯一则不允许填重复值。

  • 是否为主展示列：数据类型为文本时可选择。当用户在其它数据模型中，配置关联关系或主子明细字段关联到本数据模型时，该字段会显示为主展示列的值，方便用户查看。此配置仅影响查看效果，不影响关联关系或主子明细字段实际存储内容。

主展示列详解​

用户可以在数据模型中设置一个字段为主展示列。该字段将会影响其它模型关联此模型时的展示名称。下面以学生和课程两个数据模型为例，说明主展示列的使用方法。

学生模型配置：课程表数据类型为关联关系，关联的数据模型为课程。

img_22.png

课程模型配置：课程名称设置为主展示列。

img_23.png

通过接口查询该数据模型结果如下：课程表字段实际存储的仍然是关联表的 id，通过 @kcb 返回了关联表中该条记录的全部内容，并通过"primaryColumn": "mc"标识出主展示列为哪个字段。

{
    "records": [{
            "xm": "张三",
            "_id": "962d008f650404bc024c52f43a471189",
            "kcb": "93e4b6a0640e9139042f27941b0ab7e6",
            "@kcb": {
                "v1": {
                    "primaryColumn": "mc",
                    "record": {
                        "owner": "1446845068964986882",
                        "createdAt": 1678676281098,
                        "createBy": "1446845068964986882",
                        "updateBy": "1443776918208724994",
                        "mc": "语文",
                        "_id": "93e4b6a0640e9139042f27941b0ab7e6",
                        "updatedAt": 1690341673543
                    }
                }
            }
        },
        {
            "xm": "李四",
            "_id": "41d77edc650404c8024ad4636a1c0704",
            "kcb": "987a4537640e9140042d5c5715fce0ce",
            "@kcb": {
                "v1": {
                    "primaryColumn": "mc",
                    "record": {
                        "owner": "1446845068964986882",
                        "createdAt": 1678676288091,
                        "createBy": "1446845068964986882",
                        "updateBy": "1443776918208724994",
                        "mc": "数学",
                        "_id": "987a4537640e9140042d5c5715fce0ce",
                        "updatedAt": 1690341680970
                    }
                }
            }
        }
    ],
    "total": 2
}

在表格组件中，为方便用户查看，课程表字段自动转换为主展示列显示出来。

img_24.png

需要注意的是，如上文所述，该字段实际存储为记录的 id。

在使用数据筛选时，如果想查询课程表字段为语文的记录，筛选条件应使用课程模型中语文对应的 id 值。

{
    "where": {
        "$and": [{
            "$and": [{
                "kcb": {
                    "$eq": "93e4b6a0640e9139042f27941b0ab7e6"
                }
            }]
        }]
    }
}

在表单容器中，绑定学生模型时，课程表字段会自动生成为下拉单选组件。组件的选项名称即为主展示列，选项值为 id。

img_25.png

从提交的参数可以看出，课程表字段提交的是选项值，保存的是关联记录的 id。

{
    "xm": "王五",
    "kcb": "93e4b6a0640e9145042f2e635ed8600f"
}