1. 概述
1.1 版本
| FineBI服务器版本 | App 版本 |
|---|---|
| 6.0 | V11.0 |
1.2 应用场景
下面情况下，用户希望将定时任务结果推送至 App 中：
销售行业中，一个厂家会有很多分销商，分销商需要从厂家那里进行采购，汇款等一系列操作；厂家也会定期给分销商发送信息，告知他们货物的剩余情况，汇款情况等。
公司发工资后，给员工发送一份关于该员工的工资消息。
1.3 功能简介
用户设置定时调度任务时，在「文件处理」步骤中勾选「客户端通知」，即可将定时任务结果推送到 FineMobile 数据分析 App 中，用户登录即可查看。
本文第二章通过一个简单示例演示定时调度客户端通知功能的使用方法。
本文第三章对定时调度客户端通知功能进行详细讲解。
注：本文仅详细介绍「客户端通知-APP通知」处理方式推送BI模板的功能和注意事项。
推送FineReport模板的相关介绍，请参见：定时调度客户端通知-APP通知 。
2. 示例
本文示例：通过定时调度任务，每天晚上 18 时，给销售部销售主管的 APP 客户端推送最新的销售明细情况。
示例仪表板：「行业应用>零售电商>销售管理中心驾驶舱」主题下的「产品销售分析」仪表板。
该仪表板调用的数据为：「公共数据>部门数据>销售_Lisa」文件夹中的数据表。
2.1 复制模板链接
在设置定时调度任务前，需要先获取定时调度中使用的仪表板的链接，以便将仪表板推送给用户APP端。
选中「行业应用>零售电商>销售管理中心驾驶舱」主题下的「产品销售分析」仪表板，URL链接中report后的ID即为仪表板ID。
仪表板预览链接形如：http://IP:port/webroot/decision/v5/design/report/仪表板ID/view
注1：链接中的IP不可为「localhost」，必须更换为电脑实际的 IP 地址。
注2：APP端必须可访问该网址，如内外网环境不互通则无法访问。
2.2 分配组件数据权限
用户如需查看定时调度中使用的 BI 模板，必须拥有该仪表板调用的数据表的组件数据权限。
管理员登录FineBI系统，点击「管理系统>权限管理>普通权限配置>权限快速配置」。
选择「部门>销售部>销售主管」，点击「数据权限」，为其分配「公共数据>部门数据>销售_Lisa」文件夹的「组件数据」权限。如下图所示：
2.3 分配模板认证权限
注：此操作的前提是系统开启了 模板认证 中的 角色权限认证 功能。如未开启，无需执行本操作。
开启了角色权限认证后，管理员需要给对应的用户赋予相应 BI 模板的查看权限，否则用户将不能查看该仪表板。
点击「管理系统>模板认证>普通权限配置>权限快速配置」，选择「部门>销售部>销售主管」，为其分配「产品销售分析」仪表板的「查看权限」。如下图所示：
2.4 添加任务
管理员登录FineBI系统，点击「管理系统>定时调度>任务管理」，点击「添加任务」，添加一个定时调度任务。如下图所示：
2.5 基本设置
1）「任务名称」设置为「销售业绩达成情况」。
2）点击「默认用户组」的「编辑」按钮。部门选择销售部的「销售主管」，点击确定。如下图所示：
确认部门处已选定「所有部门:销售部:销售主管; 」，点击「确定」，默认用户组设置完成。点击「下一步」，如下图所示：
2.6 调度对象
1）对象类型选择「BI模板」，选择模板：「行业应用>零售电商>销售管理中心驾驶舱」主题下的「产品销售分析」仪表板。
2）文件名称设置为「${now()}的销售情况」。
点击「下一步」，如下图所示：
2.7 调度周期
执行频率选择「明细频率设置」，点击「添加」。
设置执行时间为「18时0分」，执行日为「每日」，执行月为「全选」，点击「确定」，即可成功添加明细频率。
点击「下一步」。如下图所示：
2.8 文件处理
1）处理方式勾选「客户端通知」。
2）在「客户端通知」设置中：
推送终端勾选：「APP通知」
收件人为：「默认用户组」
主题为：${today()}的销售情况
内容为：今天销售情况请查收。
链接勾选：「自定义链接」，填写 2.1 节获取的链接。
点击「保存」，如下图所示：
2.9 效果预览
由于该任务的执行频率是每天晚上18时执行一次，无法立刻看到任务效果。
为了立刻看到任务效果，可在「管理系统>定时调度>任务管理」界面找到该任务，选择「执行一次」。
职位「销售部>销售主管」对应的用户是Lisa（Lisa，1）。
当任务执行一次后，Lisa（Lisa，1）登录 FineMobile 数据分析 App，收到一条新消息。如下图所示：
3. 功能详情
在「定时调度>文件处理」步骤中，用户可选择「客户端通知」处理方式，客户端通知中可选择推送终端为「APP通知」。如下图所示：
本章将详细介绍「客户端通知-APP通知」处理方式推送BI模板的功能和注意事项。
注：「客户端通知-APP通知」处理方式推送FineReport模板的相关介绍，请参见：定时调度客户端通知-APP通知 。
3.1 前提条件
3.1.1 内网环境
BI 工程服务器需要能够访问消息推送服务器，才能够正常使用推送功能，但 BI 工程内网环境下无法访问推送服务器。
管理员可通过设置一个代理服务器，通过代理服务器来转发内网 BI 服务器和外部的通信。
详情请参见：代理服务器配置 。
3.1.2 用户权限
BI 仪表板是通过链接形式推送给用户的。
1）定时调度不受目录查看权限限制。仪表板无需挂载在数据决策系统目录中，若挂载了，用户也无需拥有该仪表板的查看权限。
2）用户必须有该仪表板中的组件数据查看权限，如下图所示：
若用户没有仪表板的数据的查看权限，则提示「您暂时无权限查看该组件的数据，请联系管理员」，如下图所示：
3）若系统开启了 模板认证 中的 角色权限认证 功能。用户必须有该仪表板的模板认证的查看权限。
若用户没有模板认证的该仪表板查看权限，则提示「用户没有模板权限」，如下图所示：
3.2 收件人
收件人为「定时调度>基本设置」中设置的默认用户组，定时调度任务会给默认用户组的APP客户端推送消息。
因此如需使用「客户端通知-APP通知」，则必须要设置默认用户组，否则消息无法发送给任何人。
3.3 消息类型
「客户端通知-APP通知」，仅支持链接消息，其它消息类型都将转为链接消息进行发送。
注：微信和钉钉中支持图文和文件消息，详情请参见： 微信钉钉推送支持其他消息类型
3.4 主题
主题就是客户端消息的标题、链接打开的标题，必填项，不可为空。
1）主题支持普通文本，手动输入即可。
2）主题支持公式，可以使用的公式请参见：定时调度支持的公式 。
3.5 内容
内容就是消息的正文内容，非必填项。
1）支持文本
内容支持普通文本，手动输入即可。
2）支持公式
内容支持公式，可以使用的公式请参见：定时调度支持的公式 。
3.6 链接
有两种类型，分别为定时结果链接、自定义链接。
1）定时结果链接，是指FineReport报表在定时调度任务中生成的cpr附件，BI模板不存在该项内容。
因此仅在选择「FineReport 模板」时可使用定时结果链接，选择「BI模板」时无法使用定时结果链接。
2）自定义链接，可挂载预览BI仪表板时的 URL 。
注：需根据实际情况修改 预览模板 生成 URL 中的 IP ，自定义链接才能生效。若使用「localhost」等无法打开的IP，则提示「网页无法打开」，如下图所示：
