String

String 元数据存储文本类值。它用于可读文本、业务编码、选项值、单条关联 ID、组织结构 ID、成员 ID、邮箱和链接。

当字段值需要按文本比较或传给外部接口时，使用 string 处理；即使这个文本代表业务编码或关联记录 ID，也仍然按 string 处理。

常见用途

用途	示例
展示文本	名称、标题、描述
业务编码	订单号、客户编码、流水号
单选值	下拉值、单选值
单条关联	搜索记录 ID、外键、成员 ID
联系信息	邮箱地址、URL

值形态

type StringMetadataValue = string | null;

非必填字段为空时，可能是 null，也可能是空字符串，取决于写入来源。传给外部接口前建议先归一化。

const orderNo = String(record.data.order_no || '').trim();