华为云用户手册

审批历史 “审批历史”页面展示您在流程引擎审批流程的操作记录，您可以通过此功能追溯历史审批记录，并查看审批详情。 默认情况下，审批历史列表展示当前用户的全部历史审批任务，包括：任务名称、流程元模板、流程状态、生命周期、创建人、发起时间及结束时间等。 图4 审批历史 此外，您还可以进行如下操作： 表4 “审批历史”相关操作 操作 描述 搜索历史审批任务 为了帮助您快速查询出与您相关的历史审批任务，您可以参考如下说明进行筛选。 任务名称：可通过审批任务的名称进行筛选。 流程元模板：可通过流程元模板的名称进行筛选。 流程状态：支持按挂起、未完成、已完成及取消进行筛选。 创建人：可通过审批任务的创建人进行筛选。 结束时间：您可以自定义历史审批任务的发起时间和结束时间进行筛选。 查看历史审批任务详情 通过单击对应历史审批任务的“任务名称”进行查看。

我的申请 您可以在“我的申请”页面查看已发起的流程任务，包括：主题、流程元模板、流程状态、生命周期、创建人、发起时间及结束时间等。 图2 我的申请 此外，您还可以对已发起的流程任务进行如下操作。 表2 “我的申请”相关操作 操作 描述 查看流程任务详情 单击流程任务所在行的“主题”。 进入执行流程任务页面，即可查看流程的执行进展。 搜索流程任务 为了帮助您快速查询出您发起的流程任务，您可以参考如下说明进行筛选。 主题：可通过流程任务的名称进行筛选。 流程元模板：可通过流程元模板的名称进行筛选。 流程状态：支持按挂起、未完成、已完成及取消进行筛选。 发起时间：您可以自定义流程任务的发起时间和结束时间进行筛选。

我的待办 您可以在“我的待办”页面查看需要自己审批的流程任务，包括：任务名称、流程元模板、生命周期、创建人、发起时间及操作等。 图1 我的待办 除审批流程任务以外，您还可以对待审批的流程任务进行如下操作。 表1 “我的待办”相关操作 操作 描述 搜索流程任务 为了帮助您快速查询出您待审批的流程任务，您可以参考如下说明进行筛选。 任务名称：可通过流程任务的名称进行筛选。 流程元模板：可通过流程元模板的名称进行筛选。 创建人：可通过审批任务的创建人进行筛选。 发起时间：您可以自定义流程任务的发起时间和结束时间进行筛选。 转审流程任务 单击流程任务所在行的。 在弹出的“转审”窗口中，输入转审人账号，单击“确定”。

步骤2：添加索引 索引定义是使用搜索服务定义的必要条件，只有添加索引才能对模型数据进行检索，而且不同的索引规则也会产生不同的模型数据检索效果。应用运行态支持文本、日期、浮点型、长整型和联合索引四种类型索引。 选择“索引定义”页签，单击“添加索引”。 图2 添加索引 根据业务需求，设置如下索引规则，单击“保存”。 图3 填写索引信息 文本索引 配置项 说明 索引名称 索引的名称。 索引描述 索引的描述。 索引类型 选择“文本”。 分词方法 为索引设置分词方法后，xDM-F会将可分词的内容根据设定的分词方法分成多个词。 不分词：一般用于ID、CODE或短名称字段，支持精确匹配。 普通分词：基于系统分词进行公共分词。例如“工业数字模型驱动引擎-数据建模引擎”会分为“工业数字模型驱动引擎/数据建模引擎”。 英文普通分词：对于英文内容，进行空格分词；对于中文内容，进行中文单字分词。 最全分词：介于普通分词和单字分词之间。例如“工业数字模型驱动引擎-数据建模引擎”，会分为：工业、数字模型、驱动、引擎。 单字分词：一般用于短文本的搜索，用于提升召回率。例如“工业数字模型驱动引擎-数据建模引擎”会分为“工/业/数/字/模/型/驱/动/引/擎”。 分隔符分词：按照分隔符分词，结合“分词选项”使用。 分词选项 如“分词方法”选择“不分词”或“最全分词”，该参数为“不涉及”，不可选。 如“分词方法”选择“普通分词”或“单字分词”，可选择不涉及、全拼、简拼和全拼+简拼。 如“分词方法”选择“英文普通分词”，可选择不涉及、词干化和词形还原。 词干化表示将单词的词缀部分去掉，从而得到单词的词干部分。例如，使用beauty搜索出beautiful。 词形还原表示将一些名词的复数去掉，或将动词的不同时态去掉等。例如，使用apples搜索出apple，使用doing/dose搜索出do。 如“分词方法”选择“分隔符分词”，可选择空格分词、逗号分词和分号分词。 作为过滤条件 是否将索引作为过滤条件。 Y：是。如果选择Y，iDME会将索引值作为过滤条件，对搜索内容进行过滤。 N：否。 参与关键词搜索 是否参与关键词搜索。 Y：是。例如，设置姓名和描述参与关键词搜索，关键词是“小明”，可搜索姓名或描述为“小明”的搜索结果。 N：否。 展示 是否展示。 Y：是。如果选择Y，则在搜索服务API的出参中展示。 N：否。 匹配方法 文本索引支持的匹配方式如下： 精确匹配：只会匹配与输入内容完全一致的内容。 模糊匹配：对输入内容进行拆分字、形似字、音似字、大小写等形式的相似字匹配。 短语匹配：是一种精确匹配短语（多个单词以特定顺序排列）的查询方式，分词后多个词的位置关系会被考虑。只有分词后的多个词在行数据中以同样的顺序和位置存在时，才表示行数据满足查询条件。如果“分词方法”为“单字分词”，“分词选项”为“不涉及”，使用短语匹配可以实现相关度更高的模糊查询。 例如字段值是“工业数字模型驱动引擎”，查询字段是“工业模型”，如果是模糊匹配，则可以匹配到该行数据，但是如果是短语匹配查询，则不能匹配到该行数据，因为“工业”和“模型”在查询字段中的距离是0，但是在行数据中的距离是2（“数字”两个字导致间隔距离是2）。 如“作为过滤条件”和“参与关键词搜索”均选择“N”，该参数不可选。 日期索引 配置项 说明 索引名称 索引的名称。 索引描述 索引的描述。 索引类型 选择“日期”。 作为过滤条件 是否将索引作为过滤条件。 Y：是。如果选择Y，iDME会将索引值作为过滤条件，对搜索内容进行过滤。 N：否。 参与关键词搜索 是否参与关键词搜索。 Y：是。例如，设置姓名和描述参与关键词搜索，关键词是“小明”，可搜索姓名或描述为“小明”的搜索结果。 N：否。 展示 是否展示。 Y：是。如果选择Y，则在搜索服务API的出参中展示。 N：否。 匹配方法 日期索引支持的匹配方式如下： 精确匹配：只会匹配与输入内容完全一致的内容。 范围匹配：根据设置的查询范围进行匹配。 如“作为过滤条件”和“参与关键词搜索”均选择“N”，该参数不可选。 浮点型索引 配置项 说明 索引名称 索引的名称。 索引描述 索引的描述。 索引类型 选择“浮点型”。 作为过滤条件 是否将索引作为过滤条件。 Y：是。如果选择Y，iDME会将索引值作为过滤条件，对搜索内容进行过滤。 N：否。 参与关键词搜索 是否参与关键词搜索。 Y：是。例如，设置姓名和描述参与关键词搜索，关键词是“小明”，可搜索姓名或描述为“小明”的搜索结果。 N：否。 展示 是否展示。 Y：是。如果选择Y，则在搜索服务API的出参中展示。 N：否。 匹配方法 浮点型索引支持的匹配方式如下： 精确匹配：只会匹配与输入内容完全一致的内容。 模糊匹配：对输入内容进行拆分字、形似字、音似字、大小写等形式的相似字匹配。 范围匹配：根据设置的查询范围进行匹配。 如“作为过滤条件”和“参与关键词搜索”均选择“N”，该参数不可选。 长整型索引 配置项 说明 索引名称 索引的名称。 索引描述 索引的描述。 索引类型 选择“长整型”。 作为过滤条件 是否将索引作为过滤条件。 Y：是。如果选择Y，iDME会将索引值作为过滤条件，对搜索内容进行过滤。 N：否。 参与关键词搜索 是否参与关键词搜索。 Y：是。例如，设置姓名和描述参与关键词搜索，关键词是“小明”，可搜索姓名或描述为“小明”的搜索结果。 N：否。 展示 是否展示。 Y：是。如果选择Y，则在搜索服务API的出参中展示。 N：否。 匹配方法 长整型索引支持的匹配方式如下： 精确匹配：只会匹配与输入内容完全一致的内容。 模糊匹配：对输入内容进行拆分字、形似字、音似字、大小写等形式的相似字匹配。 范围匹配：根据设置的查询范围进行匹配。 如“作为过滤条件”和“参与关键词搜索”均选择“N”，该参数不可选。 联合索引 配置项 说明 索引名称 索引的名称。 索引描述 索引的描述。 索引类型 选择“联合索引”。 运算符 联合索引支持如下逻辑运算符： 与：逻辑与，返回与联合索引所含字段条件完全匹配的数据。 或：逻辑或，返回与联合索引所含任一个字段匹配的数据。 分隔符 iDME支持多种分隔符，常见的分隔符有空格、制表符、逗号、分号、竖线等。如果您未设置分隔符，返回结果默认使用“/”进行分隔。 分词方法 为索引设置分词方法后，xDM-F会将可分词的内容根据设定的分词方法分成多个词。 不分词：一般用于ID、CODE或短名称字段，支持精确匹配。 普通分词：基于系统分词进行公共分词。例如“工业数字模型驱动引擎-数据建模引擎”会分为“工业数字模型驱动引擎/数据建模引擎”。 英文普通分词：对于英文内容，进行空格分词；对于中文内容，进行中文单字分词。 最全分词：介于普通分词和单字分词之间。例如“工业数字模型驱动引擎-数据建模引擎”，会分为：工业、数字模型、驱动、引擎。 单字分词：一般用于短文本的搜索，用于提升召回率。例如“工业数字模型驱动引擎-数据建模引擎”会分为“工/业/数/字/模/型/驱/动/引/擎”。 分隔符分词：按照分隔符分词，结合“分词选项”使用。 分词选项 如“分词方法”选择“不分词”或“最全分词”，该参数为“不涉及”，不可选。 如“分词方法”选择“普通分词”或“单字分词”，可选择不涉及、全拼、简拼和全拼+简拼。 如“分词方法”选择“英文普通分词”，可选择不涉及、词干化和词形还原。 词干化表示将单词的词缀部分去掉，从而得到单词的词干部分。例如，使用beauty搜索出beautiful。 词形还原表示将一些名词的复数去掉，或将动词的不同时态去掉等。例如，使用apples搜索出apple，使用doing/dose搜索出do。 如“分词方法”选择“分隔符分词”，可选择空格分词、逗号分词和分号分词。 作为过滤条件 是否将索引作为过滤条件。 Y：是。如果选择Y，iDME会将索引值作为过滤条件，对搜索内容进行过滤。 N：否。 参与关键词搜索 是否参与关键词搜索。 Y：是。例如，设置姓名和描述参与关键词搜索，关键词是“小明”，可搜索姓名或描述为“小明”的搜索结果。 N：否。 展示 是否展示。 Y：是。如果选择Y，则在搜索服务API的出参中展示。 N：否。 匹配方法 联合索引支持的匹配方式如下： 精确匹配：只会匹配与输入内容完全一致的内容。 模糊匹配：对输入内容进行拆分字、形似字、音似字、大小写等形式的相似字匹配。 短语匹配：是一种精确匹配短语（多个单词以特定顺序排列）的查询方式，分词后多个词的位置关系会被考虑。只有分词后的多个词在行数据中以同样的顺序和位置存在时，才表示行数据满足查询条件。如果“分词方法”为“单字分词”，“分词选项”为“不涉及”，使用短语匹配可以实现相关度更高的模糊查询。 例如字段值是“工业数字模型驱动引擎”，查询字段是“工业模型”，如果是模糊匹配，则可以匹配到该行数据，但是如果是短语匹配查询，则不能匹配到该行数据，因为“工业”和“模型”在查询字段中的距离是0，但是在行数据中的距离是2（“数字”两个字导致间隔距离是2）。 如“作为过滤条件”和“参与关键词搜索”均选择“N”，该参数不可选。

步骤2：设置阶段信息 单击“检出”。 图3 检出生命周期模板 单击“更新”。 图4 更新生命周期模板 选择“阶段信息”页签，单击。 图5 阶段信息 在弹出的窗口中，勾选生命周期模板需要添加的状态，单击“确定”。 图6 添加状态 根据实际的生命周期操作流程，选择、、、、、或，将添加的状态以及开始/结束阶段进行关联。 图7 关联状态 在弹出的窗口中，为关联的状态设置业务操作，单击“确定”。 图8 设置业务操作 表2 设置业务操作 参数 参数说明 业务操作 指定业务操作。 如果没有可选择的业务操作，可参见创建业务操作进行创建。 操作类型 支持设置状态、更新、撤销检出、检入、修订、新建和检出。 单击。 图9 保存生命周期模板

登录体验版流程引擎 登录iDME控制台。 在左侧导航栏中，单击“数据建模引擎”，进入数据建模引擎页面。 （可选）如果同时有部署在公有云上和边缘云上的运行服务，请切换到公有云。 在“公有云运行服务”列表中，找到已部署至体验版数据建模引擎的应用，单击“登录运行态”，进入应用运行态。 您也可通过服务名称链接进入详情页后，在页面右上角单击“登录运行态”。 在左侧导航栏中，单击“流程引擎”，即可进入“流程引擎”页面。

登录基础版流程引擎 首次登录基础版流程引擎之前，您需要在iDME控制台配置相应信息，具体操作请参见配置流程引擎访问。 登录iDME控制台。 在左侧导航栏中，单击“数据建模引擎”，进入数据建模引擎页面。 （可选）如果同时有部署在公有云上和边缘云上的运行服务，请切换到公有云。 在“公有云运行服务”列表中，找到待操作的基础版数据建模引擎，在其后单击更多图标，在弹出的下拉菜单中单击“访问流程引擎”。 您也可通过服务名称链接进入详情页后，展开“运行服务详情”，在“运行服务信息”的“流程引擎”处，单击“立即访问”。 图1 访问流程引擎 输入部署应用绑定组织时，所选择的运行服务管理员的账号和密码，单击“登录”。 图2 登录页面

初识UI编辑页面 图1 初识UI编辑页面 表1 各模块功能介绍 功能 描述 顶部导航栏 包含前往流程引擎、编辑模式切换、保存等基本功能。 工具栏 包含页面名称、多种画布工具、语言切换等。 插件栏 包含物料、大纲树、国际化、页面JS、状态管理、资源管理等插件。 导航树栏 包含了流程导航树的节点切换、预览等功能。 画布 对页面中的组件进行编辑、实时效果预览。 组件属性面板 展示和管理组件的属性和配置信息、自定义事件等，以便于统一管理和操作。 组件层级面包屑 展示完整的组件层级。

工具栏详细介绍 UI编辑器中的顶部工具栏从左至右包括如下功能按钮。 图2 工具栏 表3 工具栏 图标 名称 说明 页面名称 展示当前页面名称。 画布清除工具 清空当前画布页面相关的所有信息（如页面schema、页面状态、页面JS等配置）。 画布刷新工具 刷新当前页面信息，重新载入页面。 预览工具 在浏览器中打开新的标签页，预览当前编辑好的页面。 撤销工具 撤销当前操作并回退至上一步操作时的状态。 重做工具 恢复上一步操作并回到上一次撤销前的状态。 全屏工具 将当前页面全屏显示（和网页全屏功能一样）。 中英文切换工具 单击可切换页面中英文显示。

操作场景 当您发布数据模型和发布应用后，系统会在全量数据服务中预生成与其相应的API，您可以在应用设计态预览各类API的详细信息。 支持通过如下方式进行查看： 离线方式：将应用设计态的全量数据服务API导出至本地计算机进行查看（推荐），具体操作请参见导出API。 在线方式：在应用设计态上在线查看。 如需查看应用完整的全量数据服务API，需将应用部署至数据建模引擎后，前往应用运行态查看，具体操作请参见部署应用和全量数据服务。

注意事项 导入文件只支持Excel类型文件，结尾处需标注#EOF。 单次批量导入的关系实体数量不能超过500个。 导入的关系实体或属性若已存在则进行更新或修订，若不存在则进行创建。 导入的关系实体如存在参考对象，导入时支持自动解耦。 导入关系实体时，系统会对如下相关数据进行修正。 如果导入的关系实体属性类型为“文件”类型，会将“值可变”修正为“是”。 如果导入的关系实体属性类型不是“文本”类型，会将“值存储方式”置空。 如果导入的关系实体属性已被发布，则该属性的“入库”参数不会进行更新。此外， 如果该属性类型为“参考对象”类型，则该属性的参考对象信息（参考对象的英文名称、ID和类型）和“组合关系”参数也不会进行更新。 如果该属性类型为“浮点型（自定义精度）”类型，则该属性的“单位类型”参数的英文名称也不会进行更新。 如果该属性类型为“文件”类型，则该属性的“存储方式”和“必填”参数也不会进行更新。 如果该属性类型为“枚举”类型，则该属性的“枚举类型ID”参数也不会进行更新。

使用说明 使用全量数据服务API对数据实体/关系实体进行实例化时，会存在如下约束与限制： 如果入参参数为Collection、map或Array类型，单次最多传入1000个对应类型的参数值。 枚举、分类、JSON、参考对象、浮点型（自定义精度）和文件类型属性的入参值不允许为空字符串；文本、长文本、URL和人员类型属性的入参值允许为空字符串，返回结果会返回该空字符串。 如果输入的浮点型（自定义精度）类型属性值超过自定义标度，会先四舍五入到指定标度后再校验。 如果存在“多值”为“是”的枚举类型扩展属性，入参不允许输入[""]。 如果您想将 数据实例 中自定义的属性（包括基本属性和扩展属性）设置为空值，可在调用数据实体/关系实体的update、batchUpdate、save、saveAs和saveAll接口时，在“needSetNullAttrs”参数中对非必填属性进行设置。 调用数据实体/关系实体的创建类接口（如create、batchCreate、save、saveAs和saveAll）时， 已设置默认值的属性未输入入参值，返回结果会返回该默认值。 未设置默认值的整型、长整型、浮点型、日期和布尔值类型属性，如果入参值为空字符串，返回结果会返回空值（即NULL）。 调用数据实体/关系实体的更新类接口（如updateByAdmin、update、reviseAndUpdate、checkoutAndUpdate、updateAndCheckin、updateByCondition、save、saveAll、batchUpdateByAdmin、batchReviseAndUpdate、batchCheckoutAndUpdate和batchUpdateAndCheckin）时， 如果存在“值可变”为“否”的属性，其返回结果会返回原值。 整型、长整型、浮点型、日期和布尔值类型属性，如果入参值为空字符串，返回结果会返回原值。 调用save和saveAs接口时，如果入参值为NULL或未输入入参值，其返回结果会返回原值。 调用saveAll接口时，基本属性的入参值会强覆盖，扩展属性的入参值不会强覆盖。即：如果基本属性未输入入参值，其返回结果会返回NULL；如果扩展属性未输入入参值，其返回结果会返回原值。 调用find接口查询“入库”为“否”的属性时，如果对应属性未设置默认值，其返回结果会返回NULL。 支持调用数据实体/关系实体的saveAs接口另存该实体的数据实例。 如果实体具有生命周期管理功能，在为该实体创建数据实例时，不能绑定“状态”为“工作中”的生命周期模板。 如果实体具有结构化文档管理功能，该实体下的每个数据实例最多只能创建200个结构化文档。

搜索流程元模板 默认情况下，流程元模板页展示的是当前应用下全部流程元模板。为了帮助用户快速搜索出当前应用下的流程元模板，xDM-F提供搜索流程元模板功能，目前可通过英文名称、中文名称、模板状态、创建者以及更新者等属性维度进行过滤。 根据实际业务需求，设置筛选条件，单击“搜索”，即可获取对应流程元模板。 图7 搜索流程元模板 筛选条件说明如下： 英文名称：可通过流程元模板的英文名称进行筛选。 中文名称：可通过流程元模板的中文名称进行筛选。 模板状态：支持按照工作中、审核中和已发布筛选。 创建者：可通过创建流程元模板的用户名筛选。 更新者：可通过更新流程元模板的用户名筛选。 是否生效：支持按照是和否筛选。

设置显示配置（可选） 假设存在一个属性绑定了当前值集，在“数据实例”页面创建或更新实例时，您希望同时展示当前值集所选择的指定实体的其他属性，或者当前值集的可选值较多，您希望可以指定默认展示数据量。此时，您可以通过如下配置实现。 选择“显示配置”页签，根据实际业务需求，配置如下信息。 图1 设置显示配置 表3 显示配置参数说明 参数 说明 附加显示字段 用于在创建或更新数据实例页面选择属性值时展示额外信息，协助用户更准确地定位及选择实例数据。 首次添加显示字段时，请单击“增加字段”，选择需要附加显示的属性。后续可通过单击/管理已添加的附加显示字段，至多可添加5个附加显示字段。 说明： 只能选择当前值集关联实体的基本属性，且不能选择值集值字段已选择的属性。 列表展示数量 默认展示20条数据，您可以根据实际业务需求自定义设置，至多设置展示1000条数据。 预览 单击下拉列表，即可快速预览展示效果。 单击“保存”。

操作场景 当工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）提供的功能不能满足用户的需求时，支持用户自定义接口模型。接口模型可被数据实体作为父继承，继承其属性和关系。通过接口模型，实现建模时对各类型模型的公共特性进行抽象&接口化。例如，单板、整机、设备等实体均包含BOM编码、生产日期和资产编码属性，用户可创建一个接口模型，包含这三个属性。而创建实体时，勾选该接口模型即可。

注意事项 当前仅支持用户编辑XDM应用内置数据实体和内置关系实体的基本属性。如果内置模型为M-V模型实体，基本属性中的服务编码不支持编辑。 支持对内置模型ClassificationNode、EXADefinition、Folder、legalValue、legalValueType、LifecycleTemplate、MeasuringUnit和searchservicedefine的“英文描述”（即“DescriptionEn”参数）输入中文字符。

操作场景 隔离的安全程度分为物理隔离和逻辑隔离。其中，逻辑隔离更多面向企业内部的多租需求，在该形态下默认不存在恶意租户，隔离是为了内部团队间的业务保护和对可能的安全攻击进行防护。 您可以使用工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）在XDM应用中预置的“Tenant”数据实体来实现逻辑多租，在租户之间实现逻辑分离。 唯一编码为“-1”的“basicTenant”数据实例是xDM-F的默认租户，应用运行态默认在“basicTenant”租户下调用API和管理应用的模型数据。 本文指导您在应用运行态管理“Tenant”数据实体的实例数据。

接口模型 xDM-F内置了多种功能，在创建数据实体/关系实体时，不仅自具备从xDM-F继承的基本功能能力，还可根据实际业务需求勾选xDM-F提供的可选功能，每个功能会继承一个或者多个属性。每勾选一个功能，该实体会自动生成相应功能继承的一个或者多个属性。当xDM-F内置的功能无法满足您实际业务需求时，可通过接口模型进行定义。自定义的接口模型将作为自定义功能，在创建数据实体时，被数据实体通过勾选自定义功能的方式被继承和使用。 在已经确定的应用数据模型结构上，需要对具有相似功能、相似结构、相同属性的数据模型进行归一化处理，可通过接口模型定义这些相似功能、相似结构和相同属性。为这些数据模型提供了标准接口，降低参数的重复性，方便管理模型属性。 例如机械产品中，各部件间有一部分是通过销、铆钉、螺栓等常用标准件直接连接，有一部分是通过联轴器、减速器等部件间接连接。尽管这些常用的零部件大多都已经实现系列化或标准化，但这些零部件易损坏，产品在多次更换过程中需要反复操作和记录。您可以分别创建包含这些具有相似功能的零部件接口模型，然后在创建数据实体时，勾选对应接口模型即可继承该接口模型的属性和关系。

使用说明 任何实体均可与xDM-F元模型建立关系。 单个数据模型（包括数据实体、关系实体和接口模型）下的属性数量不允许超过1664个。如果应用的数据库类型为mysql，则单个数据模型（包括数据实体、关系实体和接口模型）下，其属性总长度不允许超过16000个字符。 创建数据模型时，该模型名称不能和XDM应用中的模型名称相同。 如果数据实体与抽象模型建立关系实体，该抽象模型的所有子实体模型均建立或继承了关系。 如果数据实体与存在扩展子模型的数据实体建立关系实体，该数据实体的所有扩展子模型均继承关系实体。 如果数据实体与接口模型建立关系实体，引用该接口模型的所有数据实体均建立了关系（接口模型不能直接作为父模型被其他实体模型继承，需先在功能列表中添加）。

关系实体 关系实体用于描述两个或更多数据实体相互如何关联，是xDM-F原子接口的承载体之一。 基于xDM-F支持的数据关系，提供如下关系类型： 表3 元模型关系 类型 说明 1:N组合关系 又称“参考关系”，主要用于为对象之间建立1:N或主外键关系，可分为： 组合关系：1:N组合关系，即整体和部分的关系。例如公司和部门，如果公司不存在了，部门也不存在了。 非组合关系：1:N聚合关系，即普通的1:N参考关系或主外键关系。例如部门和员工，一个部门有多个员工。 在创建属性时，将属性的“类型”定义为“参考对象”，则属性对应的数据模型具有参考关系。 适用于传统主外键数据的关联。例如，一个部门可以有多个员工，它们之间为一对多聚合关系；公司是部门的父项，部门随着公司而存在，它们之间为一对多组合关系。 说明： 仅支持“模型类型”为“实体模型”的单实体定义组合关系的参考对象属性，“模型类型”为“抽象模型”的单实体、M-V模型实体和关系实体仅支持定义非组合关系的参考对象属性。 1:N聚合关系 M:N关系 即多对多关系，用于为数据实体/接口模型建立M:N关系。 创建关系实体时，“关系类型”为“多对多”的关系实体均具有此关系能力。可为应用运行态提供：创建/删除关系实体实例，查询关系实体，获取关联实体/被关联实体清单等操作。 适用于为不同数据实体/接口模型建立多对多关系。例如，在汽车电器相关的零件开发中，工程师和零件开发为多对多关系。一个工程师可进行多个零件开发，一个零件可由多个工程师进行开发。 M:xN关系 又称“单边不确定关系”，用于为一边不确定的数据实体/接口模型建立M:N关系，不确定的数据实体或接口模型（目标端）默认为基类抽象模型“basicObject”。 创建关系实体时，“关系类型”为“单边不确定”的关系实体均具有此关系能力。可为应用运行态提供：创建/删除关系实体实例，查询关系实体，查询目标端对象等操作。 适用于基础数据与业务数据的关联。例如，标签数据与业务数据的关联。标签可给任何对象打标签，在创建实例时确定打标签的目标端对象。 UsageLink使用关系 又称“多叉树关系”，适用于实现复杂的数据结构的存储，高效地查找数据，方便管理节点数据的场景。例如，部件和部件之间的使用和被使用关系。一辆汽车有四个轮子，汽车和轮胎都是部件，创建一个关系实体承载汽车和轮胎的使用关系，并在关系实体上定义一个“使用数量”属性用于标识一辆汽车使用了四个轮胎。 自循环树形关系 又称“树形结构”，是数据对象之间存在着“一对多”的树形关系的数据结构，适用于数据间上下级的关联。例如，企业的组织结构、软件应用的结构、工作计划、项目管理等。 创建数据实体/关系实体时，通过勾选xDM-F内置的“树形结构”、“分类管理”、“文件夹管理”等能力实现。

数据实体 实体指现实世界中客观存在的并可以相互区分的对象或事物，可以是具体的人、事或物，也可以是抽象的概念或联系。这些独立事物个体的特性称为实体属性，每个实体都具有多个属性。在xDM-F中，这些独立的事物个体都可以看做是数据实体。数据实体是xDM-F原子接口的承载体之一，用于定义数据对象的基本信息、业务属性以及配置所需的功能（如基础数据服务、树形结构、生命周期管理等）。 数据实体按元模型类型的维度分为如表1所示类型。 表1 元模型实体 类型 说明 独立实体 又称“单实体”，适用于关系上不依附、不隶属，单独存在的业务对象。例如，企业的组织架构、部门、机房等。 创建数据实体时，“父模型”为“BusinessObject”或“BasicObject”的数据实体均为单实体。 多版本实体 又称“Master-Version（M-V）模型实体”，适用于只对同一业务对象进行局部的改进，或者需要对业务对象的历史演变过程进行记录和维护。例如，研发过程的技术文档、部件等业务对象会不断修改，需要能够随时查看历史版本数据及修改记录。 创建数据实体时，“父模型”为“VersionObject”的数据实体均为M-V模型实体。

步骤3：功能配置（可选） 不同类型的数据实体支持的基础功能和可选功能不同，您可根据实际的业务场景，在“功能配置”中设置相应功能的规则。如果系统提供的默认功能配置已满足您实际的业务需求，可跳过此步骤。 选择“功能配置”页签，进入功能配置页面。 根据实际需求，设置如下主要信息。 图6 功能配置 表3 功能配置-参数说明 类型 参数 参数说明 设置规则 版本服务 M-V模型实体中Version模型实体（版本对象）的默认功能，用于自定义版本号生成规则。如果在填写基本信息时，“父模型”选择为“VersionObject”，可在“功能配置”中设置“版本服务”的规则。关于M-V模型的内容请参见什么是M-V模型？。 流水码：默认为“字母（不包含I、O、Z）”。 前缀：可以选择当前实体提供的属性，可以手动输入版本号的前缀，也可以选择分隔符“-”和“_”。 后缀：可以选择分隔符“-”和“_”，可以选择当前实体提供的属性，也可以手动输入版本号的后缀。 多维版本 M-V模型实体中Version模型实体（版本对象）的可选功能，用于以不同视角差异化管理同一个数据对象。如果在填写基本信息时，“父模型”选择为“VersionObject”，且“功能列表”添加了“多维视图&多维分支”功能，可在“功能配置”中设置“多维版本”。一个M-V模型实体至多可添加3个多维版本。 单击“新增”，设置如下信息，定义多维版本。 属性英文名称：填写多维版本的英文名称。 属性中文名称：填写多维版本的中文名称。 参考对象：选择参考对象的目标端（数据实体）。 必填：设置该多维版本是否必填，默认为“是”。 当您发布数据实体时，该实体会根据新增的多维版本自动在基本属性中生成对应的多维版本属性。 将具有“多维视图&多维分支”功能的M-V模型实体部署至运行态后，您可以通过调用API的方式创建多维版本实例，具体操作请参见创建多维版本的数据实例。 业务编码生成器 如果在填写基本信息时，“功能列表”添加了“业务编码生成器”，可在“功能配置”中设置“业务编码生成器”的生成规则。 生成的业务编码由自定义字段1自定义字段2...自定义字段10生成，初始业务编码值可在业务编码生成器的说明中查看。 说明： 当数据实体的“父模型”为自定义的抽象模型且配置了业务编码生成器功能，数据实体如需使用父模型的业务编码生成规则，可保持默认配置（即“选择绑定属性”为空），即可继承父模型的业务编码生成规则。 如果数据实体更新了父模型，该数据实体支持的业务编码生成器功能会被删除，需重新配置业务编码生成器功能。 选择绑定属性： 如果您没有可使用的属性，请新增一个“类型”为“文本”，“唯一键”为“是”的属性，具体操作可参见管理数据实体属性。 如果您已有可使用的属性，请选择需要绑定的属性。 自定义字段：支持如下字段，请根据实际业务需求进行选择。如需设置多个自定义字段，可单击“添加编码段”进行添加，至多只能添加10个自定义字段。如需调整自定义字段排序，将需要调整的自定义字段拖动至所需位置后松开鼠标即可。 常量：输入自定义常量，例如下划线（_）、中横线（-）。 流水码：支持“字母”、“数字”和“数字+字母”，请根据实际业务进行选择。 如果“流水码”为“字母”：需设置流水码位数和初始流水码，还支持设置需要排除的字母。 如果“流水码”为“数字”：需设置流水码位数和初始流水码。 如果“流水码”为“数字+字母”：需设置流水码位数和初始流水码，还支持设置需要排除的字母。 其中，“流水码位数”只能为1~9的正整数，“初始流水码”只能为≥0的整数，且初始流水码的长度不能超过流水码位数。 属性：选择当前实体可使用的属性。 如果当前实体是单实体，不可使用的属性包括：ID属性，“类型”为“参考对象”、“URL”、“文件”、“JSON”、“枚举”（约束信息的“多值”为“是”）、“人员”（约束信息的“多值”为“是”）和“文本”（约束信息的“值加密”为“是”）的属性。 如果当前实体是M-V模型，不可使用的属性包括：ID属性，Iteration属性，Master属性，Version属性，Branch属性，“类型”为“参考对象”、“URL”、“文件”、“JSON”、“枚举”（约束信息的“多值”为“是”）、“人员”（约束信息的“多值”为“是”）和“文本”（约束信息的“值加密”为“是”）的属性。 日期：日期格式，支持“YYYY”、“YYMM”、“YYMMDD”和“YYYYMMDD”。其中，Y表示年，M表示月，D表示日。 树形结构 如果在填写基本信息时，“功能列表”添加了“树形结构”，可在“功能配置”中设置“树形结构”的规则。 指定全路径字段：仅支持选择文本类型或数值类型的属性，为树形节点全路径绑定属性。建议选择ID字段的属性，如将全路径字段选择为非ID字段属性，可能会影响后续对树形结构相关接口的调用。 配置完成后，在应用运行态创建实体的数据实例时，会根据您填写的父节点信息，自动填充其全路径字段（fullPath，以指定属性构建的从根到叶子节点全路径）、原始全路径字段（rawFullPath，以ID属性构建的从根到叶子节点全路径）；更新实体的数据实例时，会根据您填写的父节点信息，自动更新其全路径信息、原始全路径信息，更新方式为非实时性的异步任务（待异步任务执行完成后，刷新路径信息）。 生命周期管理 如果在填写基本信息时，“功能列表”添加了“生命周期管理”，可在“功能配置”中设置“生命周期管理”的规则。 单击“新增”，设置如下信息，用于约束运行态应用下的生命周期管理。如未新增，默认使用“LifecycleTemplate”生命周期模板。 模板属性定义：自定义模板属性的英文名称、中文名称、英文描述和中文描述，选择出厂默认生命周期模板。如果您没有可选择的生命周期模板，可先输入出厂默认生命周期模板名称，待数据实体部署至运行态后，再在运行态创建同名的生命周期模板。具体操作请参见创建生命周期模板。 状态属性定义：自定义状态属性的英文名称、中文名称、英文描述和中文描述。 扩展属性 如果在填写基本信息时，“模型类型”选择为“实体模型”，“功能列表”添加了“扩展属性”，可在“功能配置”中设置“扩展属性”的规则，用于约束应用运行态下该实体可添加的扩展属性类型数量、文本长度等配置。 单击“新增”，参考如下说明进行设置。 属性类型：用于约束应用运行态下该实体可添加的扩展属性类型。当前支持选择文本、长文本、整型、长整型、浮点型、浮点型（自定义精度）、布尔值、日期、枚举、分类、URL、文件和参考对象类型。 数量：用于约束应用运行态下该实体可添加对应扩展属性类型的数量。 如果应用的数据库类型为mysql，文本、长文本、布尔、日期、分类类型的属性数量不可超过200个，整型、长整型、浮点型、浮点型（自定义精度）类型的属性数量不可超过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，提供调用。 单击“保存”。

使用说明 支持在iDME已适配的数据库类型间的应用同步。即：如果源应用和目标应用都属于iDME应用，支持不同类型数据库间的应用同步。 如果目标应用中存在具有“多维视图&多维分支”功能的同名数据模型，不支持同步没有“多维视图&多维分支”功能的同名数据模型。 在工业数据模型模板库生成的同步任务不支持下载离线文件。如果应用中存在同名的数据模型或者枚举类型，“工作中”的同名数据模型会直接被发布，并修订更新新版本，“已发布”的数据模型直接修订更新新版本，同名枚举类型。 租户需要具有源应用和目标应用的“应用责任人”或“应用开发人员”权限。 一个目标应用仅支持创建一个“未启动”或“执行中”状态的同步任务。 系统每天凌晨2点自动清理超过一年且“状态”为“已完成”的应用同步任务，为避免所需的应用同步任务或离线文件超出保留时间被删除，请及时备份应用同步任务，以及下载所需离线文件至本地。

策略集 策略集是一个容器，是您创建的参与者、数据模型、权限规则和操作类型相互关联的权限策略集合。当应用进行鉴权时，系统将在您指定的策略集中寻找权限策略，来确定参与者是否具有相应权限。更多关于策略集的操作请参见策略集。 xDM-F内置的“adhoc”和“function”策略集不允许编辑、删除或添加子策略集。 此外，文件夹具有策略集继承的功能，子文件夹的策略集可以继承父文件夹的策略集，也可以自定义。更多关于文件夹的操作请参见文件夹。

参与者 参与者一般指的是在系统之外与系统交互的某人或某角色，在xDM-F中，参与者指的是对搜索服务定义、“权限管理”功能的数据模型与其数据实例等操作的某人或某角色。xDM-F当前提供如表1所示的参与者类型。 表1 参与者类型 类型 说明 团队角色 指一个人在团队中某一职位上应该承担的责任，例如某业务团队的业务经理、业务组长、业务人员和业务代表。 一个团队可以引用多个团队角色，一个团队角色可以被多个团队引用。 只有被引用的团队角色才可以在团队中为该团队角色添加角色成员。 群组 指将用户按照子公司、部门、项目等维度划分为不同的群组，使群组下的全部用户获得相应的权限，方便统一权限管理。 全局角色 指用于管理xDM-F全局功能的操作权限或者某个子模块最高权限的角色，例如超级管理员、系统管理员、安全管理员、质量管理员、数据源管理员等。 虚拟角色 xDM-F在团队角色中预置了所有人、拥有者和团队成员三种虚拟角色。 所有人：指应用下的所有用户，即“XDMUser”数据实体的所有数据实例。 拥有者：指数据实例的所有者，即创建某个数据实例时指定的所有者。 团队成员：指某个团队下的某个用户。例如某医院的护士团队、急诊医生团队、外科医生团队等，每个团队中均存在临时员工。此时，您可以通过该虚拟角色动态授权/鉴权。 用户 指应用下的个体成员，即“XDMUser”数据实体创建的数据实例。

授权 为了保证各类数据的安全性，满足用户自定义开发数据对象或功能授权的需求，xDM-F提供基于数据对象和操作的授权功能。您可以通过授权功能将参与者、搜索服务定义/具有“权限管理”功能的数据模型及操作类型进行关联，并将这组关系配置到策略集，提升模型维护效率，方便用户维护系统权限、数据流转等操作。 根据授权维度的不同，xDM-F的授权分为静态授权和动态授权。 表2 授权类型 类型 说明 静态授权 即实体授权，是对搜索服务定义/具有“权限管理”功能的数据模型的权限处理，基于数据模型维度所设置的权限，将影响至此数据模型所有的数据实例。 更多关于实体授权的操作请参见授权。 动态授权 即实例授权，是对具有“权限管理”功能的数据实例的精细化权限处理，可以为参与者基于某一个确定的数据实例进行权限设置，常见于工作流审批等需要临时为参与者设置数据权限等场景。 更多关于实例授权的操作请参见管理数据实例授权。

步骤2：设置角色信息 当您完成创建团队后，您需要为团队添加相应的团队角色。 选择“角色信息”页签，进入角色信息页面。 单击“添加”。 图3 添加团队角色 在弹出的窗口中，勾选待添加的团队角色，单击“确定”。 图4 添加角色 在添加的团队角色中，单击。 图5 角色成员 在弹出的窗口中，根据实际业务需求，添加成员，单击“保存”。 添加群组信息：单击“添加”，选择群组。 图6 添加群组 添加用户信息：选择“用户信息”页签，单击“添加”，选择用户的全名或工号。 图7 添加用户

搜索流程服务编排 默认情况下，流程服务编排页展示的是当前应用下全部流程服务编排。为了帮助用户快速搜索出当前应用下的流程服务编排，xDM-F提供搜索流程服务编排功能，目前可通过服务编号、服务名称、服务状态、服务类型、服务来源、创建者以及更新者等属性维度进行过滤。 在左侧导航栏中，单击“流程引擎”，进入“流程引擎”页面。 根据实际业务需求，设置筛选条件，单击“搜索”，即可获取对应流程服务编排。 图3 搜索流程服务编排 筛选条件说明如下： 服务编号：可通过流程服务编排的编号进行筛选。 服务名称：可通过流程服务编排的名称进行筛选。 服务状态：支持按照草稿、删除和发布筛选。 服务类型：支持按照HTTP和XDMAPI筛选。 服务来源：支持按照XDM、外部系统和内部系统筛选。 创建者：可通过创建流程服务编排的用户名筛选。 更新者：可通过更新流程服务编排的用户名筛选。

操作场景 工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）在XDM应用中预置一个“PropertyModel”数据实体，该数据实体包含type（配置模型类型）、value（配置模型值）和key（配置模型键）三个基本属性，可用于存储您自定义的配置模型规则、对象的对比规则、存储个人操作偏好等，以便于您后续在业务开发时，基于这些配置模型实例数据快速实现各种业务场景。 本文指导您在应用运行态管理PropertyModel数据实体的实例数据。

操作场景 为了提升业务对象建模模板的实用性、提高查询效率、避免一物多码，工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）提供分类管理功能。用户可通过分类管理实现分类结构与分类属性定义，创建业务对象时选择分类节点并定义分类属性值，确保对象唯一。也可根据分类节点及分类属性快速检索对象，提高查询效率，为企业节约时间成本、提高业务效率。 本文指导您如何在应用运行态添加分类节点。