1. 概述
1.1 版本
| FineBI服务器版本 |
|---|
| 5.1 |
1.2 应用场景
用户希望在定时调度中，可以通过公式判断来动态执行推送任务。在满足执行条件时，工程会推送信息到相关人员处。
1.3 功能简介
FineBI 中的公式判断功能可以实现根据公式判断结果，动态执行定时任务。
公式判断结果为 true 时，执行定时任务。
公式判断结果为 false 时，不执行或者延迟执行定时任务。
注：「定时调度>调度周期>公式判断」中支持的公式请参见：定时调度支持的公式。
本文将通过一个简单示例演示定时调度中公式判断功能的使用方法。
2. 示例
本文示例：通过定时调度任务的公式判断功能，在 2022 年内的每晚 18 时给用户 Anna 推送最新的品牌销售情况。
示例使用的 BI 仪表板为：「行业应用>零售行业」下的「区域销售统计」仪表板。
该仪表板使用的数据表为：「行业数据>零售行业」下的「门店销售数据统计」数据表
2.1 仪表板准备
2.1.1 复制模板链接
在设置定时调度任务前，需要先获取定时调度中使用的仪表板的链接，以便将仪表板推送给用户 Anna 的 App 端。
1）管理员登录 FineBI 系统，点击「仪表盘」，选择「行业应用>零售行业>区域销售统计」。
点击「预览模板」，跳转到仪表板预览界面，复制仪表板预览链接。
仪表板预览链接形式如：http://IP:port/webroot/decision/v5/design/report/仪表板ID/view。如下图所示：
注1：链接中的IP不可为「localhost」，必须更换为电脑实际的 IP 地址。
注2：APP端必须可访问该网址，如内外网环境不互通则无法访问。
2.1.2 分配数据权限
用户 Anna 如需访问定时调度中使用的 BI 模板，必须拥有该仪表板调用的数据表的数据使用权限。
点击「管理系统>权限管理>普通权限配置」，选择权限载体「用户」，本示例选择用户 Anna，为其分配「行业数据>零售行业>门店销售数据统计」的数据「使用」权限。如下图所示：
2.2 添加任务
管理员登录 FineBI 系统，点击「管理系统>定时调度>任务管理」，点击「添加任务」，添加一个定时调度任务。如下图所示：
2.3 基本设置
1）「任务名称」设置为「区域销售统计情况」。
2）点击「默认用户组」的「编辑」按钮。用户选择「平台」的「Anna」，点击确定。
注：如需使用平台通知，必须要设置默认用户组，否则消息无法发送给任何人。
确认用户处已选定「安娜(Anna) 」，点击「确定」，默认用户组设置完成。点击「下一步」，如下图所示：
2.4 调度对象
1）对象类型选择：BI 模板
2）选择模板：「业务主题>销售管理>销售业绩达成情况」主题下的「区域销售统计」仪表板
点击「下一步」，如下图所示：
2.5 调度周期
1）设置执行频率
执行频率选择「明细频率设置」，点击「添加」。
设置执行时间为「18时0分」，执行日为「每日」，执行月为「全选」，点击「确定」，即可成功添加明细频率。
2）设置执行条件
执行条件选择「公式判断」。
设置执行条件为：YEAR(TODAY()) = 2022
点击「下一步」。如下图所示：
2.6 文件处理
1）处理方式勾选「客户端通知」。
2）在「客户端通知」设置中：
勾选「APP」通知
选择消息类型为「链接消息」
接收人为：「默认用户组」
主题为：${today()}的区域销售情况
邮件内容为：有新的销售统计数据已到达，请及时查收。
勾选「自定义链接」，输入内容为 2.1 节准备好的仪表板预览链接
点击「保存」，如下图所示：
2.7 效果预览
由于该任务的执行频率是每天晚上18时执行一次，无法立刻看到任务效果。
为了立刻看到任务效果，可在「管理系统>定时调度>任务管理」界面找到该任务，选择「执行一次」。
执行一次后，用户 Anna 登录 App ，收到来自定时调度任务的新消息提醒，可查看对应的结果报表。如下图所示：
注：App 访问 BI 工程的步骤请参见：配置服务器访问 BI 工程。
