# 自定义创建规则 本文将指导您在工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）中，通过规则引擎创建和配置各类规则，实现工业业务逻辑的自动化执行（如设备异常报警、生产数据校验、工艺参数自动赋值等），从而有效提升生产流程的智能化与规范化水平。 #### 约束与限制 - 规则创建并提交成功后，"规则类型"、"界面模式"及"关联模型"将无法进行修改。如需调整这些内容，建议重新创建规则，或基于现有规则复制生成新的规则进行编辑。 - 对于"属性校验原子规则"和"属性赋值原子规则"，必须关联一个xDM-F数据模型，以确保规则逻辑与数据结构的一致性。 - 脚本模式限制：当基于脚本模式配置规则逻辑时，单个脚本的最大字符限制为40000个字符。 - 如需将规则应用于M-V模型的版本服务功能，建议选择"自定义规则"类型。在"定义参数"阶段，必须确保包含以下字段信息： - 条件字段： - versionCode（数字类型）：用于标识版本编码。 - iteration（数字类型）：用于表示迭代次数或版本计数。 - 结果字段： version（文本类型）：用于存储根据规则逻辑生成的最终版本号。 #### 前提条件 已[登录应用运行态](https://support.huaweicloud.com/consog-idme/idme_consog_0023.html)，并具备规则引擎操作权限。 #### 创建规则 1. 在左侧导航栏中，选择"规则引擎 \> 规则列表"，进入"规则列表"页面。 2. 在"规则列表"页面，单击"创建"，展开"创建"页面。 3. 在"基本信息"页面，设置规则的基本信息。 图1设置基本信息 ![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002490033502.png "点击放大") 表1"基本信息"参数说明 | 参数名称 | 是否必填 | 参数说明 | |:---|:---|:---| | 选择已有规则 | 选填 | 支持从规则模板或已有规则中快速复制内容，自动填充"基本信息"和"定义参数"。具体请参见[基于已有规则或模板快速创建规则](https://support.huaweicloud.com/usermanual-idme/idme_rule_0009.html)。 | | 规则编码 | 选填 | 自定义规则的唯一编码。如果不填写，系统将自动生成。 长度为5-256个字符，仅允许使用英文字母、数字、中划线（-）、下划线（_）。 | | 规则名称 | 必填 | 规则的中文名称。 仅支持字母、数字、下划线（_）和中文字符，长度不能超过256个字符。 | | 规则类型 | 必填 | 定义规则的业务用途与逻辑形态，共支持三种类型： - 自定义规则：用户自定义配置复杂逻辑，适用于设备控制、流程优化等场景。 - 属性校验原子规则：基于xDM-F数据模型的约束校验规则，用于质量检验、参数合规性检查等。 - 属性赋值原子规则：基于xDM-F数据模型的自动赋值规则，用于工艺参数自动计算、状态自动更新等。 **请注意：规则创建完成后，规则类型不可修改，请在创建前仔细确认。** | | 关联模型 | 必填 | 当"规则类型"选择"属性校验原子规则"或"属性赋值原子规则"时，此项为必填，需明确指定规则关联的xDM-F数据模型。 通过关联模型，使原子规则能精准定位到目标数据的属性（如"设备温度"、"产品合格率"），确保校验或赋值操作作用于正确的数据对象。 | | 校验策略 | 必填 | 当"规则类型"选择"属性校验原子规则"时，此项为必填，默认为强校验。 用于定义规则校验失败时的系统执行行为，共支持以下两类： - 强校验：当属性校验原子规则校验未通过时，系统将直接阻止对应业务功能的执行，从源头规避不合规数据的录入与业务操作，适用于合规要求高、数据错误会引发业务风险的核心场景。 - 弱校验：当属性校验原子规则校验未通过时，对应业务功能可正常执行，系统仅返回校验不通过的提示信息，不干预业务流程，适用于非核心指标校验、仅需做数据异常提醒的场景。 | | 界面模式 | 必填 | 根据规则复杂性，选择展示模式： - 规则集：多规则集合，适合条件复杂、多层嵌套的场景（如多级质量判定）。 - 真值表：列表式配置，满足所有条件输出预设结果，适合条件明确、输出固定的场景（如设备状态判断）。 - 决策树：树形结构分层测试，适合探索性数据挖掘场景（如故障根因分析）。 - 评分卡：条件计分并汇总结果，适合综合评价场景（如设备健康度评分）。 - 脚本模式：自定义脚本定义逻辑，适合高度定制化的复杂逻辑（如特殊算法计算）。 - 决策表：表格化多条件组合，适合多条件组合、单一输出的场景（如工艺参数选择）。 **请注意：规则创建完成后，界面模式不可修改。请根据业务逻辑的复杂度与维护需求，在创建前审慎选择界面模式。** | | 冲突解决策略 | 必填 | 处理多条规则被同时触发时的执行顺序。 - 全匹配：依次执行所有符合条件的规则（如零部件尺寸、材质、表面粗糙度等多项质检规则并行执行）。 - 先进先出：优先执行最早配置的规则（如先执行常规巡检，再处理临时告警）。 - 后进先出：优先执行最新创建/更新的规则（如紧急安全生产规范规则优先生效）。 | | 业务领域 | 选填 | 自定义规则所属业务领域，便于分类管理（如设备管理、生产调度、质量管控、供应链协同）。 | | 标签 | 选填 | 为规则添加关键词标签，便于检索与资产化管理。 - 如果您没有可使用的标签，可选择"自定义"。 - 如果您已有可使用的标签，可选择"添加标签"。 | | 触发场景 | 必填 | 当您将"规则类型"选择为"属性校验原子规则"或"属性赋值原子规则"后，需要进一步指定该规则的触发场景。系统默认选择所有可选场景，需至少勾选其中一个场景，以确保规则能够正常生效。 当关联的xDM-F数据模型执行对应交互操作时，系统将根据所选的触发场景自动触发该规则的校验或赋值逻辑。 **请注意：**同一个XDM模型中的原子操作（如创建、更新等）仅可被一个原子规则引用，不可重复配置。 支持的触发场景包括：全部、条件更新、批量创建、管理员批量更新指定属性、检入、创建或更新全量字段、检出并更新、设置状态、更新并检入、批量更新并检入、创建或更新指定字段、撤销检出、另存为、批量更新指定属性、更新指定属性、创建、批量修订且更新、检出、批量添加子项、修订且更新、批量检出并更新、管理员更新对象指定属性、修订、创建视图。 | | 描述 | 选填 | 用于对规则进行自定义说明，可简要阐述规则的用途、适用场景、判断依据等内容，以便于规则的识别、理解和后续维护。建议内容清晰、准确、简洁，便于相关人员快速了解规则意图。 | 4. 单击"下一步"，进入"定义参数"页面。 5. 在"定义参数"页面，设置规则的字段信息。 表2字段参数说明 | 参数名称 | 参数说明 | |:---|:---| | 条件字段 | 用于规则判断的输入字段，决定规则是否应被触发与执行。 同一个xDM-F数据模型只能被一个属性校验/属性赋值原子规则引用，但可被多个自定义规则引用。 - 数据类型：支持如下类型，适应不同业务场景。 - 数据模型：可选择自定义模型或在xDM-F中已构建的数据实体/关系实体。如果选择已构建的数据模型，其全部属性自动成为条件字段，引用格式为"模型名称.属性名称"（如订单.订单金额）。 - 文本：字符串类型数据。 - 数字：浮点数，可包含小数部分。 - 日期：仅包含年月日，如1999-01-02。 - 时间日期：包含日期与时间，如2025-05-29 12:30:32。 - 整数：整数值，不含小数。 - 布尔：逻辑真（true）或假（false）。 - 映射：键值对集合，适用于结构化数据。 - 字段名：自定义名称，用于规则配置界面展示。 - 字段代码：调用接口时的唯一标识（Key），需符合命名规范（建议英文小写+下划线），以保证参数传递准确。 - 数组：设置该字段是否为数组类型。 | | 结果字段 | 规则执行后输出的、具有业务含义的结果数据，用于承载规则判断与逻辑处理的最终产出。 - 内置字段：系统提供如"提示信息"等内置字段。创建自定义规则时可选择是否保留，创建校验或赋值规则时必须保留。 - 数据类型：支持选择数据模型、文本、数字、日期、时间日期、整数、布尔、映射。 - 字段名：自定义名称，用于规则配置界面展示。 - 字段代码：调用接口时的唯一标识（Key），需符合命名规范（建议英文小写+下划线），以保证参数传递准确。 - 数组：设置该字段是否为数组类型。 | | 临时字段 | 在规则执行过程中临时使用的字段，用于存储中间结果或临时数据。虽不直接参与规则的条件判断和最终结果输出，但有助于处理复杂逻辑时的数据暂存与转换。 - 数据类型：支持选择数据模型、文本、数字、日期、时间日期、整数、布尔、映射。 - 字段名：自定义名称，用于规则配置界面展示。 - 字段代码：调用接口时的唯一标识（Key），需符合命名规范（建议英文小写+下划线），以保证参数传递准确。 - 数组：设置该字段是否为数组类型。 | | 常量字段 | 在规则执行过程中始终保持不变的固定值字段，用于提供固定的参数或参考值，以便于规则的判断和计算过程。 如果您没有可使用的常量，可前往"规则引擎 \> 常量定义"进行创建，具体操作请参见[为规则创建自定义常量](https://support.huaweicloud.com/usermanual-idme/idme_rule_0030.html)。 | 6. 单击"下一步"，进入"规则配置"页面。 7. 根据界面提示，设置规则配置。 您在进行规则配置时，您需要根据所选择的"界面模式"进行配置。不同的"界面模式"，其规则配置不同。 - [规则集模式配置] - [真值表模式配置] - [决策树模式配置] - [评分卡模式配置] - [脚本模式配置] - [决策表模式配置] 8. 规则配置完成后，单击"提交"。 #### 规则集模式配置 规则集是由一系列规则组成的集合，适用于处理复杂的、涉及多重关系嵌套的判断场景。每个规则集中的基本单元被称为规则项，其结构清晰明了： ![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002489608450.png "点击放大") 在规则"rule1"中，如果输入数据满足"如果"部分设定的条件，则输出"那么"部分指定的结果。反之，如果条件不满足，则执行"否则"部分定义的操作。具体配置参数的详细信息，请参见[表3]。 表3规则项配置说明（规则集） | 参数名称 | 参数说明 | |:---|:---| | 规则名称 | 用户自定义命名，允许多个规则使用相同名称。为提升规则管理效率，建议使用与实际业务场景相关且易于理解的名称。 规则的默认名称为"rule1"。 | | 添加属性 | 用于控制规则的执行逻辑与匹配策略，包含以下关键配置项： - 优先级：用于设定规则项的匹配优先级，数值越大优先级越高。系统将按优先级从高到低依次匹配规则项，默认优先级为10。例如：优先级为20的规则项将优先于优先级为10的规则项被执行。 - 互斥组：用于标识规则项所属的互斥组，组内规则项在匹配过程中具有互斥性。当同一组中某条优先级较高的规则项匹配成功后，系统将不再继续匹配该组中其余规则项，适用于"多选一"业务场景。 - 循环规则：针对数组类型条件字段的遍历匹配机制。当输入数据为数组时，启用此功能后系统将自动遍历数组中的每个元素，依次执行规则判断与校验，适用于批量数据处理场景。 - 选择数组：从"定义参数"中已配置的条件字段或结果字段，选择一个数组类型字段作为遍历目标。 - 遍历元素：定义循环过程中的临时变量，用于在规则表达式中引用当前遍历的元素值。 - 开始前动作：在循环开始前执行初始化或预处理操作，如变量赋值或前置条件检查。 - 变量赋值：支持在循环过程中对变量进行动态赋值，可用于暂存中间结果或控制循环逻辑。 - 执行方法：提供多种内置函数方法，支持在循环中执行数组操作、映射操作、日期操作、数学函数、对象操作、字符操作，满足复杂业务逻辑的编写需求。 | | 如果 | 用于定义规则项生效的前提条件，通过灵活的逻辑组合与嵌套条件，支持从简单匹配到复杂业务规则的判断。 - 顶层逻辑关系设置：通过选择"或者"或"并且"，控制条件组合的整体判断逻辑。 - 或者：满足其中任一条件，即可触发对应结果。 - 并且：必须同时满足所有条件，才会触发对应结果。 - 条件与合并的层级配置：每个规则项默认包含一个不可删除的初始合并项，以此为基础扩展配置。 - 添加单一条件：单击"![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002489610072.jpg) \> 条件"，设置条件字段、比较符和比较值（详细信息请参见[表4]）。 - 添加复合合并：单击"![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002489453118.jpg) \> 合并"，默认合并方式为"并且"，可通过下拉键切换为"或者"，支持嵌套子条件或子合并项。 | | 那么 | "那么"区域中，配置的是"如果"满足时的输出结果。 - 变量赋值：由输出名称和输出值组成。 - 输出名称：用于标识该输出结果的名称。 - 输出值：当条件满足时系统将返回的具体值。 - 执行方法：选择用于处理数据的方法。支持的方法包括：数组操作、映射操作、日期操作、数学函数、对象操作、字符操作。 | | 否则 | "否则"区域中，配置的是"如果"不满足时的输出结果，可以为空。 | 表4条件参数配置说明（规则集） | 参数名称 | 参数说明 | |:---|:---| | 比较值来源 | 用于定义比较值的来源，支持3种选项： - 参数：从"定义参数"中引用已配置的条件字段或结果字段（如订单金额、用户等级）。 - 方法：通过预设函数对比较值进行处理后再参与判断，适用于需要二次加工数据的复杂条件。 - 规则：调用其他规则并获取其执行结果，实现规则的复杂编排。具体说明如下： - 规则引用：仅支持"规则类型"为"自定义规则"，"规则状态"为"已发布"，"是否生效"为"是"，且未引用其他规则的规则。 - 条件字段：当目标规则的条件字段与当前规则的条件字段不一致时，可配置两者的字段映射关系（即当前规则条件字段与目标规则条件字段的对应关系），确保数据正确传递。 - 结果字段：选择目标规则执行后需要返回的输出字段，该结果将作为当前规则的比较值，参与后续条件判断或逻辑运算。 | | 比较符 | 选择条件判断的比较符（如等于、大于、包含等，详细信息请参见[比较符使用说明](https://support.huaweicloud.com/usermanual-idme/idme_rule_0011.html)）。 | | 比较值类型 | 定义比较值的具体类型，支持4种方式： - 输入值：直接输入固定值（如18）。 - 选择参数：引用"定义参数"中已配置的条件字段或结果字段（如订单金额）。 - 选择常量：引用"定义参数"中已配置的常量（如VIP等级）。 - 选择方法：通过函数处理后再比较（如日期格式化、字符串截取、数学运算）。 | #### 真值表模式配置 真值表是一种以二维矩阵形式呈现的规则配置模式，采用"条件输入-结果输出"的可视化逻辑映射方式。当业务数据完全匹配某一行预设的所有条件时，系统将自动执行并输出该行对应的结果值。该模式适用于规则逻辑固定、条件组合可枚举的业务场景，如标准决策制定、分类匹配、代码映射等。 - 条件字段：作为规则的判断依据，即输入变量（如"订单金额"、"用户等级"）。 - 结果字段：作为规则的执行输出，即决策结论（如"折扣力度"、"审批状态"）。 - 配置要求：每个真值表规则必须至少包含1个条件列与1个结果列。 ![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002489459758.png "点击放大") "真值表"模式的"规则配置"页面主要分为三个区域： - 表头配置区：用于管理条件列与结果列。用户可通过此区域灵活调整字段顺序、增删字段等，以满足不同业务需求。 - 规则编辑区：以表格形式展示并编辑每一行的具体条件与结果值。每一行代表一组"条件-结果"的映射规则。 - 操作功能区：提供多种操作按钮，如增加条件列、增加结果列、添加一行等，方便用户进行规则管理与维护。 - 批量删除：支持批量选中并删除多行规则记录，适用于清理已过期或无效的规则条目，提升表格的维护效率与整洁度。 - 增加条件列：添加一个新的条件字段列，用于在决策逻辑中引入新的判断维度。例如，在"订单金额"基础上增加"客户类型"作为条件，以实现更精细的决策控制。 - 增加结果列：添加一个新的结果字段列，满足同时输出多个决策结果的需求。例如，同时输出"折扣率"和"赠送积分"，提升规则的实用价值。 - 添加一行：在表格末尾新增一条空白的规则行，用于扩展新的"条件-结果"映射组合，增强规则覆盖范围与灵活性。 #### 决策树模式配置 决策树模式通过可视化树状结构，将复杂的决策逻辑分解为清晰的"条件-分支"路径。从根节点（初始判断条件）开始，每个内部节点代表一个属性判断条件，每个分支代表条件的可能结果，最终抵达的叶子节点（最终结论）则对应确定的分类结论或预测值。该模式对数据缺失值容忍度高，即使部分数据缺失也不会显著影响规则执行效果，适用于需要明确逻辑链路（如故障根因分析、业务分类判定）且数据完整性不足的业务场景。 ![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002489622440.png "点击放大") "决策树"模式的"规则配置"页面，单击"选择值类型"，根据业务判断需求，为该规则节点配置判断逻辑。 - 选择参数：从"定义参数"中引用已配置的条件字段或结果字段（如年龄、专业）。 - 选择方法：如果判断前需要对字段值进行预处理，可选择系统提供的预设函数对原始数据进行转换、计算或提取，再参与后续的条件比较。当前支持的方法类型包括：数组操作、映射操作、日期操作、数学函数、对象操作、字符操作。预设方法详细信息请参见[方法使用说明](https://support.huaweicloud.com/usermanual-idme/idme_rule_0012.html)。 #### 评分卡模式配置 评分卡模式是一种广泛应用于评分场景的配置方式。它通过对输入数据中的各个字段进行评估，在满足特定条件的情况下赋予相应的分数。最终，将这些分数汇总计算，得出最终的结果。该模式将复杂的业务评判标准转化为可量化、可追溯的分数体系，适用于供应商绩效评估、设备健康度打分、产品质量等级判定、工艺合规性评分等需要对多指标进行综合量化的场景。 ![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002521636039.png "点击放大") 1. "评分卡"模式的"规则配置"页面，单击"添加一行"，为每一个需要评估的指标创建独立的评分规则项。 表5规则项配置说明（评分卡） | 参数名称 | 参数说明 | |:---|:---| | 属性 | 从"定义参数"中引用已配置的条件字段（如设备运行温度、零部件尺寸公差、供应商交付准时率、工艺参数偏差值等）。 | | 权重 | 当"得分计算方式"选择为"加权求和"时，用于调节该指标在总分中的占比。默认值为1。 | | 条件 | 单击![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002489644458.jpg)，定义该指标在何种情况下可获得分数。 - 逻辑关系：选择"或者"或"并且"，控制条件的整体判断逻辑。 - 或者：满足其中任一条件，即可触发对应结果。 - 并且：必须同时满足所有条件，才会触发对应结果。 - 条件配置：单击![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002521764257.jpg)，设置比较符和比较值。 - 比较符：选择指标适配的判断符号（如等于、大于、包含等，详细信息请参见[比较符使用说明](https://support.huaweicloud.com/usermanual-idme/idme_rule_0011.html)）。 - 比较值：定义比较值的具体类型，支持4种方式： - 输入值：直接输入固定值（如设备正常温度≤80℃，输入80）。 - 参数：从"定义参数"中引用已配置的条件字段或结果字段（如设备额定温度）。 - 常量：从"定义参数"中引用已配置的常量（如零部件合格公差±0.02mm）。 - 方法：通过函数处理后再比较（如"日期相减返回小时"）。 | | 分值 | 根据评分标准设置条件对应分值，取值方式建议与"比较值"一致。 - 输入值：直接输入固定值（如设备温度合格加20分，超标扣10分）。 - 参数：从"定义参数"中引用已配置的条件字段或结果字段（如分值=权重\*偏差系数）。 - 常量：从"定义参数"中引用已配置的常量。 - 方法：通过函数处理后再比较（如按"供应商延迟交付天数×(-5)"计算扣分值）。 | 2. 完成规则项配置后，设置"得分计算方式"和"得分赋值给"参数，适配评分结果输出需求。 表6评分卡总分配置说明 | 参数名称 | 参数说明 | |:---|:---| | 得分计算方式 | 支持两种评分逻辑： - 求和：将所有触发评分项的得分简单相加。适用于各指标重要性均等场景，如零部件基础质检项评分。 - 加权求和：将每个评分项的得分乘以其权重后，再累加求和。适用于指标重要性分层场景，如设备健康评估时核心部件权重高于辅助部件。 | | 得分赋值给 | 从"定义参数"中引用已配置的结果字段（如"设备健康得分"、"供应商评级得分"、"产品质量总分"等），用于接收并存储计算出的最终总分。 | #### 脚本模式配置 脚本模式采用类自然语言编写方式，支持用户直观描述"当某条件成立时，执行某操作"的业务逻辑，提升脚本的可读性与编写效率。该模式尤其适用于需要高灵活配置的复杂场景，如多设备协同控制、动态工艺调整、故障应急处理等，助力企业实现流程的快速定制与可靠执行。 ![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002521935755.png "点击放大") 在"评分卡"模式的"规则配置"页面，用户可根据不同业务场景，在规则编辑器中编写判断逻辑。也可通过左侧面板快速选取并填充关键字、参数字段、方法。 - 系统预设的关键字，如"规则"、"如果"、"那么"、"否则"、"结束"将自动以粗体显示，便于识别。 - 在编写赋值语句或条件表达式时，为明确字段作用域并避免命名冲突，需对不同来源的字段添加相应前缀。具体规则如下： 表7字段前缀规则 | 字段类型 | 前缀规范 | 示例 | |:---|:---|:---| | 条件字段 | decision_factor. | decision_factor.设备运行温度 decision_factor.零部件公差 | | 结果字段 | outcome. | outcome.报警等级 outcome.生产调整指令 | | 临时变量 | variable. | variable.临时运行时长 variable.偏差计算值 | | 常量 | $+常量的字段标题+字段名 | $设备安全温度阈值 $零部件合格公差 | #### 决策表模式配置 决策表以结构化表格形式可视化呈现复杂业务规则，将业务场景下的多条件组合与对应执行动作（如报警触发、生产调整、合规判定）进行精准映射。该模式既继承了决策树的核心逻辑判断能力，又兼具更优的可读性与可维护性，方便业务人员理解与后续优化。 ![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002521995313.png "点击放大") "决策表"模式的"规则配置"页面主要分为三个区域： - 表头配置区：用于定义与管理条件列（如设备运行参数、质检指标、工艺阈值）和结果列（如报警等级、生产指令、合规结论），明确规则判断与输出项。 - 规则编辑区：以表格形式逐行展示并编辑具体条件组合及其对应的结果值，支持直观的内容修改与逻辑确认。每行对应一组"多条件-单结果"的规则组合（例如当条件A、条件B同时满足时，则执行结果X）。 - 操作功能区：提供多项规则维护操作，包括： - 批量删除：批量选中并删除无效或过时的规则行（如废弃的质检规则），提升规则清理效率。 - 增加条件列：新增一个条件字段列（如补充"设备振动频率"、"零部件公差"等判断维度），扩展判断维度，适配复杂业务判断需求。 - 增加结果列：新增一个结果字段列（如补充"维修工单优先级"、"生产节拍调整值"等），丰富输出内容，支撑更精细的业务决策。 - 添加一行：在表格末尾插入一条空白规则行，快速扩展逻辑分支，适配业务场景的新增需求。