金蝶s-HR与金蝶云苍穹集成应用指南金蝶软件（中国）有限公司2020年12月金蝶s-HR与金蝶云苍穹集成应用指南目录前言......................................................................................................................................3一、功能目标..........................................................................................................................4二、版本支持..........................................................................................................................4三、集成同步要求..................................................................................................................5四、集成同步配置及初始化...................................................................................................5第一步：【集成服务云部署前准备】：...........................................................................5第二步：【集成服务云EAS连接器部署手册】：..........................................................111.部署要求：..................................................................................................................112.部署步骤：..................................................................................................................112.1EAS连接器部署...................................................................................................112.2苍穹远程部署.....................................................................................................13第三步：【数据集成方案配置说明】.............................................................................17第四步：【组织初始化操作（s-HR-苍穹）】：...........................................................21五、同步功能说明................................................................................................................271.基本功能......................................................................................................................271.1不进行同步推送的数据说明..............................................................................281.2同步禁用金蝶云苍穹基础数据说明..................................................................28六、同步异常分析及处理.....................................................................................................29七、注意事项........................................................................................................................302/32金蝶s-HR与金蝶云苍穹集成应用指南前言本文档是针对金蝶s-HR与金蝶云苍穹使用集成服务云进行集成应用的说明，包括应用环境、数据中心的支持，集成配置说明等。3/32金蝶s-HR与金蝶云苍穹集成应用指南一、功能目标金蝶s-HR和金蝶云苍穹集成主要为支持在包含人力资源的整体ERP解决方案当中，需要同时部署金蝶云苍穹系统，以及相应的金蝶s-HR人力资源管理系统，可以保持组织、员工基础资料的统一。最终保障整个业务系统的信息流连贯通常，及全程的自动化处理。金蝶s-HR和金蝶云苍穹集成，使用金蝶云苍穹-集成服务云。集成服务云总体介绍苍穹的开放性：苍穹支持通过JDBC、接口、消息等多种集成技术与异构系统进行集成。集成服务云是在此基础上封装的一套集成工具，以降低集成开发的难度和工作量。集成服务云是一种集成技术的低代码开发平台和配置平台，提供可视化配置实现苍穹与各类系统的数据集成，支持基于个性化场景动态集成的扩展能力，为苍穹提供平民化的集成工具支持。集成服务云聚焦大型企业各类系统与金蝶云苍穹集成的需求,采用元数据驱动的设计模式，通过低代码可视化配置、丰富的值转换规则和开放的对外服务能力，快速实现客户的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。集成云目前主要针对频繁变动的在线业务数据和高价值密度的结构化数据，暂不支持低价值密度的数据高性能同步。目前已支持苍穹系统、EAS系统、s-HR系统、Orcale/SQLServer/MySQL类型数据库等数据源类型，提供苍穹系统与以上数据源进行数据集成能力。二、版本支持金蝶s-HR（以下简称s-HR）支持V8.2SP2、V8.5、V8.5SP1、Cloud、CloudV8.6SP1、CloudV8.6H1版本，金蝶云苍穹（以下简称苍穹）需要安装金蝶云苍穹V2.0及以上版本+最新补丁。金蝶s-HR补丁要求：金蝶s-HRV8.2SP2必须安装：PTM112673+最新补丁，参见《金蝶s-HRV8.2SP2安装部署说明》；金蝶s-HRV8.5必须安装：PTM118902+最新补丁，参见《金蝶s-HRV8.5安装部署说明》；金蝶s-HRV8.5SP1必须安装：PTM130958+最新补丁，参见《金蝶s-HRV8.54/32金蝶s-HR与金蝶云苍穹集成应用指南SP1安装部署说明》；金蝶s-HRCloud必须安装：PTM140376+最新补丁，参见《金蝶s-HRCloud安装部署说明》；金蝶s-HRCloudV8.6SP1必须安装：PTM144529+最新补丁，参见《金蝶s-HRCloudV8.6SP1安装部署说明》金蝶云苍穹补丁要求：金蝶云苍穹V2.0及以上版本+最新补丁。【备注】：若需要使用s-HRV8.2SP2、V8.5、Cloud版本进行集成，需跟总部研发技术支持部门申请集成验证包。三、集成同步要求仅支持s-HR一个数据中心到金蝶云苍穹一个数据中心进行单向集成同步，不支持一对多或多对一的数据中心集成同步，也不支持同一应用服务器下挂多个数据中心分别同步。四、集成同步配置及初始化第一步：【集成服务云部署前准备】：【重要必读】集成服务云部署前准备，https://club.kdcloud.com/article/14039；A.项目组必须配备开发人员和懂技术的实施顾问，不然任何数据异常都无法看懂日志，对集成项目交付会极其困难。集成云研发组资源有限，暂不接受没有配备该角色的项目组的支持需求。B.s-HR部署的服务器和苍穹部署的服务器网络需要互通，网络问题可以咨询客户的网管或者运维人员。C.必须使用在线文档统一管理现场问题清单、测试记录和测试场景3个内容。5/32金蝶s-HR与金蝶云苍穹集成应用指南1、s-HR服务器可以访问金蝶云苍穹(苍穹默认服务器端口8080，需要看实际情况)。windows：方式一：打开cmd，输入telnet苍穹服务器ip苍穹端口（telnet172.17.5.688080）如下图：出现下图，说明网络端口是通的。6/32金蝶s-HR与金蝶云苍穹集成应用指南方式二：s-HR所在服务器用浏览器访问苍穹，能访问登陆成功，说明网络是通的。linux：方式一：终端输入命令telnet苍穹服务器IP端口，出现Escapecharateris‘^】’说明网络是通的。7/32金蝶s-HR与金蝶云苍穹集成应用指南方式二：s-HR所在服务器用浏览器访问苍穹，能访问登陆成功，说明网络是通的。2、金蝶云苍穹服务器可以访问s-HR服务器8/32金蝶s-HR与金蝶云苍穹集成应用指南方式一：登陆苍穹—集成服务云—集成管理—连接管理—连接配置—网络检查。方式二：如何确定网络是否通？可以参考上面1的步骤验证。必须在部署了苍穹的服务器上telnet）注意：金蝶内部研发环境，如果云平台是容器部署，则需要云平台所有IP都能访问s-HR服务器。单实例：实例server1的HTTP端口9/32金蝶s-HR与金蝶云苍穹集成应用指南群集：网络代理的HTTP端口方式三：苍穹所在服务器打开浏览器访问并登陆s-HR的门户，能访问并登陆成功说明网络是通的。10/32金蝶s-HR与金蝶云苍穹集成应用指南3、需要一个s-HR客户端登陆的用户密码，用于苍穹配置s-HR连接信息，该s-HR用户需要有业务权限且不能用于登陆s-HR系统进行业务操作（需要哪些业务权限需要看集成哪些单据，把需要集成的单据权限分配给该用户即可）。4、需要一个苍穹用户，用于苍穹配置s-HR连接信息的代理用户（原因:苍穹的用户不允许重复登陆），该苍穹用户需要有业务权限且不能用于登陆苍穹系统进行业务操作(需要哪些业务权限需要看集成哪些单据，把需要集成的单据权限分配给该用户即可)。5、由于s-HR需要安装补丁需要s-HR处于标准服务有效期内，请确保s-HR服务处于标准服务有效期内。6、s-HR服务端必须部署JDK1.6及以上版本。注意：检查当前苍穹运行环境的补丁包构建时间：浏览器执行http://苍穹地址/metadata/getJarInfo.do?jarname=isc-iscb-rabbitmq-1.0&appId=iscb。第二步：【集成服务云EAS连接器部署手册】：【重要必读】集成服务云EAS连接器部署，https://club.kdcloud.com/article/14205；11/32金蝶s-HR与金蝶云苍穹集成应用指南1.部署要求：s-HR服务端必须部署JDK1.6及以上版本。s-HR如果是多机群集，则每个机器上都需要部署，内容和配置文件完全一致。s-HR部署的服务器和苍穹部署的服务器网络需要互通。如何检查网络互通情况请参照第一步：【集成服务云部署前准备】。2.部署步骤：2.1EAS连接器部署1、获取部署文件isc.war.zip和sp.zip。按照苍穹的版本号，下载对应的连接器部署包https://club.kdcloud.com/article/1461342、将isc.war目录拷贝到s-HR服务端的\eas\server\deploy\easweb.ear目录下。isc.war添加后正确的目录结构12/32金蝶s-HR与金蝶云苍穹集成应用指南修改\eas\server\deploy\easweb.ear\META-INF\application.xml,将下面这段代码添加到application.xml。（参考压缩包中的application.xml）isc.war/isc建议在原文件中直接拷贝上面的一段，把值修改为isc.war和/isc，避免出错。该文件多一个空格启动都会有问题，修改一定要谨慎。假如s-HR是部署在linux环境下的，修改apllication.xml后请记得在linux服务器里用vim工具直接打开确认下里面是否有乱码，或者用IE将文件apllication.xml打开看看是否能打开。13/32金蝶s-HR与金蝶云苍穹集成应用指南3、请将sp.zip里面的isc-iscb-connector-eas.jar、isc-iscb-util.jar移到eas\server\lib\sp4、重启s-HR服务器。2.2苍穹远程部署1、配置s-HR连接配置信息。进入【集成服务云】-【集成管理】-【连接管理】-【连接配置】页面，点击“新增”按钮，连接类型选择"EAS系统"，文本框"数据中心"的内容请查看s-HR管理控制台“数据中心”页签的字段“代码”值，输入相关信息后点击保存按钮。注意：连接配置每次修改保存后会重新生成访问键信息，所以访问键信息变化后需要重新部署（包括重新选择苍穹代理用户），否则将会导致苍穹连接s-HR异常。登陆用户：苍穹用户用于苍穹配置s-HR连接信息的代理用户（原因：苍穹的一个用户不允许重复登陆），该苍穹用户需要有业务权限且不能用于登陆苍穹系统进行业务操作，需要哪些业务权限需要看集成哪些单据，把需要集成的单据权限分配给改用户即可。服务器端口：填写非s-HR实例1的HTTP端口（一个实例的情况可以用s-HR实例14/32金蝶s-HR与金蝶云苍穹集成应用指南1的HTTP端口）或者网络代理页面的HTTP端口（多实例的情况）。特别说明：多实例情况下千万不要使用server1主实例的HTTP端口，初始化数据量大的情况下有可能导致server1压力过大（s-HR主实例server1承载了license和工作流服务，如果s-HR的主实例server1不可用会导致s-HR其他实例都无法使用）。2、远程部署访问键：进入【集成服务云】-【集成管理】-【连接管理】-【连接配置】页面，选择s-HR的连接点击“部署”按钮，弹出部署弹出框。系统：“本系统”就是指你当前使用的苍穹系统，连接器需要使用该URL与集成云交互，请确保在连接器部署的服务器上可以访问当前苍穹系统。密码提示：这里的密码是指部署连接器的系统(s-HR客户端登陆)的管理员的密码，切记不是苍穹系统的管理员密码。此密码仅用于部署验证是否具有“管理员”身份，在苍穹数据库中不会保存，也不会在网络上传输。业务授权模式：全部授权：全部集成对象都授权使用（默认值，测试环境建议使用这个模式）白名单：根据管理授权清单里面的集成对象内容来实际授权（UAT和正式环境建议使用这个模式，但是需要管在管理授权页面新增需要授权的集成对15/32金蝶s-HR与金蝶云苍穹集成应用指南象），关于授权的内容会有专门的文章要说明。禁止访问：禁止任何访问，无法进行数据集成。注意：连接配置每次修改保存后会重新生成访问键信息，所以访问键信息变化后需要重新进行部署操作，否则将会导致苍穹连接s-HR异常。16/32金蝶s-HR与金蝶云苍穹集成应用指南3、测试连接，部署后点击“测试”按钮，如果出现测试成功，说明连接配置已经配置正常。4、苍穹所在服务器可以成功访问http://s-HR服务器ip:网络代理端口/isc/proxy。windows系统:在苍穹所在服务器浏览器输入http://s-HR服务器ip:网络代理端口/isc/proxy出现OK说明成功。linux系统:在苍穹所在服务器终端输入命令curlhttp://s-HR服务器ip:网络代理端口/isc/proxy出现OK说明成功。第三步：【数据集成方案配置说明】【重要必读】数据集成方案迁移说明，https://club.kdcloud.com/article/45250应用场景：17/32金蝶s-HR与金蝶云苍穹集成应用指南1、全新苍穹数据中心需要使用标准集成方案；2、需要将配置好的方案迁移到另外一个数据中心。迁移步骤：1、导出启动方案和数据集成方案（集成管理-数据集成-启动方案/数据集成方案）或者集成云研发提供的标准预置方案；2、导入启动方案（集成管理-数据集成-启动方案）；3、导入数据集成方案（集成管理-数据集成-数据集成方案）；18/32金蝶s-HR与金蝶云苍穹集成应用指南4、修改数据源(集成管理-集成元数据-数据源管理)，选择系统连接（s-HR和苍穹都需要修改，编码分别是KDEAS850和KDIERP）（导入启动方案同步会导入方案相关的信息，如：数据管、集成对象、数据集成方案、值转换规则和启动方案）；注：如果系统连接F7没有记录以EAS为例请参照文章“连接配置(EAS系统)https://club.kdcloud.com/article/13674”添加系统连接。以IERP为例请参照文章连接配置(当前账套)https://club.kdcloud.com/article/13693添加系统连接。19/32金蝶s-HR与金蝶云苍穹集成应用指南5、启用启动方案，方案导入后是禁用状态，如果需要使用请启用启动方案。（集成管理-数据集成-启动方案）6、以币别初始为例，来验证EAS-苍穹的集成方向是否是通的。启动方案列表输入“预置_币别初始化（EAS-苍穹）”，找到币别初始化方案；启用启动方案预置_币别初始化（EAS-苍穹）；勾选启动方案预置_币别初始化（EAS-苍穹），点击“立即执行”弹出执行结果界面，如果出现成功记录说明EAS-苍穹的集成方向是通的，也可以在苍穹的币别列表检查是否已经同步过来，具体失败的可以点击“日志”按钮具体分析。20/32金蝶s-HR与金蝶云苍穹集成应用指南7、通过成功日志可以分析哪些数据是通过集成服务云同步到苍穹的，点击执行结果编码，查看源数据内容。第四步：【组织初始化操作（s-HR-苍穹）】：【重要必读】组织初始化操作（EAS-苍穹），https://club.kdcloud.com/article/45260：应用场景：需要将s-HR系统的组织初始化到苍穹21/32金蝶s-HR与金蝶云苍穹集成应用指南前置条件：导入并启用组织相关启动方案（目前支持的组织类型有：行政组织、组织单元、财务组织、HR组织、库存组织、采购组织、质检组织、销售组织、成本中心）操作步骤：组织相关操作请用苍穹管理员操作administrator1、禁用苍穹行政组织编码-行政组织编码规则（应用-配置工具-业务规则-编码规则）2、苍穹新增或者修改行政组织的根节点，编码和名称需要跟s-HR保持一致。（基础服务-组织管理-行政组织）3、苍穹新增或者修改业务单元的根节点，编码和名称需要跟s-HR保持一致，并将对应的组织类型勾选上（基础服务-组织管理-业务单元）EAS和苍穹组织类型的对应关系如下：22/32金蝶s-HR与金蝶云苍穹集成应用指南EAS财务组织-苍穹核算组织EAS采购组织-苍穹采购组织EAS销售组织-苍穹销售组织EAS库存组织-苍穹库存组织EASHR组织-苍穹HR组织EAS质检组织-苍穹质检组织EAS成本中心-苍穹成本中心23/32金蝶s-HR与金蝶云苍穹集成应用指南4、修改组织相关集成方案的组织的开头长编码//为现场实际s-HR根组织的长编码（请根据现场实际情况填写）数据集成方案列表输入“组织”可以过滤组织相关方案。如何查询s-HR根节点的长编码的开头是什么？s-HR查询分析器select*fromT_ORG_adminwhereFNUMBER='00000'（00000为s-HR根节点的编码）s-HR根节点FNUMBER='00000'的长编码为00000（FLONGNUMBER是长编码），则集成方案中的//修改为00000s-HR的根节点它的上级组织是为空的才算是根节点。24/32金蝶s-HR与金蝶云苍穹集成应用指南行政组织表T_ORG_Admin组织单元表T_ORG_BaseUnit其他源对象的表请查看源对象5、完成组织形态的值匹配（集成管理-值转换管理-值转换规则）值转换规则列表搜索“93E51B05”，点击编码按钮，点击依次点击按钮“同步数据”“自动匹配”“匹配结果”，如果通过编码或者名称自动匹配不上的请点击“修改”进行手工匹配，不然会导致行政组织由于形态匹配不上导致行政组织同步失败。说明：如果EAS的组织形态在苍穹没有对应的有两个解决方案，一、苍穹二开新增形态二通过人工修改匹配苍穹现有的其他形态值。25/32金蝶s-HR与金蝶云苍穹集成应用指南6、按顺序执行启动方案6.1行政组织6.2财务组织（需要依赖行政组织和组织单元）6.3HR组织、库存组织、采购组织、质检组织、销售组织、成本中心（这个六个之间没有顺序要求，可以随意启动）初始化执行参数值请填写1970-01-0126/32金蝶s-HR与金蝶云苍穹集成应用指南第五步，【组织增量同步说明】【重要必读】数据集成组织单元增量同步操作步骤（EAS->苍穹）-定时调度，https://club.kdcloud.com/article/45431；五、同步功能说明1.基本功能集成同步配置完成并执行初始化同步后，后续系统将会定时同步更新组织、即时同步更新员工。在s-HR系统中组织数据的更新，以及员工管理中对员工信息的更新及员工变动等都会触发数据同步至金蝶云苍穹。s-HR系统内进行行政组织的新增、修改、变更、封存、启用、删除、批量组织架构调整。这些业务操作后，系统都会向金蝶云苍穹系统内自动同步。特别地，s-HR系统内行政组织封存，金蝶云苍穹自动置为封存，s-HR系统内行政组织删除，可手工同步至金蝶云苍穹，金蝶云苍穹行政组织将置为封存，这可能影响金蝶云苍穹相关的行政组织架构部门的相关业务，苍穹业务单据将引用不了这些封存的组织，已经引用这些组织的单据会进行不下去，需谨慎处理。27/32金蝶s-HR与金蝶云苍穹集成应用指南s-HR系统内进行员工的入职新增、员工信息的修改、员工信息的变更、调动事务、兼职事务、员工离职、删除、批量组织架构调整造成的员工职位变更。这些业务操作后，系统都会向金蝶云苍穹系统内自动同步。特别地，s-HR系统内管理的企业员工更新、转正、调动、离职、删除等，在金蝶云苍穹内可能自动置为禁用，这可能影响员工相关的业务，以及工作流的应用，需谨慎处理。1.1不进行同步推送的数据说明部分数据因关键数据不完整、关联的上级或前置基础资料未同步成功，将不会往金蝶云苍穹同步这些数据：同步组织：上级组织未新增同步成功的。同步员工：手机号码未填写的员工。同步员工：性别未填写的员工。1.2同步禁用金蝶云苍穹基础数据说明组织：s-HR组织封存或者删除时，同步到金蝶云苍穹封存对应组织；员工s-HR员工同步到金蝶云苍穹是否禁用该员工，根据员工当前用工关系状态上的ERP人员状态设置进行判断。若ERP人员状态为不在职、离职、离退休，则同步至金蝶云苍穹禁用员工。如：员工离职后用工关系状态变为辞职（用工关系状态为“辞职”的基础数据上的ERP人员状态为离职），同步至金蝶云苍穹后该员工变为禁用状态。请根据需要设置对应用工关系状态上的ERP人员状态，如下图：28/32金蝶s-HR与金蝶云苍穹集成应用指南【备注】：组织、员工在金蝶云苍穹同步禁用，将可能影响到相关的金蝶云苍穹业务，涉及：工作流/审批流、业务单据/基础资料/凭证等引用，若有特殊需要，请做好业务协调，在s-HR更新操作前，确保走完金蝶云苍穹业务或者不会影响到金蝶云苍穹业务。六、同步异常分析及处理1.集成同步时，同步结果可通过苍穹菜单路径：【集成服务云】-【集成管理】-【数据集成】-【执行结果】进行查看，执行结果中会显示启动方案的执行详情，显示成功、失败、忽略和总行数，并提供查看、日志、重做、撤销等功能。29/32金蝶s-HR与金蝶云苍穹集成应用指南2.同步失败的数据，可通过菜单路径：【集成服务云】-【集成管理】-【数据集成】-【执行日志】进行查看执行日志明细，检查失败原因，修复数据后重新同步。员工日常同步是由系统自动处理的，可通过监控执行日志的失败记录，及时知会相关人员进行处理。执行日志中会显示启动方案执行结果的日志详情，失败日志会自动记录。若需记录成功日志，需在启动方案选择保存全部日志的功能。3.集成云报错处理合集：https://club.kdcloud.com/article/455561)数据集成执行日志出现“根据转换规则XXXXX无法将源系统字段值X转换”如何解决？解决链接：https://club.kdcloud.com/article/4541930/32金蝶s-HR与金蝶云苍穹集成应用指南2)集成云与EAS连接配置，部署报错或者测试报错，报错日志如下java.lang.RuntimeException:java.lang.IllegalAccessException:timestampistimeout.diff=496150要求部署苍穹和EAS的服务器时间不允许相差300秒以上，如果出现该错误需要把两个服务器的时间进行校对调整。建议通过时间同步服务器做时间同步。3)如何查看当前环境集成服务云代码包的版本号？解决链接：https://club.kdcloud.com/article/1460864)组织环球科技集团本部，不在您的业务组织范围！解决链接：https://club.kdcloud.com/article/1472295)组织初始化过程提示“组织视图默认方案已存在相同长名称的组织”。解决链接：https://club.kdcloud.com/article/1475456)连接配置部署时提示“Sorry,PageNotFound”。解决链接：https://club.kdcloud.com/article/1476327)执行日志提示"参数错误，相应的用户不存在。解决链接：https://club.kdcloud.com/article/1629338)执行日志提示值转换规则异常“ERROR.Token'svalue:,token'stype:EOF”。解决链接：https://club.kdcloud.com/article/1629389)源系统新增加的操作如何可以监听或者拦截到？解决链接：https://club.kdcloud.com/article/16306510)数据集成方案导入后集成方案列表源对象为空。31/32金蝶s-HR与金蝶云苍穹集成应用指南解决链接：https://club.kdcloud.com/article/16306711)执行供应商方案时，执行日志提示错误"服务不可用”。解决链接：https://club.kdcloud.com/article/17079712)值转换规则当出现java.sql.SQLException:Invalidcolumntype类型错误。解决链接：https://club.kdcloud.com/article/17110713)EAS连接配置部署时提示”EAS反调苍穹时报错”。解决链接：https://club.kdcloud.com/article/17110614)事件触发不生效问题分析。解决链接：https://club.kdcloud.com/article/18238315)数据同步大批量数据，同步到中途就会报EAS网络连接异常，但测试连接又是成功的(ConnectionException)。解决链接：https://club.kdcloud.com/article/18296916)EAS连接配置，点击测试有时候可以成功有时候又没有反应解决链接：https://club.kdcloud.com/article/183143七、注意事项1.s-HR系统内进行行政组织的新增、修改、变更、封存、启用、删除、批量组织架构调整。这些业务操作后，系统都会向金蝶云苍穹系统内自动同步。一定需要安装s-HR的版本补丁，才能监听s-HR的操作。2.s-HR员工是事件自动触发同步。32/32
