数据分析工具FineBI的如何实现微信企业应用

数据分析工具FineBI的如何实现微信企业应用

1. 报表微信企业应用示例

示例见Demo视频。

2. 创建报表微信企业应用

管理员登录微信企业号，根据提示新建应用，创建后进入应用，可以看到应用的基本信息，其中需要关注的信息有：

# 应用ID：微信号中可能有很多个应用，后台开发的时候需要根据应用ID来决定是在哪个应用中进行响应

# 可见范围：微信权限控制

# 应用模式：应用模式主要分成两种：

普通模式：这个模式下不能调用微信的接口，只能设置固定的菜单及回复的消息；如果需要的微信应用比较简单，菜单都是固定的，可以用这种模式，但是报表就无法绑定用户了，查看报表的时候就需要先登录（除非报表不做权限控制）；

回调模式：开发者可以通过企业号提供的接口，获取微信用户信息，实现自动回复、自定义菜单等个性化功能。回调模式的界面如图所示：

3. 回调模式配置

我们在应用中需要调用微信开放的接口做开发，所以选择“回调模式”，这样微信服务器会在客户手机和开发者服务器间架起一个桥梁，通过消息的传递和响应，实现与用户的交互操作：

上面这个流程走通，需要微信服务器和开发者服务器先建立通信，这样才能构建一个完整的链路。

进入回调模式，开启模式后，可以看到，下面的功能都是不可用状态，需要设置好回调URL及密码后才能用的。

我们点开修改，会看到有3个参数，都是我们需要关注的：

# URL：开发服务器接收微信收企业号服务器推送请求的地址，支持http或https协议，端口不限，这个URL就相当于开发服务器的后台引擎，微信服务器推送的请求都是到这个地址。另外注意，这个地址必须是外网可以访问的。

# Token：可由企业任意填写也可以随机获取，用于生成签名。

# EncodingAESKey：用于消息体的加密，是AES密钥的Base64编码，点击随机获取就可以获得。

点击保存的时候，企业号会向验证url发送一个get请求，例如：

1.xxurl?msg_signature=5c45ff5e21c57e6ad56bac8758b79b1d9ac89fd3×tamp=1

409659589&nonce=263014780&echostr=P9nAzCzyDtyTWESHep1vC5X9xho%2FqYX

3Zpb4yKa9SKld1DsH3Iyt3tP3zNdtp%2B4RPcs8TgAE7OaBO%2BFZXvnaqQ%3D%3D

消息中会有四个参数，并且会以AES方式加密：

# msg_signature：消息体签名

# timestamp：时间戳

# nonce：随机数字串

# echostr：随机加密字符串

开发服务器需要解析出Get请求的参数，对参数进行解密，然后使用之前的Token、EncodingAESKey这两个值进行验证。所以在点击保存前，我们需要把开发服务器的响应先准备好。

针对加解密的处理，微信提供了各种语言的库，我们这边是用的java语言开发，所以下载java的加解密库，可以到微信发者中心下载的：

下载解压后，文件结构如下：

FR也将需要的类库准备好，见微信接口类文件夹，将其中classes文件夹下的类文件拷贝到WebReport\WEB-INF\classes即可。

注意事项：

https://www.360docs.net/doc/3e13530401.html,\qq\weixin\mp\aes目录下是用户需要用到的接入企业微信的接口，其中WXBizMsgCrypt.java文件提供的WXBizMsgCrypt类封装了用户接入企业微信的三个接口，其它的类文件用户用于实现加解密，用户无须关心。sample.java文件提供了接口的使用示例。

2.WXBizMsgCrypt封装了VerifyURL, DecryptMsg, EncryptMsg三个接口，分别用于开发者验证回调url、接收消息的解密以及开发者回复消息的加密过程。使用方法可以参考Sample.java文件。

3.请开发者使用jdk1.6或以上的版本。针对

https://www.360docs.net/doc/3e13530401.html,mons.codec.binary.Base64，需要导入jar包commons-codec-1.9（或commons-codec-1.8等其他版本），异常

java.security.InvalidKeyException:illegal Key Size的解决方案：在官方网站下载JCE 无限制权限策略文件，下载后解压，可以看到local_policy.jar和US_export_policy.jar 以及readme.txt。如果安装了JRE，将两个jar文件放到%JRE_HOME% \lib\security目录下覆盖原来的文件，如果安装了JDK，将两个jar文件放

到%JDK_HOME%\jre\lib\security目录下覆盖原来文件。

以上工作做好后，我们就可以写验证方法了，例如我们demo都到WeiXinServer.jsp，代码如下：

1.<%@ page pageEncoding="utf-8" contentType="text/html;charset=utf-

8"%>

2.<%@ page import="java.io.IOException" %>

3.<%@ page import="java.io.PrintWriter" %>

4.<%@ page import="https://www.360docs.net/doc/3e13530401.html,.URLDecoder" %>

5.<%@ page import="javax.servlet.ServletException" %>

6.<%@ page import="javax.servlet.http.HttpServlet" %>

7.<%@ page import="javax.servlet.http.HttpServletRequest" %>

8.<%@ page import="javax.servlet.http.HttpServletResponse" %>

9.<%@ page import="com.qq.weixin.mp.aes.AesException" %>

10.<%@ page import="com.qq.weixin.mp.aes.WXBizMsgCrypt" %>

11.

12.<%

13. String sToken = " nAvYVGe";

14. String sCorpID = "xxxxxxxxxxxxxxx";

15. String sEncodingAESKey = " btvk2zcD8EdbtfD4HhaDD39Xc3rRH3Xy

5Nm1LLTJtqx";

16.

17./*

18. *企业开启回调模式时，企业号会向验证url发送一个get请求

19. *假设点击验证时，企业收到类似请求：

20. * xxurl?msg_signature=5c45ff5e21c57e6ad56bac8758b79b1d9ac89

fd3×tamp=1409659589&nonce=263014780&echostr=P9nAzCzyDtyTWESHep1vC5X 9xho%2FqYX3Zpb4yKa9SKld1DsH3Iyt3tP3zNdtp%2B4RPcs8TgAE7OaBO%2BFZXvna qQ%3D%3D

21. * 企业应解析出Get请求的参数，包括消息体签名(msg_signature)，时

间戳(timestamp)，随机数字串(nonce)以及公众平台推送过来的随机加密字符串

(echostr)

22. */

23.

24. request.setCharacterEncoding("utf-8");

25.

26. String sVerifyMsgSig = request.getParameter("msg_signature"

);

27. String sVerifyTimeStamp = request.getParameter("timestamp")

;

28. String sVerifyNonce = request.getParameter("nonce");

29. String sVerifyEchoStr = request.getParameter("echostr");

30.

31. String sEchoStr; //需要返回的明文

32. PrintWriter outprint = response.getWriter();

33. WXBizMsgCrypt wxcpt;

34.try {

35. wxcpt = new WXBizMsgCrypt(sToken, sEncodingAESKey, sCorpID)

;

36. sEchoStr = wxcpt.VerifyURL(sVerifyMsgSig, sVerifyTimeStamp,

sVerifyNonce, sVerifyEchoStr);

37. System.out.println("verifyurl echostr: " + sEchoStr);

38.// 验证URL成功，将sEchoStr返回

39. outprint.print(URLDecoder.decode(sEchoStr,"utf-8"));

40. outprint.close();

41. outprint=null;

42. } catch (AesException e1) {

43. e1.printStackTrace();

44. }

45.%>

开发服务器准备好后，我们就可以点击保存了，如果验证成功，则效果如下：

总结：

验证开发服务器时，需要关注的参数有：

验证过程可以直接照抄示例代码，关键方法为：

1.WXBizMsgCrypt wxcpt;

2.wxcpt = new WXBizMsgCrypt(sToken, sEncodingAESKey, sCorpID);

3.sEchoStr = wxcpt.VerifyURL(sVerifyMsgSig, sVerifyTimeStamp, sVerify

Nonce, sVerifyEchoStr);

返回验证信息时需要进行urldecode处理。

4. 获取微信账号（OAuth2验证）后台登录报表

在报表服务器端，为了安全我们会给报表设置权限，用户访问报表的时候需要先登录，认证成功后才可以看到他能看到的数据；用户登录微信进入报表企业应用后，访问报表时肯定不希望再次弹出登录界面来登录报表的，而不登录报表的话，就无法查看报表内容了。所以在打开报表时，我们需要带上微信账号的身份信息，在后台登录报表。例如demo示例中，在微信企业号管理平台中，进入应用>回调模式，设置自定义菜单

添加事件类型选择跳转到网页，url链接类似如下：

1.https://https://www.360docs.net/doc/3e13530401.html,/connect/oauth2/authorize?appid=xxxxxxxxx

&redirect_uri=http%3A%2F%https://www.360docs.net/doc/3e13530401.html,%3A8081%2FWeiXin%2

Fpage%2FLogin.jsp&response_type=code&scope=snsapi_base&state=STATE#

wechat_redirect

链接中需要包含以下参数：

# appid：企业的应用ID即CorpID

# redirect_uri：授权后重定向的回调链接地址，请使用urlencode对链接进行处理# response_type：返回类型，此时固定为：code

# scope：应用授权作用域，此时固定为：snsapi_base

# state：重定向后会带上state参数，企业可以填写a-zA-Z0-9的参数值

# #wechat_redirect：微信终端使用此参数判断是否需要带上身份信息

员工点击菜单后，页面将跳转至redirect_url，并且带上code参数，开发服务器后台就可以根据code获取员工的身份信息userid。例如我们demo中redirect_url对应的是Login.jsp，代码如下：

1.<%@ page pageEncoding="utf-8" contentType="text/html;charset=utf-

8"%>

2.<%@ page import="java.io.IOException" %>

3.<%@ page import="java.io.PrintWriter" %>

4.

5.

6.

7.

8.

49.

50.

51.

52.

在Login.jsp中，首先获得code值后，到OAuth2.jsp根据access_token和code 获取userid，然后可以使用userid到报表端进行单点登录

注意：这边微信账号和报表账号如果是不一样的，那么需要有微信账号、报表账号及密码对应表，可以根据微信账号获取到报表用户账号及密码来做单点登陆，示例中假设的是微信账号和报表账号是相同的，并且密码都是统一的123456.

OAuth2.jsp代码如下：

1.<%@ page pageEncoding="utf-8" contentType="text/html;charset=utf-

8"%>

2.<%@ page import="java.io.IOException" %>

3.<%@ page import="java.io.PrintWriter" %>

4.<%@ page import="jsp.weixin.ParamesAPI.util.ParamesAPI" %>

5.<%@ page import="jsp.weixin.ParamesAPI.util.WeixinUtil" %>

6.<%@ page import="jsp.weixin.oauth2.util.GOauth2Core" %>

7.

8. <%

9. request.setCharacterEncoding("UTF-8");

10. response.setCharacterEncoding("UTF-8");

11. PrintWriter outprint = response.getWriter();

12.

13. String code = request.getParameter("code");

14.

15.if (!"authdeny".equals(code)) {

16. String access_token = WeixinUtil.getAccessToken(ParamesAPI.

corpId, ParamesAPI.secret).getToken();

17.//agentid 跳转链接时所在的企业应用ID 管理员须拥有agent的使用权限；

agentid必须和跳转链接时所在的企业应用ID相同

18.//code只能使用一次，5分钟未被使用自动过期

19. String UserID = GOauth2Core.GetUserID(access_token, code, "

2");

20. outprint.print(UserID);

21. }else{

22. outprint.print("授权获取失败");

23. }

24.

25. outprint.close();

26. outprint=null;

27.%>

总结：

OAuth2验证需要关注的参数有：

我们可以使用现成的封装好的类WeixinUtil.getAccessToken来获取access_token。以及GOauth2Core.GetUserID来进一步获取userID。

5. 接收微信消息与事件并响应

微信应用开启回调模式后，成员给企业应用发送消息，或者触发关注、进入应用、点击菜单、上报地理位置等事件时，微信服务器就会把这些动作及内容，以POST的方式推送到开发服务器（就是一开始设置的验证URL的地方），例如之前我们的地址是

1.https://www.360docs.net/doc/3e13530401.html,:8081/WeiXin/page/WeiXinServer.jsp

。则推送的消息就是

1.https://www.360docs.net/doc/3e13530401.html,:8081/WeiXin/page/WeiXinServer.jsp?msg

_signature=ASDFQWEXZCVAQFASDFASDFSS×tamp=135********&nonce=12341232

3

。

POST数据包为xml格式，以AES方式加密传输。支持的消息及事件类型如下图：

不同操作对应的xml结构不同，具体见微信开发接口说明，以下我们通过几个例子介绍比较常用的接口使用。

5.1 监控成员进入企业应用并响应消息

例如想在成员进入企业应用时，开发服务器在后台自动给成员发送应用介绍及操作说明：

成员进入微信应用时，会将这个消息以POST的方式发送给开发服务器的地址，如demo中的WeiXinServer.jsp；该事件推送的xml数据包消息解密后类似如下：

1.

2.

3.1434367374

4.

5.2

6.

7.

8.

可以看到，进入微信应用是一个事件event，并且是enter_agent这个具体的动作，且进入的是agentID=2这个企业应用，进入的成员是Jane。

在WeiXinServer.jsp后台，就可以抓取到这个post流，解密后对比是否是

enter_agent这个event，从而可以做出相应的相应，如下示例：

1.//获取post参数

2.StringBuffer sb = new StringBuffer() ;

3.ServletInputStream in = request.getInputStream();

4.InputStreamReader isr = new InputStreamReader(in);

5.BufferedReader br = new BufferedReader(isr);

6.String s = "" ;

7.while((s=br.readLine())!=null){

8.sb.append(s) ;

9.}

10.String sReqData =sb.toString();

11.String sReqMsgSig = request.getParameter("msg_signature");

12.String sReqTimeStamp = request.getParameter("timestamp");

13.String sReqNonce = request.getParameter("nonce");

14.System.out.println("sReqData:" + sReqData);

15.System.out.println("sReqMsgSig:" + sReqMsgSig);

16.System.out.println("sReqTimeStamp:" + sReqTimeStamp);

17.System.out.println("sReqNonce:" + sReqNonce);

18.wxcpt = new WXBizMsgCrypt(sToken, sEncodingAESKey, sCorpID);

19.String sMsg = wxcpt.DecryptMsg(sReqMsgSig, sReqTimeStamp, sReqNonce

, sReqData);

20.System.out.println("after decrypt msg: " + sMsg);

21.

22.//处理接收的消息及事件

23.DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();

24.DocumentBuilder db = dbf.newDocumentBuilder();

25.StringReader sr = new StringReader(sMsg);

26.InputSource is = new InputSource(sr);

27.Document document = db.parse(is);

28.

29.Element root = document.getDocumentElement();

30.

31.String ToUserName = root.getElementsByTagName("ToUserName").item(0)

.getTextContent();//企业号CorpID

32.String FromUserName = root.getElementsByTagName("FromUserName").ite

m(0).getTextContent();//成员的UserID

33.String MsgType = root.getElementsByTagName("MsgType").item(0).getT

extContent(); //消息类型

34.StringBuffer sRespDatabf = new StringBuffer();

35.String sRespData;

36.

37.// 进入企业应用时

38.if (MsgType.equals("event")) {

39. String Event = root.getElementsByTagName("Event").item(0).getTe

xtContent();

40. f(Event.equals("enter_agent")){

41. sRespDatabf.append("");

42. sRespDatabf.append("

"]]>");

43. sRespDatabf.append("

"]]>");

44. sRespDatabf.append("" + sReqTimeStamp + "

teTime>");

45. sRespDatabf.append("");

46. sRespDatabf.append("

好，欢迎进入帆软微信企业号应用，您可以点击下方报表应用菜单，体验帆软报表微信集成

效果。目前帆软微信集成一期已经开发完毕，您可以回复数字1来查看微信集成一期支持的

功能列表。也可以任意回复您的体验感想。]]>");

47. sRespDatabf.append("");

48. }

49.}

50.try{

51. sRespData = sRespDatabf.toString();

52. String sEncryptMsg = wxcpt.EncryptMsg(sRespData, sReqTimeStamp,

sReqNonce);

53. System.out.println("after encrypt sEncrytMsg: " + sEncryptMsg);

54.// 加密成功

55.// TODO:

56.// HttpUtils.SetResponse(sEncryptMsg);

57. outprint.print(sEncryptMsg);

58. outprint.close();

59. outprint=null;

60.}

61.catch(Exception e)

62.{

63. e.printStackTrace();

64.// 加密失败

65.}

6. 后台发送消息至成员

除了上面我们所说的根据成员的一些交互动作，后台被动的进行响应外，开发服务器还可以主动的发送消息给企业成员，比如使用FR定时器生成好报表后，发送消息给相应的人员进行查看。后台发送消息需要以POST方式，发送请求到

1.https://https://www.360docs.net/doc/3e13530401.html,/cgi-

bin/message/send?access_token=ACCESS_TOKEN

。发送的消息内容必须是Json格式的，并且需要进行加密消息的形式可以是纯文本、图片、文字图片等，每一种消息类型的数据格式可以查阅微信开发接口文档：

我们以文本消息为例说明，代码如下：

1.String RequestURL = "https://https://www.360docs.net/doc/3e13530401.html,/cgi-

bin/message/send?access_token=ACCESS_TOKEN";

2.String RequestMt = "POST";

3.String outstr = "{\"touser\": \"Jane\"," +

4."\"toparty\": \"2\"," +

5."\"totag\": \"0\"," +

6."\"msgtype\": \"text\"," +

7."\"agentid\": \"2\"," +

8."\"text\": {" +

9."\"content\": \"定时生成结果

(https://www.360docs.net/doc/3e13530401.html,:8081/WeiXin/ReportServer?op=fs_main&

&cmd=entry_report&&id=13)\"" +

10."}," +

11."\"safe\":\"0\"" +

12."}";

13.

14.String access_token = WeixinUtil.getAccessToken(ParamesAPI.corpId,

ParamesAPI.secret).getToken();

15.WeixinUtil.PostMessage(access_token, RequestMt, RequestURL, outstr)

;

总结：

后台发送消息需要的参数有：