1. 概述
1.1 版本
| 报表服务器版本 | 功能变更 |
|---|---|
| 11.0 | - |
| 11.0.5 | 若勾选「除通用结果外，根据默认用户组内的用户单独生成结果」，则在 SFTP 服务器存放路径中仅包含独立报表结果，不包含通用结果，且会根据每个用户生成对应的文件夹存放文件。 |
1.2 应用场景
在定时任务完成后想把生成的文件备份防止丢失，或把生成的文件直接上传到其他的 SFTP 服务器上面。
此时就可通过定时调度任务上传附件到 SFTP 上。
2. 示例
本文示例：通过定时调度任务，每天晚上 18 时，将当日的销售明细情况附件上传到 SFTP 服务器中。
2.1 配置 SFTP 服务器
用户需要先配置好一个用于存储文件的 SFTP 服务器。本文示例的 SFTP 服务器在 Windows 系统中。
配置方法请参见：Linux 系统配置使用 SFTP 或 Windows 系统配置使用 SFTP 。
2.2 添加任务
管理员登录数据决策系统，点击「管理系统>定时调度>任务管理」，点击「添加任务」，添加一个定时调度任务。如下图所示：
2.3 基本设置
1）「任务名称」设置为「今日销售明细」。
2）「默认用户组」无需设置。
点击「下一步」，如下图所示：
2.4 调度对象
1）对象类型选择「报表模板」，选择模板「GettingStarted.cpt」。
2）文件名称设置为「${now()}的销售情况」。
3）附件存档全部勾选。
4）文件处理选择「不清理」。
点击「下一步」，如下图所示：
注1：附件存档勾选的文件类型，即为上传到SFTP的文件类型。
注2：11.0.5 及之后版本的工程，若勾选「除通用结果外，根据默认用户组内的用户单独生成结果」，则在 SFTP 服务器存放路径中仅包含独立报表结果，不包含通用结果，且会根据每个用户生成对应的文件夹存放文件。
2.5 调度周期
执行频率选择「明细频率设置」，点击「添加」。
设置执行时间为「18时0分」，执行日为「每日」，执行月为「全选」，点击「确定」，即可成功添加明细频率。点击「下一步」。如下图所示：
2.6 文件处理
1）处理方式勾选「SFTP上传附件」。输入对应的服务器信息，选择传输模式。如下图所示：
服务器信息具体配置如下表所示：
| 配置项 | 说明 |
|---|---|
| 服务器地址 | SFTP 服务器的 ip 地址 直接输入XXX.X.XXX.XXX即可，请勿输入sftp://XXX.X.XXX.XXX/，否则会报错「invalid IPv6 address」 |
| 端口 | SFTP 服务器的端口号 |
| 保存路径 | 定时调度任务所生成附件的保存路径 Windows 系统： 若 SFTP 服务器在 Windows 系统中，「保存路径」为相对路径，即以 SFTP 服务器的根目录开始的路径，例如 SFTP 服务器的根目录为：D:\SFTP\aaaa，希望附件上传到D:\SFTP\aaaa，「保存路径」为/ 注：SFTP 服务器的根目录介绍请参见：Windows 系统配置使用 SFTP 文档的 4.4 节内容 Linux 系统： 若 SFTP 服务器在 Linux 系统中，「保存路径」为绝对路径 |
| 用户名 | 访问 SFTP 服务器的用户名 |
| 密码 | 访问 SFTP 服务器的密码 直接输入密码： 在右侧文本框中直接输入用户名密码即可 上传密钥文件： 点击钥匙图标，上传密钥文件 注：定时调度仅支持 OpenSSH 格式密钥，否则会连接 SFTP 失败。 1）若选择上传密钥文件，需要关闭 文件上传校验按钮 2）若选择上传密钥文件，集群环境下切换文件服务器方式后，需要将工程中的%FR_HOME%\webapps\webroot文件夹复制到文件服务器的根目录下，定时调度任务才能正常执行 |
2）点击「测试上传」，跳出「测试上传成功」弹窗，选择「保存」即可，如下图所示：
2.7 效果预览
由于该任务的执行频率是每天晚上18时执行一次，无法立刻看到任务效果。
为了立刻看到任务效果，可在「管理系统>定时调度>任务管理」界面找到该任务，选择「执行一次」。
当任务执行一次后，打开 SFTP 服务器对应文件夹位置，可以发现附件已成功上传。
注：若新生成的文件与服务器中已有文件重名，会将历史文件加上时间戳进行重命名。
