自定义属性

自定义属性（UDP）用于在模型各类对象上维护产品原生属性之外的扩展字段，例如数仓场景中的更新频率、字段分类。管理员在 Web 管理端统一定义属性，用户在客户端或 Web 端下载并加载后为对象赋值。本页讲属性的创建、类型与枚举设置，以及必填属性的校验边界。

数据类型与可用选项

数据类型	是否支持枚举值	说明
STRING	支持	可为属性添加固定备选值，录入时从枚举中选择
INTEGER	支持	用于整型编码类属性，同样可配置枚举值
其他类型	不支持	按数据类型本身录入，不提供枚举备选值

只有枚举类属性可以设置级联关系和枚举值多选。属性建立后修改数据类型会影响已有取值，修改前应确认影响范围。

创建与导入自定义属性

1. 进入“系统管理 → 自定义属性”。
2. 单击【创建】新建自定义属性，或使用模板导入批量建立。
3. 在编辑页填写属性名称、所属对象类型和数据类型。
4. 按需要配置枚举值、级联属性、多选和必填等选项。
5. 保存后，属性出现在列表中，供客户端与 Web 端下载。

图示为自定义属性列表页，看图重点是页面同时提供单个创建和模板导入两个入口，导入适合一次建立多条属性。

按模板导入时，先下载模板、按说明填写，再上传。导入后抽样核对属性名称、数据类型和枚举值是否与填写一致，避免因表格格式问题造成属性缺失。

设置枚举值与级联属性

1. 在属性编辑页把数据类型设为 STRING 或 INTEGER。
2. 为属性添加枚举值，构成该属性的备选值集合。
3. 需要多级分类时，在“级联属性”中选择当前属性的上级属性。
4. 保存后，属性在使用时可展示为多级备选。

图示为属性详情编辑页，看图重点是数据类型、枚举值和级联属性三项设置的位置，级联属性只在枚举类属性下出现。

级联属性建立的是上下级取值过滤关系：下级属性的备选值由上级属性的已选值过滤。以字段分类为例，先选定一级分类，二级分类只列出该一级分类下的取值，从而形成多级分类。上级属性应先于下级建立，且上级已选定值后下级才能得到正确过滤结果。

启用枚举值多选

1. 在创建或编辑枚举类属性时，勾选“枚举值多选”。
2. 保存属性并在客户端或 Web 端下载、加载。
3. 在对象编辑器中为该属性赋值时，通过多选交互一次选择多个枚举值。

图示为填写对象自定义属性时的多选交互，看图重点是枚举值可同时勾选多项，普通枚举属性只能选一个。

未勾选“枚举值多选”时，该属性只能保存一个取值。已录入多值后再取消该选项，需要核对存量对象的取值是否符合预期。

必填属性的校验边界

把自定义属性设为必填，不会在建模过程中限制对象的创建或编辑，录入阶段不做拦截。需要核对必填项是否漏填时，使用模型数据规范中的检查规则批量检查填写情况，在检查结果中统一发现漏填对象。把必填理解为“检查时报告”，可以避免误以为属性已被强制填写。客户端侧的校验表现见客户端自定义属性与客户端模型检查。

编辑、删除与下发

1. 在属性列表中单击【编辑】修改定义，或单击【删除】移除不再使用的属性。
2. 修改后通知使用方在客户端重新下载公共属性。
3. 在客户端的模型树上对目标模型执行“加载 UDP”，使新定义在对象上生效。

属性定义变更后，已加载到模型的属性不会自动更新，需要重新下载并加载。删除属性前确认没有模型或模板在引用它。客户端下载与加载的具体操作见客户端自定义属性，属性值可用于表名等命名宏的场景见客户端实体/表模板。