创建合法值
合法值是一种用于约束属性值取值范围的元数据定义，通过预定义有效值集合确保数据输入的规范性和一致性，进而提升业务规则的可读性和可维护性。为了满足不同层级的配置需求，工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）提供了应用级与租户级合法值的分层管理模式。
- 应用级合法值：由应用责任人或应用开发人员在应用设计态构建并管理的合法值均为应用级合法值，实行全局统一管理机制，以确保基础数据的一致性与规范性，避免跨租户的数据歧义。这些合法值适用于所有租户共享的基础数据（如国家/地区、通用分类等）。
- 租户级合法值：指的是租户在应用运行态进行个性化扩展的合法值，允许租户基于自身业务特性和本地化需求灵活定义（如企业内部编码、专属业务选项等）。具体操作请参见合法值概述。
本文将指导您如何在应用设计态中创建合法值类型及配置具体合法值。
前提条件
已登录应用设计态。
步骤1：创建合法值类型
- 在左侧导航栏中，选择，进入“合法值”页面。
- 在“合法值”页面，单击“创建”。
- 在展开的“创建合法值类型”页面，设置如下信息。
图1 设置基本信息
表1 合法值类型-基本信息 参数
参数说明
英文名称
用户自定义，表示合法值类型的英文标识符，例如“Fiat_Currency”。
应用下全局唯一，不能包含中文字符，长度不超过128个字符。
中文名称
用户自定义，表示当前合法值类型的中文名称，例如“货币类型”。
应用下全局唯一，长度不超过128个字符。
英文描述
用户自定义，表示当前合法值类型的英文描述。
长度不超过1024个字符。推荐使用英文字符填写，同时支持中文及其他字符输入。
中文描述
用户自定义，用于说明当前合法值类型的用途、业务定义等，以便于其他用户了解和使用该合法值类型。
长度不超过1024个字符。支持中文、英文及其他字符输入，建议优先使用中文填写以适配中文阅读场景。
类型
设置合法值的具体数据类型，用于约束数据的格式、类型和基本属性，确保数据在业务场景中的技术规范性与业务适配性。可选的类型如下：
- 文本：存储字符串内容，例如设备型号、物料编码、质检状态等。
- 整型：用于存储整数数据，例如设备运行计数、故障代码、工序步骤编号等。
- 长整型：用于存储范围较大的整数数据，例如设备唯一识别码、高精度时间戳等。
- 浮点型：用于存储带有小数的数值，例如传感器测量值、配方比例、能耗统计等。
- 人员：用于标识企业或部门内的人员名称，例如设备责任人、工单审批人、操作员工等。
- 单击“保存”。
步骤2：添加合法值
完成合法值类型创建后，您需要为其预定义有效值集合，以此来约束数据的具体取值，确保符合业务规则或行业标准。例如，如果您已创建一个“货币类型”合法值类型，可以根据业务要求添加如人民币（RMB）、美元（USD）、欧元（EUR）等合法值。在后续使用“货币类型”字段时，系统将仅允许从这些预设值中选择，从而保障数据的一致性和准确性。
- 切换至“合法值列表”页签，单击“创建”。
- 在弹出的“创建合法值”窗口中，设置如下信息。
图2 设置合法值信息
表2 合法值参数信息 参数
参数说明
合法值
为合法值类型配置具体的可选值，例如“人民币（RMB）”。
长度不能超过254个字符，且创建后不可修改。
分类
用户自定义的逻辑分组标识（如“货币类型”），用于对合法值类型进行归类管理，提升查询和维护效率。
长度不超过128个字符。
英文名称
用户自定义的合法值英文标识符（如“RMB”），用于系统内部引用、代码生成和API交互。
不能包含中文字符，长度不超过128个字符。
中文名称
用户自定义，作为合法值的业务可读名称（如“人民币”），用于方便业务人员理解和使用。
长度不超过500个字符。
英文描述
用户自定义，用于说明合法值的技术细节。
长度不超过1024个字符。推荐使用英文字符填写，同时支持中文及其他字符输入。
中文描述
用户自定义，用于说明合法值的业务含义。例如“ISO 4217标准代码，代表中国法定货币”。
长度不超过1024个字符。支持中文、英文及其他字符输入，建议优先使用中文填写以适配中文阅读场景。
- 单击“保存”。
