跳到主要内容

01-规则清单管理

核心概念：规则引擎 | 01-规则清单管理 | 概览

规则清单管理是规则中心的核心模块，用于定义和管理系统中的所有通用规则。通过可视化的方式，管理员可以创建复杂的逻辑判断，供各个业务模块（如 任务推送、黑名单、Launcher广告 等）调用。

核心概念：规则引擎 | 01-规则清单管理 | 先理解规则是怎样参与业务的

先理解规则是怎样参与业务的​

规则清单保存的是“如何筛选设备”和“规则可以用于哪些业务”，本身不会主动向设备推送内容。任务、Launcher、黑名单、UOTA 等业务绑定规则后，系统才会在需要下发内容时判断设备是否符合条件。

规则可以使用直接维护的 MAC、MAC 资源包、渠道、地区和高级条件表达式。渠道和地区选项来自相应的基础资料；MAC 资源包使用的是资源包当前有效的明细。因此，基础资料或资源包内容改变后，引用它们的规则也可能受到影响。

“设备数量”只是范围预估

“设备数量”用于快速预估，只统计有效的直接 MAC、MAC 资源包和渠道，并按 MAC 去重；地区和高级条件不会计入这项预估。因此，该数值不能作为最终命中数，更不能代表设备已经收到、下载或执行成功。点击“重新计算”会按当前基础数据刷新结果；未重新计算时，页面可能仍显示上一次的统计值。

“无设备限制”会按全部已激活设备处理，并不是“零台设备”。这是影响范围很大的配置：如果只是暂时不投放，应停用规则或设置明确的设备范围，不能依赖空配置阻止下发。

核心概念：规则引擎 | 01-规则清单管理 | 典型使用场景

典型使用场景​

场景配置方式说明
白名单测试MAC配置只让指定的几十台设备收到推送
渠道差异化渠道配置不同渠道的设备收到不同内容
地区差异化地区配置海外和国内设备分别配置
多条件筛选EL表达式按SDK版本+设备型号组合筛选
设备组复用MAC资源同一批设备在多个业务中复用
核心概念：规则引擎 | 01-规则清单管理 | 1. 规则列表 (一级页面)

1. 规则列表 (一级页面)​

在规则清单管理的一级页面中，一级页面展示了系统中所有的规则定义。在这里，您可以查看规则的基本信息，如规则ID、名称、EL表达式数据等。

规则列表

查询条件与列表字段​

查询条件含义与来源
规则别名、规则名称分别按便于阅读的名称和规则唯一名称查询
变更状态数据字典 bpm_valid
是否启用数据字典 liteflow_enable
设备限制页面固定选项“无设备限制/有设备限制”，不是数据字典
创建时间按规则创建时间范围查询
列表字段含义
ID规则记录编号，也是下方各配置页关联的规则 ID
规则别名面向用户识别的规则名称
规则名称规则的唯一英文名称
设备限制是否配置了渠道、直接 MAC 或 MAC 资源限制；无设备限制时可能覆盖全部设备
是否启用规则当前是否允许参与匹配
EL 表达式高级条件内容；鼠标移入可查看完整文本
变更状态当前已生效数据及待处理变更的状态
设备数量最近一次按 MAC、MAC 资源和渠道快速统计的数量，口径见下文
备注、创建时间规则补充说明和创建时间
操作编辑基础信息、进入 EL 编辑、删除、查看草稿或取消数据变更
核心概念：规则引擎 | 01-规则清单管理 | 1.1 新增规则

1.1 新增规则​

在规则清单管理的新增规则操作中，点击“新增”按钮，可以创建一个新的规则。

字段必填说明
业务类型、业务 ID条件显示仅从具体业务页面新增规则时显示，系统自动带入且不可编辑；在规则清单直接新增时不显示
规则别名是面向用户识别的名称
规则名称是唯一英文名称，必须以英文字母开头，只能包含字母、数字和下划线；编辑时不可修改
渠道配置否仅新增时显示，选项来自“渠道信息”的当前数据，不是字典
是否启用是数据字典 liteflow_enable，默认启用
备注否记录用途、负责人或适用范围

从业务侧新增规则但没有选择渠道时，系统会加入一个不存在的占位 MAC，避免新规则立即成为“无设备限制”。占位 MAC 不是实际设备，后续应在规则 MAC 页面补齐真实范围。

新增规则

核心概念：规则引擎 | 01-规则清单管理 | 1.2 编辑规则

1.2 编辑规则​

在规则清单管理的编辑规则操作中，点击“编辑”按钮，可以修改规则的基本信息。

编辑规则

对于仍处于审批变更中的单条规则，可以使用“取消数据变更（包含子表数据）”撤销本次未生效修改。操作前应确认不再需要本次规则及其渠道、MAC、MAC 资源、地区等子表变更；该操作不会把已生效的历史配置一并删除。

取消规则审批数��据变更

核心概念：规则引擎 | 01-规则清单管理 | 1.3 进入EL配置

1.3 进入EL配置​

在规则清单管理的EL配置入口中，在列表的操作栏中，点击 "EL表达式" 按钮，将进入强大的可视化规则编辑器（EL规则配置中心），这是配置规则具体逻辑的地方。

进入EL编辑

核心概念：规则引擎 | 01-规则清单管理 | 1.4 设备数量统计

1.4 设备数量统计​

在规则列表页中，您也可以直接查看每个规则当前覆盖的设备总数（去重后）。

  • 列表展示：直接在列表列中展示设备数量。
  • 交互操作：点击数字，同样可以打开详情弹窗，查看计算时间或执行 【重新计算】。这对于评估单条规则的影响范围非常有用。

规则设备数量与重新计算

当规则显示“无设备”或类似无限制说明时，应先查看页面给出的规则说明，确认它代表“没有配置设备限制”还是“当前没有匹配设备”，不要仅凭数字判断规则无效。

无设备规则说明

统计逻辑说明​

  • 直接维护的 MAC 与 MAC 资源包中的有效 MAC 先合并，并按 MAC 去重。
  • 规则配置了渠道时，再把这些渠道下的设备 MAC 加入统计，并与前面的 MAC 合并去重。渠道与 MAC 在这项数量统计中是合并关系，不是必须同时满足的交集关系。
  • 只有渠道时，数量为所选渠道下的设备数；只有 MAC 或 MAC 资源时，数量为合并去重后的 MAC 数。
  • 规则明确设置为“无设备限制”时，数量按全部已激活设备计算，不应理解为 0 台。
  • 地区和高级条件不参与这项快速统计。因此，数量只是根据 MAC、MAC 资源和渠道得到的范围预估，不能代替设备请求时的最终规则判断。
核心概念：规则引擎 | 01-规则清单管理 | 2. 规则配置详情 (二级页面)

2. 规则配置详情 (二级页面)​

在规则清单管理的二级配置详情页面中，点击规则列表中的某一行（非操作按钮区域），可以进入该规则的二级配置页面。这里管理与该规则关联的具体数据资源。

核心概念：规则引擎 | 01-规则清单管理 | 2.1 业务配置管理

2.1 业务配置管理​

在规则二级配置的业务配置管理中，查看当前规则已经被哪些业务模块绑定。本页只能查看和解除已有绑定，页面没有新增绑定按钮；新绑定应从相应业务页面发起。

区域字段说明
查询规则 ID当前选中规则，自动带入且不可编辑
查询业务类型数据字典 rule_business_type
查询是否生效数据字典 bpm_valid
查询创建时间按绑定记录创建时间范围查询
列表ID规则与业务绑定关系的记录编号
列表业务类型、业务 ID指明绑定到哪类业务的哪条记录
列表是否生效绑定关系当前是否生效，以及是否存在待处理变更
列表创建时间绑定关系创建时间
操作删除、取消数据变更解除绑定或撤销尚未正式生效的变更；不会删除业务记录或规则本身

业务配置管理

需要按设备反查业务时，可从规则列表的相关操作中输入 MAC、CPU 和业务类型，查看该设备在指定业务类型下匹配到的业务 ID 集合。查询仅用于核对，不会变更绑定关系。

按设备查询匹配业务

业务配置的业务意义​

当您在业务配置中绑定一条规则后：

  1. 设备请求时：系统会自动判断设备是否符合这条规则的条件
  2. 匹配成功：设备将收到该业务对应的配置内容
  3. 匹配失败：设备不会收到该业务的配置

审批状态说明​

对于需要审批的业务类型（任务推送、Launcher广告、黑名单），绑定关系会有以下状态：

状态含义设备是否生效
未生效刚绑定，等待审批否
已生效审批通过，正式生效是
待修改已生效但有新的修改待审批是（旧配置）
待删除已生效但申请解绑待审批是（旧配置）
核心概念：规则引擎 | 01-规则清单管理 | 2.2 渠道配置管理

2.2 渠道配置管理​

在规则二级配置的渠道配置管理中，为当前规则绑定特定的渠道。

区域字段说明
查询规则 ID当前选中规则，自动带入
查询渠道从渠道资料中选择，不是数据字典
查询是否生效数据字典 bpm_valid
列表ID规则渠道关系编号
列表渠道显示所选渠道；名称来自渠道资料
列表是否生效当前关系的生效或变更状态
新增规则配置从独立入口打开表单时可选择；在当前规则下新增时由页面自动带入
新增渠道可一次选择多个渠道，选项来自渠道资料
操作删除、取消数据变更移除渠道关系或撤销待处理变更
  • 作用：作为"初筛"条件之一。如果设备所属渠道不在这个列表中，规则会直接匹配失败。

渠道配置管理

渠道配置的业务意义​

场景示例：您想让"App Store"渠道的设备收到某个推送。

  1. 在渠道配置中添加"App Store"渠道
  2. 当设备请求时，系统会检查设备的渠道
  3. 只有渠道为"App Store"的设备才会继续匹配后续条件

注意：如果渠道配置为空，则表示"不限制渠道"，所有渠道的设备都可以匹配。

核心概念：规则引擎 | 01-规则清单管理 | 2.3 MAC配置管理

2.3 MAC配置管理​

在规则二级配置的 MAC 配置管理中，直接为规则绑定特定设备。

区域字段说明
查询规则 ID当前选中规则，自动带入
查询MAC按 MAC 查询
查询是否生效数据字典 bpm_valid
查询创建时间按记录创建时间范围查询
列表ID、MAC关系编号和设备 MAC
列表是否生效当前 MAC 关系的生效或变更状态
列表创建时间MAC 加入本规则的时间
新增规则配置在当前规则下自动带入；从独立入口打开时才需要选择
新增MAC单条新增时填写；导入和导入删除时改为选择文件。当前页面不提供单条 MAC 编辑入口
操作删除、批量删除、导入、导入删除、导出只影响当前规则的直接 MAC，不会删除设备资料
  • 支持批量导入功能，方便录入大量设备。
  • 作用：作为"初筛"条件。如果您只想让这几十台设备命中该规则，直接在这里导入即可。

MAC配置管理

页面支持勾选记录后批量删除，也支持上传 MAC 清单执行导入删除。少量明确记录优先使用批量删除；数量较大或名单来自外部文件时使用导入删除。

规则MAC批量与导入删除

MAC配置的业务意义​

场景示例：您有50台测试设备，想让它们先收到新版本推送。

  1. 准备好这50台设备的MAC地址列表
  2. 使用"导入"功能批量添加
  3. 这50台设备将优先匹配到这条规则

注意：MAC配置是"精确匹配"，只有列表中的设备才会匹配成功。如果MAC配置为空，则表示"不限制设备"。

核心概念：规则引擎 | 01-规则清单管理 | 2.3.1 异步导出MAC

2.3.1 异步导出MAC​

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

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

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

核心概念：规则引擎 | 01-规则清单管理 | 2.3.2 导入删除MAC

2.3.2 导入删除MAC​

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

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

注意：管理员导入删除操作会立即生效，请谨慎操作。

核心概念：规则引擎 | 01-规则清单管理 | 2.4 MAC资源配置管理

2.4 MAC资源配置管理​

在规则二级配置的 MAC 资源配置管理中，引用已创建的 MAC 资源包，实现设备清单复用。

区域字段说明
查询规则 ID当前选中规则，自动带入
查询是否生效数据字典 bpm_valid
列表ID规则与 MAC 资源的关系编号
列表MAC 库名称当前引用的资源包，名称来自 MAC 资源管理
列表是否生效当前引用关系的生效或变更状态
新增MAC 资源从 MAC 资源管理的当前资源包中选择，不是数据字典
操作删除、取消数据变更移除引用或撤销待处理变更，不会删除资源包及其 MAC 明细
  • 核心概念：与其在每个规则里重复导入几千个MAC，不如建立一个MAC资源，然后在需要的地方引用它。

MAC资源配置管理

MAC资源配置的业务意义​

场景示例：您有一个"VIP客户组"包含1万台设备，需要在"任务推送"和"Launcher广告"两个业务中使用。

不使用MAC资源：

  1. 在任务推送的规则中导入1万个MAC
  2. 在Launcher广告的规则中又导入1万个MAC
  3. 当VIP客户组有变动时，需要修改两处

使用MAC资源：

  1. 创建一个"VIP客户组"MAC资源，导入1万个MAC
  2. 在任务推送规则中引用这个资源
  3. 在Launcher广告规则中也引用这个资源
  4. 当VIP客户组有变动时，只需修改MAC资源，两处自动生效
核心概念：规则引擎 | 01-规则清单管理 | 2.5 地区配置管理

2.5 地区配置管理​

在规则二级配置的地区配置管理中，为规则绑定适用地区。

区域字段说明
查询规则 ID当前选中规则，自动带入
查询地区从地区资料中选择，不是数据字典
查询是否生效数据字典 bpm_valid
列表ID规则地区关系编号
列表地区显示所选地区，名称来自地区资料
列表是否生效当前关系的生效或变更状态
新增规则配置在当前规则下自动带入；从独立入口打开时才需要选择
新增地区可一次选择多个地区，选项来自地区资料
操作删除、取消数据变更移除地区关系或撤销待处理变更
  • 作用：作为"初筛"条件。仅当设备处于指定地区时，规则才生效。

地区配置管理

地区配置的业务意义​

场景示例：您想让海外设备使用不同的服务器地址。

  1. 创建两条规则："国内规则"和"海外规则"
  2. 国内规则配置地区为"中国"
  3. 海外规则配置地区为"美国、巴西、印度..."
  4. 当设备请求时，根据其地区自动匹配到对应规则

注意：地区配置为空表示"不限制地区"，全球设备都可以匹配。

核心概念：规则引擎 | 01-规则清单管理 | 3. EL规则配置中心 (可视化编辑器)

3. EL规则配置中心 (可视化编辑器)​

EL规则配置中心（可视化编辑器）是规则引擎的大脑。我们提供了图形模式和树形模式两种视角，让您像搭积木一样配置复杂的业务逻辑。

核心概念：规则引擎 | 01-规则清单管理 | 3.1 界面预览

3.1 界面预览​

EL规则配置中心的界面预览如下：

图形模式：适合查看整体流程走向。 图形模式

树形模式：适合查看层级包含关系。 树形模式

核心概念：规则引擎 | 01-规则清单管理 | 3.2 核心功能

3.2 核心功能​

EL规则配置中心的核心功能包括：

  • 逻辑组合：支持 AND (全满足) 和 OR (任一满足) 逻辑组。 AND_OR切换

  • 丰富的数据类型：

    • 渠道选择：支持下拉搜索。 渠道选择
    • 时间范围：支持时间点和时间段的判断。 时间配置
    • 字符串列表：判断值是否在某一组数据中（如VIP等级列表）。 字符串列表

  • 实时预览：配置过程中，右侧可以实时预览生成的 EL 表达式内容。 EL预览

  • 综合示例：下面是一个由可视化编辑器生成的 EL 表达式示例，用于描述“渠道名称包含 2024，且 (SDK 版本以 rk 开头，或者激活时间在 2026-01-01 到 2026-01-30 之间)”这一组合条件：

    IF(
      AND(
        OR(
          startsWithCmp.tag("build").data("rk"),
          betweenLInclCmp.tag("activationTime").data("2026-01-01 00:00:00,2026-01-30 00:00:00")
        ),
        containsCmp.tag("channelName").data("2024")
      ),
      deviceTrueCmp,
      deviceFalseCmp
    );

详细的操作说明和字段定义，请参考《EL编辑器操作手册》。

核心概念：规则引擎 | 01-规则清单管理 | 数据字典

数据字典​

本页字典数据截至 2026-08-27 17:48:07（UTC+8），以下字典项当前均为启用状态。

  • “liteflow规则有效状态”（liteflow_enable）：0 禁用，1 启用。
  • “规则引擎定义的业务类型”（rule_business_type）：0 任务推送、1 launcher广告配置、2 黑名单、3 uota升级、4 域名分发之域名、5 域名分发之UOTA。
  • “bpm生效检测”（bpm_valid）：0 未生效、1 已生效、2 已生效且做修改标记、3 已生效且做移除标记、4 已生效且修改状态为启用、5 已生效且修改状态为禁用。
  • “bpm流程审批状态”（bpm_inst_status）：-2 系统错误、-1 未开始(草稿)、1 审批中、2 审批通过、3 审批不通过、4 已取消。

各状态的业务含义及多规则命中方式，参见业务侧集成。

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