02-MAC资源管理

MAC资源管理旨在解决"多规则共享同一批设备清单"的需求。

核心思想：与其在每个规则里重复导入几千个MAC，不如建立一个"MAC资源库"，然后在需要的地方直接引用它。

例如，您可能有一个包含1万台设备的"VIP客户列表"，需要在"任务推送"和"广告投放"两个不同的规则中同时使用。通过MAC资源管理，您只需维护这一份列表，即可在多处引用。

数据如何生效

资源包的名称和备注用于管理，真正参与设备筛选的是资源包下面的 MAC 明细。新增、批量导入、批量删除或文件删除都会改变这批设备。规则引用资源包后，使用的是资源包当前有效的 MAC 清单，而不是绑定时复制的一份旧清单。

MAC 明细数量表示资源包中保存的有效 MAC 记录数，不是已注册设备数、在线设备数或可推送设备数。导入时系统主要校验和保存 MAC，不要求每个 MAC 当时已经存在于设备库，因此资源包数量可能大于实际可找到的设备数量。

资源包明细保存后，引用它的规则会在后续筛选中读取当前有效清单；如果关联业务有审批要求，还要以该业务当前已生效的规则关系为准。若资源包已经修改但业务页面的设备数量没有变化，应先检查关联规则和业务状态，再到业务规则页面点击“重新计算”。

为什么修改一处会影响多个业务

资源包与规则之间保存的是引用关系。同一资源包可被多条规则使用，规则又可能绑定到任务、Launcher 或黑名单等不同业务，所以修改公共资源包前应先查看“关联规则”，确认影响范围。

何时使用MAC资源

场景	是否需要MAC资源	说明
只在一条规则中使用一批设备	否	直接在规则的MAC配置中导入
同一批设备需要在多条规则中使用	是	创建MAC资源，多处引用
设备清单需要频繁更新	是	只需更新资源，所有引用自动生效
不同业务需要使用相同的设备组	是	任务推送、广告投放等业务共享同一份清单

1. MAC资源列表 (一级页面)

在MAC资源管理的一级页面中，在此页面管理所有的MAC资源包。

MAC资源列表

查询条件与列表字段

区域	字段	说明
查询	名称	按资源包名称查询
查询	创建时间	按资源包创建时间范围查询
列表	ID	资源包编号，也是下方 MAC 明细和关联规则使用的资源 ID
列表	名称	资源包名称
列表	创建时间	资源包创建时间
列表	备注	用途、设备群体等补充说明
操作	编辑、删除、取消数据变更	修改资源包基础信息、删除资源包，或撤销资源包及其明细的待处理变更

当前一级列表不直接显示 MAC 数量。需要核对资源包内容时，应选中资源包后查看下方“MAC 配置管理”的分页明细或执行导出，不能把资源包 ID、关联规则数当作 MAC 数量。

1.1 新增/修改资源包

在 MAC 资源管理的新增/修改资源包操作中：

字段	必填	说明
名称	是	给这批设备起一个易于识别的名字，例如“北京测试组”
备注	否	说明设备来源、用途、维护人或有效期

新增与修改

2. MAC明细管理 (二级页面)

在MAC资源管理的二级明细页面中，点击列表中的某一行，进入该资源包的详情页，管理具体的MAC地址。

MAC明细列表

区域	字段	说明
查询	资源 ID	当前选中的资源包，自动带入且不可修改
查询	MAC	按 MAC 查询当前资源包明细
查询	创建时间	按 MAC 明细创建时间范围查询
查询	是否生效	数据字典 `bpm_valid`
列表	ID	MAC 明细记录编号
列表	MAC	资源包内保存的设备 MAC
列表	是否生效	该 MAC 当前是否生效，以及是否存在待处理变更
列表	创建时间	该 MAC 加入资源包的时间
操作	删除、取消数据变更	删除单条 MAC 或撤销该条记录尚未正式生效的变更

页面支持勾选记录后批量删除，也支持上传 MAC 清单执行导入删除。少量明确记录适合批量删除；大量名单适合导入删除。

MAC资源批量与导入删除

2.1 导入MAC

在MAC资源管理的导入MAC操作中，对于大量的设备数据，推荐使用导入功能。

点击"导入"按钮。
下载模板，按照格式填入MAC地址。
上传文件完成批量录入。

导入MAC

批量导入操作步骤

准备数据：整理好设备MAC地址列表（建议使用Excel）
下载模板：点击"导入"按钮，下载系统提供的模板文件
填写数据：按模板格式填入MAC地址
上传文件：选择填写好的文件上传
确认导入：系统会预览导入数据，确认无误后提交

提示：MAC地址格式不区分大小写，系统会自动处理。重复的MAC地址会被自动去重。

2.1.1 异步导出MAC

当MAC数据量较大时，建议使用异步导出功能：

点击"异步导出"按钮
确认发起导出任务
前往任务中心查看导出进度
导出完成后，在任务中心下载文件

提示：异步导出适用于大量数据的场景，不会阻塞当前页面操作。

2.1.2 导入删除MAC

当需要批量删除大量MAC时，可使用导入删除功能：

点击"导入删除"按钮
下载导入模板
按模板格式填入需要删除的MAC地址
上传文件确认删除

注意：导入删除会按文件中的 MAC 批量处理。提交前应核对资源包和文件内容，并在操作后检查剩余数量。

2.2 关联使用

关于MAC资源的关联使用方法：配置好MAC资源后，该如何使用呢？

回到 01-规则清单管理。
进入某个规则的二级页面。
选择 MAC资源配置管理。
点击"新增"，选择您刚才创建的资源包进行绑定。

这样，该规则就会自动包含资源包里的所有设备了。

选中资源包后的“规则信息管理”页用于查看引用关系，字段只属于关联规则列表：

区域	字段	说明
查询	资源 ID	当前资源包，自动带入
查询	是否生效	数据字典 `bpm_valid`
列表	ID	规则与资源包关系编号
列表	规则 ID、规则别名、规则名称	指明哪条规则正在引用本资源包，名称来自规则中心
列表	是否生效	当前引用关系的生效或变更状态

该页面只展示引用关系，不是业务绑定列表。要继续判断影响到哪些任务、Launcher 或黑名单，应再到相应规则的“业务配置管理”查看。

MAC资源与规则的关系

Mermaid Diagram Code:

flowchart LR
    A[MAC资源包] -->|被引用| B[规则A]
    A -->|被引用| C[规则B]
    B -->|绑定| D[任务推送]
    B -->|绑定| E[Launcher广告]
    C -->|绑定| F[黑名单]

修改MAC资源的影响

当您修改 MAC 资源（新增或删除 MAC 地址）后：

清单共用：所有引用该资源的规则都会读取更新后的有效 MAC 清单。
数量需刷新：业务页面保存的设备数量不会因为用户正在查看页面而自动重算，需要时应点击“重新计算”。
影响可能跨业务：同一资源可能同时被任务、Launcher、黑名单等业务间接使用，修改前应先查看关联规则。
审批看关联业务：资源清单的保存和业务正式生效不是同一个概念；有关联审批时，以业务页面显示的生效状态为准。

数据字典

MAC 明细的“是否有效”使用字典“bpm生效检测”，字典类型为 bpm_valid。数据截至 2026-08-27 17:48:07（UTC+8），当前字典项均为启用状态：0 未生效、1 已生效、2 已生效且做修改标记、3 已生效且做移除标记、4 已生效且修改状态为启用、5 已生效且修改状态为禁用。

数据如何生效​

何时使用MAC资源​

1. MAC资源列表 (一级页面)​

查询条件与列表字段​

1.1 新增/修改资源包​

2. MAC明细管理 (二级页面)​

2.1 导入MAC​

批量导入操作步骤​

2.1.1 异步导出MAC​

2.1.2 导入删除MAC​

2.2 关联使用​

MAC资源与规则的关系​

修改MAC资源的影响​

数据字典​