定时调度支持组件预警

1.1 版本

1.2 应用场景

用户在制作组件时，经常对数据异常值进行分析，从而指导业务的发展。

但是人工发现异常值的效率过低，用户期望在异常值出现后，工程主动通知到相关人员。

1.3 功能简介

通过定时调度任务中的预警判断，可实现组件出现异常值后，主动推送给用户，方便及时处理/优化。

1）「预警判断」仅支持 BI 模板中的表格组件，不支持图表组件或非 BI 模板。

2）「预警判断」支持对组件中参与分析的结果字段设置预警条件。

3）「预警判断」支持「邮件通知」和「客户端通知」。

本文示例：

「业务主题>销售管理>销售业绩达成情况」主题下的「销售业绩达成情况」仪表板，存在组件「销售小组目标完成情况分析」。

设置定时调度任务，每天晚上18时，检查组件「销售小组目标完成情况分析」中是否存在项目利润率低于0，若低于0就要通过邮件通知销售部销售主管。

2.1 设置发件人

该定时调度任务需要给销售部销售主管发邮件，需要有一个发件人，否则发送动作无法完成。

管理员登录FineBI系统，点击「管理系统>系统管理>邮箱」，添加发件人，点击「确定」，如下图所示：

注1：发件人邮箱类型不同，配置步骤可能不完全相同，具体请参见：邮箱。

注2：配置完成后，请点击「发送测试邮件」，确保邮箱可使用。

3.2 设置收件人

该定时调度任务需要给销售部销售主管的邮箱发邮件，因此要先为销售主管 Lisa 绑定邮箱。

管理员登录FineBI系统，点击「管理系统>用户管理>所有用户」，编辑销售主管 Lisa 的用户信息，填入邮箱信息，点击「确定」。如下图所示：

注：本示例仅演示如何对系统内的用户配置邮箱，管理员也可在同步/手动添加用户时配置好邮箱，详情请参见：添加用户、导入用户、同步用户。

2.3 添加任务

管理员登录FineBI系统，点击「管理系统>定时调度>任务管理」，点击「添加任务」，添加一个定时调度任务。如下图所示：

2.4 基本设置

1）「任务名称」设置为「销售业绩达成情况」。

2）点击「默认用户组」的「编辑」按钮。部门选择销售部的「销售主管」，点击确定。如下图所示：

注：本步骤中也可不设置默认用户组，那么在设置邮件收件人时，可以发送给指定的邮箱账户，但无法把邮箱和数据决策系统的用户关联。

确认部门处已选定「所有部门:销售部:销售主管; 」，点击「确定」，默认用户组设置完成。点击「下一步」，如下图所示：

2.5 调度对象

1）对象类型选择：BI模板

2）选择模板：「业务主题>销售管理>销售业绩达成情况」主题下的「销售业绩达成情况」仪表板

3）文件名称设置：${today()}销售业绩

4）附件存档选择：pdf

点击「下一步」，如下图所示：

2.6 调度周期

1）设置执行频率

执行频率选择「明细频率设置」，点击「添加」。

设置执行时间为「18时0分」，执行日为「每日」，执行月为「全选」，点击「确定」，即可成功添加明细频率。

2）设置执行条件

执行条件选择「预警判断」。

选择组件「销售小组目标完成情况分析」，设置预警条件为：项目利润率小于0。

点击「下一步」。如下图所示：

2.7 文件处理

1）处理方式勾选「邮件通知」。

2）在「邮件通知」设置中：

• 发件人为：系统默认发件人，可下拉选择其他发件人

• 收件人为：「默认用户组」

• 主题为：${today()}的销售情况

• 邮件内容为：今日项目利润率小于0，请及时关注异常项目组。

• 勾选：正文预览组件内容

• 勾选：使用附件
  

点击「保存」，如下图所示：

2.8 效果预览

由于该任务的执行频率是每日晚上18时执行一次，无法立刻看到任务效果。

为了立刻看到任务效果，可在「管理系统>定时调度>任务管理」界面找到该任务，选择「执行一次」。

当任务执行一次后，职位「销售部>销售主管」对应的用户 Lisa 绑定的邮箱中，收到一封来自FineBI系统的邮件。

邮件内容如下图所示：

3.1 使用前提

如需使用「预警判断」功能。需要满足以下前提

3.1.1 对象类型

「预警判断」仅对FineBI仪表板生效。

定时调度的「调度对象>对象类型」，必须选择「BI模板」，否则无法设置「预警判断」任务。

3.1.2 选择模板

「预警判断」仅对FineBI仪表板中的表格组件生效。

定时调度的「调度对象>选择模板」，必须选择含表格组件的仪表板，否则预警判断中无可用组件。

3.2 选择组件

执行条件选择「预警判断」后，支持「选择组件」。

1）组件选项包括仪表板中所有有数据权限的表格组件，按照组件创建日期排序。

2）一个任务仅能对一个表格组件进行预警判断，不支持多选

3）当已选择组件，添加预警条件，此时切换组件，则预警条件清空

注：「预警判断」仅支持 BI 模板中的表格组件，不支持图表组件或非 BI 模板。

3.3 预警条件

支持选择表格组件的结果字段，包括维度和指标。

1）维度

• 展示分组结果值和其他未分组的原始值

• 日期字段为年月日分组的原始值

• 相同字段按照分析区域内展示顺序先后展示

2）指标

• 展示结果值，不包括合计行和组内合计行

3）过滤器、表格属性、隐藏的字段不支持设置

3.4 任务执行

预警任务执行时：

首先判断预警条件是否异常（如字段权限丢失、字段丢失等）。

• 若预警条件异常则预警任务执行失败。

• 若预警条件正常则预警任务继续执行。

预警条件判断正常后，按照任务用户组依次执行对应的预警判断。

• 若 A 用户执行异常，则跳过，被跳过的用户在任务执行详情里会进行标记。

• 若 B 用户执行成功，发送预警通知。

• 依次执行，直至任务执行完成，单个用户执行失败不影响剩余用户。

4.1 调度对象

4.1.1 调度结果

1）若不勾选「调度结果」，按照组件归属人的数据权限，判断是否发送预警至整个用户组。

2）若勾选「调度结果」，则按照用户组成员各自的数据权限，判断是否发送与预警给某个用户。

      勾选该按钮后，可根据设置的 行列权限 给不同用户发送不同数据结果。

4.1.2 附件存档

如勾选了任何「附件存档」，会为预警组件和仪表板分别生成一份附件进行存档。

4.2 调度周期

为了保证预警任务的高效可用，建议预警任务的执行频率不小于1小时。

4.3 条件失效

定时调度任务设置完成后，预警判断的预警条件可能会标红失效。

1）失效原因

• 当字段丢失时，字段标红且提示 「当前字段已丢失」

• 当对应用户无该字段权限时，字段标红且提示「无该字段权限」

   注：当字段的分组类型改变后，不会影响用户的预警任务执行。

          如果分组改变前后，对应的预警条件仍可以匹配，则对应的预警还是会触发。

2）条件类型

• 或条件：单条预警条件失效，不影响其他条件，仍然生效。

• 且条件：若定时调度任务中存在「且」类型的预警条件失效，则该调度任务执行失败。

4.4 邮件通知

1）正文预览内容

若定时调度任务配置了「预警判断」，在「文件处理>邮件通知>邮件内容」中，新增「正文预览组件内容」选项

用户可自行选择在邮件「正文预览模板内容」和「正文预览组件内容」。

若同时勾选两项，正文中优先展示预警组件内容，其次展示仪表板内容。

2）使用附件

若定时调度任务配置了「预警判断」，且勾选了附件存档，在「文件处理>邮件通知>邮件内容」中：

• 6.1.1之前版本，支持勾选「使用模板附件」，勾选后，邮件附件会发送仪表板和预警组件两份附件

• 6.1.1及之后版本，新增「使用组件预警附件」选项。用户可自行选择在邮件中「使用模板附件」和「使用组件预警附件」。