反馈已提交

网络繁忙

模板消息事件插件

  • 文档创建者:caixiaolan
  • 历史版本:42
  • 最近更新:HeroZ 于 2023-02-06
  • 1. 概述

    1.1 版本

    报表服务器版本
    插件名称
    插件版本
    功能变动
    11.0模板消息事件V1.7.5
    -

    注:安装此插件必须开通 WebSocket 端口,否则平台消息提醒时不会弹出提示框,详情参见文档:WebSocket端口未开放提醒

    1.2 应用场景

    实时推送消息至移动端,可以做到信息的快速传输。无论是一线人员还是企业管理者,都可以随时随地通过手机了解业务状态,提高数据的信息价值。

    • 员工进行信息填报后,需要实时推送微信消息,告知上级及时审批。

    • 领导填写信息后,可以选择不同责任人,责任人第一时间收到消息提醒和对应任务。

    • 银行登记 ETC 客户后,需要将 ETC 客户情况实时推送给领导,领导可以及时了解到 ETC 客户信息。

    1.3 功能简介

    模板消息事件支持移动端,填报成功后,即时推送消息至 App、微信、钉钉,让消息的快速和精准传递变得更加简单。

    通过 模板消息事件 插件、钉钉管理 插件、微信管理 插件,达成此功能。

    1.4 注意事项

    1)若微信钉钉集成要通过模板消息事件插件发送单个模板的链接。支持在集成插件中,直接生成单个模板访问链接,并为模板设置参数,在本文 3.1.2 节使用。不需要自己拼接链接。

    2)模板消息插件不支持推送至二级及以下部门用户。

    2. 插件介绍

    2.1 准备工作

    安装「 模板消息事件 」插件。

    若要推送至 App,需安装并配置好 App ,参考文档:App 使用

    若要推送至微信钉钉,需安装 钉钉管理 插件、微信管理 插件并绑定数据决策系统。建议设置好单点登录。

    2.2 模板消息设置入口

    1)右击某一单元格,选择「控件设置>事件编辑」,新增事件中,增加「模板消息」,如下图所示:

    35.png
    2)点击「菜单模板>模板 Web 属性」,三种预览方式下的「事件设置」中都增加「模板消息」,如下图所示:

    24.png

    3. 示例

    下面以一个简单的实例进行说明,填报成功后,通知对应人查看模板。

    3.1 添加模板 Web 属性

    打开模板:%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\Form\LineForm\LineForm.cpt

    点击「模板>模板 Web属性」,选择「填报页面设置」,选择「为该模板单独设置」,添加「填报成功」事件,事件类型为「模板消息」,如下图所示:

    66.png

    3.1.1 设置消息接收对象

    模板消息可以发送给平台用户、角色和机构部门,最终接收对象为三项的并集。

    这里以用户做示例,发送模板消息给 Alice 。

    1571300564195260.png

    注:可以输入多用户,以逗号隔开,例如:用户1,用户2,用户3。

    注:用户、角色、部门不能同时为空。

    3.1.2 填写消息内容

    1)客户端:

    • 默认支持 PC 平台及 App 。用户可通过安装钉钉 / 微信管理插件,增加微信 / 钉钉客户端。

    • 「微信/钉钉应用」选择框下拉读取微信/钉钉插件中配置的应用名称。

    • 不勾选微信/钉钉复选框时,微信 / 钉钉应用下拉框灰化不可编辑。

    2)链接:

    • 示例:decision/view/report?viewlet=LineForm.cpt&op=h5

    • 表示模板消息发送后打开的模板,该模板以「分页预览」的方式打开。

    • 链接不能为空。

    注1:通过“生成钉钉链接”,参数名和参数值中都不能包含中文,否则 PC 端传参会失败。

    注2:微信钉钉集成后,如果想生成模板推送链接,在「应用快捷配置」中「生成单个模板链接」,同时可以为模板添加设置参数。微信集成参见文档:企业微信集成 2.2.3 节;钉钉集成参见:钉钉管理插件 2.7.2 节。

    3)标题:模板消息发送的标题。

    4)内容:消息提示内容。

    5)封面图:

    • 选填建议尺寸 640*320,即宽高比 2:1,5M 以内 JPG、PNG 格式图片。

    • 选择图片后显示样式为适应。

    • 封面图只在微信、钉钉中有效

    如下图所示:

    1571383463998930.png

    注:链接、标题、内容中都支持输入公式。使用参数时,参数默认值只能取到模板参数和全局参数,数据集参数默认值获取不到

    注:链接、标题、内容中如有中文或特殊字符(如+ \ /)等需要正确转换

    3.1.3 模板消息事件全局校验

    模板消息事件的设置需满足以下条件,按照优先顺序,只提示第一个错误信息。

    优先级
    校验对象
    提示信息
    1消息接收对象不允许为空用户名、角色和部门不能同时为空
    2应用不允许为空请设置推送的微信应用/钉钉应用
    3链接不允许为空链接不能为空
    4标题不允许为空标题不能为空
    5内容不允许为空内容不能为空

    3.2 决策系统中添加模板

    设置完点击事件后,将模板保存。启动内置服务器。

    在浏览器中输入 http://localhost:8075/webroot/decision ,登录管理员账号,打开 FineReport 报表平台。

    点击「管理系统>目录管理」将报表添加到决策系统中。

    打开模板,修改数据后,点击提交,跳出「消息发送成功」提示,即将消息发送给 Alice,如下图所示:
    19.png

    注:如果消息不在平台里发送,单独访问模板时发送,取不到用户时,跳出「消息发送失败,无发送者」提示。如下图所示:

    20.png

    3.3 效果查看

    3.3.1 PC 端

    登录 Alice 的账号,模板消息已经发送过来,点击右上角,点击「我的消息>模板消息>处理」,即可跳转到对应模板。

    或者直接点击右下角新消息的「处理」,即可跳转到对应模板。如下图所示:

    21.png

    3.3.2 App

    使用与 Alice 匹配的账号登录 App ,可以在消息中看到模板消息事件通知。如下图所示:

    d81a59c82b91826136c8826fd12c1e6b.jpg

    3.3.3 微信

    使用与 Alice 匹配的账号登录企业微信,可以看到绑定的应用发送了模板消息事件通知,点击即可查看。如下图所示:

    23.png

    3.3.4 钉钉

    使用与 Alice 匹配的账号登录钉钉,可以看到绑定的应用发送了模板消息事件通知,点击即可查看。如下图所示:

    1571383796830987.png

    附件列表


    主题: 安装与升级
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持