@移动办公 @O2OA微信办公 @微信公众号办公 @微信办公 @手机办公

O2OA平台拥有配套的原生开发的安卓和IOS移动APP,目前O2OA已经支持微信公众号的集成,用户可以通过关注微信公众号进行工作处理。并且支持待办工作的消息提醒。本文主要介绍如何将O2OA集成到微信公众号上去。


可以先扫下面的二维码关注我们公司的微信公众号进行体验:
zoneland_mpweixin.jpg

一、自行注册认证微信公众号

首先需要用户自行准备微信公众号,注册地址:https://mp.weixin.qq.com

二、启用配置

公众号管理平台启用服务器


到微信公众号的管理平台,左边菜单底部的【开发】那栏,找到【基本配置】这个菜单点击进入配置页面。
image.pngimage.png

这里分两种情况。

第一,如果公众号本来就已经开启了这个开发服务器配置功能,也就是你们后台本来就有公众号的程序在运行了的。那上面这些数据都已经有了,只需要把一些关键信息复制到O2OA后台的公众号相关的那个配置文件(mpweixin.json)中就行了。

第二,如果公众号没有开启过这个服务器配置,那就需要启用服务器配置信息。这里需要注意的是,因为微信的要求,服务器必须要用http(80) https(443)这两个默认端口,所以O2OA需要开启80端口代理模式。【文章链接】

这里有一点要注意,开启服务器配置,会把公众号原有的菜单清除掉,所以先记得备份记录一下原有的菜单结构和数据。


从上往下说明下:
1 开发者ID(AppID)这个是默认生成的,需要复制到配置文件(mpweixin.json)中
2 开发者密码(AppSecret) 这个需要开启,并记录下这个值,需要复制到配置文件(mpweixin.json)中
3 IP白名单 这个需要配置,就是你们部署的O2OA服务器的外网的ip地址,O2OA需要访问微信服务器,如果没有配置ip地址,微信那边会拒绝访问。
4 服务器地址(URL) http://O2OA服务器的外网访问地址/x_program_center/jaxrs/mpweixin/check
5 令牌(token) 自定义字符串,可以自行写一个,比如o2oa。需要复制到配置文件(mpweixin.json)中
6 消息加密密钥(EncodingAESKey)这个用旁边的自动生成按钮,点击生成一个就行。需要复制到配置文件(mpweixin.json)中
7 消息加密方式 选择明文模式。

这里填写和生成各种参数完成后先不要点击保存。先将这些参数配置到O2OA后台的一个配置文件中,如下说明

O2OA服务器配置mpweixin.json配置文件


到O2OA服务器后台config目录下,打开,如果没有就创建一个mpweixin.json文件,如下把前面公众号管理平台生成的参数填入对应的位置
mpweixin.json:

{
"enable": true,
"appid":"填入AppID",
"appSecret":"填入AppSecret",
"token":"填入token",
"encodingAesKey":"填入EncodingAESKey"
}

将mpweixin.json文件保存,重启O2OA服务器。然后就可以在公众号后台那个服务器配置表单点击保存。这个时候提示配置成功就表示公众号和O2OA服务器关联已经完成。

公众号菜单管理

如果微信公众号启用了服务器配置,那公众号的菜单将由配置的服务器管理,不能在公众号的管理平台编辑了。所以O2OA提供了管理公众号菜单的api。


image.png
菜单的API在 x_program_center 模块中。微信公众号菜单目前支持4种形式的菜单,【父级菜单、点击发送文本消息菜单、点击查看网页菜单、点击打开小程序菜单】

微信公众号的菜单每次都是全量覆盖创建的,所以需要先用menuAdd接口把菜单数据保存到O2OA数据库,然后调用menuCreate2Weixin接口把数据写到微信公众号上去。menuWeixinList可以查看当前已经保存的菜单数据。


先用menuAdd接口保存菜单数据,格式如下:

父级菜单

{
"name": "联系我们",
"order": "000001"
}

name: 菜单显示名字
order: 同级排序字段

点击发送文本消息菜单

{
  "name": "联系电话",
  "parentId": "父级菜单id",
  "type": "click",
  "key": "showPhoneNumber",
  "content": "太开心啦,小智终于等到您问我联系方式!想更了解我可以联系客服哦:400-888-0545",
  "order": "000101"
}

name: 菜单显示名字
parentId: 父级菜单id
type: click //click代表点击发送文本消息
key:是一个唯一标识符号,可自定义输入
content: 文本消息内容
order: 同级排序字段

点击查看网页菜单

{
  "name": "官方网站",
  "parentId": "父级菜单id",
  "type": "view",
  "url": "http://www.o2oa.net/",
  "order": "000102"
}

name: 菜单显示名字
parentId: 父级菜单id
type: view //view代表这个菜单是打开一个网页
url:打开网页的网址
order: 同级排序字段

点击打开小程序菜单 (注意:小程序必须先和公众号关联)

{
  "name": "小程序",
  "parentId": "父级菜单id",
  "type": "miniprogram",
  "url": "http://www.o2oa.net/",
  "appid":"wx5e498e66e2dd900b",
  "pagepath": "pages/login/login",
  "order": "000301"
}

name: 菜单显示名字
parentId: 父级菜单id
type: miniprogram //miniprogram代表这个菜单是打开一个小程序
url:微信为了兼容老的版本微信,不支持小程序的将打开这个网页地址
appid: 微信小程序的appid,可到小程序的管理平台查看
pagepath: 微信小程序的打开地址
order: 同级排序字段

模版消息

目前微信公众号只支持主动给用户发送模版消息,模版消息是服务号才有的功能。所以需要O2OA的待办消息推送给公众号的用户,公众号必须是服务号。


到公众号管理平台,菜单【功能】模块下的,【模版消息】。如果没有【模版消息】这个菜单,点击下面的 添加功能插件 中找到模版消息,添加到菜单中。
image.png
到模版消息的模版库中找一个待办消息类的模版,点击详情可以查看模版的格式,如:
image.png
这里主要关注详细内容,就是模版的内容,里面有几个参数表示可以替换成需要的业务字段,最终消息的展示结果可以看左边的内容示例。
把这个模版添加到我的模版中。

准备好模版后,到O2OA服务器配置mpweixin.json配置文件:

{
"enable": true,
"appid":"填入AppID",
"appSecret":"填入AppSecret",
"token":"填入token",
"encodingAesKey":"填入EncodingAESKey",
"portalId":"O2OA门户ID,工作处理完成后打开的门户页面的id",
"messageEnable": true, //模版消息是否启用
"tempMessageId": "模版消息id",
"fieldList": [
    {"name": "title", "tempName": "keyword1"},
    {"name": "creatorPerson", "tempName": "keyword2"},
    {"name": "activityName", "tempName": "keyword3"}
    ]
}

这里有几个字段配置:
portalId : O2OA门户ID,工作处理完成后打开的门户页面的id
messageEnable : 模版消息是否启用,启用才会发送待办消息到用户
tempMessageId : 模版消息id,就是上面选择的那个模版的ID
fieldList : 这个是模版的内容中业务字段的对应关系,目前O2OA提供了这几个业务字段 【creatorPerson:创建人, activityName: 当前节点, processName: 流程名称, startTime: 开始时间, title 标题】。这个配置方式就是把业务字段和模版内容字段一一对应起来,name 代表业务字段名,tempName 代表模版字段名。 如 {"name": "title", "tempName": "keyword1"} 就表示把O2OA工作的title字段,放入到模版内容的keyword1字段的位置上去。

模版中 first 和 remark 字段是固定形式,不需要配置。

效果如下:
IMG_ED005F9D4985-1.jpeg

推荐文章:

会议申请使用手册
2021-02-19
O2OA会议申请是使用平台流程管理能力开发的一个申请流程。员工的会议申请通过审批之后,可以同步到会议管理系统,由会议管理系统进行展现,提醒和跟踪。可以清晰地在会
开发知识-数据优化知识点
2021-02-07
查询性能优化使用连接(JOIN)来代替子查询(Sub-Queries)MySQL从4.1开始支持SQL的子查询。这个技术可以使用SELECT语句来创建一个单列的
密码管理-超级管理员密码修改
2021-02-25
O2OA内置了一个登录账号为xadmin的超级管理员,此管理员信息未添加到组织结构中,对超级管理员的密码修改,可以使用命令,系统配置或者修改配置文件。本篇主要介
信息栏目-创建栏目和分类
2021-03-01
O2OA提供的信息管理功能可以帮助用户快速地配置信息发布栏目,如通知公告,公司动态,规章制度等。用户可以高效地完成信息栏目和配置。本文主要介绍如何在O2OA中完
系统集成-SSO微软ADSF单点认证-AD域认证
2021-02-26
O2OA平台提供灵活的系统集成方案,让企业信息平台与各类第三方系统进行集成。本篇主要介绍如何在O2OA中使用微软ADSF单点认证的方案与其他系统实现单点登入。
工作管理使用手册
2021-02-18
O2OA工作管理系统,能够将工作任务全面结构化、过程化,将个人与企业融合起来,加强工作协同,确保企业向信息化和规范化道路发展。
系统角色权限设置说明
2021-02-25
O2OA平台内置19种不同的系统角色,适应于各类应用的权限控制。本篇主要简单讲述初平台拥有的角色列表以及如何对指定的应用进行权限设置
Custom应用前端代码编译
2021-03-15
O2OA允许用户对服务进行扩展,可以修改原来的代码,但是我们更推荐用户增加新的war包,jar包,根据O2OA的源码结构新增服务和应用来进行业务的扩展。本文主要
业务开发-组织架构-组织职位信息管理
2021-02-26
O2OA提供多级组织架构设置能力,用户可以在系统内设置集团、分公司、部门、小组等多级企业组织结构来满足办公需要,可以为组织设置不同的职务来实现配置和人员的解耦。
论坛管理
2021-02-19
O2OA平台论坛管理为企业提供了一个员工公开交流的场所,经过配置后,论坛可以拥有丰富的栏目、版块,可以进行版块的权限设置,可见性,发贴回复权限设置。

results matching ""

    No results matching ""