1993-2022金蝶国际软件集团有限公司④内部公开请勿外传主数据接口自定义配置付前文组织人事与共享系统部2023-11-23s-HRCloudV8.8SP1微课堂2④内部公开请勿外传0203功能介绍接口配置接口调用目录01功能介绍功能入口：管理员登录开发平台集成配置接口配置功能介绍第三方系统单点登录调用inteForOtherGetMainDataService调用接口配置实现类Query元数据取数数据封装数据返回参数：bizImplNumber：接口编码page：页码，默认1pageSize：每页数据量，默认10全量取数：page:1pageSize:2147483647参数、权限校验预置了主数据集成取数的osf（inteForOtherGetMainDataService），统一入口，通过不同的参数，调用对应的接口query取数。功能介绍市场环境中第三方集成时，不同客户对于取数字段需求差异，因此需要实现主数据接口配置，满足扩展性需求，对权限、日志、取数等做统一管理。快速交付：零代码快速支持对不同类型数据的获取，配置简单，在权限校验与实体限制的条件下满足客户需求；灵活扩展：基于DEP功能实现对取数的实体级与字段级的扩展；集成规范：不再需要繁琐的二开与指导，约束取数范围与流程，进行权限认证与日志记录；接口配置1.根据实际需求，在eas客户端动态扩展平台高级版（dep）中新建或者导入业务数据源；2.接口配置中增加配置，定义编码、名称、query全路径、权限项等；接口配置3.接口配置中需要关联权限项，且权限项必须是在“第三方取数”的权限项下；集成取数时会根据此权限项进行单点登录用户的权限认证。4.配置好的接口需要进行“启用”。接口配置5.测试调用：登录s-HR后，F12进入开发者模式，在console中测试取数是否能够正常返回数据。测试demo：shr.callService({serviceName:'inteForOtherGetMainDataService',param:{bizImplNumber:'test001',page:1,pageSize:20},async:false,success:function(data){varresult=data;varstr=JSON.stringify(result);console.log(str);}});接口配置6.安全限制：系统设置了集成接口允许取数的实体范围，若接口调用时提示“接口中不允许查询实体相关数据，若需要可配置到集成实体白名单中”，则需要在T_HR_InterEntityAllow中手动配置实体全路径。接口配置7.自定义实现路径：接口默认取数逻辑是HRMainReadDefaultService，返回的数据格式中字段是query查询的字段别名。若默认逻辑无法满足实际需求，可以自定义扩展取数逻辑，二开实现类并继承AbstractHRInterfaceForOtherService，重写部分取数方法逻辑。接口调用1.第三方系统中引入s-HR最新的单点登录SDK，并配置s-HR系统OTA认证密钥到SDK中，可参考链接https://vip.kingdee.com/article/140145523868595456?productLineId=10。2.调用osf接口“inteForOtherGetMainDataService”，获取数据。SHRClient默认以user账号进行登录，若以其它账号集成取数，使用OSFWSClient。3.系统会根据接口配置返回具体的信息。接口调用4.接口配置集成日志中可以查看接口调用日志。5.常见异常。1993-2022金蝶国际软件集团有限公司④内部公开请勿外传特别声明ClaimofConfidential本文件内容为④内部公开请勿外传：禁止未授权的内部、第三方人员使用与访问非专项必要的业务与项目负责人，收到此内容请立即删除严禁在未经过主管领导审批，发送给无关业务团队与人员特别声明ClaimofConfidential•1993-2022金蝶国际软件集团有限公司。保留一切权利。•未经金蝶国际软件集团有限公司的书面许可，任何单位或个人不得以任何形式或为任何目的复制或传播本文档的任何内容。本文档中包含的信息如有更改，恕不另行通知。•本文档提到的金蝶®、金蝶云®、金蝶云EBC®、金蝶云苍穹®、金蝶云星瀚®、金蝶云星空®、金蝶云星辰®、金蝶KIS®、K/3®、金蝶EAS®、友商网®、Apusic®和其它金蝶产品和服务以及它们各自的徽标均为金蝶软件（中国）有限公司或其关联公司在中国和其他国家或地区的商标或注册商标。本文档提到的所有其它产品和服务名称分别为它们各自公司的商标。•本文档所用数据均为虚构的模拟数据，不代表任何一家企业的真实情况，如有权利人认为文档中的任何内容存在侵权情况，请反馈给金蝶官方邮箱（DataSubjectRequest@kingdee.com），我们将在15个工作日内处理。•注：①②机密信息严禁泄露③秘密信息严禁泄露④内部公开请勿外传
