企业微信(新微信企业号)集成

目录:

0. 视频教程

http://bbs.fanruan.com/course-34.html 

注：微信/钉钉集成过程中，必须确保各版本相对应，详情参照：微信、钉钉、H5、服务器、jar之间的依赖关系。

注：微信集成下若使用“扫码控件”， 要求单点登录、且域名必须经过校验，其他情况不支持。

1. 创建企业微信应用

管理员登录企业微信后，点击企业应用，添加应用，如下图：
上传应用logo，填写应用名称，应用介绍选填，设置可见范围，设置完成后，点击创建应用，如下图：
这样应用就创建好了，如下图：

2. 报表服务器准备

2.1 版本
 报表服务器版本   jar包版本  微信管理插件版本 新移动端HTML5方式预览报表
  9.0  2018-4-20  v3.0.0及以上 v5.0及以上
2.2 报表服务器要求
您的报表服务器必需是能够访问外网的，如果是http协议则访问端口推荐使用80，如果是https协议访问端口推荐使用443
2.3 微信管理插件安装
为了简化微信集成，FR开发了微信管理插件，将微信的相关配置从后台转为前台可视化界面操作，实现了微信集成基本信息配置、内置回调URL验证、同步微信通讯录并与报表用户关联实现单点登录以及定时发送消息至微信成员。FR还在继续开发常用的管理界面。
a. 安装微信插件

设计器插件安装方法参照设计器插件管理

服务器安装插件方法参照服务器插件管理
b. 安装后的效果
安装微信管理插件后，打开报表管理平台，管理系统下会增加“微信管理”节点，微信相关的配置管理都将会放在这个节点中去配置：
同时，设置定时任务的最后一步文件处理>客户端通知中，会增加“微信通知”，如下图：
微信管理插件的使用我们在回调模式配置及定时推送消息至微信中详细介绍。
2.4 手机浏览器报表插件
微信集成的企业应用中打开的只能是HTML5页面，不能使用FR新版移动app的原生解析功能。 FR开发了手机浏览器HTML5浏览方式，实现手机浏览器中报表的自适应、参数界面分离等效果。 移动终端HTML5浏览方式仅对分页报表进行了处理，详细请查阅移动端Html5报表
设计器插件安装方法参照插件的安装管理
服务器安装插件方法参照服务器上安装插件

3. 微信管理

3.1 应用管理设置
登录FR管理平台，点击管理系统>微信管理>应用管理，页面显示如下：
1）报表服务器
必须设置报表服务器地址并保存，如果不设置，推送的时候可能会有问题
注：请使用二级或二级以上域名，且需通过ICP备案，如果是http协议则访问端口推荐使用80，如果是https协议访问端口推荐使用443
2）企业微信应用

点击“新建微信应用”，显示如下：

输入相应的企业微信应用名称、CorpID、Secret，建立微信应用，如下图所示：

注：请填写合乎规范的信息，企业应用名称、CropID、管理组凭证密钥不可为空，且应用名称不可与其他应用的重复

a. 微信企业号ID来源于企业微信管理平台里的我的企业-企业信息的CorpID，如下图：
注：企业logo和简称可以修改。
b. 管理组凭证密钥，来源于企业微信管理平台里的刚刚创建的企业应用里的Secret，如下图：
注：老版微信升级成企业微信会出现两个Secret，需要仔细核对Secret或配置应用权限，具体请查看：旧版微信升级企业微信。

设置成功后，改组微信应用信息刷新，点击右侧的两个按钮，可以对信息进行修改和删除，如下图所示：


支持集成多个企业微信应用，如下图所示：

3.2 成员管理

成员管理页面显示如下：

1） 用户匹配方式

用户匹配方式分为：微信号匹配、手机账号匹配、手动匹配及自定义匹配，默认为微信号匹配

注：不管集成几个企业微信，用户统一进行管理

2）成员管理

a. 微信号匹配和手机账号匹配相同

选择这两个匹配方式时，微信通讯录信息展示：微信成员名、姓名、微信部门、微信成员手机号，显示页面如下：

b. 手动匹配

当匹配方式为“手动匹配”时，微信成员列表中多出“报表用户名”一列信息，点击出现下拉框，选择相应的报表用户名，进行手动匹配，如下所示：

c. 自定义匹配

选择“自定义匹配”时，下方多出“匹配设置”项，选择数据集、微信用户名以及报表用户名，进行匹配，如下图所示：

d.通讯录更新

点击左侧“立即更新”按钮，更新通讯录内容，如下所示：

也可设置定时更新，点击“自动更新”按钮，弹出设置框，设置更新频率，如下所示：

3.3 应用快捷配置

1）生成微信链接

选择模板，生成决策报表或单个模板的微信链接，如下图所示：

注：生成的链接用户可以直接拷贝复制到自己的微信中

2）微信代理跳转

注：需要将微信插件版本升级为v3.1.0。

若有些用户报表服务器是配置在内网，则需要配置代理服务器地址，来进行微信的访问，如下图：

注：微信集成既需要设置正向代理，也需要设置反向代理，配置方法参考代理服务器配置。

文本框中输入正确的代理服务器地址，点击测试连接，如下图：

3）主页型应用快速配置

注：需要将微信插件版本升级为v3.1.0。

注：此处是对微信应用进行自动配置，若想进行手动配置，参照下面的第四章介绍。

默认为企业微信列表中的第一个，通过下拉框选择需要配置的应用名称，然后点击按钮“一键配置”主页型应用，即可快速的配置主页型应用，不需要用户再到微信后台配置。

配置包括：可信域名、应用主页链接、自定义菜单中设置一个菜单并添加主页链接。

如下图：

a.若配置前，微信应用的主页链接和菜单为空，点击“一键配置”按钮后，直接进行快速配置

进入刚刚自建的应用-文档测试，如下图：

b.若配置前，微信应用的主页链接和菜单不为空，则先弹出对话框提示“当前应用已配置主页或菜单，继续配置将清空原始设置”，如下图：

点击确定，则会清空原始设置，重新进行配置。

注：若勾选了“在微工作台中始终进入主页”，此项配置不会被清掉。

4. 企业微信应用配置

4.1 主页配置

进入刚刚自建的应用-文档测试：

1）可见范围：选择用户所在的部门，不能选择单个成员，因为单个用户将无法读取，示例文档测试组

2）网页授权及JS-SDK(可信域名)：域名和端口号，示例：www.finereporthelp.com:80 
注：域名只能使用备案域名，如果是http协议则访问端口推荐使用80，如果是https协议访问端口推荐使用443
如应用页面需要使用微信JS-SDK，需完成域名归属验证，如下所示：
注：微信集成下若使用“扫码控件”，域名必须要经过验证。
3）勾选“在微信插件中始终进入主页”则成员在微信中点击应用将始终进入企业设置的主页，若勾选了这个选项，则普通微信中收不到推送消息
例如：
将之前微信管理中生成好的报表服务器地址链接复制进去并保存，这样主页就配置好了，移动端打开企业微信app，效果如下：
4.2 自定义菜单配置
点击自定义菜单，如下图：
若开启了模板权限，设置自定义菜单需要使用WeiXinServer，则将平台里面生成好模板链接，把链接中对应的ReportServer改为WeiXinServer，具体可参看开启模板权限时访问单个模板需要用WeiXinServer
填写主菜单，设置菜单内容为跳转到网页，填写网址，都填写完成后，点击保存，如下图：
点击发布，才能生效，如下图：

这样自定义菜单就配置好了，移动端打开企业微信app，效果如下：

注：若发布成功后，无法查看到该推送，需要新增一个定时任务，在企业微信的消息列表界面中查看刚刚设定的自定义报表菜单。

5. 个人微信查看企业应用

另外上面描述都是在企业微信里查看的效果，如果是普通微信，可以扫描二维码关注，在普通微信中即可出现一个企业号，即可在企业号中查看主页内容或收到推送消息，如下图：
点击微信插件Logo，上传图片后，即可扫描二维码，加入该企业。
若勾选“在微信插件中始终进入主页”，则从文档测试应用进去，显示数据决策系统主页，收不到推送消息，如下图所示：
若不勾选“在微信插件中始终进入主页”，同时需要在企业微信设置-新消息通知里关闭“仅在企业微信中接受消息”，则可收到推送消息，可以查看推送的内容和配置的自定义菜单，如下图所示：

6. 推送微信消息

6.1 普通推送
注：如果要用企业微信的推送功能，微信插件需要升级到1.19及以上版本
开发服务器可以主动的发送消息给企业成员，比如使用FR定时器生成好报表后，发送消息给相应的人员进行查看。
进入FR管理平台，添加定时任务：
第一步：基本设置，填写任务名称，设置默认用户组（即需要接收微信通知的用户）如下图：
第二步：调度周期，按照默认设置，如下图：
第三步：本地文件中，选择模板，如下图：
注：推送对象需要有模板查看权限
第四步：文件处理
勾选“客户端通知”，切换到客户端通知标签页，勾选“微信通知”，选择应用ID，填写主题和内容，选择链接，如下图：
注：jar包升级至2018-07-04，消息推送支持图文消息和文件消息，详细请参考微信钉钉推送支持其他消息类型。
应用ID：发消息至哪个应用，应用ID查看方法：打开企业应用>选择你要用哪个发送的应用>点击后会有应用ID；
定时结果访问连接：勾选的话会在消息正文最后加上定时生成的结果连接，点击后就可以直接打开定时结果；
这样定时任务结束后，默认用户组（即第一步里设置的）所有成员都可以收到消息。
定时任务设置好后，每次执行后就会推送消息给对应的成员，若勾选了定时结果链接，那么点击详情即可打开定时生成的结果链接，效果如下：
6.2 根据不同人推送不同消息
设置方法和定时任务邮件发送实现不同的人发送不同内容相同，只需要将第三步参数设置处勾选“除通用结果外，根据默认用户组内的用户单独生成结果”，如下图所示：
且最后一步：文件处理中的邮件通知换成客户端通知>微信通知即可，效果如下：

7. 微信单点登录及权限控制

1）单点登陆
在手机企业微信app里，您可以看到是不需要登陆fs，直接可以查看结果的。而如果您使用手机浏览器访问相同的报表，您会发现，是需要登录的。那是因为，将微信成员与报表用户关联后，通过微信企业应用进入查看报表时，在FR后台，我们会使用微信的OAuth2接口进行用户验证并获取对应微信成员名，然后关联报表用户并自动登录，从而实现微信单点登陆。
2）权限控制
微信应用的菜单是在微信中管理，所以哪些成员可以看到的哪些报表这是在微信中控制。比如您可以创建多个报表应用，每个应用的查看权限选择不同的成员或组。
用户在微信中打开报表，是否可以查看报表的内容，以及可以查看的数据这部分是在FR报表端控制的，控制方法与PC端是一样的，比如可以通过角色控制可查看的报表，可以在报表模板中通过sql语句通过用户名过滤来实现不同用户看到的数据不同等等。

8. 升级兼容说明

微信管理3.0版本支持集成多企业应用，可以实现不同部门／角色查看进入不同的应用查看报表

如果您已经配置好了微信管理，想要升级至微信管理3.0，您需要按照以下操作，来使您的应用运行正常

1）升级插件

2）将管理组凭证密钥改为应用密钥

如果升级前微信基本信息>管理组凭证密钥，采用的是管理组secret，打开微信管理，将会提示用户更改为应用secret

注：如果升级前采用了管理组secret，并且推送消息设置了多个应用，那每个应用都会提示要更改secret，同时转成多个企业应用

3）更新微信后台的链接

微信管理3.0支持多企业应用后，微信集成的链接中需要包含对应的参数，以用于识别对应的应用

您可以使用应用快捷配置中的生成微信链接功能，一键生成链接，替换原来的url


附件列表


主题：
标签： 应用ID 9.0验证

文档内容仅供参考，如果你需要获取更多帮助，付费/准付费客户请咨询帆软技术支持
关于技术问题，您还可以前往帆软社区，点击顶部搜索框旁边的提问按钮
若您还有其他非技术类问题，可以联系帆软传说哥（qq：1745114201）