2. 定义流程
A. 申请企业微信:申请一个企业微信号。
B. 搭建Smartbi外网环境:Smartbi服务要求能够外网访问。
C. 配置基本信息:在Smaribi配置基本信息。
D. 创建用户:创建企业微信用户,Smartbi用户。
E. 创建应用:在企业微信创建应用。
F. 报表推送:Smartbi向企业微信推送报表。
3. 实现步骤
3.1 申请企业微信
首先用户要有一个企业微信号,之前叫企业号,现在企业号统一升级为企业微信,企业微信的申请流程请访问企业微信官方网站。
3.2 搭建Smartbi外网环境
Smartbi服务要求能够通过外网域名访问(企业微信的要求),若不能打开则应通过其他代理手段来达成(如:阿里云)。
并且需要下载并加载企业微信的扩展包,扩展包部署路径:扩展包部署
扩展包可从此处下载:WeiXinEx.ext
3.3 配置基本信息
由于Smartbi需要和企业微信集成到一起,在加载扩展包之后,需要到Smartbi系统中配置一些基本信息。具体如下:
1. 访问Smartbi,在系统导航栏中选择“系统运维”,在“系统运维界面主菜单”选择 系统选项。
进入到“系统选项”页面,点击 微信设置,进入配置界面:
2. 需要配置,微信CropID、通讯管理Secret和服务器地址,各项配置信息需按照如下步骤查找:
微信CropID
登录进入企业微信,点击 我的企业 按钮,找到如下“企业ID”,拷贝对应的CropID串。
将上一步骤中拷贝的CropID串粘贴到“微信CropID”位置中:
企业应用Secret
企业应用Secret需要创建应用后才会生成,详情参考“创建应用”。
通讯管理Secret
登录进入企业微信,点击 管理工具 按钮,找到如下“通讯录同步”,单击进入
在“通讯录同步”页面拷贝Secret
将上一步拷贝的Secret粘贴到“通讯管理Secret”处,
服务器地址
以外网域名地址访问Smartbi,点击“服务器地址”右方的 自动获取 ,设置服务器地址。
3、配置完并保存即可。
3.4 创建用户
无论是正式使用企业微信的功能还是只是进行测试,一般都会使用企业微信创建的用户来进行测试。因此先进行创建用户的操作。步骤如下:
1、登录进入企业微信,进入“通讯录”。
2、新建一个用户,并输入用户的姓名(自定义)、账号(自定义)、用户的手机号码或邮箱(手机和邮箱不能同时为空)。
其中:
账号:成员唯一标识,设定以后不支持修改。自定义账号须符合企业微信的规定,账号长度为1-64个字符,账号只能由字母、数字及符号(.-_@)组成,并且符号(.-_@)不能放在开头。
- 手机、邮箱:成员通过验证后可加入企业。
- 手机号码能和微信号一起用于实现企业微信用户同步到Smartbi用户,邮箱不能实现。
目前企业微信号是支持微信号和号码只填其中一个就可以进行验证的,但是要实现填号码就可以验证的话,需要在smartbi中填写通讯管理Secret才可支持。
3、登录Smartbi系统,在用户管理中,新建一个用户。并且注意该用户的“微信账号”与在企业微信中创建的用户的“账号”保持一致。通过这个设置项,将Smartbi中的用户与企业微信中的用户进行绑定。另外,可以将“是否强制修改密码”设为“否”。
注意:微信号的格式要求也与企业用户账号格式要求一致:账号长度为1-64个字符,账号只能由字母、数字及符号(.-_@)组成,并且符号(.-_@)不能放在开头。
3.5 创建应用
Smartbi向企业微信推送报表是通过将报表推送到企业应用来实现的。SmartbiV8.5支持向多应用推送电子表格,每个应用有唯一的配置。因此进行创建应用的操作:
登录进入企业微信,找到“应用与小程序”界面,在该界面中配置应用。
1、添加一个应用,上传应用Logo,设置应用名称,如下:
2、设置应用可见成员/部门,在可见范围中,添加在上一步骤中同步过来的用户组, 如下:
3、设置完毕后,点击下方的 创建应用 按钮,进入“应用属性”界面,拷贝应用中的“Secret”。
4、访问Smartbi,打开系统选项,在“微信设置”中,将上一步骤拷贝的Secre粘贴到“企业应用Secret”中,如下:
5、点击“微信CropID”后的“生成微信链接”,会将Smartbi访问URL转换成微信中访问的URL,并点击复制该链接。
如下,点击复制URL。
6、切换到企业微信中,进入之前创建的应用属性界面。点击 设置应用主页 按钮,将上一步骤中拷贝过来的微信链接,粘贴到应用主页中。
并勾选“在微工作台中始终进入主页”。
勾选“在微工作台中始终进入主页”,点击报表推送消息链接,跳转到“Smartbi移动端首页”。
- 未勾选“在微工作台中始终进入主页”,点击报表推送消息链接,直接打开报表。
7、点击“网页授权及JS_SDK”中的“设置可信域名。
8、输入Smartbi外网地址的域名,如下:
9、申请校验域名
点击上图的申请校验域名,点击下载校验文件,将下载的文件上传至填写域名根目录下,例如 http://demo.smartbi.com.cn/WW_verify_bQWOKCWfznxZCWLy.txt,并确保地址可以访问。
勾选图中的用于OAuth2.0回调的可信域名是否校验,然后点击确定
确定后可以看到可信域名已启用
10、至此集成微信设置完毕。
3.6 微信微工作台访问
1.在使用微信访问前,请注意需要先在smartbi中发布资源到移动端。
2.使用在创建用户时绑定的手机号码上的微信,在企业微信管理台-我的企业-微工作台页面下拉找到二维码,通过微信扫一扫关注企业号。
3.微信通信录进入企业号,可看到发布的应用
4.点击发布的SmartbiTest应用,可进入smartbi移动端首页界面,进行浏览
3.7 报表推送
Smartbi系统中的自助仪表盘和电子表格支持推送到企业微信。
1、登录进入Smartbi系统,选中要推送的报表,点击更多菜单 >选择 推送到企业号。
2、选择推送到的企业应用,这里选择刚创建的“DEMO”企业应用。
3、点击“推送”,即可将报表通过消息的形式在企业微信中推送。
如果需要点击应用进入Smartbi移动界面,那么应用必须勾选“始终进入主页”;如果需要推送报表消息,点击打开报表,那么应用不能勾选“始终进入主页”。当这两种需求同时存在时,则需要建立2个应用。
3.8 导入微信用户
为了在微信公众号访问应用或报表时跳过登录界面自动进行免密单点登录,因此需要在Smartbi的用户信息内添加用户与之对应的微信号信息。具体操作流程如下:
1、登录进入企业微信,进入“通讯录”,选择“批量导入/导出”的下拉框。
- 选择下拉框后如下图所示,选择“导出通讯录”,接着按照实际需求选择导出相应的部门或者整个公司;
2、登录进入Smartbi系统,在左侧 “系统导航栏”选择 系统运维,进入“系统运维”界面,在其界面主菜单选择 用户管理,进入“用户管理”界面。
3、点击 用户管理 界面下“功能菜单区”内的“导入微信用户”。
4、下载“用户信息模板”
- 根据先前导出的通讯录数据将微信号手动填写进模板文件内。
“导入微信用户”功能只能更新Smartbi已有用户的信息,不能新增用户。只能更新数据,不能插入数据。
5、导入填写完毕的“用户信息模板”文件,即可完成导入微信用户数据的操作。