1. 概述
1.1 版本
| 报表服务器版本 |
|---|
| 11.0 |
1.2 功能简介
用户在定时调度中，通过服务器数据集可以在一次定时任务中实现以下场景：
通过服务器数据集多值传参，针对传入的所有参数生成对应的结果。
使用服务器数据集中的参数值命名生成的结果附件，并存储在本地。
使用服务器数据集定义默认用户组，将生成的结果通过邮件发送给组内用户。
本文将通过具体的示例来演示定时调度中服务器数据集的使用方法。
2. 示例
2.1 准备用户信息
管理员点击「服务器>服务器数据集」，新建内置数据集「定时调度用户信息」，数据集内容如下图所示：
这个数据集既是平台用户信息表，也是模板参数取数表，需要保证选择的「name」列数据与平台中的用户名一致，否则任务执行无法成功。
2.2 准备模板
本文示例所用模板为%FR_HOME%\webapps\webroot\WEB-INF\reportlets\GettingStarted.cpt
模板设计步骤请参考：第一张普通报表。
模板样式如下图所示：
2.3 导入用户
管理员登录数据决策系统，点击「管理系统>用户管理>所有用户>导入用户」，使用上文的服务器数据集导入用户，如下图所示：
导入的信息中包含了用户的邮箱，即收件人邮箱。如不包含邮箱信息，请手动为用户配置邮箱，详情请参见：添加用户、导入用户、同步用户。
2.4 设置发件人
发邮件，需要有一个发件人，否则发送动作无法完成。
管理员登录数据决策系统，点击「管理系统>系统管理>邮箱」，添加发件人，点击「确定」，如下图所示：
注1：发件人邮箱类型不同，配置步骤可能不完全相同，具体请参见：邮箱。
注2：配置完成后，请点击「发送测试邮件」，确保邮箱可使用。
2.5 设置定时任务
2.5.1 添加任务
管理员登录数据决策系统，点击「管理系统>定时调度>任务管理」，点击「添加任务」，添加一个定时调度任务。如下图所示：
2.5.2 基本设置
1）「任务名称」设置为「地区销售概况通知」。
2）点击「默认用户组」的「编辑」按钮。
选择用户为「自定义用户>定时调度用户信息>name」,选取「name」列中的用户作为默认用户组。
点击确定。如下图所示：
注：本步骤仅用于演示如何使用服务器数据集定义默认用户组，将生成的结果通过邮件发送给组内用户。
并不与模板参数产生联动效果，不会给指定用户推送指定参数值的模板内容
确认默认用户组已选定「数据集：定时调度用户信息」、「接收人：name」。点击「确定」，默认用户组设置完成。点击「下一步」，如下图所示：
2.2.3 调度对象
1）对象类型选择：报表模板
2）选择模板：GettingStarted.cpt
3）点击「设置参数默认值」，系统会自动获取 GettingStarted 模板中的「地区」参数。
选择输入方式为：数据集
值为：定时调度用户信息中的「area」列
在执行定时任务时，会根据参数值「area」进行数据过滤，在 schedule 文件夹中的用户文件夹下生成对应结果的 cpr 文件。
4）附件存档勾选：pdf
注：本步骤中勾选了什么类型的「附件存档」，发送邮件时便可以选择什么类型的邮件附件。
5）文件名称设置：${地区}地区销售概况
点击「下一步」，如下图所示：
2.2.4 调度周期
执行频率选择「明细频率设置」，点击「添加」。
设置执行时间为「18时0分」，执行日为「每日」，执行月为「全选」，点击「确定」，即可成功添加明细频率。
勾选上一步添加的明细频率。
2.2.5 文件处理
1）处理方式勾选「邮件通知」。
2）在「邮件通知」设置中：
发件人为：系统默认发件人，可下拉选择其他发件人
收件人为：「默认用户组」
主题为：${today()}的销售情况
邮件内容为：今天销售情况请查收。
勾选：使用附件 pdf
点击「保存」，如下图所示：
2.6 效果预览
由于该任务的执行频率是每天晚上 18 时执行一次，无法立刻看到任务效果。
为了立刻看到任务效果，可在「管理系统>定时调度>任务管理」界面找到该任务，选择「执行一次」。
执行一次后，在「定时调度>运行监控」中，可以查看到定时任务已经成功执行。如下图所示：
邮件通知成功，已经将生成的结果通过邮件发送给默认用户组内所有用户。
对传入的参数值，进行模板计算得出不同的结果，如华东地区和华北地区。
在本地 schedule 文件夹中的用户文件夹下可查看到定时任务生成的结果。如下图所示：
使用服务器数据集「area」列作为「地区」参数的值，执行一次后，该定时任务针对传入的所有参数值均生成了对应的结果文件。
并使用服务器数据集中的参数值命名生成的 cpr 文件和附件。
