(1) 平台功能

目前不少图书馆正在打造属于自己的微信公众平台。以“图书馆”为关键词能查找到很多微信公众号, 其中有少数公众号与图书馆业务系统对接, 实现了读者号的绑定、图书借阅查询、期刊查询等功能。其对接方式主要两种: 一种是在微信上输入指令或关键词进行查询的整合性对接, 如上海图书馆、重庆图书馆; 另一种是链接到图书馆Web系统上查询的形式性对接, 微信只充当浏览器功能, 如上海交通大学图书馆和广州图书馆。就多数公众号而言, 并未与图书馆业务系统对接, 提供的功能较为简单。

(2) 平台技术

从平台技术上看, 微信官网提供了详细的技术文档, 开发者根据自己熟悉的编程技术进行开发。在CNKI上, 以“微信”和“图书馆”为关键词进行检索, 检出文献中的平台设计多数直接按照技术文档进行原始开发。如文献[4]采用Dom4j解析XML消息, 文献[5]自建Java的Weixinservlet类来实现消息的接收解析等, 文献[6]自建PHP消息封装与回复函数reply($replytext)。这些文献的重点集中在如何按照技术文档一步步实现微信XML消息的解析、封装, 对于获取XML数据后如何处理或与图书馆业务系统如何对接介绍较少。

另外, 按照技术文档开发效率低下, 且编程难度较大。目前, 虽然微信官方提供了SDK, 但只有基于PHP环境的SDK。因此, 出现了很多第三方SDK, 如PHP环境的PHP SDK 增强版^{[ 7]}和Wechat-php-sdk^{[ 8]}; Java环境的Java SDK^{[ 9]}和消息接口-java-jsp^{[ 10]}; .NET环境的WeixinMpSdk^{[ 11]}、Senparc.Weixin.MP SDK^{[ 12]}和Loogn.WeiXinSDK^{[ 13]}等。虽有这么多开源SDK, 但通过对CNKI中微信公众平台开发文献的检索, 并未发现开源SDK的应用设计。而且这些设计类文献, 主要基于Java、PHP两种环境进行设计开发, 没有基于.NET环境的相关文献。

图书馆与读者交互信息较多, 若通过微信APP客户端响应每个读者的需求, 只能通过开发模式与图书馆各类系统进行整合性对接, 利用微信公众平台自动回复消息功能, 完成读者与图书馆间信息交互^{[ 4, 14]}。

根据微信公众平台信息交互的特点, 平台运行过程为: 接收读者发送的查询需求, 将查询关键词传递给图书馆业务系统执行查询, 返回查询结果并发送给读者客户端, 从而完成信息的自动交互。整个平台框架如图1 所示:

图1

	Figure Option ViewDownloadNew Window
	图1 平台框架

其中Web应用系统(简称“应用系统”)是实现平台的唯一核心系统, 它需要完成微信公众平台发送的XML消息解析、与图书馆业务系统建立信息查询、将获取的查询信息进行XML封装等工作^{[ 4]}。

本文基于.NET环境, 选择开源SDK软件, 直接调用SDK相应功能完成XML消息的解析与封装等工作, 从而降低程序开发难度。开发的重点是开源SDK软件的应用和平台与图书馆业务系统的对接方式。

(1) 开源SDK的简介

.NET环境下的Senparc.Weixin.MP.dll开源SDK控件^{[ 12]}集成了URL有效性验证、接收消息、发送消息和自定义菜单等主要功能, 在开发中调用相应功能即可。其中SDK包含的关键类如表1所示:

表1

表1

表1 Senparc.Weixin.MP关键类介绍 关键类 功能介绍 CheckSignature 验证来自微信服务器的GET请求合法性 RequestMessageFactory 用于自动生成不同Request类型的实体, 并作必要的数据填充 Entities.RequestMessage* 用于接收微信公众平台发送的实体(发送的是XML) Entities.ResponseMessage* 用于反馈给发送人的信息实体(最终转成XML) RequestMsgType 用于获取消息类型

表1 Senparc.Weixin.MP关键类介绍

(2) 开源SDK调用流程

在程序中, 主要涉及“消息接口URL有效性验证”、“发送的XML消息接收与解析”、“解析后消息类型的判断”和“回复XML消息封装与转换”这4个环节, 对应SDK类或方法的调用^{[ 15]}。其整个调用流程如图3所示:

图3

	Figure Option ViewDownloadNew Window
	图3 开源SDK类或方法的调用流程

在微信公众平台管理系统中, 填写消息接口URL和Token参数。验证URL时, 微信服务器向URL发送GET请求。获取请求的Signature、Times-tamp、Nonce和Echostr参数值, 并将值传递给CheckSignature.Check方法进行URL有效性检验, 若确认请求来自微信服务器, 则原样返回Echostr参数内容, 表示验证成功。

将微信服务器发送的XML数据包转换为XDocument对象。调用RequestMessageFactory. GetRequestEntity方法, 将XDocument对象转换为Entities.RequestMessageBase实例, 取得消息类型RequestMsgType的值, 根据不同的值执行不同的操作。以下是程序的主要执行过程:

Dim doc As XDocument

doc = XDocument.Parse(XML)

Dim requestMessage As RequestMessageBase =

_RequestMessageFactory.GetRequestEntity(doc)

   ’获取RequestMessageBase 基础类实体, 用于消息类型判断

Select Case requestMessage.MsgType

   Case RequestMsgType.Event ’事件推送

      Dim requestMessageevent As

         RequestMessageEventBase =_RequestMessageFactory.GetRequestEntity(doc)

      Select Case requestMessageevent.Event

        Case [Event].subscribe ’关注事件

        … … ’向读者发送欢迎词和查询指令菜单

      Case [Event].unsubscribe ’取消关注事件

 		… …’解除读者号与微信ID的绑定

   End Select

Case RequestMsgType.Text ’文本类信息

   Dim requestMessagetxt As RequestMessageText = RequestMessageFactory.GetRequestEntity(doc) ’获取请求

   RequestMessageText类实体

   Dim content As String =requestMessagetxt.Content

   ’获取文本消息

   … … ’对文本内容分析, 识别查询指令类型, 启动相应的信息查询模块程序

End Select

(1) 信息获取方式

图书馆业务系统中有自建系统、也有第三方的系统, 针对不同类型的业务系统建立不同的信息查询方式。本文主要采用以下三种方式:

①从FAQ知识库获取信息

将图书馆网站上常见的FAQ信息进行整理并建立知识库, 其字段如表2所示。当平台接收到查询命令后, 直接从知识库中返回查询结果, 节约查询响应时间。

表2

表2

表2 FAQ知识库 字段名 数据类型 说明 id int 记录编号 Inst varchar(2) 查询指令 title varchar(50) FAQ标题 content varchar(500) FAQ内容 Intr_URL varchar(100) 查询信息来源地址

表2 FAQ知识库

②从业务系统查询接口获取信息

针对自建业务系统和第三方预留数据查询接口的业务系统, 建立调用接口程序, 获取查询信息。

③从业务系统Web页面获取信息

针对第三方且未预留数据查询接口的业务系统, 从Web页面提取数据。引用Winista.HtmlParser.net开源控件, 建立模拟登录程序, 执行相关查询, 解析查询结果页面内容, 获取相关信息。

(2) 指令编码与查询控制

整个平台的查询指令主要分为三类:

①数字指令查询。由0-9构成单一指令, 主要针对FAQ知识库中的Inst字段进行查询。

②关键词查询。输入关键词进行查询, 主要针对FAQ知识库的FAQ标题和内容进行全文检索。

③复合指令查询。由a-z单个字母+#+关键词构成的字母复合指令, 主要针对图书馆业务系统信息查询。字母对应图书馆业务系统, “#”为分隔符。该类指令对应信息查询模块较多, 为减少主程序代码过长和提高执行效率, 将指令字母部分与对应的信息查询模块名称储存在数据库中, 其字段如表3所示:

表3

表3

表3 指令与信息查询模块关联 字段名 数据类型 说明 id int 记录编号 Inst varchar(2) 查询指令 Query_ mod varchar(50) 信息查询程序模块名称 Intr_URL varchar(100) 查询信息来源地址

表3 指令与信息查询模块关联

将①和③的指令存储在数据库中的优势: 具有良好的可扩展性, 在不调整指令分析控制程序的前提下, 可按照指令规则任意新增查询功能。

根据读者发送指令的类型, 启动相应信息查询模块, 其控制流程如图4所示。

图4

	Figure Option ViewDownloadNew Window
	图4 信息查询模块控制流程

调用ResponseMessageBase.CreateFromRequest-Message方法, 创建查询结果的ResponseMessage*实例, 通过EntityHelper.ConvertEntityToXmlString方法将其实例转换为文本并回复读者。以下是针对读者requestMessage会话回复文本消息的程序代码:

	Dim xmlString As String = Nothing

	Dim responseMessage As ResponseMessageText = _

	ResponseMessageBase.CreateFromRequestMessage

		(requestMessage, _ResponseMsgType.Text)

	responseMessage.Content ="回复文本内容"

	xmlString = EntityHelper.ConvertEntityToXmlString

		(responseMessage)

	Response.Write(xmlString)

在上述程序中, 将ResponseMessageText、Res-ponseMsgType.Text、responseMessage.Content三项作相应修改, 即可实现其他类型消息的回复。