1. 概述
1.1 版本
| FineBI服务器版本 | 功能变更 |
|---|---|
| 6.0 | - |
| 6.1.1 | 在邮件通知中新增「使用组件预警附件」选项，支持自定义发送预警组件和仪表板相关附件 |
1.2 应用场景
用户在制作组件时，经常对数据异常值进行分析，从而指导业务的发展。
但是人工发现异常值的效率过低，用户期望在异常值出现后，工程主动通知到相关人员。
1.3 功能简介
通过定时调度任务中的预警判断，可实现组件出现异常值后，主动推送给用户，方便及时处理/优化。
1）「预警判断」仅支持 BI 模板中的表格组件，不支持图表组件或非 BI 模板。
2）「预警判断」支持对组件中参与分析的结果字段设置预警条件。
3）「预警判断」支持「邮件通知」和「客户端通知」。
2. 示例
本文示例：
「业务主题>销售管理>销售业绩达成情况」主题下的「销售业绩达成情况」仪表板，存在组件「销售小组目标完成情况分析」。
设置定时调度任务，每天晚上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. 功能详情
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. 注意事项
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及之后版本，新增「使用组件预警附件」选项。用户可自行选择在邮件中「使用模板附件」和「使用组件预警附件」。
