规则引擎

打开“开发配置 → 规则引擎”，添加节点、填写参数并连线，校验和保存后启用流程。新建规则默认禁用。

做一个大于 100 的判断

先按内存计算创建 Memory.ManualValue，仅用于本次练习。

1. 点击列表右上方的加号（新增规则），名称填“演示值判断”，点击“创建未启用规则”进入编辑器。
2. 在左侧搜索“变量通知规则”，将它拖到画布。
3. 选中这个节点，在右侧把 DeviceNames 填为 Memory，VariableNames 填为 ManualValue。其他筛选条件留空。
4. 搜索“大于”，从“比较运算”分类拖入“大于”节点，不要选“大于等于”。点击画布上节点的标题，在右侧“自定义初始输入参数”中把 InputB 填为 100；InputA 不填写，它由连线传入。
5. 添加“类型转换 → JSON 数值提取”，将通知节点的 Result 连接到数值提取的 Input，再把数值提取的 Result 连接到“大于”的 InputA。这样可明确检查输入是否为有效数字。
6. 点击“校验流程”，处理错误后点击右上角对勾图标保存；确认“已保存”，再点击“启用”，核对“已装载”的版本。
7. 到内存计算，把 ManualValue 写为 101，回到规则编辑器并选中“大于”节点。在右侧切换到“运行”页签，打开“实时参数值”，查看“输出参数”的 Result，应为 true；“输入参数”中 InputA 为 101，InputB 为 100。
8. 再写为 99，Result 应变为 false。完成后在流程详情顶部点击“禁用”。

变量通知规则监听值变化。一直写同一个值，不一定产生新的触发。本例只做判断，不写入设备、不发送通知。

完成规则配置后，在“运行”页签查看 Result 字段，并按后续三节点示例验证连线与输出。

右侧“配置”页签中的“自定义初始输入参数”用于设置起点；连线传入的 InputA 在“运行 → 实时参数值”中查看。

接下来做什么

修改生产流程前先导出备份。

创建和编辑流程

流程列表

规则引擎列表用于管理流程基本信息、启停状态和规则包。

新建流程

1. 点击列表右上角“新增规则”。
2. 在提示框中输入流程名称。
3. 点击“创建未启用规则”后，系统创建禁用的 v1 流程并进入编辑器。
4. 在编辑器中维护流程描述、触发方式、节点、连线和参数。
5. 点击“校验流程”，按诊断定位到节点或连线，处理必填输入、类型和环路等错误。
6. 点击“保存”。禁用规则可保存尚未配置完整的草稿，但必须通过执行校验后才能启用。
7. 点击“启用”，确认配置状态、实际装载版本和本次运行值。已启用规则的保存按钮为“保存并重新装载运行规则”，会应用到运行侧，应安排合适的操作窗口。

修改草稿后重新校验。多人编辑产生版本冲突时，先保留自己的改动，再读取最新流程核对。

流程编辑器

点击流程行的“详情”进入流程编辑器。

节点面板

节点面板中的节点来自已加载的内置节点和自定义节点。常见分类包括保持、比较运算、边沿检测、变量 RPC、常量、触发器、定时器、计数器、类型转换、逻辑运算、数据统计、数据推送、数学运算、条件判断和字符串处理。

如果节点没有出现在列表中，先确认对应脚本或自定义节点已经编译成功，再刷新规则引擎页面。

画布操作

“快捷操作”可查看复制、粘贴和选择操作。跨流程复制后，核对节点依赖、设备名称、变量名称和外部连接参数，再校验流程。

节点参数

节点参数由节点类型决定。不同节点会显示不同的输入、输出和输入输出参数。

端口按名称绑定，连接还会检查事件/状态、数值类型、数组、可空性和单位。Object 到数值的动态连接可能出现转换提示；无效数字、溢出或不允许的空值会使目标执行失败。使用“JSON 数值提取”“整数转十进制”等转换节点明确数据形态；事件与状态之间使用相应的转换节点，不能只改端口名称。

“清除配置值”表示取消显式初值，恢复节点定义的起点，不等于写入空字符串或 null。右侧“节点参数”控制合并策略、批次大小等设置；“高级执行策略”控制超时和重试，二者都不作为业务端口连线。

高级执行策略

选中节点，在右侧“配置”页签展开“高级执行策略”。这些字段控制当前节点的执行，不作为业务端口连接到其他节点。

总期限应能容纳预计处理时间和退避。超时不会撤销已经发出的设备写入或外部消息。设备写入、MQTT、邮件和 Webhook 一旦开始外部操作，结果未确认时可能为 UnknownEffect，不会因为增加尝试次数就盲目重发；应先核对真实接收端或设备状态。业务拒绝、取消和超时也不能作为通用重试条件。

运行值与执行结果

切换到右侧“运行”页签，先核对采样更新时间、当前活动和最近执行结果，再查看输入、输出、输入输出值。“诊断详情”可展开流程实例、装载版本、快照序号、执行完成时间、执行身份、错误码和累计次数。采样更新时间表示读取观察值的时间，执行完成时间才对应最近结束的执行。

保存并重新装载后，确认当前实例与装载版本；累计次数属于当前实例。采样超过 5 秒未更新会显示“采样已过期”，观察请求失败时点击“重新观察”。核对本次输入时，同时查看执行完成时间和执行结果。

需要把节点执行结果接入流程时，将 ExecutionResult 事件输出连接到执行错误捕获节点的 Input。成功和显式跳过都可被观察，但捕获节点忽略这两类结果，只输出错误或取消结果。业务输出与执行结果分开连接，不用执行事件直接充当设备写入值。

当前活动与等待说明

当前活动与最近结果可以同时显示：节点上次执行成功后会继续等待，下次条件不满足也可显示跳过。周期之间的正常等待不应解释为执行失败或新的一次跳过。

连接运行明细

打开“实时参数值”，选中源节点，再展开右侧“连接运行明细”。逐条查看输出端口到目标输入的最近活动、原因、执行身份及时间；“上次投递结果”和“上次投递时间”单独保留。

画布绿色仅短暂表示最近 3 秒发生投递；绿色虚线表示合并接收，黄色虚线表示源节点跳过，红色表示投递或源执行失败，灰色表示未传播或尚无活动。采样过期时不保留成功色。以文字明细为准，绿色消退不表示流程停止，“已投递”也不表示目标业务成功。

同一源节点扇出到多个目标时，每条连接分别核对。一次部分投递失败不会撤回其他目标已接收的输入；节点显式提交过的中间输出也不会因后续失败自动回滚。

导入导出

规则配置使用 JSON 规则包备份和交换。日志导出独立于规则包，不用于恢复流程。

1. 在列表按名称筛选所需流程，点击“导出规则包”，妥善保存 JSON 文件。
2. 在目标网关点击“导入规则包”，选择文件，核对每条流程的名称、节点数、连线数、依赖和已脱敏字段。
3. 没有同名流程时选择新建；同名流程默认跳过。确需替换时先导出现有流程作备份，再明确选择替换。
4. 导入后逐条检查节点类型与自定义节点依赖，补齐密码、令牌等脱敏配置，校验后保存。
5. 导入的规则保持禁用；确认现场设备、变量与接收端后再逐条启用，核对实际装载版本和结果。

规则包记录节点依赖，不携带自定义节点 DLL。目标网关应先部署并编译所需节点。替换时若流程已被其他人修改，重新读取并核对后处理；不要强行覆盖。出现运行重载错误时，配置导入与运行应用分别核对，不能只凭导入数量认定已经生效。

节点与触发方式

触发方式

定时、状态与事件

定时器用于明确触发时刻，不能代替设备写入确认。选中节点后，输入值在“自定义初始输入参数”中填写，容量、策略等设置在节点参数区维护。

周期定时器的 Tick 是事件，每次载荷都可以为 true。连接普通布尔状态输入前，使用“布尔事件转状态”；持续状态需要形成逐次事件时，使用“布尔状态转事件”。JSON 载荷同样提供状态与事件转换节点。转换节点明确改变语义，不会自动产生定时脉冲。

1. 新建禁用的练习流程，添加周期定时器，设置 IntervalTime=1000、Enabled=true。
2. 连接事件端口时选择相同事件语义；需要数值运算时，将 Count 经“整数转十进制”连接到小数输入。
3. 校验、保存并启用，观察 Count 增长以及每次事件的下游执行次数。
4. 测试单次定时器时按假、真、假、真的顺序输入，分别观察延时、输出和复位；完成后禁用练习流程。

流程停止或重新装载会取消仍在等待的动作并释放定时任务。重新装载建立新实例，计数和节点内部状态重新开始。

数据流与共享上下文

“数据流”分类用于选择状态、拆分或汇合事件，以及在同一流程实例中保存少量共享 JSON 数据。先确认连线是状态还是事件，再配置容量和关联条件。

Flush、Write、Read、Remove 是事件输入，事件到达即消费，布尔载荷不必为 true。拆分、批处理和汇合携带事件信封，联调时同时检查关联身份、序号和实际载荷，避免把信封整体当作数值。

上下文的默认键为 shared.value，键名为 1–64 个 ASCII 字母、数字或 .、_、-。每个流程实例最多 128 个键，单值不超过 64 KiB，总量不超过 1 MiB；不同流程不共享，停止、重载或重启后不恢复。事件批次与待汇合数据也应在重载前处理完毕，需要保留记录时交给持久化目标。

变量、事件与写回节点

这组节点直接使用网关的变量、报警和设备状态事件。事件节点不需要上游输入，流程启用后会等待对应事件；筛选条件全部满足时才向下游输出。多个名称或枚举值使用英文逗号分隔，留空表示不按该条件筛选。

变量通知规则

“触发器 → 变量通知规则”监听在线变量的值变化，适合把采集变量接入阈值判断、记录或通知流程。节点匹配成功后同时输出当前变量值和完整变量数据对象。

变量离线时不会触发该节点。需要区分数据来源时，优先使用 VariableBasicData，其中包含变量名称、设备名称、采集组、在线状态、变更时间和采集时间等字段。

同一字段中的多个名称表示可匹配集合；设备名、变量名和采集组之间则同时约束。例如设备填 Memory、变量填 ManualValue、采集组填 LineA，只有三个条件均符合才进入下游。验证筛选时保留一个未匹配的对照输入，修改条件后再写入不同的新值。

告警通知规则

“触发器 → 告警通知规则”监听报警生命周期事件，并按级别、设备、事件类型和报警类型筛选。匹配后从 FilteredAlarmData 输出原始报警对象。

设备通知规则

“触发器 → 设备通知规则”监听设备状态变化，可用于设备离线告警、恢复通知和按插件分流。

变量 RPC 节点

“变量RPC节点”用于通过规则流程调用变量的 RPC 写入能力。它会按 DeviceName 和 VariableName 查找变量，再把 WriteData 转为 JSON 参数调用变量运行时的 RPC；不要绕过变量权限直接调用驱动。

建议将变量 RPC 节点放在上升沿、按钮触发或互锁判断之后，避免高频变量变化造成重复写入。验证时同时检查 Result、变量写入日志和设备侧实际动作；变量不存在、权限关闭或设备暂停都会返回失败结果。

MQTT 客户端上传节点

“数据推送 → Mqtt客户端上传”节点收到 InputData 事件后，把对象序列化为 UTF-8 JSON 发布到指定主题。支持 TCP MQTT 和 WebSocket MQTT。初始化不主动连接或上传；首次发送、连接断开或连接配置变化时，在本次执行中建立连接，失败处理受高级执行策略约束。

参数说明

最小配置与验证

1. 拖入节点，填写 Url、Topic，按 broker 要求填写用户名和密码。
2. 将待推送的数据输出连接到 InputData，按端口提示检查类型和事件语义，并将 ExecutionResult 接入执行错误捕获节点。
3. 先用独立 MQTT 客户端订阅同一主题，再保存并启用流程，触发一次可辨认的新数据。
4. 在“运行”页签确认本次执行为 Succeeded，并在订阅端核对主题、JSON 内容和 QoS。Retain=false 时，发送后才订阅会错过已经发出的消息。

连接或发布失败时，查看最近执行状态、错误码及运行日志；出现 UnknownEffect 时先核对订阅端记录，再决定是否重发。

邮件推送节点

“数据推送 → 邮件推送”节点收到 Data 事件后使用 SMTP 发送规则数据。节点在第一次发送或邮件配置变化时准备 SMTP 通道，发送受总执行期限约束。

参数说明

最小配置与验证

1. 填写 SMTP 主机、端口、用户名、密码、发件人和至少一个收件人。
2. 将告警通知规则的 FilteredAlarmData 事件输出连接到 Data；使用变量通知快照时，先经过“JSON 状态转事件”。
3. 根据接收端要求修改主题或正文模板，保存并启用流程。
4. 将 ExecutionResult 接入执行错误捕获节点后触发一次测试事件。在“运行”页签确认本次状态为 Succeeded、LastPushTime 已推进，并在收件箱检查正文格式和字段替换结果。

SMTP 认证失败、证书错误或收件人无效时，先查看最近执行状态与错误码，再核对服务器端口、SSL 模式和发件人策略。不要在流程日志或公开文档中记录密码。

Webhook 推送节点

“数据推送 → Webhook推送”节点可把规则结果发送到钉钉自定义机器人、企业微信消息推送（原群机器人）或自定义 HTTP 接口。Platform 在属性面板中以下拉框显示，平台必须显式选择，节点不会根据 URL 自动猜测厂商。

参数说明

BodyTemplate 中位于 JSON 字符串内的占位符会自动转义引号、反斜杠和换行；位于 JSON 值位置的占位符会保留数值、布尔、数组或对象类型。找不到的属性在字符串内替换为空文本，在值位置替换为 null。

告警通知规则输出连接到 Data 时，自定义 HTTP 接口可使用以下模板。变量名称是 Name，触发值是 AlarmCode；普通变量通知的值字段才是 Value。

{
  "device": "{{DeviceName}}",
  "variable": "{{Name}}",
  "message": "{{AlarmText}}",
  "level": {{AlarmLevel}},
  "value": {{AlarmCode}}
}

这是等待替换的模板正文。报警等级为 1、报警值为 101 时，level 输出数字 1，value 输出字符串 "101"，因为 AlarmCode 是文本字段；将它放在引号外不会自动转换为数字。

先把待推送的数据连接到 Data，并将 ExecutionResult 接入执行错误捕获节点。接收端准备就绪后启用流程，触发一条可辨认的新事件；在“运行”页签核对本次执行身份、Succeeded 与推进后的 LastPushTime，再到 HTTP 接收端或消息客户端检查正文。初始化时间或旧的成功时间不能作为本次发送的结果。

钉钉配置

1. 将 Platform 设为 DingTalk。
2. 将完整的 https://oapi.dingtalk.com/robot/send?access_token=<机器人Token> 填入 Url。
3. 使用加签安全设置时填写 Secret；使用关键词或 IP 白名单时留空。
4. 文本消息可填写以下正文；告警变量名称使用 {{Name}}：

{
  "msgtype": "text",
  "text": {
    "content": "设备：{{DeviceName}}\n变量：{{Name}}\n内容：{{AlarmText}}\n报警值：{{AlarmCode}}"
  }
}

钉钉 Markdown 使用以下结构：

{
  "msgtype": "markdown",
  "markdown": {
    "title": "网关报警",
    "text": "## {{DeviceName}}\n\n{{AlarmText}}"
  }
}

节点按钉钉官方 HmacSHA256 规则自动追加 timestamp 与 sign，不要在 URL 中手工重复添加。HTTP 2xx 后还会检查响应 JSON，只有 errcode 为数字 0 或钉钉官方成功示例中的数字字符串 "0" 才确认发送成功。错误码 310000 通常表示关键词、时间戳、签名或 IP 白名单校验失败；系统时间与钉钉请求时间误差不能超过 1 小时。

企业微信配置

1. 将 Platform 设为 WeCom。
2. 将完整的 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=<消息推送Key> 填入 Url。
3. Secret 留空。文本消息使用与上面相同的 text.content 正文，并核对变量名与报警值。
4. 企业微信 Markdown 必须使用 markdown.content，不能使用钉钉的 title、text：

{
  "msgtype": "markdown",
  "markdown": {
    "content": "# {{DeviceName}}\n{{AlarmText}}"
  }
}

企业微信文本最长 2048 UTF-8 字节，Markdown 最长 4096 UTF-8 字节。节点只有在 HTTP 为 2xx 且企业微信响应 errcode 可解析为整数 0 时确认发送成功。

频率与安全

钉钉每个机器人、企业微信每个消息推送都不能超过每分钟 20 条。高频变量不要直接连接 Webhook 节点，应先使用边沿、阈值、保持、定时器或聚合节点减少触发，并把多条报警合并成摘要。Webhook URL 本身包含发送凭据，不要写入日志、截图、公开文档或代码仓库。

运行与验收

运行日志

规则流程运行后，可在编辑器底部查看运行日志。

启用后的运行检查

1. 核对实际装载版本。
2. 用安全测试值触发流程，从上游到下游查看节点实时参数值。
3. 在运行日志中核对触发时间、执行路径、输出结果和异常。
4. 到最终接收位置确认结果，例如内存变量、报警、消息目标或外部接口。

从输入到执行结果逐段验证

变量通知节点的 Result 是当前值，VariableBasicData 是包含值、质量和时间的完整快照。连接数值计算时，可以先加“JSON 数值提取”，把通知值明确转为数值，再接比较或数学节点；需要完整身份与时间时使用快照端口。不要把对象、数字、布尔和写入结果混为同一种输入。

1. 用设备名称和变量名称限定通知来源；配置多个名称时按字段要求填写，不要让全站变化都进入控制规则。
2. 给比较节点设置 InputB=100，通过连线传入 InputA。输入端已有连线时，运行值由上游提供，修改该端口的初始值不能代替上游输入。
3. 依次写入 101、99、100，核对严格“大于”的结果为 true、false、false，同时查看当前输入和执行时间。
4. 使用条件节点时，分别设置真、假分支值，例如 900 和 100，再切换条件核对实际选中的分支。
5. 接入变量 RPC 时，明确设备名、变量名和 WriteData；把布尔控制结果送入写入内容，查看 Result 中的写入业务结果及 ExecutionResult 中的节点执行结果，再到源端独立回读。

设备特殊方法节点和目标特殊方法节点分别调用选定设备或转发目标公开的方法。选择名称或标识后先检查方法参数，再用两次不同输入观察调用次数和最终效果。普通周期采集、周期上传会同时运行，不能把它们产生的结果算作方法调用的结果。

状态输出默认只在值变化时向下游传播，事件端口则可在相同载荷下再次触发。检查重复动作时，同时看当前输入、执行身份和下游反馈，避免仅凭布尔输出不变就判断未执行。控制规则应明确使用持续状态还是上升沿/下降沿，防止一次变化造成不需要的重复写入。

带回差的风机控制

以下流程可在隔离的协议仿真工程中练习。先准备可读写温度变量 Temperature 和布尔线圈 Fan，让风机从关闭状态开始。完整点位和上下游配置见完整项目配置与交付。

1. 新建并暂时禁用流程，添加“变量通知规则”，只监听温度变量。
2. 添加“JSON 数值提取”和“阈值触发”，把通知值连接到数值提取，再把数值连接到阈值输入。
3. 阈值触发填写 Threshold=75、Hysteresis=5、CompareOperator=>。
4. 添加变量 RPC，设备和变量选择实际风机线圈，把阈值的 Triggered 输出连接到 WriteData。
5. 保存并启用，依次改变温度，逐次核对节点状态、写入结果与源端线圈。

回差向中心阈值两侧展开，不是把 75 当作固定开关点。比较符为严格 > 时，关闭状态输入恰好 80 不进入，开启状态输入恰好 70 会退出；若业务要求不同，应明确选择比较符并测试相等边界。流程重载会重新建立节点状态，上线时也应检查启动状态和第一次通知。

结束练习时先禁用流程，再恢复温度和风机初始状态。现场控制还应核对通信质量、变量写权限和执行机构反馈，单次 RPC 成功不等于执行机构已经动作。

常见流程设计

使用与排障

故障处理

相关链接

• 采集配置 - 通道、设备、变量配置
• 内存计算 - 维护规则流程常用的内存变量
• 自定义节点 - 自定义节点管理
• 脚本管理 - 脚本开发和管理