1. 概述
1.1 版本
| 报表服务器版本 | 功能变更 |
|---|---|
| 11.0.9 | 微信、钉钉、飞书、WeLink 定时调度推送消息支持「图片消息」 |
| 11.0.4 | 文件处理-客户端通知-自定义链接支持输入公式 |
| 11.0 | - |
1.2 应用场景
下面情况下，用户希望将定时任务结果推送至 App 中：
销售行业中，一个厂家会有很多分销商，分销商需要从厂家那里进行采购，汇款等一系列操作；厂家也会定期给分销商发送信息，告知他们货物的剩余情况，汇款情况等。
公司发工资后，给员工发送一份关于该员工的工资消息。
1.3 功能简介
用户设置定时调度任务时，在「文件处理」步骤中勾选「客户端通知」，即可将定时任务结果推送到 FineMobile 数据分析 App 中，用户登录即可查看。
本文第二章通过一个简单示例演示定时调度客户端通知功能的使用方法。
本文第三章对定时调度客户端通知功能进行详细讲解。
1.4 功能扩展
本文仅介绍如何通过定时调度任务推送消息至 FineMobile 数据分析 App 。
但定时调度客户端通知也可推送至微信、钉钉等第三方平台，详情请参见以下文档：
2. 示例
本文示例：通过定时调度任务，每天晚上 18 时，给销售部saleLeader的 APP 客户端推送最新的销售明细情况。
2.1 添加任务
管理员登录数据决策系统，点击「管理系统>定时调度>任务管理」，点击「添加任务」，添加一个定时调度任务。如下图所示：
2.2 基本设置
1）「任务名称」设置为「今日销售明细」。
2）点击「默认用户组」的「编辑」按钮。部门选择销售部的「saleLeader」，点击确定。如下图所示：
确认部门处已选定「所有部门:销售部:saleLeader; 」，点击「确定」，默认用户组设置完成。点击「下一步」，如下图所示：
2.3 调度对象
1）对象类型选择「报表模板」，选择模板「GettingStarted.cpt」。
2）文件名称设置为「${now()}的销售情况」。
点击「下一步」，如下图所示：
2.4 调度周期
执行频率选择「明细频率设置」，点击「添加」。
设置执行时间为「18时0分」，执行日为「每日」，执行月为「全选」，点击「确定」，即可成功添加明细频率。
勾选刚添加的明细频率，点击「下一步」。如下图所示：
2.5 文件处理
1）处理方式勾选「客户端通知」。
2）在「客户端通知」设置中：
推送终端勾选：「APP通知」
收件人为：「默认用户组」
主题为：${today()}的销售情况
内容为：今天销售情况请查收。
链接勾选：「定时结果链接」
勾选：正文加上结果链接
勾选：使用附件
点击「保存」，如下图所示：
2.6 效果预览
由于该任务的执行频率是每天晚上18时执行一次，无法立刻看到任务效果。
为了立刻看到任务效果，可在「管理系统>定时调度>任务管理」界面找到该任务，选择「执行一次」。
职位「销售部saleLeader」对应的用户是Lisa（Lisa，123456）。
当任务执行一次后，Lisa（Lisa，123456）登录 FineMobile 数据分析 App，收到一条新消息。如下图所示：
3. 功能详情
在「定时调度>文件处理」步骤中，用户可选择「客户端通知」处理方式，客户端通知中可选择推送终端为「APP通知」。如下图所示：
本章将详细介绍「客户端通知-APP通知」处理方式的功能和注意事项。
3.1 前提条件
报表工程服务器需要能够访问消息推送服务器，才能够正常使用推送功能，但报表工程内网环境下无法访问推送服务器。
管理员可通过设置一个代理服务器，通过代理服务器来转发内网报表服务器和外部的通信。
详情请参见：代理服务器配置 。
3.2 收件人
收件人为「定时调度>基本设置」中设置的默认用户组，定时调度任务会给默认用户组的APP客户端推送消息。
因此如需使用「客户端通知-APP通知」，则必须要设置默认用户组，否则消息无法发送给任何人。
3.3 消息类型
「客户端通知-APP通知」，仅支持链接消息，其他消息类型都将转为链接消息进行发送。
注：微信、钉钉、飞书、WeLink 中支持图文、文件和图片消息，详情请参见： 第三方集成推送支持的消息类型
3.4 主题
主题就是客户端消息的标题、链接打开的标题，必填项，不可为空。
1）主题支持普通文本，手动输入即可。
2）主题支持公式，可以使用的公式请参见：定时调度支持的公式 。
3.5 内容
内容就是消息的正文内容，非必填项。
1）支持文本
内容支持普通文本，手动输入即可。
2）支持公式
内容支持公式，可以使用的公式请参见：定时调度支持的公式 。
3.6 链接
有两种类型，分别为定时结果链接、自定义链接。
1）定时结果链接，为生成的调度对象结果报表内容。
2）自定义链接，可挂载FineReport 设计器中 预览模板 时生成的 URL 。
若自定义链接为填报模板点击填报预览生成的链接，可在客户端实现填报功能。
注1：需根据实际情况修改 预览模板 生成 URL 中的 IP ，自定义链接才能生效。
注2：11.0.4 及之后版本的报表工程，自定义链接支持使用公式输入，支持的格式请参见：定时调度支持的公式 。
