1.1 版本

1.2 功能简介

用户在定时调度中，通过服务器数据集可以在一次定时任务中实现以下场景：

• 通过服务器数据集多值传参，针对传入的所有参数生成对应的结果。

• 使用服务器数据集中的参数值命名生成的结果附件，并存储在本地。

• 使用服务器数据集定义默认用户组，将生成的结果通过邮件发送给组内用户。

本文将通过具体的示例来演示定时调度中服务器数据集的使用方法。

2.1 准备用户信息

管理员点击「服务器>服务器数据集」，新建内置数据集「定时调度用户信息」，数据集内容如下图所示：

这个数据集既是平台用户信息表，也是模板参数取数表，需要保证选择的「name」列数据与平台中的用户名一致，否则任务执行无法成功。

2.2 准备模板

模板设计步骤请参考：第一张普通报表。

模板样式如下图所示：

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 文件和附件。