跳到主要内容

按规则引擎导出设备

核心概念:设备管理 | 按规则引擎导出设备 | 概览

该功能按已绑定的规则批量匹配设备,并为每个导出配置生成独立的结果文件。入口为“设备管理 → 按规则引擎导出设备”。

MAC 配置在此功能中不生效

此导出功能不会使用规则中的 MAC 直接绑定关系。即使已经向规则导入 MAC,执行导出时也会忽略这些 MAC。请优先通过渠道限制和规则表达式配置匹配条件。

规则的绑定、启停、生效状态和多规则命中方式,参见规则中心:业务侧集成。


核心概念:设备管理 | 按规则引擎导出设备 | 导出数据是怎样生成的

导出数据是怎样生成的​

该功能不是导出设备列表当前页,而是以系统预先准备的设备数据备份为准。启动批次后,系统在后台读取备份中的设备编号、MAC、CPU 和渠道等信息,再按每个导出配置绑定的规则进行匹配。用户不能自行指定其他备份地址。

每个导出配置都会生成一份独立的 CSV 文件,包含设备编号、MAC 和 CPU,完成后压缩为 ZIP 供下载。批次页的“设备总数”是这份备份中实际处理的设备记录数,反映的是备份生成时的设备情况,不会随着设备资料之后的变化自动更新。

“匹配设备数”不是去重设备数

一台设备每命中一个导出配置就计一次。同一设备同时命中三个配置,会在三份结果文件中各出现一行,批次“匹配设备数”也会累计三次。因此,这个数字表示所有配置的命中次数之和,并不是跨配置去重后的设备数量;单份结果文件中的“设备数量”才表示该配置导出了多少行。

系统同一时间只执行一个导出批次。点击停止后,正在执行的批次会在处理过程中停止;如果批次被停止或发生异常,应结合进度和日志判断处理到了哪一步。没有生成结果文件不等于“零台设备命中”,也可能是尚未处理完成。


核心概念:设备管理 | 按规则引擎导出设备 | 1. 维护导出配置

1. 维护导出配置​

导出配置列表

查询条件​

条件说明
配置名称按导出配置名称查询
状态数据字典 rule_export_device_status
创建时间按配置创建时间范围查询

配置列表​

字段说明
ID导出配置的系统编号。
配置名称用于区分导出用途。
状态正常配置可参与导出;停用配置仍保留,但不应继续用于新批次。
配置备注配置用途或维护说明。
创建时间配置建立时间。
操作编辑或删除当前配置。

点击“新增”或“编辑”后填写以下字段:

字段必填说明
配置名称是用于区分导出用途
状态是数据字典 rule_export_device_status
配置备注否记录数据接收方、用途或保留期限

导出配置新增与编辑

选中一行配置后,在页面下方为该配置绑定规则。一个配置可以绑定多条规则,设备匹配任意一条即视为命中。

规则绑定区与其他业务共用规则中心组件,显示规则名称、规则启用状态、规则生效状态、绑定生效状态、设备限制和设备数量。绑定已有规则时,候选项来自规则中心;新增规则时会创建规则并自动绑定。这里的规则字段不属于导出配置表,详细含义参见业务侧集成。


核心概念:设备管理 | 按规则引擎导出设备 | 2. 执行导出

2. 执行导出​

  1. 需要只执行部分配置时,先勾选相应行;不勾选时默认执行当前列表中的全部配置。
  2. 点击“执行导出”。
  3. 输入批次名称;名称可以留空,由系统自动生成。
  4. 核对提示中的配置数量后,点击“确认执行”。

开始新导出批次

执行限制

系统同一时间只允许一个导出批次运行。任务执行期间不能重复启动,可以转到“执行批次”查看进度、日志或停止任务。匹配使用批次开始时取得的设备备份数据。


核心概念:设备管理 | 按规则引擎导出设备 | 3. 查看批次与日志

3. 查看批次与日志​

执行批次列表

批次页可按执行批次名称、执行状态和创建时间查询。运行中的任务会定时刷新进度。

批次列表字段说明
ID、执行批次名称批次编号和本次执行名称
执行状态数据字典 rule_export_batch_status
执行进度当前批次处理百分比;执行异常或停止时,不代表已有结果完整
执行开始时间、执行完成时间本次批次实际开始和结束时间;未结束时完成时间为空
设备备份文件地址本次匹配读取的设备备份位置,用于问题核对,不是最终结果文件
设备总数备份中实际处理的设备记录数
匹配设备数各导出配置命中行数之和,跨配置不去重
创建时间批次记录创建时间
操作打开该批次执行日志

点击“查看日志”可检查当前步骤和异常信息;日志弹窗顶部显示进度,正文按执行顺序显示处理信息。运行中的任务也可从顶部状态提示直接查看最新日志。日志是过程说明,不是设备结果清单。

执行批次日志

停止任务前应确认该批次确实不再需要。停止后可保留已经产生的日志,但未完成的配置不应视为完整结果。


核心概念:设备管理 | 按规则引擎导出设备 | 4. 下载结果文件

4. 下载结果文件​

选择导出配置后,在该配置的导出记录中查看各批次生成的文件。

导出结果文件列表

结果区可按创建时间筛选;导出配置 ID 由当前选中的配置自动带入,不可修改。

结果列表字段说明
执行批次 ID生成该文件的批次编号
导出配置 ID当前结果所属配置编号
配置名称生成文件时保存的配置名称,便于保留当时信息
导出时间结果文件生成完成时间
本配置导出的设备数量该配置结果文件中的设备行数
创建时间结果记录创建时间
操作下载文件、复制链接或删除该条结果记录;删除前应确认结果已经归档

核心概念:设备管理 | 按规则引擎导出设备 | 5. 数据字典

5. 数据字典​

以下字典值来自 2026-08-27 17:48:07(UTC+8)的全量字典快照;当前列出的字典项均为启用状态。

配置状态​

字典名称:规则引擎导出设备配置状态;字典类型:rule_export_device_status。

显示名称取值含义
正常0配置可正常维护并用于导出。
停用1配置保留但已停止使用。

执行状态​

字典名称:规则引擎导出设备执行批次状态;字典类型:rule_export_batch_status。

显示名称取值含义
执行中0批次正在处理,可查看实时进度和日志。
停止1批次已被人工停止。
异常2批次因错误未正常完成,应先查看日志。
完成3批次已正常结束,可检查和下载结果。

核心概念:设备管理 | 按规则引擎导出设备 | 6. 匹配范围特别说明

6. 匹配范围特别说明​

此功能先取得当前导出业务可用的规则,再按渠道限制、无设备限制标识和规则表达式判断设备。它与任务推送、黑名单等业务的 MAC 直绑行为不同,因此页面虽然可以看到“规则 MAC 配置”标签,也不代表其中的 MAC 会影响导出结果。

如果结果数量与预期不一致,应依次检查配置是否正常、规则是否启用并生效、渠道限制是否正确、表达式条件是否能命中,以及批次日志是否存在异常。

开发文档
AI 助手
Agent 列表
请选择一个 Agent 开始对话
AI 问答