定时任务执行条件之公式判断

1.1 版本

1.2 应用场景

用户希望在定时调度中，可以通过公式判断来监测指标情况。当指标出现异常值时，工程会主动通知到相关人员。

1.3 功能简介

通过定时调度任务中的公式判断，可实现指标出现异常值后，主动推送信息给相关用户，方便用户及时处理/优化。

• 公式判断结果为 true 时，执行定时推送任务。

• 公式判断结果为 false 时，不执行或者延迟执行定时推送任务。

注：「定时调度>调度周期>公式判断」中支持的公式请参见：定时调度支持的公式。

本文将通过一个简单示例演示定时调度中公式判断功能的使用方法。

示例：使用定时调度来监测销售总额是否达标，当销售总额小于 20000 时，通过邮件将销售概况信息发送到销售总监邮箱中。

2.1 设计模板

管理员需要先准备一张模板，作为调度对象发送到销售总监邮箱中。

点击下载模板：销售概况.cpt

模板的详细制作步骤请参见：普通报表入门示例。

模板样式如下图所示：

2.2 设置发件人

发邮件，需要有一个发件人，否则发送动作无法完成。

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

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

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

2.3 添加任务

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

2.4 基本设置

「任务名称」设置为「销售总额未达标通知」。

2.5 调度对象

1）对象类型选择：报表模板

2）选择模板：销售概况.cpt

3）文件名称设置：${today()}地区销售概况

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

2.6 调度周期

1）设置执行频率

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

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

勾选上一步添加的明细频率。

2）设置执行条件

执行条件选择「公式判断」。

设置执行条件为：D5<20000，当销售总额小于 20000 时，执行该定时任务。

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

注：公式长度不可超过1000

2.7 文件处理

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

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

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

• 自定义填写收件人邮箱为：Alice@outlook.com

注：该邮箱地址仅为展示自定义邮箱用法，用户在使用时需自行填入正确的邮箱地址。

• 主题为：${today()}地区销售概况

• 邮件内容为：今日地区销售总额未达标，请及时查看地区销售概况。

• 勾选：正文预览报表内容、正文加上结果链接

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

2.8 效果预览

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

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

由于 D5 单元格的值为 16948，满足小于 20000 的执行条件。所以当任务执行一次后，销售总监即可接收到邮件。

在邮件中可以查看到对应的附件和报表。如下图所示：