1. 概述
1.1 版本
| 报表服务器版本 | 功能变更 |
|---|---|
| 11.0 | - |
| 11.0.5 | 短信内容限制： 1）短信字数不能超过500字符 2）短信参数个数不能超过7个 |
1.2 应用场景
用户希望定时任务结束后，以短信形式提醒用户查看结果。
1.3 功能简介
在数据决策系统中设置发信人和收信人，在定时任务完成后进行短信提醒，发送短信通知收信人。
本文第二章通过一个简单示例演示定时调度短信通知功能的使用方法。
本文第三章对定时调度短信通知功能进行详细讲解。
2. 示例
本文示例：通过定时调度任务，每天晚上 18 时，给销售部saleLeader的手机发送短信，提醒她查看最新的销售明细。
2.1 设置发信人
发短信，需要有一个发信人，否则发送动作无法完成。每个数据决策系统的发信人是唯一的，只需要设置一次即可。
管理员登录数据决策系统，点击「管理系统>系统管理>短信」，开启「使用短信平台」，使用一个开通了「短信服务」的「帆软通行证」账户登录。如下图所示：
注1：绑定的帆软通信证需要开启短信服务，且充值一些账户余额，否则无法成功发送短信，具体请参见：短信。
注2：配置完成后，请点击「发送测试信息」，确保该手机号可使用。
2.2 收信人设置
该定时调度任务需要给销售部 saleLeader 的邮箱发短信，因此要先为销售部主管 Lisa 绑定手机号。
管理员登录数据决策系统，点击「管理系统>用户管理>所有用户」，编辑销售部主管 Lisa 的用户信息，填入手机号，点击「确定」。如下图所示：
注：本示例仅演示如何对系统内的用户配置手机号，管理员也可在同步/手动添加用户时配置好手机号，详情请参见：添加用户、导入用户、同步用户。
2.3 添加任务
管理员登录数据决策系统，点击「管理系统>定时调度>任务管理」，点击「添加任务」，添加一个定时调度任务。如下图所示：
2.4 基本设置
1）「任务名称」设置为「今日销售明细」。
2）点击「默认用户组」的「编辑」按钮。部门选择销售部的「saleLeader」，点击确定。如下图所示：
确认部门处已选定「所有部门:销售部:saleLeader; 」，点击「确定」，默认用户组设置完成。点击「下一步」，如下图所示：
2.5 调度对象
1）对象类型选择「报表模板」，选择模板「GettingStarted.cpt」。
2）勾选「除通用结果外，根据默认用户组内的用户单独生成结果」
3）文件名称设置为「${now()}的销售情况」。
点击「下一步」，如下图所示：
注：勾选「除通用结果外，根据默认用户组内的用户单独生成结果」，是为了在短信中使用 $fine_username 参数。如不勾选，则该参数不生效。
2.6 调度周期
执行频率选择「明细频率设置」，点击「添加」。
设置执行时间为「18时0分」，执行日为「每日」，执行月为「全选」，点击「确定」，即可成功添加明细频率。
勾选刚添加的明细频率，点击「下一步」。如下图所示：
2.7 文件处理
2.7.1 短信通知
1）处理方式勾选「短信通知」。
2）在「短信通知」设置中：
收件人为：「默认用户组」
短信签名选择：信息平台
短信模板选择：尊敬的#name#，#taskname#于#time#已更新，请及时关注。
短信参数name默认值为公式${fine_username}
短信参数taskname默认值为公式=$taskname
短信参数time默认值为公式=$time
如下图所示：
2.7.2 平台通知
短信通知一般都会再搭配一种文件处理方式，方便用户在收到短信提醒后查看定时调度结果。本示例选择「平台通知」。
1）处理方式勾选「平台通知」。
2）在「平台通知」设置中：
收件人为：「默认用户组」
主题为：${today()}的销售情况
内容为：今天销售情况请查收。
点击「保存」，如下图所示：
2.8 效果预览
由于该任务的执行频率是每天晚上 18 时执行一次，无法立刻看到任务效果。
为了立刻看到任务效果，可在「管理系统>定时调度>任务管理」界面找到该任务，选择「执行一次」。
当任务执行一次后，职位「销售部saleLeader」对应的用户 Lisa 绑定的手机中，会收到定时任务运行成功的短信通知，如下图所示：
Lisa（Lisa，123456）登录数据决策系统，收到来自定时调度任务的新消息提醒，可查看对应的结果报表。如下图所示：
3. 功能详情
在「定时调度>文件处理」步骤中，用户可选择「短信通知」处理方式。如下图所示：
本章将详细介绍短信通知处理方式的功能和注意事项。
3.1 前提条件
发短信，需要有一个发信人，否则发送动作无法完成。每个数据决策系统的发信人是唯一的，只需要设置一次即可。
管理员登录数据决策系统，点击「管理系统>系统管理>短信」，开启「使用短信平台」，使用一个开通了「短信服务」的「帆软通行证」账户登录。如下图所示：
注1：绑定的帆软通信证需要开启短信服务，且充值一些账户余额，否则无法成功发送短信，具体请参见：短信。
注2：配置完成后，请点击「发送测试信息」，确保该手机号可使用。
3.2 收件人
收件人为「定时调度>基本设置」中设置的默认用户组，定时调度任务会给默认用户组的手机发送短信。
因此如需使用短信通知，则必须要设置默认用户组，否则短信无法发送给任何人。
需要注意，默认用户组的用户信息，若未绑定手机，则短信无法成功发送。
3.3 短信签名/短信模板
短信签名，为 3.1 节该系统绑定的帆软通行证账号所拥有的短信签名和短信模板。
官方提供一些公用的短信签名和短信模板，用户也可自行申请自己独有的短信签名和短信模板。
申请步骤请参见：短信申请签名和模板 。
注：11.0.5 及之后版本，最终短信字数不能超过500字符，否则会导致定时调度任务保存失败。
3.4 短信参数
短信参数，会自动读取 3.3 节设置的短信模板中的参数，不可手动添加参数。
参数类型支持公式、布尔型、日期、双精度型、整型、字符串。可以使用的公式请参见：定时调度支持的公式。
注：11.0.5 及之后版本，限制参数个数不能超过7个，否则会导致定时调度任务保存失败。
有两个独有的短信参数：参数类型选择公式时，可以通过=$taskname、=$time获取任务名及执行时间。
如需使用用户全局参数（例如${fine_username}），在「定时调度>调度对象」处必须选择报表模板，且必须勾选「除通用结果外，根据默认用户组内的用户单独生成结果」，否则用户全局参数不生效 。
4. 注意事项
问题描述：
定时任务发送短信通知，选择某个「短信模板」后，保存时提示：任务更新失败 。
数据库报错如下图所示：
原因分析：
短信模板中的参数会进行入库的操作，若所设置的参数字段过长，超过数据库的字段限制，就会报错。
解决方案：
删掉一些「短信参数」，即某些「短信参数」后不设置值即可。
更多有关定时调度短信通知的注意事项、报错及解决方案请参考：定时调度常见问题 。
