s-HR与金蝶云星空（旗舰版）集成配置操作手册【免责声明】：本文档仅用于学习使用，未经授权，禁止转载。本文档中所涉及的数据均为虚构的模拟数据，不代表任何一家企业的真实情况，如有权利人认为其中的任何内容存在侵权情况，请反馈给金蝶官方邮箱（DataSubjectRequest@kingdee.com），我们将在7个工作日内处理。金蝶软件（中国）有限公司2023年10月s-HR与金蝶云星空集成配置操作手册目录前言......................................................................................................................................3一、功能目标..........................................................................................................................4二、版本支持..........................................................................................................................4三、集成同步要求..................................................................................................................5四、集成服务云同步配置.......................................................................................................5第一步：【集成服务云部署前准备】...............................................................................5第二步：【集成服务云EAS连接器部署手册】：..........................................................111.部署要求.............................................................................................................112.部署步骤.............................................................................................................11五、组织人事集成配置及功能说明.....................................................................................171.集成配置说明................................................................................................................17第一步：【数据集成方案配置说明】.........................................................................17第二步：【组织初始化操作（s-HR-星空）】...........................................................202.同步功能说明................................................................................................................242.1基本功能................................................................................................................242.2不进行同步推送的数据说明.................................................................................252.3同步禁用金蝶云星空基础数据说明.....................................................................252/26s-HR与金蝶云星空集成配置操作手册前言本文档是针对金蝶s-HR（以下简称s-HR）与金蝶云星空使用集成服务云进行集成应用的说明，包括应用环境、数据中心的支持，集成配置说明等。3/26s-HR与金蝶云星空集成配置操作手册一、功能目标s-HR和金蝶云星空集成主要为支持在包含人力资源的整体ERP解决方案当中，需要同时部署金蝶云星空系统，以及相应的金蝶s-HR人力资源管理系统，可以保持组织、员工基础资料的统一。最终保障整个业务系统的信息流连贯通常，及全程的自动化处理。s-HR和金蝶云星空集成，使用金蝶云星空-集成服务云。集成服务云总体介绍苍穹的开放性：苍穹支持通过JDBC、接口、消息等多种集成技术与异构系统进行集成。集成服务云是在此基础上封装的一套集成工具，以降低集成开发的难度和工作量。集成服务云是一种集成技术的低代码开发平台和配置平台，提供可视化配置实现苍穹与各类系统的数据集成，支持基于个性化场景动态集成的扩展能力，为苍穹提供平民化的集成工具支持。集成服务云聚焦大型企业各类系统与金蝶云苍穹集成的需求,采用元数据驱动的设计模式，通过低代码可视化配置、丰富的值转换规则和开放的对外服务能力，快速实现客户的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。集成云目前主要针对频繁变动的在线业务数据和高价值密度的结构化数据，暂不支持低价值密度的数据高性能同步。目前已支持苍穹系统、EAS系统、s-HR系统、Orcale/SQLServer/MySQL类型数据库等数据源类型，提供苍穹系统与以上数据源进行数据集成能力。二、版本支持1.组织人事适用集成版本1.1组织人事集成s-HR支持：s-HRCloudV8.8、s-HRCloudV8.8SP1版本星空支持：金蝶云星空（旗舰版）V5.0版本4/26s-HR与金蝶云星空集成配置操作手册金蝶s-HR补丁要求：s-HRCloudV8.8必须安装：PTM166339+最新补丁，参见《金蝶s-HRCloudV8.8安装部署说明》。s-HRCloudV8.8SP1必须安装：PTM171251+最新补丁，参见《金蝶s-HRCloudV8.8SP1安装部署说明》。【备注】：s-HR各版本最新补丁清单可以从以下链接获取：https://vip.kingdee.com/article/61509631671398912金蝶云星空补丁要求：云星空V5.0及以上版本+最新补丁。三、集成同步要求仅支持s-HR一个数据中心到金蝶云星空一个数据中心进行单向集成同步，不支持一对多或多对一的数据中心集成同步，也不支持同一应用服务器下挂多个数据中心分别同步。四、集成服务云同步配置第一步：【集成服务云部署前准备】【重要必读】：集成服务云部署前准备，https://club.kdcloud.com/article/14039；A.项目组必须配备开发人员和懂技术的实施顾问，不然任何数据异常都无法看懂日志。对集成项目交付会极其困难。集成云研发团队资源有限，暂不接受没有配备该角色的项目组的支持需求；B.s-HR部署的服务器和苍穹部署的服务器网络需要互通，网络问题可以咨询客户的网管或者运维人员；C.必须使用在线文档统一管理现场问题清单、测试记录和测试场景三项内容。5/26s-HR与金蝶云星空集成配置操作手册1、s-HR服务器可以访问金蝶云苍穹(苍穹默认服务器端口8080，需要看实际情况)。windows：方式一：打开cmd，输入telnet苍穹服务器ip苍穹端口（telnet172.17.5.688080）如下图：出现下图，说明网络端口是通的。6/26s-HR与金蝶云星空集成配置操作手册方式二：s-HR所在服务器用浏览器访问苍穹，能访问登陆成功，说明网络是通的。linux：方式一：终端输入命令telnet苍穹服务器IP端口，出现Escapecharateris‘^】’说明网络是通的；7/26s-HR与金蝶云星空集成配置操作手册方式二：s-HR所在服务器用浏览器访问苍穹，能访问登陆成功，说明网络是通的。2、金蝶云苍穹服务器可以访问s-HR服务器。8/26s-HR与金蝶云星空集成配置操作手册方式一：登陆苍穹—>集成服务云—>集成管理—>连接管理—>连接配置—>网络检查；方式二：如何确定网络是否通？可以参考上面第一步的验证。必须在部署了苍穹的服务器上telnet；【备注】：金蝶内部研发环境，如果云平台是容器部署，则需要云平台所有IP都能访问s-HR服务器。单实例：实例server1的HTTP端口，如下图：9/26s-HR与金蝶云星空集成配置操作手册群集：网络代理的HTTP端口，如下图：方式三：苍穹所在服务器打开浏览器访问并登陆s-HR的门户，能访问并登陆成功说明网络是通的。10/26s-HR与金蝶云星空集成配置操作手册3、需要一个s-HR客户端登陆的用户密码，用于苍穹配置s-HR连接信息，该s-HR用户需要有业务权限且不能用于登陆s-HR系统进行业务操作（需要哪些业务权限需要看集成哪些单据，把需要集成的单据权限分配给该用户即可）；4、需要一个苍穹用户，用于苍穹配置s-HR连接信息的代理用户（原因:苍穹的用户不允许重复登陆），该苍穹用户需要有业务权限且不能用于登陆苍穹系统进行业务操作(需要哪些业务权限需要看集成哪些单据，把需要集成的单据权限分配给该用户即可)；5、s-HR服务端必须部署JDK1.6及以上版本。【备注】：检查当前苍穹运行环境的补丁包构建时间：浏览器执行：http://苍穹地址/metadata/getJarInfo.do?jarname=isc-iscb-rabbitmq-1.0&appId=iscb第二步：【集成服务云EAS连接器部署手册】：【重要必读】集成服务云EAS连接器部署，https://club.kdcloud.com/article/14205；1.部署要求s-HR服务端必须部署JDK1.6及以上版本；11/26s-HR与金蝶云星空集成配置操作手册s-HR如果是多机群集，则每个机器上都需要部署，内容和配置文件完全一致；s-HR部署的服务器和苍穹部署的服务器网络需要互通。如何检查网络互通情况请参照第一步：【集成服务云部署前准备】。2.部署步骤EAS连接器部署1、获取部署文件isc.war.zip和sp.zip。按照苍穹的版本号，下载对应的连接器部署包https://club.kdcloud.com/article/146134；2、将isc.war目录拷贝到s-HR服务端的\eas\server\deploy\easweb.ear目录下；isc.war添加后正确的目录结构，如下图：修改\eas\server\deploy\easweb.ear\META-INF\application.xml,将下面这段代码12/26s-HR与金蝶云星空集成配置操作手册添加到application.xml。（参考压缩包中的application.xml）isc.war/isc【备注】：建议在原文件中直接拷贝上面的一段，把值修改为isc.war和/isc，避免出错。该文件中即使多一个空格，启动都会有问题，修改一定要谨慎。假如s-HR是部署在linux环境下的，修改apllication.xml后请记得在linux服务器里用vim工具直接打开确认下里面是否有乱码，或者用IE将文件apllication.xml打开看看是否能打开。3、请将sp.zip里面的isc-iscb-connector-eas.jar、isc-iscb-util.jar移到eas\server\lib\sp13/26s-HR与金蝶云星空集成配置操作手册4、重启s-HR服务器。苍穹远程部署1、配置s-HR连接配置信息。进入【集成服务云】->【集成管理】->【连接管理】->【连接配置】页面，点击“新增”按钮，连接类型选择"EAS系统"，对于文本框"数据中心"的内容，请查看s-HR管理控制台“数据中心”页签的字段“代码”值，输入相关信息后点击保存按钮。【备注】：连接配置每次修改保存后会重新生成访问键信息，所以访问键信息变化后需要重新部署（包括重新选择苍穹代理用户），否则将会导致苍穹连接s-HR异常；登陆用户：苍穹用户用于苍穹配置s-HR连接信息的代理用户（原因：苍穹的一个用户不允许重复登陆），该苍穹用户需要有业务权限且不能用于登陆苍穹系统进行业务操作，需要哪些业务权限需要看集成哪些单据，把需要集成的单据权限分配给改用户即可；服务器端口：填写非s-HR实例1的HTTP端口（一个实例的情况可以用s-HR实例1的HTTP端口）或者网络代理页面的HTTP端口（多实例的情况）。特别说明：多实例情况下千万不要使用server1主实例的HTTP端口，初始化数据量大的情况下有可能导致server1压力过大（s-HR主实例server1承载了license和工作流服务，如果s-HR的主实例server1不可用会导致s-HR其他实例都无法使用）。14/26s-HR与金蝶云星空集成配置操作手册2、远程部署访问键：进入【集成服务云】->【集成管理】->【连接管理】->【连接配置】页面，选择s-HR的连接点击“部署”按钮，弹出部署弹出框。系统：“本系统”就是指你当前使用的苍穹系统，连接器需要使用该URL与集成云交互，请确保在连接器部署的服务器上可以访问当前苍穹系统；密码提示：这里的密码是指部署连接器的系统(s-HR客户端登陆)的管理员的密码，切记不是苍穹系统的管理员密码。此密码仅用于部署验证是否具有“管理员”身份，在苍穹数据库中不会保存，也不会在网络上传输；业务授权模式：全部授权：全部集成对象都授权使用（默认值，测试环境建议使用这个模式）；白名单：根据管理授权清单里面的集成对象内容来实际授权（UAT和正式环境建议使用这个模式，但是需要管在管理授权页面新增需要授权的集成对象），关于授权的内容会有专门的文章要说明；禁止访问：禁止任何访问，无法进行数据集成。【备注】：连接配置每次修改保存后会重新生成访问键信息，所以访问键信息变化后需要重新进行部署操作，否则将会导致苍穹连接s-HR异常。15/26s-HR与金蝶云星空集成配置操作手册3、测试连接，部署后点击“测试”按钮，如果出现测试成功，说明连接配置已经配置正常；4、苍穹所在服务器可以成功访问http://s-HR服务器ip:网络代理端口/isc/proxy。windows系统:在苍穹所在服务器浏览器输入http://s-HR服务器ip:网络代理端口/isc/proxy，出出“OK”时说明成功，如下图。16/26s-HR与金蝶云星空集成配置操作手册linux系统:在苍穹所在服务器终端输入命令：curlhttp://s-HR服务器ip:网络代理端口/isc/proxy，出现“OK”时说明成功。五、组织人事集成配置及功能说明1.集成配置说明第一步：【数据集成方案配置说明】应用场景：全新星空数据中心需要使用标准集成方案；17/26s-HR与金蝶云星空集成配置操作手册步骤：1、使用集成云研发提供的标准预置方案；2、导入启动方案（集成管理->数据集成->启动方案）；3、导入数据集成方案（集成管理->数据集成->数据集成方案）；4、修改数据源(集成管理->集成元数据->数据源管理)，选择系统连接（s-HR和星空都需要修改，编码分别是KDEAS850和KDXKQJ）（导入启动方案同步会导入方案相关的信息，如：数据管、集成对象、数据集成方案、值转换规则和启动方案）；【备注】：如果系统连接F7没有记录，则按照以下方式处理：以EAS为例请参照文章“连接配置(EAS系统)https://club.kdcloud.com/article/13674添加系统连接；以IERP为例请参照文章连接配置(当前账套)18/26s-HR与金蝶云星空集成配置操作手册https://club.kdcloud.com/article/13693添加系统连接。5、启用启动方案，方案导入后是禁用状态，如果需要使用请启用启动方案。（集成管理->数据集成->启动方案）6、以行政组织初始化为例，来验证EAS->星空的集成方向是否是通的；启动方案列表输入“启动方案_预置_行政组织单元初始化（EAS-星空旗舰）”，找到行政组织初始化方案；启用启动方案启动方案_预置_行政组织单元初始化（EAS-星空旗舰）；勾选启动方案启动方案_预置_行政组织单元初始化（EAS-星空旗舰），点击“立即执行”弹出执行结果界面，如果出现成功记录，说明EAS-星空的集成方向是通的，也可以在星空的行政组织（部门）列表检查是否已经同步过来，具体失败的可以点击“日志”按钮具体分析。19/26s-HR与金蝶云星空集成配置操作手册7、通过成功日志可以分析哪些数据是通过集成服务云同步到苍穹的，点击执行结果编码，查看源数据内容。第二步：【组织初始化操作（s-HR-星空）】【重要必读】组织初始化操作，https://club.kdcloud.com/article/45260（仅供参考）应用场景：需要将s-HR系统的组织初始化到星空。前置条件：导入并启用组织相关启动方案（目前支持的组织类型：行政组织）。操作步骤：对于组织相关操作，请使用星空管理员（administrator）。1、禁用云星空行政组织编码->行政组织编码规则（应用->配置工具->编码规则配置）20/26s-HR与金蝶云星空集成配置操作手册2、云星空修改行政组织的根节点，编码和名称需要跟s-HR保持一致；（基础服务->人员部门管理->行政组织（部门））；3、修改组织相关集成方案的组织的开头长编码//为现场实际s-HR根组织的长编码（请根据现场实际情况填写）,数据集成方案列表输入“组织”可以过滤组织相关方案。21/26s-HR与金蝶云星空集成配置操作手册如何查询s-HR根节点的长编码的开头是什么？s-HR查询分析器select*fromT_ORG_adminwhereFNUMBER='00000'（00000为s-HR根节点的编码）;s-HR根节点FNUMBER='00000'的长编码为00000（FLONGNUMBER是长编码），则集成方案中的//修改为00000;【备注】：s-HR的根节点它的上级组织是为空的才算是根节点。22/26s-HR与金蝶云星空集成配置操作手册行政组织表T_ORG_Admin；组织单元表T_ORG_BaseUnit；其他源对象的表请查看源对象。4、完成组织形态的值匹配（集成管理->值转换管理->值转换规则）值转换规则列表搜索“93E51B05”，点击编码按钮，依次点击按钮“同步数据”、“自动匹配”、“匹配结果”；如果通过编码或者名称自动匹配不上的请点击“修改”进行手工匹配，不然会导致行政组织由于形态匹配不上导致行政组织同步失败。【备注】：如果EAS的组织形态在云星空没有对应，有两个解决方案：第一、星空二开新增形态；第二、通过人工修改匹配云星空现有的其他形态值。5、按顺序执行启动方案23/26s-HR与金蝶云星空集成配置操作手册对于初始化执行参数值，请填写1970-01-01。2.同步功能说明2.1基本功能集成同步配置完成并执行初始化同步后，后续需人工启动方案更新组织、即时同步更新员工。在s-HR系统中组织数据的更新，以及员工管理中对员工信息的更新及员工变动等都会触发数据同步至云星空。在s-HR系统内进行行政组织的新增、修改、变更、封存、启用、删除、批量组织架构调整等这些业务操作后，系统都会向金蝶云星空系统内同步。特别地，s-HR系统内行政组织封存，金蝶云星空自动置为封存，s-HR系统内行政组织删除，可手工同步至金蝶云星空，金蝶云星空行政组织将置为封存，这可能影响云星空相关的行政组织架构部门的相关业务，云星空业务单据将引用不了这些封存的组织，已经引用这些组织的单据会进行不下去，需谨慎处理。在s-HR系统内进行员工的入职新增、员工信息的修改、员工信息的变更、调动事务、24/26s-HR与金蝶云星空集成配置操作手册兼职事务、员工离职、批量组织架构调整造成的员工职位变更等这些业务操作后，系统都会向云星空系统内自动同步。特别地，s-HR系统内管理的企业员工更新、、调动、离职等，在云苍穹内可能自动置为禁用，这可能影响员工相关的业务，以及工作流的应用，需谨慎处理。2.2不进行同步推送的数据说明部分数据因关键数据不完整、关联的上级或前置基础资料未同步成功，将不会往云星空同步这些数据：同步组织：上级组织未新增同步成功的；同步员工：手机号码未填写的员工；同步员工：性别未填写的员工。2.3同步禁用金蝶云星空基础数据说明组织：s-HR组织封存或者删除时，同步到云星空封存对应组织；员工s-HR员工同步到云苍穹是否禁用该员工，是根据员工当前用工关系状态上的ERP人员状态设置进行判断的。若ERP人员状态为不在职、离职、离退休，则同步至金蝶云苍穹后禁用员工。如：员工离职后用工关系状态变为辞职（用工关系状态为“辞职”的基础数据上的ERP人员状态为离职），同步至云苍穹后该员工变为禁用状态。请根据需要设置对应用工关系状态上的ERP人员状态，如下图：【备注】：组织、员工在云星空同步禁用，将可能影响到相关的金蝶云星空业务，25/26s-HR与金蝶云星空集成配置操作手册涉及：工作流/审批流、业务单据/基础资料/凭证等引用；若有特殊需要，请做好业务协调，在s-HR更新操作前，确保走完云星空业务或者不会影响到云星空业务。【特殊设置1】客户端新增参数“s-HR员工变动即时同步云苍穹”，在配置苍穹集成的前提下：参数设置为是时，开启即时监听，员工在s-HR发生入职、转正、调动、离职等变动业务即时同步到云苍穹；参数设置为否时，不进行员工变动数据的即时同步。【V8.8新增】26/26
