O2OA对接企业微信相关v7.2.3

O2OA对接企业微信，测试版本：v7.2.3

> 本文档主要讲述踩坑
> `[root@spt]` 是我环境的地址，不是命令，请知悉

测试**O2OA**版本：`v7.2.3`

##第一步：按照官方文档进行企业微信对接
参考地址：[移动办公-将平台集成到企业微信(WeChat)](https://www.o2oa.net/cms/mobileoa/193.html "移动办公-将平台集成到企业微信(WeChat)")

##第二步：踩坑点

####1、因为我是用的docker安装部署的linux环境，启动发现中文提示都是问号，类似：???:???????
- ######这是由于docker启动时没有定义好编码，可以试试下面命令：

```
#首先进入docker检查当前环境编码
[root@spt] locale
#结果类似如下，就是没设置，一般我们都是utf-8,所以需要设置下
	LANG=
	LANGUAGE=
	LC_CTYPE="POSIX"
	LC_NUMERIC="POSIX"
	LC_TIME="POSIX"
	LC_COLLATE="POSIX"
	LC_MONETARY="POSIX"
	LC_MESSAGES="POSIX"
	LC_PAPER="POSIX"
	LC_NAME="POSIX"
	LC_ADDRESS="POSIX"
	LC_TELEPHONE="POSIX"
	LC_MEASUREMENT="POSIX"
	LC_IDENTIFICATION="POSIX"
	LC_ALL=
#设置编码,注意各个操作系统可能有所不同，我这里是设置 U.UTF-8 ,以下命令不能设置大家可以去网上搜索一下
[root@spt] LANG=U.UTF-8
#生效
[root@spt] source /etc/profile
#再次查看
[root@spt] locale
```
- ######如果还没生成docker容器或者可以重新打包一下，在生成容器的时候就自己设置编码格式

####2、对接后，不能同步，显示接口因微信整改而不可用了，可以试试替换下面这个包

- ######war包：[x_program_center.war](http://klala.pengdayou.top/png/x_program_center.war "x_program_center.war")

####3、关闭重启

- ######a、如果还没关闭启动的控制台窗口，则直接：stop,start,exit等命令可以直接使用

- ######b、命令查找再关闭

```
[root@spt] ps -ef |grep -v grep |grep o2server
#结果类似如下
root      8173  8170  6 02:35 ?        00:04:48 /O2OA/target/o2server/jvm/linux_java11/bin/java -Dnashorn.args=--no-deprecation-warning --add-exports jdk.scripting.nashorn/jdk.nashorn.internal.runtime=ALL-UNNAMED --add-exports jdk.scripting.nashorn/jdk.nashorn.internal.runtime.arrays=ALL-UNNAMED --add-opens java.base/java.lang=ALL-UNNAMED -javaagent:/O2OA/target/o2server/console.jar -server -Djava.awt.headless=true -Xms2g -Duser.timezone=GMT+08 -XX:+HeapDumpOnOutOfMemoryError -jar /O2OA/target/o2server/console.jar

#上方的8173就是启动进程的PID，杀死重启即可
#杀死
[root@spt] kill -9 8173
#进入启动目录
[root@spt] cd /O2OA/target/o2server
#启动
[root@spt] sh start_linux.sh

```

####4、https启用
官方文档参考地址：https://www.o2oa.net/cms/serverdeployment/263.html
> 踩坑点：
>>	设置config/node_127.0.0.1.json 的内容、上传文件改keystore、后台配置设置ssh开启并配置密匙内容后，启动不报错，但是http和https都不能访问。

>解决办法:
>>	用全地址试试，如：https://域名:端口/x_desktop/index.html

注意：
- 1、将  `域名.jks` 文件上传到 config下改名为：keystore
- 2、设置config/node_127.0.0.1.json 的内容
- 3、登录后台，进入系统配置>服务配置>服务器配置>右侧选择`节点:127.0.0.1`
- 4、拉到底部找到`是否启用SSL`，启用,并配置好密匙(阿里云申请的密匙是在下载证书的时候和`*.jks`文件一起的txt文件内容)，点保存
- 5、查看config/token.json文件中`sslKeyStorePassword`、`sslKeyManagerPassword`是否已修改为刚填写密匙。
- 6、重启服务器，用全地址访问，不要单独用域名

`node_127.0.0.1.json`示例代码：

```
{
  "enable": true,
  "center": {
    "enable": true,
    "order": 0,
    "sslEnable": true,
    "port": 9070,
    "httpProtocol": "https",
    "proxyHost": "",
    "proxyPort": 9070
  },
  "application": {
    "enable": true,
    "port": 9070,
    "sslEnable": true,
    "proxyHost": "",
    "proxyPort": 9070,
    "includes": [],
    "excludes": []
  },
  "web": {
    "enable": true,
    "port": 9070,
    "sslEnable": true,
    "proxyHost": "",
    "proxyPort": 9070,
    "proxyCenterEnable": false,
    "proxyApplicationEnable": false
  },
  "data": {
    "enable": false,
    "tcpPort": 20050,
    "includes": [],
    "excludes": [],
    "jmxEnable": false,
    "cacheSize": 512,
    "logLevel": "WARN",
    "maxTotal": 50,
    "maxIdle": 0,
    "statEnable": false,
    "statFilter": "mergeStat",
    "slowSqlMillis": 2000,
    "lockTimeout": 120000
  },
  "storage": {
    "enable": true,
    "port": 20040,
    "sslEnable": false,
    "name": "251",
    "prefix": "",
    "deepPath": false
  },
  "dumpData": {
    "enable": false,
    "cron": "* * * * * 7",
    "size": 1,
    "path": ""
  },
  "restoreData": {
    "enable": false,
    "cron": "",
    "path": ""
  },
  "stackTrace": {
    "enable": false,
    "interval": 20
  },
  "nodeAgentEnable": true,
  "nodeAgentPort": 20010,
  "nodeAgentEncrypt": true,
  "autoStart": true,
  "selfHealthCheckEnable": false
}

```

`centerServer.json`示例代码（可以先试试不加这个文件）：
```
{
  "sslEnable": true,
  "redeploy": true,
  "port": 9070,
  "httpProtocol": "",
  "proxyHost": "",
  "proxyPort":9070,
  "scanInterval": 0.0,
  "###enable": "是否启用###",
  "###sslEnable": "是否启用ssl传输加密,如果启用将使用config/keystore文件作为密钥文件.使用config/token.json文件中的sslKeyStorePassword字段为密钥密码,sslKeyManagerPassword为管理密码.###",
  "###redeploy": "每次启动是否重新部署所有应用.###",
  "###port": "端口,center服务器端口,默认20030###",
  "###httpProtocol": "对外http访问协议,http/https###",
  "###proxyHost": "代理主机,当服务器是通过apache/eginx等代理服务器映射到公网或者通过路由器做端口映射,在这样的情况下需要设置此地址以标明公网访问地址.###",
  "###proxyPort": "代理端口,当服务器是通过apache/eginx等代理服务器映射到公网或者通过路由器做端口映射,在这样的情况下需要设置此地址以标明公网访问端口.###",
  "###scanInterval": "重新扫描war包时间间隔(秒)###",
  "###config": "其他参数###"
}
```

<blockquote>
<p>本文档主要讲述踩坑<br><code>[root<a href="https://github.com/spt" title="@spt" class="at-link">@spt</a>]</code> 是我环境的地址，不是命令，请知悉</p>
</blockquote>
<p>测试<strong>O2OA</strong>版本：<code>v7.2.3</code></p>
<h2 id="h2--"><a name="第一步：按照官方文档进行企业微信对接" class="reference-link"></a><span class="header-link octicon octicon-link"></span>第一步：按照官方文档进行企业微信对接</h2><p>参考地址：<a href="https://www.o2oa.net/cms/mobileoa/193.html" title="移动办公-将平台集成到企业微信(WeChat)">移动办公-将平台集成到企业微信(WeChat)</a></p>
<h2 id="h2--"><a name="第二步：踩坑点" class="reference-link"></a><span class="header-link octicon octicon-link"></span>第二步：踩坑点</h2><h4 id="h4-1-docker-linux-"><a name="1、因为我是用的docker安装部署的linux环境，启动发现中文提示都是问号，类似：???:???????" class="reference-link"></a><span class="header-link octicon octicon-link"></span>1、因为我是用的docker安装部署的linux环境，启动发现中文提示都是问号，类似：???:???????</h4><ul>
<li><h6 id="h6--docker-"><a name="这是由于docker启动时没有定义好编码，可以试试下面命令：" class="reference-link"></a><span class="header-link octicon octicon-link"></span>这是由于docker启动时没有定义好编码，可以试试下面命令：</h6></li></ul>
<pre><code>#首先进入docker检查当前环境编码
[root@spt] locale
#结果类似如下，就是没设置，一般我们都是utf-8,所以需要设置下
    LANG=
    LANGUAGE=
    LC_CTYPE="POSIX"
    LC_NUMERIC="POSIX"
    LC_TIME="POSIX"
    LC_COLLATE="POSIX"
    LC_MONETARY="POSIX"
    LC_MESSAGES="POSIX"
    LC_PAPER="POSIX"
    LC_NAME="POSIX"
    LC_ADDRESS="POSIX"
    LC_TELEPHONE="POSIX"
    LC_MEASUREMENT="POSIX"
    LC_IDENTIFICATION="POSIX"
    LC_ALL=
#设置编码,注意各个操作系统可能有所不同，我这里是设置 U.UTF-8 ,以下命令不能设置大家可以去网上搜索一下
[root@spt] LANG=U.UTF-8
#生效
[root@spt] source /etc/profile
#再次查看
[root@spt] locale
</code></pre><ul>
<li><h6 id="h6--docker-"><a name="如果还没生成docker容器或者可以重新打包一下，在生成容器的时候就自己设置编码格式" class="reference-link"></a><span class="header-link octicon octicon-link"></span>如果还没生成docker容器或者可以重新打包一下，在生成容器的时候就自己设置编码格式</h6></li></ul>
<h4 id="h4-2-"><a name="2、对接后，不能同步，显示接口因微信整改而不可用了，可以试试替换下面这个包" class="reference-link"></a><span class="header-link octicon octicon-link"></span>2、对接后，不能同步，显示接口因微信整改而不可用了，可以试试替换下面这个包</h4><ul>
<li><h6 id="h6-war-x_program_center-war"><a name="war包：  x_program_center.war" class="reference-link"></a><span class="header-link octicon octicon-link"></span>war包：<a href="http://klala.pengdayou.top/png/x_program_center.war" title="x_program_center.war">x_program_center.war</a></h6></li></ul>
<h4 id="h4-3-"><a name="3、关闭重启" class="reference-link"></a><span class="header-link octicon octicon-link"></span>3、关闭重启</h4><ul>
<li><h6 id="h6-a-stop-start-exit-"><a name="a、如果还没关闭启动的控制台窗口，则直接：stop,start,exit等命令可以直接使用" class="reference-link"></a><span class="header-link octicon octicon-link"></span>a、如果还没关闭启动的控制台窗口，则直接：stop,start,exit等命令可以直接使用</h6></li><li><h6 id="h6-b-"><a name="b、命令查找再关闭" class="reference-link"></a><span class="header-link octicon octicon-link"></span>b、命令查找再关闭</h6></li></ul>
<pre><code>[root@spt] ps -ef |grep -v grep |grep o2server
#结果类似如下
root      8173  8170  6 02:35 ?        00:04:48 /O2OA/target/o2server/jvm/linux_java11/bin/java -Dnashorn.args=--no-deprecation-warning --add-exports jdk.scripting.nashorn/jdk.nashorn.internal.runtime=ALL-UNNAMED --add-exports jdk.scripting.nashorn/jdk.nashorn.internal.runtime.arrays=ALL-UNNAMED --add-opens java.base/java.lang=ALL-UNNAMED -javaagent:/O2OA/target/o2server/console.jar -server -Djava.awt.headless=true -Xms2g -Duser.timezone=GMT+08 -XX:+HeapDumpOnOutOfMemoryError -jar /O2OA/target/o2server/console.jar

#上方的8173就是启动进程的PID，杀死重启即可
#杀死
[root@spt] kill -9 8173
#进入启动目录
[root@spt] cd /O2OA/target/o2server
#启动
[root@spt] sh start_linux.sh
</code></pre><h4 id="h4-4-https-"><a name="4、https启用" class="reference-link"></a><span class="header-link octicon octicon-link"></span>4、https启用</h4><p>官方文档参考地址：<a href="https://www.o2oa.net/cms/serverdeployment/263.html">https://www.o2oa.net/cms/serverdeployment/263.html</a></p>
<blockquote>
<p>踩坑点：</p>
<blockquote>
<p>   设置config/node_127.0.0.1.json 的内容、上传文件改keystore、后台配置设置ssh开启并配置密匙内容后，启动不报错，但是http和https都不能访问。</p>
</blockquote>
<p>解决办法:</p>
<blockquote>
<p>   用全地址试试，如：<a href="https://域名:端口/x_desktop/index.html">https://域名:端口/x_desktop/index.html</a></p>
</blockquote>
</blockquote>
<p>注意：</p>
<ul>
<li>1、将  <code>域名.jks</code> 文件上传到 config下改名为：keystore</li><li>2、设置config/node_127.0.0.1.json 的内容</li><li>3、登录后台，进入系统配置&gt;服务配置&gt;服务器配置&gt;右侧选择<code>节点:127.0.0.1</code></li><li>4、拉到底部找到<code>是否启用SSL</code>，启用,并配置好密匙(阿里云申请的密匙是在下载证书的时候和<code>*.jks</code>文件一起的txt文件内容)，点保存</li><li>5、查看config/token.json文件中<code>sslKeyStorePassword</code>、<code>sslKeyManagerPassword</code>是否已修改为刚填写密匙。</li><li>6、重启服务器，用全地址访问，不要单独用域名</li></ul>
<p><code>node_127.0.0.1.json</code>示例代码：</p>
<pre><code>{
  "enable": true,
  "center": {
    "enable": true,
    "order": 0,
    "sslEnable": true,
    "port": 9070,
    "httpProtocol": "https",
    "proxyHost": "",
    "proxyPort": 9070
  },
  "application": {
    "enable": true,
    "port": 9070,
    "sslEnable": true,
    "proxyHost": "",
    "proxyPort": 9070,
    "includes": [],
    "excludes": []
  },
  "web": {
    "enable": true,
    "port": 9070,
    "sslEnable": true,
    "proxyHost": "",
    "proxyPort": 9070,
    "proxyCenterEnable": false,
    "proxyApplicationEnable": false
  },
  "data": {
    "enable": false,
    "tcpPort": 20050,
    "includes": [],
    "excludes": [],
    "jmxEnable": false,
    "cacheSize": 512,
    "logLevel": "WARN",
    "maxTotal": 50,
    "maxIdle": 0,
    "statEnable": false,
    "statFilter": "mergeStat",
    "slowSqlMillis": 2000,
    "lockTimeout": 120000
  },
  "storage": {
    "enable": true,
    "port": 20040,
    "sslEnable": false,
    "name": "251",
    "prefix": "",
    "deepPath": false
  },
  "dumpData": {
    "enable": false,
    "cron": "* * * * * 7",
    "size": 1,
    "path": ""
  },
  "restoreData": {
    "enable": false,
    "cron": "",
    "path": ""
  },
  "stackTrace": {
    "enable": false,
    "interval": 20
  },
  "nodeAgentEnable": true,
  "nodeAgentPort": 20010,
  "nodeAgentEncrypt": true,
  "autoStart": true,
  "selfHealthCheckEnable": false
}
</code></pre><p><code>centerServer.json</code>示例代码（可以先试试不加这个文件）：</p>
<pre><code>{
  "sslEnable": true,
  "redeploy": true,
  "port": 9070,
  "httpProtocol": "",
  "proxyHost": "",
  "proxyPort":9070,
  "scanInterval": 0.0,
  "###enable": "是否启用###",
  "###sslEnable": "是否启用ssl传输加密,如果启用将使用config/keystore文件作为密钥文件.使用config/token.json文件中的sslKeyStorePassword字段为密钥密码,sslKeyManagerPassword为管理密码.###",
  "###redeploy": "每次启动是否重新部署所有应用.###",
  "###port": "端口,center服务器端口,默认20030###",
  "###httpProtocol": "对外http访问协议,http/https###",
  "###proxyHost": "代理主机,当服务器是通过apache/eginx等代理服务器映射到公网或者通过路由器做端口映射,在这样的情况下需要设置此地址以标明公网访问地址.###",
  "###proxyPort": "代理端口,当服务器是通过apache/eginx等代理服务器映射到公网或者通过路由器做端口映射,在这样的情况下需要设置此地址以标明公网访问端口.###",
  "###scanInterval": "重新扫描war包时间间隔(秒)###",
  "###config": "其他参数###"
}
</code></pre>

O2OA对接企业微信相关v7.2.3

热门文章

置顶推荐

最近访客