1. 概述
1.1 版本
| FineBI 版本 | 功能变更 |
|---|---|
| 5.1.10 | - |
| 5.1.11 | 非组件预警时，不显示「正文预览组件」按钮 |
| 5.1.12 | 组件预警任务执行时，根据用户逐一执行任务 |
1.2 应用场景
用户在制作组件时，经常对数据异常值进行分析，从而指导业务的发展。
但是人工发现异常值的效率过低，用户期望在异常值出现后，工程主动通知到相关人员。
1.3 功能简介
通过定时调度任务中的预警判断，可实现组件出现异常值后，主动推送给用户，方便及时处理/优化。
1）「预警判断」仅支持 BI 模板中的表格组件，不支持图表组件或非 BI 模板。
2）「预警判断」支持对组件中参与分析的结果字段设置预警条件。
3）「预警判断」支持「邮件通知」和「客户端通知」。
2. 示例
本文示例：
「业务主题>销售主题>营销组织销售分析」主题下的「营销组织销售分析」仪表板，存在组件「销售小组目标完成情况分析」。
设置定时调度任务，每天晚上18时，检查组件「销售小组目标完成情况分析」中是否存在项目利润率低于0，若低于0就要通过邮件通知销售部销售主管。
2.1 设置发件人
该定时调度任务需要给销售部销售主管发邮件，需要有一个发件人，否则发送动作无法完成。
管理员登录FineBI系统，点击「管理系统>系统管理>邮箱」，添加发件人，点击「确定」，如下图所示：
注1：发件人邮箱类型不同，配置步骤可能不完全相同，具体请参见：邮箱。
注2：配置完成后，请点击「发送测试邮件」，确保邮箱可使用。
2.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 任务执行
5.1.12 及之后的 BI 工程，预警任务执行时：
首先判断预警条件是否异常（如字段权限丢失、字段丢失等）。
若预警条件异常则预警任务执行失败。
若预警条件正常则预警任务继续执行。
预警条件判断正常后，按照任务用户组依次执行对应的预警判断。
若 A 用户执行异常，则跳过，被跳过的用户在任务执行详情里会进行标记。
若 B 用户执行成功，发送预警通知。
依次执行，直至任务执行完成，单个用户执行失败不影响剩余用户。
4. 注意事项
4.1 调度结果
1）若不勾选「调度结果」，按照组件归属人的数据权限，判断是否发送预警至整个用户组。
2）若勾选「调度结果」，则按照用户组成员各自的数据权限，判断是否发送与预警给某个用户。
勾选该按钮后，可根据设置的 行列权限 给不同用户发送不同数据结果。
4.2 调度周期
为了保证预警任务的高效可用，建议预警任务的执行频率不小于1小时。
4.3 条件失效
定时调度任务设置完成后，预警判断的预警条件可能会飘红失效。
1）失效原因
当字段丢失时，字段标红且提示 「当前字段已丢失」
当对应用户无该字段权限时，字段标红且提示「无该字段权限」
注：当字段的分组类型改变后，不会影响用户的预警任务执行。
如果分组改变前后，对应的预警条件仍可以匹配，则对应的预警还是会触发。
2）条件类型
或条件：单条预警条件失效，不影响其他条件，仍然生效。
且条件：若定时调度任务中存在「且」类型的预警条件失效，则该调度任务执行失败，提示「预警条件失效，任务执行失败」。
4.4 邮件通知
若定时调度任务配置了「预警判断」，在「文件处理>邮件通知>邮件内容」中，新增「正文预览组件内容」选项。
「正文预览组件内容」选项默认选中。
1）若同时勾选了「正文预览模板内容」，正文中优先展示组件内容，其次展示模板内容
2）若同时勾选了「使用附件」，则在邮件正文和附件中均展示组件内容
3）
5.1.11 之前的版本，若调度周期中没有勾选「预警判断」，即使勾选了「正文预览组件内容」，在收到邮件中也不会有组件相关内容
5.1.11 及之后的版本，若调度周期中没有勾选「预警判断」，则不显示「正文预览组件内容」选项
