金蝶s-HR-金蝶s-HR与K3Cloud集成应用指南.docx

s-HR&K/3Cloud集成应用指南金蝶软件（中国）有限公司2017年7月金蝶s-HR与K/3Cloud集成应用指南目录一、功能目标..................................................................4二、支持版本..................................................................4三、集成同步要求..............................................................5四、集成同步配置及初始化......................................................5第一步：【s-HR组织信息维护】...............................................5第二步：【K/3Cloud端配置】................................................7第三步：【s-HR单点登录配置】...............................................8第四步：【s-HR端配置】.....................................................9第五步：【初始化同步】....................................................10五、同步功能说明.............................................................111.基本功能.............................................................111.1不进行同步推送的数据说明............................................131.2同步禁用Cloud基础数据说明...........................................142.Cloud强制同步功能...................................................153.同步日志记录及映射表.................................................17六、同步异常分析及处理.......................................................19七、应用服务器或数据库切换...................................................20八、业务配置方案.............................................................20场景一：先应用s-HR，后应用Cloud。.........................................20场景二：先应用Cloud，后应用s-HR。.........................................21场景三：WEBService（旧接口）调整为WEBAPI方式（新接口）.................22场景四：多个客户的s-HR同步到Cloud公有云的对应数据中心....................22场景五：s-HR调整同步的数据中心............................................23场景六：Cloud调整同步的数据中心...........................................24场景七：Cloud调整同步的用户..............................................24场景八：s-HR修改K/3Cloud业务组织编码（建议不改）.......................25九、老客户升级...............................................................25十、注意事项.................................................................262/28金蝶s-HR与K/3Cloud集成应用指南前言本文档是针对金蝶s-HR与K/3Cloud使用新接口集成应用的说明，包括应用环境、数据中心的支持，同步配置及同步机制说明等。3/28金蝶s-HR与K/3Cloud集成应用指南一、功能目标金蝶s-HR和K/3Cloud集成主要为支持在包含人力资源的整体ERP解决方案当中，需要同时部署K/3Cloud系统，以及相应的金蝶s-HR人力资源管理系统，可以保持组织部门、岗位、员工基础资料的统一，以及在金蝶s-HR完成薪资核算后，可以快速将薪资核算结果结转至K/3Cloud财务总账系统，并生成相应的财务费用凭证及其他相关业务凭证。最终保障整个业务系统的信息流连贯通常，及全程的自动化处理。金蝶s-HR和K/3Cloud集成采用了新接口，改用WebAPI的同步方式，提供同步效率和稳定性。同步过程中记录同步日志和映射关系，以便在出现同步异常时，可以通过同步日志和映射关系快速查找原因，并结合业务应用，根据需要进行修复。二、支持版本金蝶s-HR（以下简称s-HR）支持V2.0版本和V8.2版本，K/3Cloud（以下简称Cloud）需要安装K/3CloudV6.X+最新补丁或者K/3CloudV7.0。金蝶s-HR补丁要求金蝶s-HRV2.0必须安装：PTM102562、PT106843（前置补丁）、集成补丁PT109256、薪酬补丁PT110113；金蝶s-HRV8.2必须安装：PTM112673，参见《金蝶s-HRV8.2SP2安装部署说明》。【注意】：金蝶s-HRV8.2只同步已初始化s-HR应用的组织及其下级组织、职位和员工，不包括无职位人员；2.0中s-HR的岗位在8.2中改名为职位。K/3Cloud补丁要求K/3CloudV6.0/6.1+最新补丁（多语言补丁除外）K/3CloudV6.2+最新补丁（多语言补丁除外）K/3CloudV7.0【备注】：若需要使用金蝶s-HRV8.2的补丁，K/3Cloud需安装V7.0；若是安装的是V6.X，则必须打V6.X版本2017年4月20日发布的补丁（或者后续更新补丁）。4/28金蝶s-HR与K/3Cloud集成应用指南三、集成同步要求目前仅支持s-HR一个数据中心到K/3Cloud一个数据中心进行单向集成同步，不支持一对多或多对一的数据中心集成同步，也不支持同一应用服务器下挂多个数据中心分别同步。【重要】：s-HR的基础数据编码是大小写敏感的，不区分数据库；K/3Cloud区分数据库，Oracle默认大小写敏感，SQLServer默认大小写不敏感（可配置）。若K/3Cloud使用的是SQLServer数据库，请配置为大小写敏感，或注意在s-HR中维护数据时编码统一使用大写或小写，不要出现字符相同仅大小写不一致的编码的数据，否则可能因与K/3Cloud编码重复导致同步失败。四、集成同步配置及初始化第一步：【s-HR组织信息维护】s-HR的组织数据要与K/3Cloud集成同步，需要指定该组织对应的Cloud业务组织，请在同步之前维护完整（所有需要同步的组织都需要配置）。【注意】：“K/3Cloud业务组织编码”字段非常重要，同步前需确保该字段配置正确，否则，若配置错误且已经同步成功，后面再修改将无法同步更新，需要通过特殊方式处理（参考第八章：场景八）。在s-HR组织信息form视图上增加zipCode字段配置（可设置为必录，避免未输入值而导致同步失败）；5/28金蝶s-HR与K/3Cloud集成应用指南设置s-HR组织上的“K/3Cloud业务组织编码”值为K/3Cloud要对应的组织机构编码。可单个设置,也可通过调整组织导入模板新增该字段后，通过【组织更新导入】批量导入该值（注意使用导入时需要将组织上所有值的信息填写完整，否则会将已有字段的值清空）；若K/3Cloud是单组织模式，也可以在初始化时使用语句批量在后台更新为统一值100，参考的SQL语句如下：updatet_org_adminsetfzipcode='100'updateT_ORG_OUPartAdminsetfzipcode='100'6/28金蝶s-HR与K/3Cloud集成应用指南第二步：【K/3Cloud端配置】Administrator登录K/3Cloud数据中心，进入菜单【公共设置】→【s-HR集成】→【s-HR集成配置】，按下面流程操作：1.选择具有Cloud部门、岗位、员工、任岗操作权限的用户，该用户将作为s-HR同步更新Cloud数据的用户；2.在s-HR接口地址配置金蝶s-HR应用服务器地址和端口，按示例直接替换s-HR的服务器地址和端口号即可；7/28金蝶s-HR与K/3Cloud集成应用指南【备注】：若s-HR8.2是集群环境，s-HR接口地址中配置的端口号不要使用公共端口，而要使用某实例的端口；3.点击【启用】，启用s-HR集成配置；4.点击【引出密钥文件】，引出密钥文件，注意引出文件名称不要修改；若后面修改了用户、修改s-HR接口地址或者重置密钥，需要重新引出密钥文件，并在s-HR系统的集成配置中引入，引入方法见【s-HR端配置】描述。【注意】：在设置的K/3Cloud用户名和密码时，请务必保证此用户有K/3Cloud内的部门、岗位、员工、员工任岗四个基础资料的所有权限。同时，确认部门、岗位两个基础资料的基础资料控制策略中，在相应的业务组织内可以创建此基础资料。请勿修改此用户名及密码。若有任何修改，需重新引出密钥文件并在s-HR端进行引入。因此，建议自行创建一个特殊的用户，作为同步用户。启用WEBAPI集成方式后，不能恢复使用WEBService的集成方式。第三步：【s-HR单点登录配置】如已配置，请检查：(1)将服务端server\profiles\server(1…n)\config\portalConfig目录下的ssoClient.properties文件中的sso.easIsSSOClient参数项的值修改为true；(2)将服务端server\profiles\server(1…n)\config\portalConfig目录下的autoLoginConfig.properties文件中的datacenter参数修改为s-HR要登录的数据中心代码(即：数据中心id)，并且将authPattern参数修改为BaseTrdLtpaToken；(3)重新启动s-HR服务器。【注意】：对于s-HRV2.0版本，此处仅需配置上面内容即可；对于s-HRV8.2版本，除了配置上面内容，还需配置下面内容：【s-HRV8.2版本】配置默认监听集群部署的需要每个实例下的这个文件都需要增加。1、需要在s-HRV8.2服务端安装目录下\eas\server\profiles\server1\config\listenerconfig.data文件中增加以下信息:2、修改配置文件后需要重启EAS应用服务器。【s-HRV8.2版本】启用跨域POST请求以及添加到白名单对于s-HRV8.2及以上版本或Apusic9及以上版本服务器的环境，安全策略有调整，默认禁用了跨站POST请求，需要增加白名单（存在多个实例的情况下，每个实例都需要配置），如下：打开安装目录\apusic\domains\server1\config\web.xml文件，将初始化参数serverNameWhiteList的值设置为第三方系统的服务名称。以K/3Cloud系统(http://172.17.1.215/k3cloud/)中打开s-HR为例，需修改如下配置：另外还需要修改配置，如下：安装目录\apusic\domains\server1\config\web.xml文件，将初始化参数enableCSRFCheck_POST的值需要改为false，重启EAS应用服务器后生效。第四步：【s-HR端配置】以administrator用户登录s-HR，进入菜单“开发平台—>集成配置—>K/3Cloud集成配置”。9/28金蝶s-HR与K/3Cloud集成应用指南1、在消息接口服务地址配置所要集成的K/3Cloud应用服务器地址；2、引入从K/3Cloud引出的密钥文件，方法见【K/3Cloud端配置】描述；3、勾选需要启用的基础资料和薪酬发放结果同步集成接口后保存；4、点击【测试连接】，确认配置信息正确、网络正常。【注意】：若集成配置界面中的“启用基础资料同步集成接口”启用后取消勾选，则系统不再进行组织、岗位、员工数据的自动同步，但不影响K/3Cloud手动发起的同步指令（即：Cloud强制同步，见第五章第2节描述）。若“启用薪资发放结果同步集成接口”启用后需手动同步数据，取消勾选后，则系统不再允许同步数据。第五步：【初始化同步】请完成以上配置后，再进行初始化同步。组织、岗位、员工1.请在“开发平台—>集成配置—>K/3Cloud集成配置”界面，点击初始化同步（同步前，请保证组织信息维护已完成）；2.同步完成后检查同步结果（参见第五章第3节同步日志记录及映射表的描述）。【注意】：初始化同步时，若Cloud是空的数据中心，s-HR会以新增方式同步数据，后续会根据数据的ID进行匹配，同步更新；若Cloud当前组织下已有数据，需要确保相同组织s-HR和Cloud的编码相同，通过Cloud强制同步功能处理（即：Cloud强制同步，见第五章第2节描述）后，再将仅在s-HR中存在的组织进行初始化同步。初始化同步会按照基础资料顺序的级次顺序同步（组织->职位->员工，上级在前），强制同步亦然；强制同步前，需确保选择的基础资料依赖的上一级次数据及上级已同步或10/28金蝶s-HR与K/3Cloud集成应用指南同时选择进行同步。初始化同步不对已经封存的组织、已禁用的岗位（禁用岗位下的员工）及已离职的员工（员工用工关系状态上的用户状态为禁用）进行同步。薪酬数据薪酬部分不需要初始化。五、同步功能说明1.基本功能集成同步配置完成并执行初始化同步后，后续系统将会自动同步更新组织、岗位、员工。在s-HR系统中组织岗位数据的更新，以及员工管理中对员工信息的更新及员工变动等都会触发数据同步至K/3Cloud。s-HR系统内进行组织单元的新增、修改、变更、封存、删除、批量组织架构调整。这些业务操作后，系统都会向Cloud系统内自动同步。特别地，s-HR系统内组织封存、删除，Cloud自动置为禁用，这可能影响Cloud相关的行政组织架构部门的财务、供应链、制造等相关的业务，需谨慎处理。s-HR系统内进行岗位的新增、修改、变更、封存、删除、批量组织架构调整造成的岗位变更，系统都会向Cloud系统内自动同步。特别地，s-HR系统岗位封存、删除，Cloud自动置为禁用，这可能影响Cloud相关的行政岗位的财务、供应链、制造等相关的业务及汇报关系，需谨慎处理。s-HR系统内进行员工的入职新增、员工信息的修改、员工信息的变更、调动事务、兼职事务、员工离职、删除、批量组织架构调整造成的员工岗位变更。这些业务操作后，系统都会向Cloud系统内自动同步，同步时，HR员工数据分别会写入Cloud基础资料中【人员】、【员工】、【员工任岗】三个基础资料对象中。前者记录的是企业员工的清单明细，后者为具体员工任岗关系的明细。特别地，s-HR系统内管理的企业员工更新、转正、调动、离职、删除等，在Cloud内可能自动置为禁用，这可能影响员工相关的财务、供应链、制造等相关的业务及供应链业务员的设置，以及工作流的应用，需谨慎处理。组织、岗位、员工数据更新机制及字段对应关系，请参考下面Excel的描述：11/28金蝶s-HR与K/3Cloud集成应用指南组织、岗位、员工数据同步1、s-HR操作更新K/3Cloud数据说明如下表：2、s-HR与K/3Cloud集成_字段同步说明如下表：若有同步失败的数据，可以在s-HR的日志里边重新同步（参见第五章第3节），或者通过Cloud的强制同步功能更新（参见第五章第2节）。薪资数据同步在s-HR端【K/3Cloud集成配置】中启用薪资发放结果数据同步接口。通过【薪酬核算->薪酬核算->费用分配信息（K/3Cloud）】中的“同步薪酬项目”进行薪酬项目的同步，每期次的薪酬数据通过“提交财务”功能提交到K/3Cloud。手工同步操作后，会在s-HR和K/3Cloud中记录同步日志表和数据映射表。“同步薪酬项目”：只同步s-HR启用状态的薪酬项目，未同步的薪酬项目进行新增同步，已经同步的薪酬项目进行更新同步，如果是同步后s-HR删除或禁用了的项目，则不同步。“提交财务”：【费用分配信息（K/3Cloud）】列表中查询核算状态为“已审批”的计算规则，需要点击对应的计算规则，维护“总账业务组织编码、总账业务组织名称”（据此判断数据下推的目标财务组织）。提交财务时，需要录入“财务日期”（根据此日期找到K/3Cloud对应的会计期间）。提交前，先判断以下两个条件，不满足则提示，满足则同步。计算规则的薪酬项目是否已经同步到K/3Cloud；该期次的薪酬发放数据是否已经生成成本分摊。若同一个计算规则同一个期次的成本分摊数据多次“提交财务”，则会判断对应的K/3Cloud薪资单是否已经生成凭证，如果已经生成凭证，则不允许同步，且不允许再生成成本分摊，以保证成本分摊的数据、薪酬发放的数据、同步到K/3Cloud的数据三者一致。如果要更新同步，必须先删除凭证，才能重新生成成本分摊和“提交财务”；如果未12/28金蝶s-HR与K/3Cloud集成应用指南生成凭证，则允许更新同步，更新同步时，薪资单的内码不变，薪资单中单据体明细数据先删除，再新增本次的同步的数据。同一计算规则不同期次或不同计算规则“提交财务”均为新增同步。K/3Cloud中同步薪资发放界面默认不提供查看界面，只有在会计智能平台才可以选择；如果需要显示，可以通过BOS集成平台进行相应操作。薪资发放结果是部门级别，不涉及到个人级别，主要进行费用成本凭证的处理。例如：借：生产成本、管理费用、销售费用贷：应付工资。1.1不进行同步推送的数据说明部分数据因关键数据不完整、关联的上级或前置基础资料未同步成功，将不会往K/3Cloud同步这些数据，这些数据的失败日志将写入s-HR和Cloud的错误日志：同步组织：K/3Cloud业务组织为空的，失败原因为：“K/3Cloud业务组织编码为空，不进行同步推送”；同步组织：上级组织在映射表中不存在的（即上级组织未新增同步成功的），失败原因为：“上级组织【编码+名称】未同步成功，不进行同步推送”；同步组织：组织同步成功后又修改了K/3Cloud业务组织，更新的数据不进行同步，失败原因为：“组织**的K/3Cloud所属业务组织发生变化，不进行同步推送!需要采用人工方案进行变更，具体可参考指南！”；（具体请参考第八章，场景八）同步岗位：所属组织在映射表中不存在（即组织未新增同步成功的）的，失败原因为：“所属组织【编码+名称】未同步成功，不进行同步推送”；上级岗位在映射表中不存在（即上级岗位未新增同步成功的）的，失败原因为：“该岗位的上级岗位【编码+名称】未同步成功，不进行同步推送”；同步岗位：岗位同步成功后对应组织的K/3Cloud业务组织发生变化，更新的数据不进行同步，失败原因为：“组织**的K/3Cloud所属业务组织发生变化，不进行同步推送!需要采用人工方案进行变更，具体可参考指南！”；（具体请参考第八章，场景八）同步员工：员工任职职位在映射表中不存在（即岗位未新增同步成功的）的，失败原因为：“任职职位【编码+名称】未同步成功，不进行同步推送”；同步员工任岗：员工的兼职任职岗位未同步成功，或岗位对应的K/3Cloud业务组织为空或组织同步后K/3Cloud业务组织发生变化，不进行同步推送，提示信息为：“该员工的所属组织为【编码+名称】，所属岗位为【编码+名称】的兼职任职，不进行同步13/28金蝶s-HR与K/3Cloud集成应用指南推送！可能原因：1、该兼职的组织未同步2、该兼职的岗位未同步3、该兼职的组织的K/3Cloud所属业务组织为空或者发生变化，请检查！”；同步薪酬发放数据：只同步成本分摊了的数据，且员工如果没有同步成功，则该员工对应的薪酬成本分摊数据不会同步到K/3Cloud。1.2同步禁用Cloud基础数据说明组织组织删除和封存同步到Cloud禁用对应部门。岗位岗位删除和禁用同步到Cloud禁用对应岗位。员工s-HR员工同步到Cloud是否禁用该员工，根据员工当前用工关系状态上的用户状态设置进行判断。若用户状态为禁用，则同步至Cloud禁用员工和所有任岗。如：员工离职后用工关系状态变为辞职（用工关系状态为“辞职”的基础数据上的用户状态为禁用），同步至Cloud后该员工变为禁用状态。请根据需要设置对应用工关系状态上的用户状态。员工任岗当s-HR员工变动所用的变动操作对应的事务类别为“离职”，则会根据变动操作配置终止员工任职，同步至Cloud后员工对应的这些任职也相应会被禁用。14/28金蝶s-HR与K/3Cloud集成应用指南【注意】：组织、岗位、员工、员工任岗在Cloud同步禁用，将可能影响到相关的Cloud业务，涉及：工作流/审批流、业务单据/基础资料/凭证等引用，若有特殊需要，请做好业务协调，在s-HR更新操作前，确保走完Cloud业务或者不会影响到Cloud业务。2.Cloud强制同步功能通过K/3Cloud强制更新同步功能，可以让客户自行决定是否从s-HR强行刷新数据，以免对历史数据产生影响。比如：K/3Cloud已存在员工0010张三（K/3Cloud手工新增），使用K/3Cloud岗位（业务员，上级是业务组长）进行审批流业务处理，且流程没有结束，s-HR上线后，维护员工0010张三的岗位（业务员，上级是部门经理），岗位上存在差异，如果自动同步则会造成Cloud的审批流提交不正确。提供强制更新，可以让客户自行选择是否按照s-HR的员工0010张三的数据强行覆盖K/3Cloud同一编码0010张三的数据。K/3Cloud强制同步时，K/3Cloud与s-HR相同编码的数据（组织、岗位、员工），按照s-HR的数据内容进行同步覆盖，强制更新后，会返回同步结果信息，并在s-HR和K/3Cloud中记录同步日志和映射关系表，具体请参考本章第3节描述。【注意】：强制同步会针对所选记录按照编码完全匹配原则，以s-HR内容强行覆盖Cloud对应内容，强制同步后可能会影响Cloud的业务，例如：工作流、业务单据的引用等，需谨慎处理；若确实需要同步，请确保相同数据的编码一致；强制同步时，建议按s-HR组织及岗位层次进行分层分组，确保将上级先同步再同15/28金蝶s-HR与K/3Cloud集成应用指南步下级或者所选数据同时包含上级，避免由于上级未同步成功，而导致同步失败；Cloud选择员工任岗强制同步时，会将s-HR当前员工所有岗位信息同步覆盖Cloud对应数据，任岗信息只在Cloud记录映射关系；K/3Cloud进行强制同步时，当前登录用户要有s-HR基础资料的强制更新s-HR数据的权限；强制同步时，将仅从s-HR单点登录所配置的数据中心进行同步，并且该s-HR数据中心的集成配置中引入的是当前Cloud数据中心的密钥文件。K/3Cloud强制同步入口，如下图：对于员工，HR员工数据分别对应Cloud基础资料中【人员】、【员工】、【员工任岗】三个基础资料对象。Cloud强制同步时，每1条员工强制更新，会同步更新3条数据（人员、员工、员工任岗），且这3条数据的编码一致，如下图所示：16/28金蝶s-HR与K/3Cloud集成应用指南对于部门和岗位，s-HR的组织对应Cloud的部门，s-HR的岗位对应Cloud的岗位，Cloud强制同步时，每1条部门或岗位强制更新，Cloud同步更新1条对应数据。3.同步日志记录及映射表在K/3Cloud和s-HR系统均可以查看同步数据的同步日志和映射关系表。通过同步日志可以直观查看同步失败的原因，便于分析原因，通过映射关系的查看可以溯源。初始化同步时，系统根据s-HR中的基础数据（组织、职位、员工）编码与K/3Cloud中的对应基础数据（部门、岗位、员工/人员）编码进行匹配，生成对应数据内码的映射表，后续数据更新均通过映射表中的ID进行匹配更新；新增的数据会在K/3Cloud中创建并返回内码记录到映射表中。数据同步成功和失败均在s-HR和K/3Cloud同时记录日志，s-HR可由管理员通过【开发平台—>集成配置—>K/3Cloud集成同步日志】进行查看，每次同步均会新增日志记录。薪酬的同步日志，可在【开发平台—>集成配置—>K/3Cloud集成同步日志】和【费用分配信息（K/3Cloud）】的“查看同步日志”中查看同步结果。s-HR同步日志有权限的用户进入【开发平台—>集成配置—>K/3Cloud集成同步日志】查看，每次同步都会新增一条日志记录。同步失败的数据，可以批量选择重新同步，同步后会以最新的同步结果更新Cloud的数据，并生成最新的日志。17/28金蝶s-HR与K/3Cloud集成应用指南K/3Cloud集成同步日志K/3Cloud由同步用户针对具体的s-HR基础资料分别查看同步日志，功能路径：【部门/岗位/员工/员工任岗】的【s-HR同步】→【s-HR同步日志】菜单；s-HR同步日志记录同步的类型、编码、名称、同步时间以及失败原因；映射关系表记录同步记录的CloudID和s-HRID。s-HR同步日志界面如下，该界面的工具栏，点击【查看映射关系】，可打开映射关系。18/28金蝶s-HR与K/3Cloud集成应用指南s-HR同步映射关系界面如下：【注意】：Cloud员工同步是按【人员】、【员工】、【员工任岗】的顺序依次同步，员工的s-HR同步日志，包括了【人员】、【员工】、【员工任岗】的同步日志内容。若【人员】同步失败，【员工】【员工任岗】都不再同步，此时同步日志只记录【人员】同步失败信息。员工的默认过滤方案，过滤掉了【人员】的日志内容，如果希望看到信息，需要把过滤条件：单据头-资料类型不等于人员详细信息（公共）去掉即可。19/28金蝶s-HR与K/3Cloud集成应用指南六、同步异常分析及处理初始化同步时，根据反馈的同步结果可直接关联查看同步日志明细，也可通过s-HR菜单【开发平台—>集成配置—>K/3Cloud集成同步日志】进入查看，同步失败的请检查失败原因，修复数据后重新同步。日常同步是由系统自动处理的，可通过监控同步日志的失败记录，及时知会相关人员进行处理；发现K/3Cloud未能同步更新的数据，也可以通过两边的日志进行分析。若有个别异常数据，或者先上Cloud后上s-HR的应用情况，可以通过K/3Cloud强制同步更新功能，客户可以根据需要自行决定是否从s-HR强行刷新数据。下表是同步过程中可能存在的问题、原因及对应的操作指引：七、应用服务器或数据库切换当需要进行应用服务器或数据库切换时，请根据以下指引选择正确的方式处理：s-HR或Cloud服务器地址切换需根据新的服务器地址调整s-HR和Cloud端的配置（包括密钥文件要重新引出引入）；s-HR或Cloud数据库切换需清空未变化的数据库中的映射表（如s-HR数据库不变，K/3Cloud切换为另一个未执行过同步的数据库，则需要清空s-HR数据库的映射表；反之若s-HR切换为另一个未执行过同步的数据库，K/3Cloud数据库不变，则需要清空K/3Cloud数据库的映射表；数据库均切换成未执行过同步的数据库，则无需处理），重新配置后再进行初始化同步。若s-HR和Cloud数据库均做过同步，需要重新以未同步状态进行初始化同步，则需要同时清空两个数据库中的映射表。初始化同步在数据库进行切换的情况下，均需要在配置完成后进行初始化同步，仅服务器地20/28金蝶s-HR与K/3Cloud集成应用指南址切换可无需处理。八、业务配置方案s-HR与cloud集成根据不同的业务场景有不同的操作步骤。场景一：先应用s-HR，后应用Cloud。操作步骤：1.CloudA进行s-HR集成配置，并启用，引出密钥文件；2.s-HR1#在Cloud集成配置中引入CloudA密钥文件，填写消息地址，点击【初始化同步】，系统进行初始化同步操作；3.后续s-HR1#的数据有异动，则系统会自动同步到CloudA。场景二：先应用Cloud，后应用s-HR。操作步骤：1.先梳理需同步的数据；主要分为两部分：一个是Cloud尚不存在，需s-HR追加同步的数据；另一个是对s-HR和Cloud双方都已存在的数据同步。对于s-HR和Cloud双方都已存在的数据：1)从业务层面决策是否需要与s-HR一致，如果保存一致是否会影响Cloud的历史数据或者工作流之类的，最终确定需双方保持一致的数据范围；2)确定同步数据的顶层、自上而下的级次顺序；3)保证同步数据在两个系统的编码相同，且编码最好都是大写或者小写；特别21/28金蝶s-HR与K/3Cloud集成应用指南是遇到编码不同名称相同的，重点检查确认是否要做同步，若需要，需要调整编码，保证两个系统编码完全一致。2.CloudB进行s-HR集成配置，并启用，引出密钥文件，然后s-HR2#在Cloud集成配置中引入CloudB密钥文件，填写消息地址；3.对于s-HR和Cloud双方都已存在数据的，且需做同步的数据：选择这些数据，在Cloud使用【强制更新s-HR数据】；【注意】：Cloud强制同步时，需要从同步数据的顶层开始，自上而下的级次顺序逐级选择记录进行操作。4.Cloud尚不存在，需s-HR追加同步的数据：s-HR2#在Cloud集成配置界面，点击【初始化同步】，系统进行初始化同步操作；5.若强制同步或者初始化同步存在不能同步的数据，需要根据同步日志检查。场景三：WEBService（旧接口）调整为WEBAPI方式（新接口）操作步骤：1.CloudC进行s-HR集成配置，并启用，引出密钥文件；系统判断存在WEBService配置，清除同步数据的原映射关系，同步数据依然在Cloud中存在；2.s-HR3#在Cloud集成配置中引入CloudC密钥文件，填写消息地址，点击【初始化同步】，系统进行初始化同步操作；【注意】：s-HR3#引入密钥文件后，不可再恢复为存在WEBService方式；3.初始化同步时，Cloud系统按照同步数据的编码完全匹配原则自行进行强制同步，并自动建立数据映射关系；4.后续s-HR3#的数据有异动，则系统会自动同步到CloudC；5.两个系统各自打上同步补丁后，WEBService方式是可以继续沿用的。场景四：多个客户的s-HR同步到Cloud公有云的对应数据中心22/28金蝶s-HR与K/3Cloud集成应用指南操作步骤：1.公有云的CloudD和E各自进行s-HR集成配置，并启用，引出密钥文件；2.客户甲s-HR4#在Cloud集成配置中引入CloudD密钥文件，填写消息地址，点击【初始化同步】，系统进行初始化同步操作；3.后续客户甲s-HR4#的数据有异动，则系统会自动同步到CloudD。4.客户乙按照步骤2和3进行同样的操作。要求：s-HR和Cloud的公有云服务器，可以相互访问，并可以做POST请求。场景五：s-HR调整同步的数据中心操作步骤：1.CloudF在s-HR集成配置执行【停用】；2.CloudF手动执行脚本清除与s-HR6#的数据映射关系，同步数据依然在CloudF存在；3.梳理s-HR7#与CloudF的同步数据对于已同步到Cloud的数据（由s-HR6#同步过去的）：1）从业务层面决策是否需要与s-HR7#一致，如果保存一致是否会影响Cloud的历史数据或者工作流之类的，最终确定需双方保持一致的数据范围；2）确定同步数据的顶层、自上而下的级次顺序；3）保证同步数据在两个系统的编码相同，且编码最好都是大写或者小写；特别是遇到编码不同名称相同的，重点检查确认是否要做同步，若需要，需要调整编码，23/28金蝶s-HR与K/3Cloud集成应用指南保证两个系统编码完全一致。4.CloudF重新启用，引出密钥文件；5.s-HR7#在Cloud集成配置中引入CloudF密钥文件，填写消息地址；针对第3步梳理的数据，在Cloud使用【强制更新s-HR数据】，然后点击【初始化同步】，系统进行初始化同步操作，确保s-HR7#后续追加数据的同步；【注意】：Cloud强制同步时，需要从同步数据的顶层开始，自上而下的级次顺序逐级选择记录进行操作。6.后续s-HR7#的数据有异动，则系统会自动同步到CloudF。场景六：Cloud调整同步的数据中心操作步骤：1.s-HR8#手动执行脚本清除与CloudG的数据映射关系；2.CloudH进行s-HR集成配置，并启用，引出密钥文件；3.s-HR8#在Cloud集成配置中引入CloudH密钥文件，填写消息地址，点击【初始化同步】，系统进行初始化同步操作；4.后续s-HR8#的数据有异动，则系统会自动同步到CloudH。场景七：Cloud调整同步的用户24/28金蝶s-HR与K/3Cloud集成应用指南操作步骤：1.CloudL在s-HR集成配置执行【停用】，修改用户为“李四”，点击【重置密钥】，重新引出密钥文件；2.s-HR11#在Cloud集成配置中重新引入CloudL的新密钥文件，点击【初始化同步】；3.后续s-HR11#的数据有异动，则系统会自动同步到CloudL；4.Cloud站点的IP地址调整，也是重新执行步骤1和2，并且在2中修改消息地址。场景八：s-HR修改K/3Cloud业务组织编码（建议不改）业务场景：s-HR的组织同步后（含HR组织下的岗位以及员工），发现【K/3Cloud业务组织编码】填写错误，或者其他原因需要调整。若s-HR组织的K/3Cloud所属业务组织发生变化，系统不进行同步推送。需要采用人工方案进行变更，具体下面文档：25/28金蝶s-HR与K/3Cloud集成应用指南九、老客户升级使用原集成接口进行同步的客户安装补丁后将仍继续使用老的集成接口进行同步。若要启用新的接口进行同步，需要同时在s-HR和K/3Cloud参照新的同步接口进行配置后重新初始化同步。启用新接口是不可逆的操作，一旦启用新接口，则不支持再按旧的同步方式进行同步。请保证配置前K/3Cloud已更新到所需的补丁，并已进行了s-HR和K/3Cloud相关功能验证。使用旧接口改为新接口，在【开发平台—>集成配置—>K/3Cloud集成配置】中，点击【初始化同步】时，会自动根据编码匹配进行组织、岗位、员工及薪酬项目的同步更新（类似Cloud强制同步），写入同步日志并生成映射关系，请保证相对应数据的编码一致；同时更新为已启用新接口，不支持重复初始化同步。对于组织、岗位、员工，若第一次初始化同步出现数据同步失败，再次进行初始化同步时，不再认为是旧接口改新接口同步，将不会自动根据编码匹配进行同步更新，需要在Cloud选择数据进行强制更新。Cloud强制同步时，首先根据业务确定同步数据范围及同步级次（主要是有上级关系的基础资料，例如：部门、岗位等）。强制同步会针对所选记录按照编码完全匹配原则，以s-HR内容强行覆盖Cloud对应内容，需要业务分析，确保强制同步后不影响Cloud的后续业务，例如：工作流、业务单据的引用等。建议按s-HR层级进行分层分组，确保将上级先同步再同步下级，避免由于上级未同步成功，而导致强制同步失败。具体操作说明，请参考第八章的场景三。新接口中员工的同步字段做了精简，去掉了出生日期、证件号码、照片、办公电话这四个字段的同步，因为Cloud没有这些字段的业务应用。【注意】：1、打补丁后继续使用旧接口的需重点关注：对于旧接口转为新接口，在安装了补丁，未启用新接口的情况下，s-HR提交财务到Cloud，由于Cloud薪资的字符转换不了，造成薪资数据无法同步。解决办法：因为新接口会更加稳定，且体验方面会好很多，且老接口已存在问题（例如26/28金蝶s-HR与K/3Cloud集成应用指南s-HRID大小写敏感），难以修复，所以建议客户启用并使用新接口即可。若短时间内没有办法采用新接口，请采用下面给出的变通解决方案：旧转新老接口薪资同步变通解决方案.docx。【特别注意】：如果按照变通方案解决了问题，过一段时间客户希望改成新接口，一定要按照【变通方案】里改新接口的步骤操作一下，然后再配置集成同步。十、注意事项1.s-HR组织的【K/3Cloud业务组织编码】必须维护且录入准确，且要求录入的编码在Cloud存在，否则会导致s-HR数据无法同步。2.同步字段暂不支持自定义配置。3.s-HR员工的初始化导入不会触发自动同步，请在初始化同步之前，确保已完成s-HR员工的初始化导入，或者在s-HR员工初始化导入之后，再通过集成配置的初始化同步进行触发。4.Cloud数据中心反注册后，再重新注册，需重新引出密钥并在s-HR集成配置中引入。5.s-HR基础资料（部门、岗位、员工、任岗）同步到Cloud后，建议不要再修改基础资料名称，否则会有相关影响。1）部门、岗位、员工、任岗基础资料在s-HR中变更是按时间轴展示的，Cloud是没有时间轴的处理，所以业务单据都是显示基础资料的最新名称，通过ID处理的，这样会导致历史数据按照也改为最新名称显示，与之前本身名称不一致。2）注意在做修改时，必须考虑后面系统的历史数据；若是做了修改又不能接受历史数据的改变，直接将名称修改回去即可。6.K/3Cloud与s-HR是不同的系统，校验规则及字段长度要求会有差异，而K/3Cloud作为数据的接收方，数据同步将遵循Cloud的校验规则。请参考下表：名称s-HRK/3Cloud解决方案27/28金蝶s-HR与K/3Cloud集成应用指南总体部门、岗位、员工大小写是否敏感区分数据库：Oracle默认大小写敏感，SQLServer敏感参与同步的数据（组织、职位、员工）编码大小写敏感s-HR的基础资料编码维护时，需要含字母的全部使用大写或者小写，不要都使用例如：s-HR维护岗位的编码时，使用A001、B001或者a001、b001，不要同时使用A001、a001。部门组织保存：1、同一创建组织下，名称允许重复；2、名称可以包括特殊字符“/”部门保存：1、同一创建组织下，名称不能重复；2、名称不允许包括特殊字符“/”s-HR维护组织单元时，1、同一创建组织下不要存在同名的组织单元；2、组织名称避免包含“/”、“{”、引号等特殊字符。组织修改：同步数据可以修改组织单元名称。同步数据在Cloud不能修改，但是部门被业务单据引用，s-HR修改名称后会导致历史数据的名称同步改动。已经同步的组织单元不要修改名称，除非保证同步数据在Cloud没有做业务单据。岗位岗位保存：同一组织单元下允许存在两个相同名称的岗位（历史数据），最新版本已修改为不允许相同。岗位保存：同一组织的同一部门下不能存在相同的岗位名称。针对s-HR的同名岗位数据，需要在s-HR修改名称为不一样，再进行同步。28/28