• 文档
  • 注册记录类型

注册记录类型


记录类型是非时序的事实数据的类型。只有在通用数据服务上注册过的记录类型，才能通过通用数据服务 API 查询这些记录的字段。应用构建者可以通过上传模板文件批量注册记录类型。

前提条件


开始之前，确保当前帐号已被分配所需的资产权限、操作权限点和包含 记录类型 在内的菜单组。如未分配，联系应用管理员。

操作步骤


  1. 在左侧导航栏中选择 元数据 > 记录类型。

  2. 根据目标记录类型的生效范围选择 公有记录类型 或 私有记录类型 标签页，点击 导入。有关公有/私有记录类型的区别，参见 公有/私有记录类型。

  3. 在弹窗中点击 下载模板，选择下载 Excel 或 JSON 模板文件。

  4. 参考以下信息填写模板文件。


    分类 字段名称 标识符 必填/选填 描述
    基础信息 记录类型标识符 recordType 必填 记录类型的标识符，需保证在同一作用域（公有/私有）内的唯一性。
    基础信息 记录类型中文/英文/日语/西班牙语名称 nameZh/En/Ja/Es 中文和英文为必填 不同语言的记录类型名称。
    基础信息 关联数据源 srcKey 必填 数据源 API 的唯一标识符，即 API Key。
    基础信息 数据源路由参数 dataSourceParam 选填 数据源的路由参数。一个数据源可能会提供多类记录，通过在此处传参指定数据源中的记录类别。例如：{“recordType”:“WOWorkType”}，含义为：通过 recordType 参数指定获取数据源中 WOWorkType 的记录类型。
    基础信息 是否透出错误代码 showSubMsg 选填 若透出错误码，则填写 Y；若不透出，则填写 N。默认值为 N。
    基础信息 父记录类型信息 references 选填 可关联多个父记录类型，格式为：{“recordType”:“SubCommand”, “foreignKeys”:{“controlRecordId”:“controlRecordId”}}。
    字段列表 记录字段Key field 必填 记录字段的唯一标识符。
    字段列表 字段中文/英文/日语/西班牙语名称 nameZh/En/Ja/Es 中文和英文为必填 不同语言的字段名称。
    字段列表 字段中文/英文/日语/西班牙语描述 descriptionZh/En/Ja/Es 中文和英文为必填 不同语言的字段描述。
    字段列表 数据类型 dataType 必填 字段的数据类型。目前支持的数据类型：Integer，Object，String，timeStamp，JSONObject。
    字段列表 单位 units 选填 字段单位，参考 EnOS 内置单位 填写。
    字段列表 表达式 expression 必填 指定字段的生成方式，可以直接配置单一字段名表示透传数据源中的字段，也可以通过配置表达式实现轻量计算。
    字段列表 是否可排序 sortable 选填 若查询字段的结果可以按升/降序返回结果，则填写 Y；若不可排序，填写 N。
    字段列表 筛选器 filters 选填 查询字段时支持的筛选方式。目前支持的筛选方式：in，==，!=，>，>=，<，<=。多个筛选方式之间用英文逗号分隔，例如：==,in。
    字段列表 字段内容是否国际化 isl18n 选填 根据字段内容是否为 l18n 结构填写 Y 或 N，默认为 N。
    字段列表 是否按国际化返回 extractl18n 选填 根据是否需要按指定语言返回填写 Y 或 N，默认为 N。
    字段列表 枚举量来源类型 enumSourceType 必填 如果是静态枚举，则填写 static；如果枚举来自通用数据服务的记录，则填写 record；如果枚举来自配置中心的维度表，则填写 amcDimension。
    字段列表 静态枚举量 enumerate 选填 如果枚举量来源为 static，则指定枚举量的标识符和名称。
    字段列表 动态枚举来源ID enumerateSourceID 选填 如果枚举量来源为 record 或 amcDimension，则指定关联的记录类型或维度表的标识符。
    字段列表 动态枚举字段映射 enumerateMapping 选填 如果枚举量来源为 record 或 amcDimension，则指定枚举量标识符和名称在关联记录类型或维度表中对应的字段。
    字段列表 是否关联子记录类型 isSubRecordType 选填 如果是关联子记录类型的字段，则填写 Y，否则填写 N。
    字段列表 子记录类型返回字段 subRecordFields 选填 子记录类型中需要返回的字段。

    注解

    导入模板中的“所属组织标识符”、“所属组织名称”、“记录字段数量”、“更新时间”和“操作人”字段无需填写，将在上传后由系统自动填充。


  5. 在弹窗中点击 上传。选择填写后的模板文件并点击 确定。

结果


注册成功后，记录类型出现在记录类型列表中。应用构建者可以查看记录类型详情，并进行以下操作：

  • 修改记录类型：点击 导出，按需修改下载的文件后再导入新文件。标识符相同的记录类型会覆盖原有记录类型，不同则新增记录类型。
  • 删除记录类型：点击对应记录类型行的 删除 Delete 。记录类型删除后不可恢复。