关于企业微信集成的使用流程如下:
一、申请企业微信
首先用户要有一个企业微信号,之前叫企业号,现在企业号统一升级为企业微信,企业微信的申请流程请访问企业微信官方网站。
二、搭建Smartbi外网环境
Smartbi服务要求能够外网访问,并且端口号为80或者443(微信的要求),若不能打开则应通过其他代理手段来达成(如:阿里云)。
并且需要下载并加载集成企业微信的扩展包,扩展包可从此处下载:WeiXinEx.ext,如何部署此扩展包请参考文档:扩展包部署
三、配置基本信息
由于smartbi需要和企业微信集成到一起,在加载扩展包之后,需要到smartbi系统中配置一些基本信息。包括微信CropID和smartbi域名。
1.登录进入企业微信,在“我的企业”中,找到如下CropID项,拷贝对应的CropID串
2.访问smartbi,打开“定制管理”-》“系统运维”-》“系统选项”-》“微信设置”,将上一步骤中拷贝的CropID串拷贝到微信CropID位置中:
3.以外网地址访问smartbi,点击“服务器地址”右方的“自动获取”,设置服务器地址(注意一定要是80端口或443端口的外网地址访问smartbi,若是使用内网地址访问,可以直接输入外网服务器地址)
4.配置完并保存即可。
四、同步用户
无论是正式使用集成企业微信的功能还是只是进行测试,一般都会使用一些微信号进行测试。因此先进行同步用户的操作。步骤如下:
1.登录进入企业微信,切换到“管理工具”,点击“通讯录同步”,进入通讯录同步设置界面
2.点击“开启API接口同步”,进入设置界面
3.在“权限”一项后面点击“编辑”
将权限修改为“编辑通讯录权限”,并保存
4.至此通讯录同步设置完成,接下来需要拷贝通讯录同步下的Secret
5.访问smartbi系统,在系统选项的“微信设置”中,将拷贝出来的Srcret串粘贴到“微信Secret”一项中,如下:
并设置“是否同步微信用户”为“是”
6.在smartbi中创建用户组,注意用户组需要填写编号,编号为数字,并且编号必须唯一。(这是遵循企业微信的接口规范)另外,要求编号不允许为“1”。
7.创建用户。注意用户信息中的“微信账号”目前必须绑定手机号码。若不绑定手机号码,则无法正常在微信中登录smartbi,如下:
另外,可以将“是否强制修改密码”设为“否”
接下来正常为用户设置角色和权限即可。
8.创建完用户组及用户时,在企业微信中自动会同步部门和用户,如下:
9.若是smartbi系统中已有的组和用户,那么注意修改组编号以及用户信息中的“微信账号”,再点击工具栏上的“同步到微信”,即可将系统中的用户和组均同步到企业微信中
点击“同步到微信”
同步中:
同步成功:
若存在未同步成功的情况,则会显示出相应的信息。
10.至此用户同步微信即已完成,接下来需要在企业微信中创建应用并设置信息。
五、创建应用
1.登录企业微信后台,进入“企业应用”,添加一个新的应用
2.上传应用Logo,设置应用名称,如下:
3.设置应用可见成员/部门,在可见范围中,添加在上一步骤中同步过来的用户组
如下:
4.设置完毕后,点击下方的“创建应用”按钮,进入应用属性界面
5.接下来拷贝应用中的Secret
6.通过外网地址访问Smartbi,打开系统选项,在“微信设置”中,将上一步骤拷贝的Secre粘贴到“微信Secret”中,如下:
注意保存。
7.点击“微信CropID”后的“生成微信链接”,会将Smartbi访问URL转换成微信中访问的URL,并点击复制该链接
如下,点击复制URL
8.切换到企业微信中,进入之前创建的应用属性界面。点击设置应用主页
将上一步骤中拷贝过来的微信链接,粘贴到应用主页中
并勾选“在微信插件中始终进入主页”
9.点击“网页授权及JS_SDK”中的“设置可信域名”
输入Smartbi外网地址的域名,如下:
10.至此集成微信设置完毕
六、访问
1.在使用微信访问前,请注意需要先在smartbi中发布资源到移动端。可以参考:移动应用
2.使用在创建用户时绑定的手机号码上的微信,关注企业号。
3.进入企业号,可看到发布的应用
4.点击发布的SmartbiTest应用,可进入smartbi移动端界面,进行浏览。
注
若后续需要进入smatbi用户管理增加或修改用户,并且同步到企业微信中。则需要将系统选项-》微信设置中的“微信Sceret”修改为“通讯录同步”中的Secret。待用户同步完成之后,需要重新将系统选项-》将微信设置中的“微信Secret”修改为应用的Secret。