更新时间:2025-08-15 GMT+08:00
分享

合法值概述

合法值是一种用于指定属性值的合法取值范围的方法。当您需要限制属性值的取值范围时,合法值可以帮助您清晰地表达这些限制,以确保属性值的正确性和可读性。您可以在系统中自定义合法值类型,并为此合法值类型定义合法值列表,当您指定的属性绑定了此合法值类型作为合法值约束时,此属性在实例化时可接受的值将受限为合法值范围内。例如,您可自定义新增合法值类型“来源类型”,并为“来源类型”合法值列表增加“采购”“制造”两个合法值。将零部件数据实体上的属性“来源”绑定合法值类型“来源类型”,那么属性“来源”的值仅接受“采购”“制造”这两种选项。

合法值目录

租户可根据实际业务架构(如生产线、车间、设备类型等)自定义合法值目录的树形层级结构,通过目录维度对合法值类型进行分类聚合和分层管控,实现数据的有序组织与快速检索。

在应用运行态初始化时,默认提供一个包含系统预设合法值及用户在应用设计态创建的应用级合法值的默认目录。租户可以在此默认目录内直接管理合法值类型,也可以创建全新的合法值目录以满足更细致的分类需求。

合法值类型

合法值类型是一组预定义值的集合,用于约束业务参数的取值范围,确保数据在业务场景中的技术规范性与业务适配性。根据管理级别分为以下三类:

  • 系统预设:系统预定义的合法值类型(“来源”“内置”),包含核心业务参数(如XDMUser用户类型合法值)。
  • 应用级:在应用设计态定义的合法值类型(“来源”“应用”),全租户共享(如通用分类、业务编码等)。
  • 租户级:租户在应用运行态自定义的合法值类型(“来源”“用户”),满足个性化需求(如企业专属编码、内部分类等)。

合法值

合法值是租户自定义合法值类型的取值范围,且合法值内容与合法值类型保持一致。即,如合法值类型为整型,其合法值也是整型。

约束与限制

根据管理级别,xDM-F对系统预设和应用级的合法值类型设置了以下约束与限制:

  • 系统预设的合法值类型
    • 支持编辑合法值类型,不支持删除合法值类型。
    • 支持编辑已有合法值、新增合法值记录,不支持删除、生效或失效已有合法值。
  • 应用级的合法值类型
    • 不支持编辑和删除合法值类型。
    • 支持新增合法值记录,不支持编辑、删除、生效或失效已有合法值。

相关文档