O2OA使用手册
第1章 功能简介及概述
第6章 平台部署与配置
  • 6.1 安装部署-在Windows系统中部署O2OA开发平台
  • 6.2 安装部署-在Linux系统中部署O2OA开发平台
  • 6.3 安装部署-在宝塔/PHPStudy中部署O2OA开发平台
  • 6.4 安装部署-O2OA开发平台之HTTP端口规划
  • 6.5 安装部署-平台服务器版本升级操作说明
  • 6.6 安装部署-私有化部署服务器架构推荐
  • 6.7 安装部署-O2OA开发平台集群部署配置及操作说明
  • 6.8 安装部署-在线部署自定义应用的WAR包和JAR包
  • 6.9 服务器配置与管理-​O2OA主要配置文件说明
  • 6.10 服务器配置与管理-服务器端口冲突和端口修改
  • 6.11 服务器配置与管理-如何修改服务器内存占用率?
  • 6.12 服务器配置与管理-如何访问和操作H2内置数据库
  • 6.13 服务器配置与管理-​如何在O2OA中使用MySQL数据库?
  • 6.14 服务器配置与管理-如何修改平台支持的数据库驱动包
  • 6.15 服务器配置与管理-O2OA使用openGauss(华为高斯数据库)配置
  • 6.16 服务器配置与管理-O2OA开发平台平台数据库配置信息样例
  • 6.17 服务器配置与管理-配置O2OA服务器连接O2云
  • 6.18 服务器配置与管理-O2OA实现服务器随操作系统自动启动
  • 6.19 服务器配置与管理-文件存储服务器配置
  • 6.20 服务器配置与管理-工作日节假日配置
  • 6.21 服务器配置与管理-为平台增加全文检索功能
  • 6.22 服务器配置与管理-消息提醒配置说明
  • 6.23 服务器配置与管理-自定义消息提醒
  • 6.24 服务器配置与管理-定制消息通知的内容
  • 6.25 服务器配置与管理-消息通知过滤
  • 6.26 服务器配置与管理-为待办创建配置邮件通知
  • 6.27 服务器配置与管理-待办待阅数据的查询操作和管理
  • 6.28 服务器配置与管理-​自动执行平台数据的备份与恢复
  • 6.29 服务器配置与管理-数据导出导入与系统数据备份
  • 6.30 ​服务器配置与管理-定期自动执行数据备份与恢复
  • 6.31 系统安全-O2OA作为认证中心实现基于OAUTH2单点认证
  • 6.32 系统安全-O2OA基于Nginx的SSL跳转、转发配置
  • 6.33 系统安全-访问日志相关配置
  • 6.34 系统安全-审计日志相关配置
  • 6.35 系统安全-平台日志文件说明
  • 6.36 系统安全-O2OA日志输出设置log4j2.xml
  • 6.37 系统安全-用户密码初始化规则的设定
  • 6.38 系统安全-启用HTTPS(百度云版)
  • 6.39 系统安全-启用HTTPS(腾讯云版)
  • 6.40 系统安全-自签名SSL证书验证HTTPS功能
  • 6.41 系统安全-登录密码RSA加密
  • 6.42 系统安全-用户登录IP限制
  • 6.43 系统安全-在用户登录过程中启用图形验证码
  • 6.44 系统安全-平台部署之使用非root用户运行服务
  • 6.45 系统安全-O2Server启用国密加密设置
  • 6.46 系统安全-日志应用使用说明
  • 6.47 系统安全-用户重置密码操作
  • 6.48 系统安全-超级管理员(xadmin)密码修改
  • 6.49 系统安全-使用Web端运行服务器管理命令
  • 6.50 系统安全-o2server无法正常显示验证码解决办法
  • 第16章 开发知识及常见问题
  • 16.1 如何替换登录页面二维码中默认的logo图标
  • 16.2 O2OA(翱途)流程引擎中如何修改,定制流程的流转记录
  • 16.3 mysql数据库备份
  • 16.4 domain不正确的时候如何强制设置成正确的
  • 16.5 配置文件中使用密文存储密码
  • 16.6 常见问题-连接MySQL出现 Public Key Retrieval is not allowed 的错误
  • 16.7 常见问题-查看表结构
  • 16.8 常见问题-7.2及以上版本开启web代理后请求中没有正确使用web端口问题解决方式
  • 16.9 linux环境libreoffice安装及使用
  • 16.10 在O2OA中使用网络会议(二):Openmeetings与O2OA认证配置
  • 16.11 在O2OA中使用网络会议(一):Openmeetings-5.1.0亲手安装整理 Step-By-Step
  • 16.12 藕粉社区问答系列1
  • 16.13 藕粉社区问答系列2
  • 16.14 藕粉社区问答系列3
  • 16.15 快速入门-平台相关资料汇总
  • 16.16 快速入门-服务器总体介绍汇总
  • 16.17 快速入门-流程表单载入基础数据
  • 16.18 快速入门-常用表单脚本样例汇总
  • 16.19 快速入门-自定义表数据分页样例
  • 16.20 OEM白标-如何修改平台中的Logo图标和文字
  • 16.21 云服务器-阿里云ECS服务器的端口启用
  • 16.22 开发知识-React篇:在O2OA平台框架中使用React
  • 16.23 开发知识-React篇:在O2OA门户页面中使用React
  • 16.24 开发知识-Vue篇:在Vue应用中集成O2OA
  • 16.25 开发知识-Vue篇:使用Vue-CLI开发O2应用
  • 16.26 开发知识-Vue篇:在O2门户页面中使用Vue
  • 16.27 平台中使用Druid数据库连接及监控
  • 16.28 开发知识-在PAAS平台上部署O2OA开发平台
  • 16.29 开发知识-如何使用Tomcat架设webdav服务器
  • 16.30 开发知识-单个端口模式的Nginx和系统配置
  • 16.31 开发知识-Linux非root用户如何使用80端口启动O2OA
  • 16.32 开发知识-O2OA平台启用Eruda进行移动端调试
  • 16.33 开发知识-神通数据库安装
  • 16.34 开发知识-人大金仓数据安装
  • 16.35 开发知识-中标麒麟安装达梦数据库(DM8)
  • 16.36 开发知识-中标麒麟安装人大金仓详细步骤
  • 16.37 开发知识-使用VNC连接中标麒麟V7操作系统
  • 16.38 开发知识-鲲鹏(ARM)麒麟操作系统如何替换yum源?
  • 16.39 开发知识-数据优化知识点
  • 16.40 水印安全-附件水印|加密|文档格式转换图片|PDF
  • 16.41 消息队列-配置activeMQ、kafka消息队列
  • 16.42 常见问题-数据导出或者导入时发生OOM异常
  • 16.43 常见问题-如何让用户在首次登录时,必须对初始密码进行修改
  • 16.44 常见问题-如何在模块部署中控制模块的访问权限
  • 16.45 常见问题-如何在平台中开发Ftp文件上传文件的服务?
  • 16.46 常见问题-如何使用服务管理调用WebService
  • 16.47 常见问题-如何使用脚本调用外部服务
  • 16.48 常见问题-如何使用脚本控制流程自动流转
  • 16.49 常见问题-如何通过脚本调用系统内服务
  • 16.50 常见问题-接口代码疑惑解答汇总
  • 16.51 常见问题:Maven编译o2server错误: Java Heap Space
  • 16.52 常见问题-集群配置后启动报错:NullPointerException
  • 16.53 常见问题-服务器错误:can not decrypt token
  • 16.54 常见问题-IOS移动办公无法收到验证码
  • 16.55 常见问题-服务器和日志时间相差12小时的问题
  • 16.56 常见问题-为什么127.0.0.1可以访问但其他IP无法访问
  • 16.57 藕粉社区问答系列4
  • 16.58 开发知识-React篇:在React应用中集成O2OA

  • 微信公众号-将O2OA与微信公众号集成

    时间:2022-12-16   

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

    一、先决条件:

    1、O2Server服务器正常运行,系统安装部署请参考文档《如何在服务器上安装部署O2OA》

    2、以拥有管理员权限的用户账号登录O2OA(翱途)开发平台,如:xadmin

    3、管理与配置公众号需要用户自行准备微信公众号管理账户,注册地址:https://mp.weixin.qq.com

    二、公众号管理平台相关配置

    1、启用服务器配置

    管理员登录微信公众号管理平台,在左边菜单导航底部的【开发】部分找到【基本配置】菜单,点击进入配置页面,如下图所示:

    image.png

    image.png

    这里的配置可以分两种情况:

    1)如果公众号管理平台中已经开启过服务器配置功能,可能代表公司已经有其他应用在使用微信公众号了。那么只需要把一些关键信息复制到O2OA开发平台系统设置公众号相关的配置文件(mpweixin.json)中就行了,配置方法后面会详细阐述。

    2)如果公众号管理平台中没有开启过服务器配置功能,则需要先启用服务器配置信息。这里需要注意的是,因为微信公众平台的要求,服务器必须要用http(80)或者 https(443)这两个默认端口。O2OA服务器端口设置如下图所示(请注意,sample.o2oa.net是兰德网络的官方演示服务器,请替换为您部署的服务器域名):

    image.png

    注意:开启服务器配置,会清除掉原有的公众号菜单,如果之前已经在使用微信公众号处理业务,最好先备份记录一下原有的菜单结构和数据。

    开发信息与服务器配置说明

    • 开发者ID(AppID)这个是默认生成的,需要复制到配置文件(mpweixin.json)中

    • 开发者密码(AppSecret) 这个需要开启,并记录下这个值,需要复制到配置文件(mpweixin.json)中

    • IP白名单 这个需要配置,就是你们部署的O2OA服务器的外网的ip地址,O2OA需要访问微信服务器,如果没有配置ip地址,微信那边会拒绝访问。

    • 服务器地址(URL) http://O2OA服务器的外网访问地址/x_program_center/jaxrs/mpweixin/check

    • 令牌(token) 自定义字符串,可以自行写一个,比如o2oa。需要复制到配置文件(mpweixin.json)中

    • 消息加密密钥(EncodingAESKey)这个用旁边的自动生成按钮,点击生成一个就行。需要复制到配置文件(mpweixin.json)中

    • 消息加密方式  选择明文模式。

    填写和生成各种参数完成后先不要点击保存,先将这些参数配置到O2OA后台的一个配置文件中,请参考下述O2OA服务器配置mpweixin.json配置文件说明:

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

    使用管理员登录O2OA系统,打开系统设置 -> 移动端配置 -> 应用集成 -> 微信公众号集成,把前面公众号管理平台生成的参数填入对应的位置,如下图所示界面:

    image.png

    或者直接到在部署O2OA服务器的文件系统中在o2server/config目录下找到配置文件mpweixin.json并进行修改,

    (如果没有config目录,请在o2server目录中创建config目录;如果config目录中没有mpweixin.json文件,请从o2server/configSample目录中复制mpweixin.json文件到o2server/config目录中进行修改;请注意只有o2server/config目录的配置文件才会生效

    将参数填入,配置信息如下:

    {
    "enable": true,
    "appid":"填入AppID",
    "appSecret":"填入AppSecret",
    "token":"填入token",
    "encodingAesKey":"填入EncodingAESKey",
     "enablePublish":true // 是否启用发布菜单功能
    }

    mpweixin.json文件修改完成之后保存文件,并重启O2OA服务器让配置修改生效。

    服务器重启后,开发者就可以使用管理员账号在系统设置-移动端配置-APP工具中对公众号对公众号菜单进行配置,并且保存。

    保存时提示配置成功就表示公众号和O2OA服务器关联集成已经成功。

    三、公众号菜单管理

    如果微信公众号启用了服务器配置,那公众号的菜单将由配置的服务器管理,不能在公众号的管理平台编辑,所以O2OA开发平台直接提供了管理公众号菜单的能力,如下图所示:

    image.png

    目前菜单支持3种形式,分别是发送文字消息、点击菜单打开一个网页、点击菜单打开一个关联小程序。第一级菜单最多支持3个子菜单,第二级菜单最多支持5个子菜单。

    O2OA 关联菜单配置

    O2OA开发平台的业务可以关联到公众号的菜单中,并使用公众号内嵌的网页形式打开O2OA开发平台中设计的页面与表单,完成办公相关的业务操作,如下图所示:

    IMG_5104.jpg

    在O2OA中注册的用户关注公众号之后,需要将公众号用户账号和O2OA的内部注册的用户账号进行一次绑定,这样公众号用户和O2OA的用户之间才能建立联系,实现在公众号上直接打开并且处理O2OA内部的工作页面。所以我们需要尝试创建两个网页菜单:绑定账号工作页面

    1)创建‘绑定账号’菜单

    image.png

    因为绑定账号为O2OA开发平台提供的能力,所以页面地址为固定的URL,请参考下方信息并且修改后填入:

    https://open.weixin.qq.com/connect/oauth2/authorize?appid=【wx1c0c41e607a8b6fe】&redirect_uri=【https】%3A%2F%2F【sample.o2oa.net】%2Fx_desktop%2Fmpweixinsso.html%3Ftype%3Dbind&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect

    URL中需要注意修改【】符号包含的内容:第一个是appid,第二个是http 或 https,第三个是访问O2OA的域名

    2)创建‘工作页面’菜单

    image.png

    微信公众号一般具有相当多不同的功能点,工作界面一般代表在微信公众号上点击菜单跳转到的O2OA开发平台准备的业务模块首页。页面跳转链接的写法也相对固定,描述如下:

    https://open.weixin.qq.com/connect/oauth2/authorize?appid=【wx1c0c41e607a8b6fe】&redirect_uri=【https】%3A%2F%2F【sample.o2oa.net】%2Fx_desktop%2Fmpweixinsso.html%3Ftype%3Dlogin%26redirect%3Dportalmobile.html%253Fid%253D【mobilePortal】&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect

    根据自己部署的服务器,URL中需要注意修改【】符号包含的内容:第一个是appid,第二个是http 或 https,第三个是O2OA访问域名,第四个是跳转的门户ID(门户标识)

    门户ID(门户标识)的获取方法:

    使用管理员进入已经开发好的门户应用,在门户应用的门户属性信息中可以获取门户标识信息

    image.png

    四、模版消息

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

    使用管理员登录公众号开放平台,在菜单【功能】模块下的【模版消息】菜单中进行相关配置。

    如果没有【模版消息】这个菜单,可以点击下面的 添加功能插件 中找到模版消息,添加到菜单中,如下图所示:

    image.png

    模版消息模版库中找一个待办消息类的模版,点击详情可以查看模版的格式,如下图所示:

    image.png

    这里主要关注详细内容,也就是模版的内容,里面有几个参数表示可以替换成需要的业务字段,最终消息的展示结果可以看左边的内容示例。可以把这个模版添加到我的模版中。

    准备好模版后,使用管理员登录O2OA开发平台,到 系统设置 -> 移动端配置 -> 应用集成 -> 微信公众号集成 中把模版消息id和对应的参数字段填入到配置中:

    image.png

    或者直接到O2OA服务器配置o2server/config/mpweixin.json配置文件(如果没有config目录,请在o2server目录中创建config目录;如果config目录中没有mpweixin.json文件,请从o2server/configSample目录中复制mpweixin.json文件到o2server/config目录中进行修改;请注意只有o2server/config目录的配置文件才会生效),配置信息如下图所示:

    {
    "enable": true,
    "appid":"填入AppID",
    "appSecret":"填入AppSecret",
    "token":"填入token",
    "encodingAesKey":"填入EncodingAESKey",
    "enablePublish":true, // 是否启用发布菜单功能
    "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 标题】。

    • fieldList配置就是把业务字段和模版内容字段一一对应起来,name 代表业务字段名,tempName 代表模版字段名。 如 {"name": "title", "tempName": "keyword1"} 就表示把O2OA工作的title字段,放入到模版内容的keyword1字段的位置上去。

    另外,模版中 first 和 remark 字段是固定形式,不需要配置。公众号配置完成之后,使用的效果如下图所示:

    IMG_ED005F9D4985-1.jpg



    以上是如何将如何将O2OA(翱途)开发平台中的业务集成到微信公众号实现公众号办公的详细说明,希望对您有帮助。