关于企业微信集成的使用流程如下:
一、申请企业微信
首先用户要有一个企业微信号,之前叫企业号,现在企业号统一升级为企业微信,企业微信的申请流程详细见文档企业微信简介 ,或者微信官方网站信息。
二、搭建Smartbi外网环境
Smartbi服务要求能够外网访问,并且端口号为80或者443(微信的要求),若不能打开则应通过其他代理手段来达成(如:阿里云)。
并且需要下载并加载集成企业微信的扩展包,扩展包可从此处下载:WeiXinEx.ext,如何部署此扩展包请参考文档:扩展包部署
三、配置基本信息
由于smartbi需要和企业微信集成到一起,在加载扩展包之后,需要到smartbi系统中配置一些基本信息。包括微信CropID和smartbi域名。
1.登录进入企业微信,在“我的企业”中,找到如下CropID项,拷贝对应的CropID串
2.访问smartbi,打开“定制管理”-》“系统运维”-》“系统选项”-》“微信设置”,将上一步骤中拷贝的CropID串拷贝到微信CropID位置中:
3.以外网地址访问smartbi,点击“服务器地址”右方的“自动获取”,设置服务器地址(注意一定要是80端口或443端口的外网地址访问smartbi,若是使用内网地址访问,可以直接输入外网服务器地址)
四、同步用户
无论是正式使用集成企业微信的功能还是只是进行测试,一般都会使用一些微信号进行测试。因此先进行同步用户的操作。步骤如下:
1.登录进入企业微信,切换到“管理工具”,点击“通讯录同步”,进入通讯录同步设置界面
2.点击“开启API接口同步”,进入设置界面
3.在“权限”一项后面点击“编辑”
将权限修改为“编辑通讯录权限”,并保存
4.至此通讯录同步设置完成,接下来需要拷贝通讯录同步下的Secret
5.访问smartbi系统,在系统选项的“微信设置”中,将拷贝出来的Srcret串粘贴到“微信Secret”一项中,如下:
并设置“是否同步微信用户”为“是”
6.在smartbi中创建用户组,注意用户组需要填写编号,编号为数字,并且编号必须唯一。(这是遵循企业微信的接口规范)另外,要求编号不允许为“1”。
7.创建用户。注意用户信息中的“微信账号”目前必须绑定手机号码。若不绑定手机号码,则无法正常在微信中登录smartbi,如下:
另外,可以将“是否强制修改密码”设为“否”
接下来正常为用户设置角色和权限即可。
8.创建完用户组及用户时,在企业微信中自动会同步部门和用户,如下:
9.若是smartbi系统中已有的组和用户,那么注意修改组编号以及用户信息中的“微信账号”,再点击工具栏上的“同步到微信”,即可将系统中的用户和组均同步到企业微信中
点击“同步到微信”
同步中:
同步成功:
若存在未同步成功的情况,则会显示出相应的信息。
2.系统接入企业微信,填写必要的参数。
2.1 进入【SmartBI】定制管理-系统选项-微信设置
2.2 配置CorpId 和 Secret。
CorpId获取方式:
a.注意同步通讯录需要配置通讯录应用对应的secret,获取方式如下:
同时,应该注意,如果需要同步通讯录到微信,需要开启通讯录权限:
在这里需要选择编辑通讯录权限。
配置好这些就可以进行通讯录同步了。
b.推送报表到对应的应用的时候,需要配置对应的应用的secret。
首先点击企业应用进入应用列表:
如果没有应用,可以点击添加应用新建一个应用。
假如现在我们想推送消息到smartBIt这个应用,则点击该应用进入详情页面查看其对应的secret。
这样就配置好了CorpId 和 Secret。
2.3配置可信域名,创建微信链接的必要条件。填写服务器的地址,并在企业微信的应用里设置好可信域名。域名使用二级或者二级以上,而且已经通过备案。端口为80或者443
【企业微信】 企业应用-smartBIt-网页授权及JS-SDK
3.同步系统用户到企业微信
注意:同步用户信息时,必须按照2中的配置来设置secret信息。
3.1 组的创建与修改同步【SmartBI】用户管理-新建组 对应 【企业微信】通讯录-部门
3.2用户的同步,其中微信帐号可以填微信号,邮箱,手机;并且必须和企业微信里面的微信账号一一对应。
【SmartBI】用户管理-新建用户 对应 【企业微信】通讯录-部门-成员
3.3批量同步用户
3.3.1这是一个异步的同步操作,用户点击【用户同步到微信】后,会返回一个JobId。
3.3.2点击【微信同步结果】系统会根据JobId查看同步的情况。只有出错的记录才会显示出来,成功的只会显示成功的个数。
4.生成微信链接 可以分享到企业微信的应用里。如:发给好友,朋友圈之类。前提是用户为系统用户或者微信用户才能访问。
注意:要将报表分享到哪个应用,就需要在步骤2中配置对应应用的secret。
4.1 单个报表分享【SmartBI】任意一个报表,点击鼠标右键。
点击复制,就可以使用链接在企业微信分享报表。
分享到企业微信应用里
4.2 整站型报表链接分享【SmartBI】 系统运维-系统选项-微信设置-生成微信链接
这个链接指的是整个应用的入口。
4.3 微信端访问之前必须设置发布到手机主题才能访问。
5.分享功能(正在开发中)
用户可以在浏览企业微信里,分享报表内容,【发给朋友】【分享朋友圈】【分享QQ空间】等。