泛微E9版本解决方案
<p>[TOC]</p>
<h1>泛微E9版本解决方案</h1>
<p>本文档主要说明泛微E9版本的对接业务,对接解决方案,对接过程中需要特别注意点,以及实施过程中如何进行初始化以及对应的FAQ</p>
<p>泛微E8版本解决方案对接业务对接条件(必须满足以下条件)标准接口文档实施初始化步骤泛微E8对接过程中可能遇到的问题</p>
<h2>对接业务</h2>
<table>
<thead>
<tr>
<th>业务</th>
<th>协议</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>公司同步</td>
<td>http</td>
<td></td>
</tr>
<tr>
<td>部门同步</td>
<td>http</td>
<td></td>
</tr>
<tr>
<td>岗位同步</td>
<td>http</td>
<td></td>
</tr>
<tr>
<td>人员同步</td>
<td>http</td>
<td></td>
</tr>
</tbody>
</table>
<h2>对接条件(必须满足以下条件)</h2>
<p>1.组织同步</p>
<p>1.1 组织用编码作为唯一标识,DHG的组织层级和编码必须保持一致,否则会出现组织错乱,此问题是泛微标准功能。如果客户希望不出现此问题,需要跟泛微沟通开发。</p>
<p>1.2 此处需要注意在进行组织合并转移时不要去修改对应的组织编码,否则会影响泛微生成重复的组织</p>
<p>1.3 E8版本OA组织架构里面,不支持部门直接放到顶级的集团根节点下面,需要在顶级根节点下面先建立公司,然后放部门。 在进行第三方接口配置时最高级的集团不要勾选,集团不用同步</p>
<p>1.4 E8版本OA组织架构里面,不支持部门下面建公司!!否则同步后这个公司会“找不到上级“直接跑到集团根节点下面去。(原因是因为向OA同步组织档案的时候,会把它的上级组织一起推给OA,但是这个公司的上级不是”公司“(分部)属性,然后”找不到上级“就这样了。所以公司、子公司需要层层递进,不能在部门下面建公司同步给OA。</p>
<p>2.人员同步</p>
<p>2.1 泛微的上级组织是必填的,这时要跟客户沟通下我们这边的上级领导需要必填,如果需要去掉这个限制,需要泛微进行开发</p>
<p>3.同步岗位</p>
<p>泛微的岗位设计与我们是不一样的,这个建议不做同步,影响不大,同步过去也无法知道这个岗位是哪个部门的,会造成岗位重复</p>
<p>4.同步管理组类别</p>
<p>这里DHG支持配置,但是泛微的矩阵接口需要泛微进行定制开发,泛微没有对应的标准接口 这里前期 要跟客户确认好。</p>
<h2>标准接口文档(<a href="https://e-cloudstore.com/doc.html?appId=c373a4b01fb74d098b62e2b969081d2d">https://e-cloudstore.com/doc.html?appId=c373a4b01fb74d098b62e2b969081d2d</a>)</h2>
<p>方案一:token认证
<a href="https://www.showdoc.com.cn/p/1b3374375d38acb1b9f808daa36906ae">https://www.showdoc.com.cn/p/1b3374375d38acb1b9f808daa36906ae</a>
方案二:IP认证方式
IP方式:在/WEB-INF/prop/HrmWebserviceIP.properties配置客户端IP;多个值的以逗号分隔。
调用的客户端ip正确,则无需提供任何额外的参数。直接调用业务接口。</p>
<p>同步公司:
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=a9ba0f3f6bb3633b33a400e285aaa382&file=file.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=2eb1de33f4f9af6512dfe24526d18787&file=file.png" alt="" />
同步部门:
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=d4a73a68fac035559a02135ca5158552&file=file.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=82cb2b9915c303b5749ae982d0f3749d&file=file.png" alt="" />
同步岗位
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=5ea0e4b4ff5ce07c83db1b83673d8296&file=file.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=3e001e9e303844df2418216d727a3f6b&file=file.png" alt="" />
同步人员
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=0484f0f32282b547fdb79fa5a7500e16&file=file.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=8c81a34fa60e17f9004ce8c160557afc&file=file.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=084198ffaad7588c2685377b715774cb&file=file.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=ad44c3558bdffad1effef42902594a98&file=file.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=9f8a9bf8b277fcb84790b41c25b0f48d&file=file.png" alt="" /></p>
<p>实施初始化步骤:</p>
<p>一.同步需求分析
进行同步之前需要做好需求分析
1.确定好数据库类型
2.初始化脚本里是一些标准字段,如果说还需增加或者删除掉字段的,需要实施与客户沟通后,提供一份需求文档,明确业务流程
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=4f8b002a4798f9551aafde527d34e8c6&file=file.png" alt="" /></p>
<p>二.下载脚本
1.【脚本位置】项目文档管理——第三方接口——泛微类;</p>
<p>2、选择相应的oa版本和数据库类型的脚本下载
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=4825e7264192d30d67ea1bdd81698fe4&file=file.png" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=c4f778a9c4f48396949af1da8c7bbc86&file=file.png" alt="" /></p>
<p>3.检查接口配置</p>
<p>1-导入脚本完成后,在DHG中找到第三方接口平台(新)并打开,检查里面部门人员岗位接口是否都有
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=6acfcc2af534c03e01b464e1f78c8fd4&file=file.png" alt="" />
2-点击右上角的数据源信息,检查发现有没有泛微的数据源,将其ip和端口改为泛微的地址
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=9c6c2b7ab4cbfa513e6aa4a2ef955a6e&file=file.png" alt="" />
3-点击接口参数设置,将第三方同步勾选上,其他选项不用管,点击保存即可
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=985e17e4c52f28ef6fdff36e809dbfa1&file=file.png" alt="" /></p>
<p>三.验证测试
1.测试同步有两种方式来测试,一种是找到第三接口配置模块,然后选择批量同步,选择部门,新增,执行就行了
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=29b4723f2ff5a47e06f2f1c671557ee8&file=file.png" alt="" />
<strong>
要注意的是,一定要先同步部门然后在去同步人员和岗位信息,否则会同步失败!!!</strong></p>
<p>四.日志分析
查看日志的地方:找到第三方接口平台(新),点击进去,右上角有个日志信息,对创建日期进行筛选,找到最新的一次日志,双击进行查看
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=4a8e66107b7d6cd9daff043fe6820a74&file=file.png" alt="" /></p>
<p>看相应结果,当相应结果出现以下的信息时,状态码等于1时就是同步成功了</p>
<p>对日志结果进行简单的分析,param里面传到的就是部门的一些参数,如果有些信息没同步过去,就看下param里面的参数有没有取到值。根据状态码来确定是否同步成功,code=1表示成功,其他人员和岗位的接口也相似
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=9f1b33f893b7bea446017f609a9f9eae&file=file.png" alt="" /></p>
<p>四.常见问题
请求的地址没增加白名单,将日志上的ip交个泛微的人添加白名单
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=a3e408df3546638aaa4c6e0c87baa68e&file=file.png" alt="" /></p>
<p>人员所在的部门在OA上不存在报的的错,同步的顺序部门——岗位——人员
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=7cf240c72afce03285162e709e8a2653&file=file.png" alt="" /></p>