系统集成——第三方向金蝶s-HR写入数据的方法（人事）

【应用场景】

  此文档为指导如何在二开组织人事接口，并调用二开接口，实现客制化需求。

【开发基础】

1.熟悉s-HR开发模式、框架、工具；

2.了解osf配置、运行过程；

3.熟悉单据的相关元数据及业务逻辑；

4.搭建s-HR开发环境；

【参考资料】

s-HR与第三方集成

https://vip.kingdee.com/article/345616446195667456?fromAction=POST_ARTICLE&productLineId=10

【常见问题】

（1）单点登录时返回状态301状态异常。

检查单点登录的地址和s-HR系统地址是否协议一致，如果单点登录设置的地址为http地址，但实际系统地址为https地址，此时会强制跳转https，返回301状态。

（2）引用了单点登录相关jar包后，系统编译失败。

       单点登录的jar包引用了其它开放工具jar包，如httpClient等，检查是否是jar包版本冲突导致编译失败。

（3）单点登录成功，但返回失败数据。

       在二开的osf服务类中添加日志埋点，便于排查单点登录成功后是否进入服务类。排查s-HR系统中apusic日志，解决发生的业务异常。

（4）osf服务类部署路径不对，调用时找不到相关服务。

       先确认单点登录是否成功，检查apusic日志，若osf服务没有部署在addon/custom目录下，则会报classDefNotFound异常；若调用的服务名称错误，则会报classNotFound异常。

（5）集成单据失败，生成的单据数据异常。

       由于osf服务中是直接调用单据的后台保存或提交生效方法，