前提准备
用户需要进行以下部署和配置才能使用“消息推送”功能:
- 部署企业微信扩展包并在系统选项中配置“企业应用Secret”,详情请参考 企业微信扩展包使用流程;
- 在用户角色的操作权限中勾选“推送到企业号”,详情请参考 操作权限列表 。
推送报表消息
Smartbi支持以应用消息的方式推送自助仪表盘、电子表格类型的资源到企业微信。
1、在报表上右键选择“推送到企业号”。
2、填写企业应用、推送类型、推送给哪些成员、标题等信息,点击 推送(O) 按钮,将报表推送到企业微信。
设置项说明如下:
部署企业微信扩展包创建的企业应用。
设置打开资源时访问的客户端类型,包括:
- 自动:系统自动判断;
- 移动端:使用移动端访问推送消息;
- 电脑端:使用电脑端访问推送的消息。
- 静默授权:用户点击链接后,页面直接打开报表
- 手动授权:用户点击链接后,会弹出一个中间页,让用户选择是否授权,用户确认授权后再打开报表
消息推送可以指定用户、部门、标签为推送对象。
消息推送给全体成员,默认 。
推送消息的封面。
3、打开企业微信,打开企业应用”ldytest“发送的消息,可看到刚才推送的报表。
点击报表显示具体内容:
推送其它类型的消息
概述
Smartbi支持推送多种类型的消息到企业微信,包括文本消息、图片消息、语音消息、视频消息、文件消息、文本卡片消息、图文消息、mpnews图文消息以及markdown消息。
获取消息信息
用户需要先通过企业微信工具箱获取消息的相关信息,详情请参考 企业微信工具箱 。
发送消息
根据需求的不同,可通过私聊或群聊发送消息。
发送私聊信息
1、将生成的消息信息替换到代码对应的位置中,并删除其他消息类型代码。
代码块 | ||||||
---|---|---|---|---|---|---|
| ||||||
// appid var appid = "1000005"; // 发送人,可以选人或者部门 var receiver = JSON.stringify({ "user": "XiaoXi" }); // 文本类型的信息 var msg = JSON.stringify({ "msgType": "text", "msgContent": { "content": "测试发送信息" } }); // 发送图片类型的信息 msg = JSON.stringify({ "msgType": "image", "msgContent": { "media_id": "3snBPC9exFWCdtZwFGRoTNKnN1ffTLYyQwwvkeqDg9pIfm-ZGE7yW1nK5uIEOW1TY" } }); // 发送文本卡片 var msg = JSON.stringify({ "msgType": "textcard", "msgContent": { "title": "测试文本卡片", "description": "看一看demo站点上的这个电子表格", "url": "https://demo.smartbi.com.cn/smartbi/vision/openresource.jsp?resid=I402881ba7c65508101487ca738e500a2&user=demo&password=demo", "btntxt": "打开报表" } }); // 发送markdown信息 var msg = JSON.stringify({ "msgType": "markdown", "msgContent": { "content": "#一级标题 \r\n##二级标题 \r\n**文字超链**:[简书](http://www.jianshu.com)" } }); // 发送图文消息 var msg = JSON.stringify({ "msgType": "news", "msgContent": { "articles":[ { "title": "新闻1", "description": "看一看demo站点上的这个电子表格", "url": "https://demo.smartbi.com.cn/smartbi/vision/openresource.jsp?resid=I402881ba7c65508101487ca738e500a2&user=demo&password=demo", "picurl": "https://pic.ntimg.cn/20110811/8029346_082444436000_2.jpg" },{ "title": "新闻2", "description": "11123格", "url": "https://demo.smartbi.com.cn/smartbi/vision/openresource.jsp?resid=I402881ba7c65508101487ca738e500a2&user=demo&password=demo", "picurl": "https://pic.quanjing.com/k6/67/QJ6278220913.jpg" },{ "title": "新闻2", "description": "3341212表格", "url": "https://demo.smartbi.com.cn/smartbi/vision/openresource.jsp?resid=I402881ba7c65508101487ca738e500a2&user=demo&password=demo", "picurl": "https://pic.quanjing.com/32/3g/QJ6107931496.jpg" } ] } }); // 发送mpnews图文消息 var msg = JSON.stringify({ "msgType": "mpnews", "msgContent": { "articles":[ { "title": "新闻1", "thumb_media_id": "3snBPC9exFWCdtZwFGRoTNKnN1ffTLYyQwwvkeqDg9pIfm-ZGE7yW1nK5uIEOW1TY", "author": "系统用户1", "content": "<html><body><b>看一看demo站点上的这个电子表格</b></body></html>", "content_source_url": "https://demo.smartbi.com.cn/smartbi/vision/openresource.jsp?resid=I402881ba7c65508101487ca738e500a2&user=demo&password=demo", },{ "title": "新闻2", "thumb_media_id": "3snBPC9exFWCdtZwFGRoTNKnN1ffTLYyQwwvkeqDg9pIfm-ZGE7yW1nK5uIEOW1TY", "author": "系统用户2", "content": "<html><body><b>看一看demo站点上的这个电子表格</b></body></html>", "content_source_url": "https://demo.smartbi.com.cn/smartbi/vision/openresource.jsp?resid=I402881ba7c65508101487ca738e500a2&user=demo&password=demo", },{ "title": "新闻3", "thumb_media_id": "3snBPC9exFWCdtZwFGRoTNKnN1ffTLYyQwwvkeqDg9pIfm-ZGE7yW1nK5uIEOW1TY", "author": "系统用户3", "content": "<html><body><b>看一看demo站点上的这个电子表格</b></body></html>", "content_source_url": "https://demo.smartbi.com.cn/smartbi/vision/openresource.jsp?resid=I402881ba7c65508101487ca738e500a2&user=demo&password=demo", } ] } }); // 发送 connector.remoteInvoke("WeiXinModule", "sendAppMessage", [ appid, receiver, msg]); |
以发送图片类型的消息为例,如图:
2、在任务页面中,点击 新建任务 按钮新建一个任务。
3、填写任务名称,选择任务类型为“定制”,将刚才修改好的代码复制到自定义设置中,点击 保存 按钮保存。然后点击 测试运行(T) 按钮,将消息发送到企业微信。
4、打开企业微信,打开企业应用”ldytest“发送的消息,可看到刚才推送的图片。
创建群聊并发送信息
1、将生成的消息信息替换到代码对应的位置中,并删除其他消息类型代码。
代码块 | ||||||
---|---|---|---|---|---|---|
| ||||||
// 创建人 var ownerId = "XiaoHua"; // 群聊用户列表,用|分隔 var userIds = "XiaoHua|XiaoMing"; // appid var appid = "1000005"; // 群聊名字 var name = "测试群聊"; var chartId = ""; // 创建群聊,每执行一次就创建一个新的,因此最好找地方保存 var rtn = connector.remoteInvoke("WeiXinModule", "createAppChat", [appid, name, ownerId, userIds]); if (rtn && rtn.succeed) { chartId = rtn.result; } // 文本类型的信息 var msg = JSON.stringify({ "msgType": "text", "msgContent": { "content": "测试发送信息" } }); // 发送图片类型的信息 msg = JSON.stringify({ "msgType": "image", "msgContent": { "media_id": "@lADPDfYH0l5peu7NAg3NArw" } }); // 发送链接的信息 var msg = JSON.stringify({ "msgType": "link", "msgContent": { "messageUrl": "https://demo.smartbi.com.cn/smartbi/vision/openresource.jsp?resid=I402881ba7c65508101487ca738e500a2&user=demo&password=demo", "picUrl":"@lADPDfYH0l5peu7NAg3NArw", "title": "这是一个测试链接", "text": "看一看手机demo站点上的这个电子表格" } }); // 发送markdown信息 var msg = JSON.stringify({ "msgType": "markdown", "msgContent": { "title": "这是一个markdown测试", "text": "#一级标题 \r\n##二级标题 \r\n**文字超链**:[简书](http://www.jianshu.com)" } }); // 发送卡片的信息 var msg = JSON.stringify({ "msgType": "action_card", "msgContent": { "title": "这是一个卡片测试", "markdown": "#一级标题 \r\n##二级标题 \r\n**文字超链**:[简书](http://www.jianshu.com)", "single_title": "查看详情", "single_url": "https://demo.smartbi.com.cn/smartbi/vision/openresource.jsp?resid=I402881ba7c65508101487ca738e500a2&user=demo&password=demo" } }); connector.remoteInvoke("WeiXinModule", "sendAppChatMessage", [appid, chartId, msg]); |
以发送图片类型的消息为例,如图:
2、打开系统监控中的日志,进行监控(用于获取创建群聊生成的chartId)。
3、在任务页面中,点击 新建任务 按钮新建一个任务。
4、填写任务名称,选择任务类型为“定制”,将刚才修改好的代码复制到自定义设置中,点击 保存 按钮保存。然后点击 测试运行(T) 按钮,创建群聊并将消息发送到企业微信。
5、打开企业微信,可看到新建的群聊和推送的图片。
6、创建群聊完成后,在日志中可查看并保存chartId。
下次想要直接在群聊中发送消息,需要在代码中添加chartId并删除创建群聊部分的代码。