元数据类型

元数据类型描述表单字段存储的值形态，也是 Studio API 返回字段值时使用的分类。字段元数据里，type 表示具体字段类型，dataType 表示存储值类型。

Studio 脚本读取记录、构造创建或更新接口的 data、校验入参，或在处理字段前判断字段类型时，都需要参考元数据类型。

类型分类

Data Type	字段类型
string	文本、长文本、辅助文本、流水号、搜索、外键、下拉、单选、部门、组织、成员、邮箱、链接
number	数字
boolean	开关
date	日期、时间、周、月、季度、年
datetime	日期时间
array	多选搜索、多选、复选框组、多成员、图片、视频、文件、音频
object	位置

值出现的位置

表单记录值存放在 record.data，并以字段 API 名作为 key：

const record = await context.form.find({
  formApiName: 'orders',
  condition: {
    logic: 'and',
    children: [
      { field: 'order_no', operator: 'eq', value: 'SO-1001' },
    ],
  },
});

const amount = record?.data.amount;

字段元数据可以通过 context.formSchema 读取：

const amountField = await context.formSchema.field({
  formApiName: 'orders',
  fieldApiName: 'amount',
});

if (amountField?.dataType === 'number') {
  // 按数字处理。
}

日期格式

Studio SDK 会按字段元数据格式化时间类值。

Data Type	返回格式
date	YYYY-MM-DD
datetime	YYYY-MM-DD HH:mm:ss

其他类型按存储的 JSON 兼容值返回。