【功能介绍】

    第三方异构系统需要从s-HR获取组织、职位、员工等数据，系统已经预置标准的全量取数接口来获取数据；对于s-HR Cloud V8.8 SP1及以上，系统支持通过DEP动态扩展平台增加扩展字段查询。

【适用版本】

    全量取数接口：s-HR Cloud V8.2 SP2及以上

    主数据接口及扩展：s-HR Cloud V8.8 SP1及以上

【操作步骤】

1. 首先需要了解s-HR中osf接口的调用方式，可以参考“s-HR 单点登录及调OSF”，目前标准方案是通过引入SDK的方式进行认证与接口调用，若不使用该方式，需要参考SDK的代码来二开调用。

   
   

2. 对于全量取数接口，s-HR Cloud V8.2 SP2及以上已预置了标准osf接口供第三方调用，常见的有：

   全量获取组织：inteOAGetAdminOrgDataService

   全量获取员工：inteOAGetPersonDataService

   全量获取职位：inteOAGetPositionDataService

   全量获取员工任岗：inteOAGetEmpOrgRelationService

   全量获取用户：inteOAGetUserDataService

       全量获取职级：inteOAGetJobLevelService  

       全量获取职位,职位族,职位类,职位子类：inteOAGetJobRelatedDataService 

      详情可参考如下文档

金蝶s-HR V8.5 OSF接口说明及开发指导_人事篇.pdf

   3.对于通过主数据扩展接口的方式来获取数据，s-HR Cloud V8.8 SP1及以上预置了统一的osf接口“inteForOtherGetMainDataService”来获取数据，通过给接口传递不同的参数来查询组织、职位或者员工数据。osf接口参数说明及扩展可参考视频  金蝶s-HR主数据接口及扩展开发

【常见问题】

1. 全量取数接口是否支持传参

   目前提供的全量接口不支持传参，只有员工取数接口支持参数filterType=1取在职员工，filterType=2取离职员工。

   2.接口调用时能否直接调用http端口

       目前osf接口调用时必须引入SDK进行身份认证等，或者参考源码进行开发，暂不支持通过其它方法直接调用。

  3.现有接口的返回字段不满足需求，怎么进行扩展

        对于s-HR Cloud V8.8 SP1以下的版本，只能参考已有全量取数接口，二开新的osf文件来查询其它相关字段。

  4.全量取数接口获取不到数据

        首先判断是单点登录的问题还是接口的问题，通过在浏览器中直接访问“http://localhost:6888/shr/shr/msf/service.do?method=callService&serviceName=inteOAGetPersonDataService&filterType=1”（替换为实际的ip和端口号）查看返回数据是否正确，若接口可以正常返回数据，则继续排查是否是单点登录问题，查看调用端的日志进行分析。若无数据，则排查是否是登录账号没有权限，全量取数接口增加了权限管理，只有当前登录用户有权限时才能获取数据，可以给当前单点登录的用户分配权限项“第三方取数”。

   5.接口调用时返回连接超时

        此种情况一般为网络不通，请排查调用端能否正常访问s-HR服务器地址；

    6.接口调用时返回302异常

        此种情况一般是单点登录认证失败，根据具体的异常消息来排查，一般有密钥问题或者token已使用，密钥问题请参考“单点登录配置应用指导”；若偶发的报token已使用，可能是多个集成端使用了同样的账号进行单点登录，请替换新的账号来同步。