金蝶s-HR与金蝶云苍穹薪酬代发单集成应用指南金蝶软件（中国）有限公司2021年12月金蝶s-HR与金蝶云苍穹集成应用指南目录前言......................................................................................................................................3一、功能目标..........................................................................................................................4二、版本支持..........................................................................................................................4三、集成同步要求..................................................................................................................5四、集成同步配置及初始化...................................................................................................5第一步：【集成服务云部署前准备】：...........................................................................5第二步：【集成服务云EAS连接器部署手册】：..........................................................111.部署要求：..................................................................................................................122.部署步骤：..................................................................................................................122.1EAS连接器部署...................................................................................................122.2苍穹远程部署.....................................................................................................14第三步：【代发单集成同步操作（s-HR-苍穹）】：...................................................17五、同步功能说明................................................................................................................201.s-HRV2021H1部署...................................................................................................202.基本功能......................................................................................................................231.1星瀚出纳代发单退单/退票后，如何重新生成并同步代发单.........................23六、同步异常分析及处理.....................................................................................................24七、注意事项.................................................................................................................282/29金蝶s-HR与金蝶云苍穹集成应用指南前言本文档是针对金蝶s-HR与金蝶云苍穹使用集成服务云进行薪酬代发单集成应用的说明，包括应用环境、数据中心的支持，集成配置说明等。3/29金蝶s-HR与金蝶云苍穹集成应用指南一、功能目标金蝶s-HR和金蝶云苍穹集成主要为支持在包含人力资源的整体ERP解决方案当中，需要同时部署金蝶云苍穹系统，以及相应的金蝶s-HR人力资源管理系统，可以保持组织、员工基础资料的统一，和薪资与财务的连通。最终保障整个业务系统的信息流连贯通常，及全程的自动化处理。金蝶s-HR和金蝶云苍穹集成，使用金蝶云苍穹-集成服务云。集成服务云总体介绍苍穹的开放性：苍穹支持通过JDBC、接口、消息等多种集成技术与异构系统进行集成。集成服务云是在此基础上封装的一套集成工具，以降低集成开发的难度和工作量。集成服务云是一种集成技术的低代码开发平台和配置平台，提供可视化配置实现苍穹与各类系统的数据集成，支持基于个性化场景动态集成的扩展能力，为苍穹提供平民化的集成工具支持。集成服务云聚焦大型企业各类系统与金蝶云苍穹集成的需求,采用元数据驱动的设计模式，通过低代码可视化配置、丰富的值转换规则和开放的对外服务能力，快速实现客户的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。集成云目前主要针对频繁变动的在线业务数据和高价值密度的结构化数据，暂不支持低价值密度的数据高性能同步。目前已支持苍穹系统、EAS系统、s-HR系统、Orcale/SQLServer/MySQL类型数据库等数据源类型，提供苍穹系统与以上数据源进行数据集成能力。二、版本支持金蝶s-HR（以下简称s-HR）支持2021H1版本，金蝶云苍穹（以下简称苍穹）需要安装金蝶云苍穹V4.0.008及以上版本+最新补丁。金蝶s-HR补丁要求：金蝶s-HR2021H1必须安装：PTM155668最新补丁，参见《金蝶s-HR2021H1安装部署说明》；金蝶云苍穹补丁要求：金蝶云苍穹V4.0.008及以上版本+最新补丁。4/29金蝶s-HR与金蝶云苍穹集成应用指南三、集成同步要求仅支持s-HR一个数据中心到金蝶云苍穹一个数据中心进行单向集成同步，不支持一对多或多对一的数据中心集成同步，也不支持同一应用服务器下挂多个数据中心分别同步。四、集成同步配置及初始化第一步：【集成服务云部署前准备】：【集成服务云部署前准备】以以下链接中的最新内容为准，请按链接内容进行配置。论坛链接：https://club.kdcloud.com/article/14039A.项目组必须配备开发人员和懂技术的实施顾问，不然任何数据异常都无法看懂日志，对集成项目交付会极其困难。集成云研发组资源有限，暂不接受没有配备该角色的项目组的支持需求。B.s-HR部署的服务器和苍穹部署的服务器网络需要互通，网络问题可以咨询客户的网管或者运维人员。C.必须使用在线文档统一管理现场问题清单、测试记录和测试场景3个内容。数据脱敏：如因未脱敏导致正式环境的数据问题，请自行负责！！！将苍穹或者EAS的正式库备份到测试环境用于测试时，需要对数据库进行数据脱敏，防止测试过程中将测试数据同步到正式环境。1、s-HR服务器可以访问金蝶云苍穹(苍穹默认服务器端口8080，需要看实际情况)。5/29金蝶s-HR与金蝶云苍穹集成应用指南windows：建议方式一和方式二同时验证，部分机器浏览器会设置代理可能导致浏览器可以但是cmd异常的情况。方式一：打开cmd，输入telnet苍穹服务器ip苍穹端口（telnet172.17.5.688080）如下图：出现下图，说明网络端口是通的。6/29金蝶s-HR与金蝶云苍穹集成应用指南方式二：s-HR所在服务器用浏览器访问苍穹，能访问登陆成功，说明网络是通的。linux：方式一：终端输入命令telnet苍穹服务器IP端口，出现Escapecharateris‘^】’说明网络是通的。7/29金蝶s-HR与金蝶云苍穹集成应用指南方式二：s-HR所在服务器用浏览器访问苍穹，能访问登陆成功，说明网络是通的。2、金蝶云苍穹服务器可以访问s-HR服务器8/29金蝶s-HR与金蝶云苍穹集成应用指南方式一：登陆苍穹—集成服务云—集成管理—连接管理—连接配置—网络检查。方式二：如何确定网络是否通？可以参考上面1的步骤验证。必须在部署了苍穹的服务器上telnet）注意：金蝶内部研发环境，如果云平台是容器部署，则需要云平台所有IP都能访问s-HR服务器。单实例：实例server1的HTTP端口9/29金蝶s-HR与金蝶云苍穹集成应用指南群集：网络代理的HTTP端口方式三：苍穹所在服务器打开浏览器访问并登陆s-HR的门户，能访问并登陆成功说明网络是通的。10/29金蝶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连接器部署手册】：11/29金蝶s-HR与金蝶云苍穹集成应用指南【集成服务云EAS连接器部署手册】以以下链接中的最新内容为准，请按链接内容进行配置。论坛链接：https://club.kdcloud.com/article/142051.部署要求：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目录下。12/29金蝶s-HR与金蝶云苍穹集成应用指南isc.war添加后正确的目录结构修改\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/29金蝶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连接信息，该s-HR用户需要有业务权限且不能用于登陆s-HR系统进行业务操作（需要哪些业务权限需要看集成哪些单据，把需要集成的单据权限分配给该用户即可）。苍穹代理用户：苍穹用户用于苍穹配置s-HR连接信息的代理用户，并且这个代理用户的用户名不为空，该苍穹用户需要有业务权限，需要哪些业务权限需要看集14/29金蝶s-HR与金蝶云苍穹集成应用指南成哪些单据，把需要集成的单据权限分配给改用户即可。服务器端口：填写非s-HR实例1的HTTP端口（一个实例的情况可以用s-HR实例1的HTTP端口）或者网络代理页面的HTTP端口（多实例的情况）。特别说明：多实例情况下千万不要使用server1主实例的HTTP端口，初始化数据量大的情况下有可能导致server1压力过大（s-HR主实例server1承载了license和工作流服务，如果s-HR的主实例server1不可用会导致s-HR其他实例都无法使用）。2、远程部署访问键：进入【集成服务云】-【集成管理】-【连接管理】-【连接配置】页面，选择s-HR的连接点击“部署”按钮，弹出部署弹出框。本系统：“本系统”就是指你当前使用的苍穹系统，连接器需要使用该URL与集成云交互，请确保在连接器部署的服务器上可以访问当前苍穹系统。密码提示：这里的密码是指部署连接器的系统(s-HR客户端登陆)的管理员的密码，切记不是苍穹系统的管理员密码。此密码仅用于部署验证是否具有“管理员”身份，在苍穹数据库中不会保存，也不会在网络上传输。业务授权模式：全部授权：全部集成对象都授权使用（默认值，测试环境建议使用这个模式）15/29金蝶s-HR与金蝶云苍穹集成应用指南白名单：根据管理授权清单里面的集成对象内容来实际授权（UAT和正式环境建议使用这个模式，但是需要管在管理授权页面新增需要授权的集成对象），关于授权的内容会有专门的文章要说明。禁止访问：禁止任何访问，无法进行数据集成。注意：连接配置每次修改保存后会重新生成访问键信息，所以访问键信息变化后需要重新进行部署操作，否则将会导致苍穹连接s-HR异常。16/29金蝶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说明成功。17/29金蝶s-HR与金蝶云苍穹集成应用指南第三步：【代发单集成同步操作（s-HR-苍穹）】：应用场景：需要将s-HR系统的银行代发单同步到苍穹，对应生成出纳代发单，财务可直接在苍穹系统处理薪资发放的出纳付款业务前置条件：1、需要先同步财务组织、HR组织、员工（请参考《金蝶s-HR与金蝶云苍穹集成配置操作手册》），同步后维护组织、人员，确保s-HR银行代发单中的财务组织编码、发薪业务组织编码、员工编码分别在苍穹系统的资金组织、核算组织、人员中存在；2、s-HR银行代发单单据所属的付款公司（即EAS财务组织）同步到苍穹系统上，并在苍穹系统上要维护为资金组织后，需要完成该资金组织的出纳初始化，才能进行单据同步；操作步骤：1、请按以下链接的步骤部署方案：https://club.kdcloud.com/article/2407925330162572802、进入苍穹服务平台->应用->集成服务云->集成管理->连接管理->数据源管理，搜索并点击数据源【预置EAS850】，修改系统连接，关联2.2苍穹远程部署步骤中自行配置的连接配置；18/29金蝶s-HR与金蝶云苍穹集成应用指南3、进入苍穹服务平台->应用->集成服务云->集成管理->服务流程->流程设计->服务流程，启用并发布第一步中导入的流程；注：若币别数据以苍穹的预置基础资料为准，则不需要发布【预置flow_s-HR币别初始化（s-HR-苍穹）】，只需要修改s-HR上币别的编码，保证和苍穹对应同一币别的编码一致，同步时系统就可以按编码在苍穹中找到对应币别数据；（也不需要执行步骤4）4、若同步完成后，后续在s-HR中新增了币别基础资料数据，且代发单中的数据的发放币别包含新增币别，则需要在服务流程中，选择【预置flow_s-HR币别初始化（s-HR-苍穹）】，点击执行；19/29金蝶s-HR与金蝶云苍穹集成应用指南五、同步功能说明1.s-HRV2021H1部署请按照私包部署文件里的《私包说明》进行部署（注：请提单找总部要私包文件，目前私包版本仅支持s-HRV2021H1，其他版本请勿部署）。按步骤部署完成后，需要配置视图，管理员登录s-HR，在视图中搜索【银行代发单list】，编辑该视图，增加星瀚出纳代发单编码、星瀚出纳代发单处理状态、集成接口处理返回日志字段（集成接口处理返回日志字段可不放出，该字段用于查看同步集成错误日志）：并修改state、cashBillNum字段，增加属性type="hidden"，如下图所示：20/29金蝶s-HR与金蝶云苍穹集成应用指南视图【银行代发单所有规则list】也按以上内容修改在视图中搜索【银行代发单明细List】，编辑该视图，增加星瀚支付状态字段：并修改isSuccess字段，增加属性type="hidden"，如下图所示：完成视图配置后，效果如下图：21/29金蝶s-HR与金蝶云苍穹集成应用指南在视图中搜索【薪酬核算-银行代发动态列表】，编辑该视图，增加以下内容：{'value':2,'alias':'支付失败代发单'}，如下图所示：配置完成后，即可过滤支付失败的员工，重新生成代发单，效果如下图：22/29金蝶s-HR与金蝶云苍穹集成应用指南2.基本功能集成同步配置完成后，用户在【薪酬核算向导-第四步-银行代发】中点击生成代发单时，会触发数据同步至金蝶云苍穹。s-HR生成代发单后，如果单据上的【星瀚出纳代发单处理状态】字段为未处理，且【星瀚出纳代发单编码】字段为空，则说明同步生成星瀚出纳代发单正在进行中；若状态一直为未处理，可能因服务器问题导致同步中断，请在服务流程中查看日志；如果单据上的【星瀚出纳代发单处理状态】字段为付款失败，且【星瀚出纳代发单编码】字段为空，则说明同步生成星瀚出纳代发单失败，请在服务流程中查看日志；（查看日志步骤在六、同步异常分析及处理中的序号1）如果同步生成成功，则【星瀚出纳代发单编码】字段会被返写为星瀚出纳代发单单据编码。如果同步失败，则需要删除s-HR银行代发单，重新生成并同步。注意：1）当【星瀚出纳代发单处理状态】为[未处理/付款失败]（即星瀚出纳代发单还未生成成功）时，s-HR银行代发单允许删除，否则不允许删除。2）星瀚出纳代发单若是由s-HR下推生成的，则也不允许删除。1.1星瀚出纳代发单退单/退票后，如何重新生成并同步代发单当星瀚出纳代发单退单/退票后，s-HR银行代发单中分录状态会被返写为【已退单】，此时可以在核算向导-第四步-银行代发中，展开过滤，过滤条件【代发单员工】选择[支付23/29金蝶s-HR与金蝶云苍穹集成应用指南失败代发单]，过滤出已退单的记录，勾选并重新生成代发单。六、同步异常分析及处理1.在s-HR生成银行代发单后，若同步生成星瀚代发单失败，可通过【五、1.s-HRV2021H1部署】中视图配置的字段【集成接口处理返回日志】查看日志，或者在苍穹服务平台->应用->集成服务云->集成管理->服务流程->流程设计->服务流程中，选择流程【同步s-HR薪酬代发单到星瀚】，并点击流程实例，再选择对应发起时间的流程实例，点击日志，查看报错原因；24/29金蝶s-HR与金蝶云苍穹集成应用指南2.若星瀚代发单的状态未返写回s-HR，可选择【同步星瀚代发单状态到s-HR】，并点击流程实例，再选择对应发起时间的流程实例，点击日志，查看报错原因；3.集成同步时，同步结果可通过苍穹菜单路径：【集成服务云】-【集成管理】-【数据集成】-【执行结果】进行查看，执行结果中会显示启动方案的执行详情，显示成功、失败、忽略和总行数，并提供查看、日志、重做、撤销等功能。4.同步失败的数据，可通过菜单路径：【集成服务云】-【集成管理】-【数据集成】-【执行日志】进行查看执行日志明细，检查失败原因，修复数据后重新同步。员工日常同步是由系统自动处理的，可通过监控执行日志的失败记录，及时知会相关人员进行处理。执行日志中会显示启动方案执行结果的日志详情，失败日志25/29金蝶s-HR与金蝶云苍穹集成应用指南会自动记录。若需记录成功日志，需在启动方案选择保存全部日志的功能。5.集成云报错处理合集：https://club.kdcloud.com/article/455561)数据集成执行日志出现“根据转换规则XXXXX无法将源系统字段值X转换”如何解决？解决链接：https://club.kdcloud.com/article/454192)集成云与EAS连接配置，部署报错或者测试报错，报错日志如下java.lang.RuntimeException:java.lang.IllegalAccessException:timestampistimeout.diff=496150要求部署苍穹和EAS的服务器时间不允许相差300秒以上，如果出现该错误需要把两个服务器的时间进行校对调整。建议通过时间同步服务器做时间同步。26/29金蝶s-HR与金蝶云苍穹集成应用指南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)数据集成方案导入后集成方案列表源对象为空。解决链接：https://club.kdcloud.com/article/16306711)执行供应商方案时，执行日志提示错误"服务不可用”。解决链接：https://club.kdcloud.com/article/17079712)值转换规则当出现java.sql.SQLException:Invalidcolumntype类型错误。27/29金蝶s-HR与金蝶云苍穹集成应用指南解决链接：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/18314317)集成服务流程操作指南解决链接：https://club.kdcloud.com/article/9889075274668876818)启动方案支持事件处理（回调通知）解决链接：https://club.kdcloud.com/article/182647七、注意事项1.需要先同步财务组织、HR组织、员工（请参考《金蝶s-HR与金蝶云苍穹集成配置操作手册》），同步后维护组织、人员，确保s-HR银行代发单中的财务组织编码、发薪业务组织编码、员工编码分别在苍穹系统的资金组织、核算组织、人员中存在；2.若币别数据以s-HR的基础数据为准，则需要同步币别数据；若币别数据以苍穹的预置基础资料为准，则只需要修改s-HR上币别的编码，保证和苍穹对应同一币别的编码一致，同步时系统就可以按编码在苍穹中找到对应币别数据。28/29金蝶s-HR与金蝶云苍穹集成应用指南【免责声明】：本课程或文档仅用于学习使用，未经授权，禁止转载。本课程或文档中所用数据均为虚构的模拟数据，不代表任何一家企业的真实情况，如有权利人认为其中的任何内容存在侵权情况，请反馈给金蝶官方邮箱（DataSubjectRequest@kingdee.com），我们将在7个工作日内处理。29/29
