管理功能配置
操作场景
完成数据实体的构建后，您可以根据实际业务需求调整数据实体的功能和功能配置。
约束与限制
删除数据实体的功能时，存在如下约束与限制：
- 基础功能和从父模型继承的功能不能删除。
- 如果可选功能中的扩展属性、扩展类型、文件夹管理、生命周期管理和多维视图&多维分支功能已在数据实体中发布，则不能删除。
前提条件
已登录应用设计态。
为数据实体新增功能
- 在左侧导航栏中，选择，进入数据实体页面。
- 单击需要添加功能的数据实体编码，进入该数据实体详情页面。
- 根据数据实体的状态，单击“编辑”或“修订”，进入编辑状态。
- “状态”为“正在工作”的数据实体，单击“编辑”。
- “状态”为“已发布”的数据实体，单击“修订”。
- 在“功能列表”栏中，单击“添加”。
图1 添加功能
- 在弹出的窗口中，勾选需要添加的功能，单击“确定”。
- 在弹出的提示框中，单击“我知道了”。
如果勾选的功能中无需配置规则，跳过此步骤。
- 单击“保存”。
- 如果勾选的功能需要配置规则，选择“功能配置”页签，设置如下信息，并“保存”。
图2 功能配置
表2 功能配置-参数说明 类型
参数
参数说明
设置规则
版本服务
M-V模型实体中Version模型实体（版本对象）的默认功能，用于自定义版本号生成规则。如果在填写基本信息时，“父模型”选择为“VersionObject”，可在“功能配置”中设置“版本服务”的规则。关于M-V模型的内容请参见什么是M-V模型？。
- 流水码：默认为“字母（不包含I、O、Z）”。
- 前缀：可以选择当前实体提供的属性，可以手动输入版本号的前缀，也可以选择分隔符“-”和“_”。
- 后缀：可以选择分隔符“-”和“_”，可以选择当前实体提供的属性，也可以手动输入版本号的后缀。
多维版本
M-V模型实体中Version模型实体（版本对象）的可选功能，用于以不同视角差异化管理同一个数据对象。如果在填写基本信息时，“父模型”选择为“VersionObject”，且“功能列表”添加了“多维视图&多维分支”功能，可在“功能配置”中设置“多维版本”。一个M-V模型实体至多可添加3个多维版本。
单击“新增”，设置如下信息，定义多维版本。
- 属性英文名称：填写多维版本的英文名称。
- 属性中文名称：填写多维版本的中文名称。
- 参考对象：选择参考对象的目标端（数据实体）。
- 必填：设置该多维版本是否必填，默认为“是”。
当您发布数据实体时，该实体会根据新增的多维版本自动在基本属性中生成对应的多维版本属性。
将具有“多维视图&多维分支”功能的M-V模型实体部署至运行态后，您可以通过调用API的方式创建多维版本实例，具体操作请参见创建多维版本的数据实例。
业务编码生成器
在“基本信息”设置中，如果勾选“业务编码生成器”至“功能列表”，您可以在“功能配置”设置具体的生成规则。
- 选择绑定属性：选择数据实体中用于生成编码的特定属性，例如产品型号、设备编号等。
- 当数据实体的“父模型”为自定义抽象模型且已配置业务编码生成规则时，保持此配置项为空，即可自动继承父模型的业务编码生成规则，无需重复配置。
- 当绑定属性的“唯一键区间”为“租户内唯一”时，数据实体部署至应用运行态后，支持按逻辑租户维度隔离编码规则，各逻辑租户可自定义编码规则。例如，某分公司使用COM01-{流水码}，另一分公司使用COM02-{流水码}。
- 当绑定属性的“唯一键区间”为“全局唯一”时，数据实体部署至应用运行态后，所有逻辑租户共用同一业务编码规则，且不支持自定义。例如全局统一使用GLOBAL-{日期}-{流水码}。
- 如果数据实体中没有合适的属性用于绑定，需要新增一个文本类型且设为唯一键的属性，以确保编码唯一性。具体操作可参见管理数据实体属性。
- 配置编码段：从预设编码段列表中选择所需编码段，并通过拖拽操作组合编码结构。单击具体的编码段，可以灵活调整和设计符合业务需求的编码规则。
：常量编码段，在业务编码中嵌入自定义固定值，用于统一标识编码的用途、归属或分类，提升编码规范性与可读性。例如，添加固定常量“MAT-”作为原料编码前缀。
：属性编码段，从当前数据实体的属性中选择字段，将对应实例数据（如设备参数、产品规格）动态嵌入编码，强化编码与数据实体的关联性，实现高效的数据溯源与精准检索。
xDM-F依据元模型实体类型，对此编码段做出如下约束与限制：
- 单实体：
内置属性限制：“ID”属性不可使用。
属性类型限制：“参考对象”、“URL”、“文件”和“JSON”类型属性均不可使用。
特殊属性限制：“多值”设置为“是”的“枚举”和“人员”类型属性，以及“值加密”设置为“是”的“文本”类型属性均不可使用。
- M-V模型实体：
内置属性限制：“ID”、“Iteration”、“Master”、“Version”和“Branch”属性均不可使用。
属性类型限制：“参考对象”、“URL”、“文件”和“JSON”类型属性均不可使用。
特殊属性限制：“多值”设置为“是”的“枚举”和“人员”类型属性，以及“值加密”设置为“是”的“文本”类型属性均不可使用。
- 单实体：
：日期编码段，支持多种日期格式嵌入，将时间戳整合至业务编码中，为业务数据赋予时间维度标识，便于按时间序列管理与追溯。可选格式包括：
- YYYY：4位年份（如2025，表示2025年）。
- YYMM：2位年份+2位月份（如2505，表示2025年05月）。
- YYMMDD：2位年份+2位月份+2位日期（如250514，表示2025年05月14日）。
- YYYYMMDD：4位年份+2位月份+2位日期（如20250514，表示2025年05月14日）。
Y代表年份，M代表月份，D代表日期。
：流水码编码段，通过生成唯一的递增序列，确保业务编码的唯一性与连续性。
- 流水码：支持“字母”、“数字”和“数字+字母”三种类型。
字母：生成由字母组成的序列（如A、B、C...）。
数字：生成由数字组成的序列（如001、002...）。
数字+字母：生成数字与字母混合的序列（如009、00A...）。
- 要排除的字母：可选参数，用于指定不希望出现在流水码中的字母。仅在字母/数字+字母流水码类型下可用，用于过滤易混淆字符（如I、O、Z等），避免人工识别歧义。
- 流水码位数：指定流水码的长度，只能为1-9的正整数。
- 初始流水码：设置序列的起始值，且初始流水码的长度不能超过流水码位数（如位数为3时，初始值最大为999）。
- 流水码：支持“字母”、“数字”和“数字+字母”三种类型。
：雪花ID编码段，采用分布式唯一ID生成算法，可在高并发环境下生成不重复的全局唯一标识。适用于多厂区协同管理、跨地域系统集成等场景，确保不同厂区、不同业务系统中的业务编码始终保持唯一性，有效避免编码冲突，提升数据管理效率与准确性。
约束与限制：
- 最多添加10个编码段。
- 流水码编码段和雪花ID编码段只能二选一。
- 雪花ID编码段与其他所有编码段互斥。即，选择使用雪花ID后，不能添加常量、属性、日期等其他类型的编码段；反之，若已使用其他编码段，则不能再添加雪花ID。
此外，如果数据实体更新了其父模型，与之相关的所有业务编码生成器功能将会被自动移除。为确保其功能的正确性和有效性，您需要重新配置业务编码生成器。
树形结构
如果在填写基本信息时，“功能列表”添加了“树形结构”，可在“功能配置”中设置“树形结构”的规则。
指定全路径字段：仅支持选择文本类型或数值类型的属性，为树形节点全路径绑定属性。建议选择ID字段的属性，如将全路径字段选择为非ID字段属性，可能会影响后续对树形结构相关接口的调用。
配置完成后，在应用运行态创建实体的数据实例时，会根据您填写的父节点信息，自动填充其全路径字段（fullPath，以指定属性构建的从根到叶子节点全路径）、原始全路径字段（rawFullPath，以ID属性构建的从根到叶子节点全路径）；更新实体的数据实例时，会根据您填写的父节点信息，自动更新其全路径信息、原始全路径信息，更新方式为非实时性的异步任务（待异步任务执行完成后，刷新路径信息）。
生命周期管理
如果在填写基本信息时，“功能列表”添加了“生命周期管理”，可在“功能配置”中设置“生命周期管理”的规则。
单击“新增”，设置如下信息，用于约束运行态应用下的生命周期管理。如未新增，默认使用“LifecycleTemplate”生命周期模板。
- 模板属性定义：自定义模板属性的英文名称、中文名称、英文描述和中文描述，选择出厂默认生命周期模板。如果您没有可选择的生命周期模板，可先输入出厂默认生命周期模板名称，待数据实体部署至运行态后，再在运行态创建同名的生命周期模板。具体操作请参见创建生命周期模板。
- 状态属性定义：自定义状态属性的英文名称、中文名称、英文描述和中文描述。
扩展属性
如果在填写基本信息时，“模型类型”选择为“实体模型”，“功能列表”添加了“扩展属性”，可在“功能配置”中设置“扩展属性”的规则，用于约束应用运行态下该实体可添加的扩展属性类型数量、文本长度等配置。
单击“新增”，参考如下说明进行设置。
- 属性类型：用于约束应用运行态下该实体可添加的扩展属性类型。当前支持选择文本、长文本、整型、长整型、浮点型、浮点型（自定义精度）、布尔值、日期、枚举、分类、URL、文件和参考对象类型。
- 数量：用于约束应用运行态下该实体可添加对应扩展属性类型的数量。
- 如果应用的数据库类型为mysql，文本、布尔、日期、分类类型的属性数量不可超过200个，长文本类型的属性数量不可超过185个，整型、长整型、浮点型、浮点型（自定义精度）类型的属性数量不可超过100个，枚举类型的属性数量不可超过55个，URL类型的属性数量不可超过4个，文件类型的属性数量不可超过183个，参考对象类型的属性数量不可超过45个。
- 如果应用的数据库类型为postgresql，每种类型的属性数量不可超过200个。
- 文本长度：表示存储至数据库的文本总长度。如果应用的数据库类型为mysql，其文本总长度不可超过14234字节（Byte）。
- 是否索引：选择为“是”，系统会在对应实体扩展表中创建普通索引，后续您在应用运行态为该实体添加“索引”为“是”的扩展属性时，将自动匹配至有索引的列。同时存在如下约束：
- 长文本、文件、布尔值、URL不支持选择“索引”为“是”。
- 文本、日期、分类和参考对象类型的属性数量不可超过60个，整型、长整型、浮点型和浮点型（自定义精度）类型的总属性数量不可超过60个。
- 如果应用的数据库类型为postgresql，枚举类型的属性数量不可超过60个。
- 如果应用的数据库类型为mysql，且“文本长度”的设置大于768个字符，则该配置无效，无需配置。
- 扩展表名称：默认为“应用英文名称_数据实体英文名称+属性类型+EXAValue”，可自定义。
例如应用名为DMEApp，数据实体为Parts，属性类型为整型，扩展表名称默认为“DMEApp_PartsNumberEXAValue”。
将具有“扩展属性”功能的实体部署至运行态后，运行态会基于设计态的扩展属性约束规则，自动生成对应的扩展属性值宽表。例如，您在设计态对A实体设置扩展属性类型为数值类型，数量为10个，则在运行态中会自动创建一个“A数值扩展属性值宽表”的实体。
联合索引管理
如果在填写基本信息时，“模型类型”选择为“实体模型”，且需要对该实体进行多属性查询时，可在“功能配置”中定义联合索引，提高查询效率。更多关于联合索引的介绍请参见联合索引管理。
API列表
-
应用发布后，API列表中的API会注册到APIG，提供调用。
删除数据实体的功能
- 在左侧导航栏中，选择，进入数据实体页面。
- 单击需要删除功能的数据实体编码，进入该数据实体详情页面。
- 根据数据实体的状态，单击“编辑”或“修订”，进入编辑状态。
- “状态”为“正在工作”的数据实体，单击“编辑”。
- “状态”为“已发布”的数据实体，单击“修订”。
- 在“功能列表”栏，勾选需要删除的功能，单击“删除”。
图3 删除功能
- 在弹出的提示框中，单击“确定”。
- 单击“保存”。
修改数据实体的功能配置
- 在左侧导航栏中，选择，进入数据实体页面。
- 单击需要修改功能规则的数据实体编码，进入该数据实体详情页面。
- 选择“功能配置”页签，进入功能配置页面。
- 根据数据实体的状态，单击“编辑”或“修订”，进入编辑状态。
- “状态”为“正在工作”的数据实体，单击“编辑”。
- “状态”为“已发布”的数据实体，单击“修订”。
- 找到需要修改规则的功能，修改其对应规则，单击“保存”。
如果之前设置的规则已在数据实体中发布，那么在修改这些功能规则时，可能会存在如下限制和影响：
表3 修改功能配置的限制与影响 功能
限制与影响
版本服务
不支持修改流水码的类型。
多维版本
不支持修改或删除多维版本及其对应生成的多维版本属性。
业务编码生成器
- 不支持修改或删除“流水码”编码段。
- 如果修改了业务编码生成规则，后续在应用运行态新增的实例数据按照新规则生成业务编码。
- 如果只修改已绑定属性，未修改业务编码生成规则，后续在应用运行态新增的实例数据仍沿用原规则在新属性上生成业务编码。
树形结构
-
生命周期管理
-
扩展属性
- 只支持修改扩展属性的数量、是否索引，不支持修改扩展属性的属性类型、文本长度和扩展表名称。
- 不支持删除扩展属性。
联合索引管理
-
