建模流程 图1 反向建模流程图 预置反向建模策略 建模范围：反向建模前，您需要根据业务需求确定需要将哪些物理表反向生成为数据模型。 此过程需要确定数据库类型，物理表名称，物理表中的字段名称和类型。读取到的物理表和表字段后续将会被反向生成相应数据模型和模型属性。 建模规则：确定反向生成的数据模型的类型、属性及命名规范。 添加数据源 连接本地数据库，是读取数据和反向建模的前提。具体操作请参见创建数据源。 读取数据 xDM-F会根据您设置的反向建模策略进行读取，生成出待创建的建模信息。具体操作请参见读取数据库数据。 确认建模信息 xDM-F初步生成的建模信息可能会存在偏差，您需要根据业务需求进行建模信息的调整。例如，更改物理表中建模信息的实体类型、中英文名称、沿用表名称、父模型等基本信息。具体操作请参见修改建模信息。 生成最终模型 建模完成后，您可以查看生成的模型信息和状态。查看建模失败的错误信息，快速定位问题并及时处理。 建模成功的数据模型会被存放至“数据模型管理”中，您可以前往“数据模型管理”页面查看并进行后续的管理操作。具体操作请参见数据模型管理。

编排限制 表1 服务编排内容限制 编排类型 说明 Java类型 支持编排如下内容： xDM-F的内置模型 用户自定义的数据模型 Java集合类，例如Collection接口和Map接口 Java包装类，例如Integer类、Byte类、Float类和Double类 正则表达式，例如Pattern类和Matcher类 时间相关类，例如java.util包下的java.util.Date和java.util.Calendar类 JSON相关类，例如Jackson类库 Lombok项目 持久化功能相关类，例如GeneralCrudService JavaScript类型 不可转义：`、'、;和"。 不可转义，但可在SQL中转换：{。 例如，有一条如下所示的SQL语句： select 1 from tablename where name='{}' 可在SQL中进行如下转换： select 1 from tablename where name=chr(123)||'}' 可转义：(、)和|。 例如，(转义成\\(，)转义成\\)，|转义成\\|。

步骤2：添加索引 索引定义是使用搜索服务定义的必要条件，只有添加索引才能对模型数据进行检索，而且不同的索引规则也会产生不同的模型数据检索效果。应用运行态支持文本、日期、浮点型、长整型和联合索引四种类型索引。 选择“索引定义”页签，单击“添加索引”。 图2 添加索引 根据业务需求，设置如下索引规则，单击“保存”。 图3 填写索引信息 文本索引 配置项 说明 索引名称 索引的名称。 索引描述 索引的描述。 索引类型 选择“文本”。 分词方法 为索引设置分词方法后，iDME会将可分词的内容根据设定的分词方法分成多个词。 不分词：一般用于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支持多种分隔符，常见的分隔符有空格、制表符、逗号、分号、竖线等。如果您未设置分隔符，返回结果默认使用“/”进行分隔。 分词方法 为索引设置分词方法后，iDME会将可分词的内容根据设定的分词方法分成多个词。 不分词：一般用于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 保存生命周期模板

操作场景 应用同步指两个应用之间的数据同步，工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）支持跨环境、跨租户同步应用设计态数据。例如， 同一租户下，将数据同步至不同环境标识的同名应用。例如，将“环境标识”为“dev”的A应用同步至“环境标识”为“sit”的同名应用。 同一租户下，将数据同步至除源应用自身以外的环境。例如，将广州友好区域的B应用同步至北京四区域的C应用。 不同租户下，但源应用和目标应用都属于iDME应用，这种应用之间的数据同步。

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

概述 工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）支持同步的内容如下： 同步模块 同步内容 本应用可选状态 同步后目标应用状态（目标应用A版本） 同步后目标应用状态（目标应用非A版本） 基础数据 属性库 生效 生效 生效 合法值 合法值列表只同步生效的 生效 生效 分类 - - - 文件夹 - - - 计量单位 生效 生效 生效 生命周期 业务操作 生效 生效 生效 状态 生效 生效 生效 生命周期模板 生效 生效 生效 数据模型 数据实体 已发布 已发布 已发布 关系实体 已发布 已发布 已发布 服务编排 高代码编排 已发布 正在工作 正在工作 父主题： 应用同步

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

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

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

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

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

执行结果 索引的执行结果主要分为：初始态、执行中、待创建、成功和失败。 表1 执行结果 名称 说明 初始态 表示索引定义完成，待系统调用执行接口，将索引添加至应用的数据库中。 执行中 表示索引规则正在应用的数据库中执行，待返回结果。 待创建 表示索引规则未提交/应用上不存在此模型/索引字段在表中不存在，请联系运维人员处理。 成功 表示索引在应用的数据库中创建成功。 失败 表示索引在应用的数据库中创建失败，请联系运维人员处理。

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

注意事项 导入文件只支持Excel类型文件，结尾处需标注#EOF。 导入的数据实体或属性若已存在则进行更新或修订，若不存在则进行创建。 导入的数据实体如存在参考对象，导入时支持自动解耦。 导入数据实体时，系统会对如下相关数据进行修正。 如果导入的数据实体是M-V模型中的版本对象，会将属性的“唯一键”修正为“否”。 如果数据实体的属性将“唯一键”设置为“是”，会将“默认值”修正为空字符（""）。 如果导入的数据实体属性类型为“文件”类型，会将“必填”、“列表属性”、“入库”和“唯一键”修正为“否”。 如果导入的数据实体属性类型为“参考对象”类型，会将“唯一键”修正为“否”。 如果“参考对象”类型的属性将“组合关系”设置为“是”，会将“必填”修正为“是”。 如果“文本”类型的属性将“值加密”设置为“是”，会将“列表属性”修正为“否”。 如果导入的数据实体属性类型为“JSON”类型，会将“唯一键”、“列表属性”和“多值”修正为“否”。 如果导入的数据实体属性类型为“URL”类型，会将“唯一键”修正为“否”。