[TOC]

泛微E9版本解决方案

本文档主要说明泛微E9版本的对接业务，对接解决方案，对接过程中需要特别注意点，以及实施过程中如何进行初始化以及对应的FAQ

泛微E8版本解决方案对接业务对接条件（必须满足以下条件）标准接口文档实施初始化步骤泛微E8对接过程中可能遇到的问题

对接业务

业务	协议	备注
公司同步	http
部门同步	http
岗位同步	http
人员同步	http

对接条件（必须满足以下条件）

1.组织同步

1.1 组织用编码作为唯一标识，DHG的组织层级和编码必须保持一致，否则会出现组织错乱，此问题是泛微标准功能。如果客户希望不出现此问题，需要跟泛微沟通开发。

1.2 此处需要注意在进行组织合并转移时不要去修改对应的组织编码，否则会影响泛微生成重复的组织

1.3 E8版本OA组织架构里面，不支持部门直接放到顶级的集团根节点下面，需要在顶级根节点下面先建立公司，然后放部门。 在进行第三方接口配置时最高级的集团不要勾选，集团不用同步

1.4 E8版本OA组织架构里面，不支持部门下面建公司！！否则同步后这个公司会“找不到上级“直接跑到集团根节点下面去。（原因是因为向OA同步组织档案的时候，会把它的上级组织一起推给OA，但是这个公司的上级不是”公司“(分部)属性，然后”找不到上级“就这样了。所以公司、子公司需要层层递进，不能在部门下面建公司同步给OA。

2.人员同步

2.1 泛微的上级组织是必填的，这时要跟客户沟通下我们这边的上级领导需要必填，如果需要去掉这个限制，需要泛微进行开发

3.同步岗位

泛微的岗位设计与我们是不一样的，这个建议不做同步，影响不大，同步过去也无法知道这个岗位是哪个部门的，会造成岗位重复

4.同步管理组类别

这里DHG支持配置，但是泛微的矩阵接口需要泛微进行定制开发，泛微没有对应的标准接口 这里前期 要跟客户确认好。

标准接口文档（https://e-cloudstore.com/doc.html?appId=c373a4b01fb74d098b62e2b969081d2d）

方案一：token认证 https://www.showdoc.com.cn/p/1b3374375d38acb1b9f808daa36906ae 方案二：IP认证方式 IP方式：在/WEB-INF/prop/HrmWebserviceIP.properties配置客户端IP；多个值的以逗号分隔。 调用的客户端ip正确，则无需提供任何额外的参数。直接调用业务接口。

同步公司： 同步部门： 同步岗位 同步人员

实施初始化步骤：

一.同步需求分析 进行同步之前需要做好需求分析 1.确定好数据库类型 2.初始化脚本里是一些标准字段，如果说还需增加或者删除掉字段的，需要实施与客户沟通后，提供一份需求文档，明确业务流程

二.下载脚本 1.【脚本位置】项目文档管理——第三方接口——泛微类；

2、选择相应的oa版本和数据库类型的脚本下载

3.检查接口配置

1-导入脚本完成后，在DHG中找到第三方接口平台（新）并打开，检查里面部门人员岗位接口是否都有 2-点击右上角的数据源信息，检查发现有没有泛微的数据源，将其ip和端口改为泛微的地址 3-点击接口参数设置，将第三方同步勾选上，其他选项不用管，点击保存即可

三.验证测试 1.测试同步有两种方式来测试，一种是找到第三接口配置模块，然后选择批量同步，选择部门，新增，执行就行了 要注意的是，一定要先同步部门然后在去同步人员和岗位信息，否则会同步失败！！！

四.日志分析 查看日志的地方：找到第三方接口平台（新），点击进去，右上角有个日志信息，对创建日期进行筛选，找到最新的一次日志，双击进行查看

看相应结果，当相应结果出现以下的信息时，状态码等于1时就是同步成功了

对日志结果进行简单的分析，param里面传到的就是部门的一些参数，如果有些信息没同步过去，就看下param里面的参数有没有取到值。根据状态码来确定是否同步成功，code=1表示成功，其他人员和岗位的接口也相似

四.常见问题 请求的地址没增加白名单，将日志上的ip交个泛微的人添加白名单

人员所在的部门在OA上不存在报的的错，同步的顺序部门——岗位——人员