金蝶s-HR-金蝶s-HR与金蝶云星空集成配置操作手册（修正版）1(1).docx

金蝶s-HR与金蝶云星空集成应用指南金蝶软件（中国）有限公司2019年8月金蝶s-HR与金蝶云星空集成应用指南目录一、功能目标..................................................................5二、支持版本..................................................................5三、集成同步要求..............................................................6四、集成同步配置及初始化......................................................7第一步：【行政组织信息维护】：.............................................7第二步：【金蝶云星空端配置】：.............................................8第三步：【s-HR单点登录配置】：............................................10第四步：【s-HR端配置】：..................................................12第五步：【初始化同步】：..................................................13五、同步功能说明.............................................................131.基本功能...............................................................13不进行同步推送的数据说明................................................15同步禁用金蝶云星空基础数据说明..........................................162.金蝶云星空强制同步功能.................................................183.同步日志记录及映射表...................................................20六、同步异常分析及处理.......................................................22七、应用服务器或数据库切换...................................................22八、业务配置方案.............................................................23场景一：先上金蝶云星空后上s-HR............................................23场景二：先上s-HR后上金蝶云星空............................................24场景三：s-HR组织单元的业务组织编码调整（建议不改）........................25场景四：金蝶云星空调整同步的数据中心......................................25场景五：金蝶云星空调整同步的用户..........................................26场景六：金蝶云星空调整地址IP..............................................262/32金蝶s-HR与金蝶云星空集成应用指南场景七：s-HR调整同步的账套................................................27场景八：WEBService（旧接口）调整为WEBAPI方式（新接口）.................27九、老客户升级...............................................................28十、注意事项.................................................................293/32金蝶s-HR与金蝶云星空集成应用指南前言本文档是针对金蝶s-HR与金蝶云星空使用新接口集成应用的说明，包括应用环境、数据中心的支持，同步配置及同步机制说明等。4/32金蝶s-HR与金蝶云星空集成应用指南一、功能目标金蝶s-HR和金蝶云星空集成主要为支持在包含人力资源的整体ERP解决方案当中，需要同时部署金蝶云星空系统，以及相应的金蝶s-HR人力资源管理系统，可以保持组织部门、岗位、员工基础资料的统一，以及在s-HR完成薪资核算后，可以快速将薪资核算结果结转至金蝶云星空财务总账系统，并生成相应的财务费用凭证及其他相关业务凭证。最终保障整个业务系统的信息流连贯通常，及全程的自动化处理。s-HR和金蝶云星空集成新接口，改用WebAPI的同步方式，提供同步效率和稳定性。同步过程中记录同步日志和映射关系，以便在出现同步异常时，可以通过同步日志和映射关系快速查找原因，并结合业务应用，根据需要进行修复。二、版本支持金蝶s-HR（以下简称s-HR）支持V2.0版本、V8.2版本、V8.5版本（以下简称V8.5包括V8.5和V8.5SP1），金蝶云星空（以下简称星空）需要安装金蝶云星空V6.X及以上版本+最新补丁。金蝶s-HR补丁要求：金蝶s-HRV2.0必须打上：PTM102562、PT106843（前置补丁）、集成补丁PT109256、薪酬补丁PT110113；金蝶s-HRV8.2必须安装：PTM112673，参见《金蝶s-HRV8.2SP2安装部署说明》；金蝶s-HRV8.5必须安装：PTM118902，参见《金蝶s-HRV8.5安装部署说明》；金蝶s-HRV8.5SP1必须安装：PTM130958，参见《金蝶s-HRV8.5SP1版本安装部署说明》。【备注】：金蝶s-HRV8.5以上版本只同步已初始化s-HR应用的组织及其下级组织、职位和员工，不包括无职位人员；s-HRV2.0中的岗位在V8.2、V8.5、V8.5SP1中改名为职位；s-HRV2.0、V8.2中的组织在V8.5、V8.5SP1中改名为行政组织。5/32金蝶s-HR与金蝶云星空集成应用指南金蝶云星空补丁要求：金蝶云星空V6.X+最新补丁（多语言补丁除外）；金蝶云星空V7.X+最新补丁。【备注】：若需要使用s-HRV8.2的补丁，金蝶云星空必须同步打V6.X版本2017年4月20日发布的补丁（或者后续更新补丁）。金蝶s-HR与金蝶云星空集成支持版本对照表如下：序号金蝶s-HR版本金蝶云星空版本支持情况1s-HRV1.5金蝶云星空V3.0金蝶云星空V5.0若安装的是星空V3.0版本主程序，则必须要安装PT090038补丁2s-HRV2.0金蝶云星空V6.X及以上版本支持，需安装最新补丁（若安装的是V6.X，则必须打V6.X版本2017年4月20日发布的补丁，或者后续更新补丁）3s-HRV8.2金蝶云星空V6.X及以上版本支持，需安装最新补丁（若安装的是V6.X，则必须打V6.X版本2017年4月20日发布的补丁，或者后续更新补丁）4s-HRV8.5金蝶云星空V6.X及以上版本支持，需安装最新补丁（若安装的是V6.X，则必须打V6.X版本2017年4月20日发布的补丁，或者后续更新补丁）三、集成同步要求仅支持s-HR一个数据中心到金蝶云星空一个数据中心进行单向集成同步，不支持一对多或多对一的数据中心集成同步，也不支持同一应用服务器下挂多个数据中心分别同步。【重要】：s-HR的基础数据编码是大小写敏感的，不区分数据库；金蝶云星空区分数据库，Oracle默认大小写敏感，SQLServer默认大小写不敏感（可配置）。若金蝶云星空使用的是SQLServer数据库，请配置为大小写敏感或注意在s-HR中维护数据时编码统一使用大写或小写，不要出现字符相同仅大小写不一致的编码的数据，否则可能因与金蝶云星空编码重复导致同步失败。6/32金蝶s-HR与金蝶云星空集成应用指南四、集成同步配置及初始化第一步：【行政组织信息维护】：s-HR的组织数据要与金蝶云星空集成同步，需要指定该行政组织对应金蝶云星空业务组织，请在同步之前维护完整（所有需要同步的行政组织都需要配置）：【备注】：“金蝶云星空业务组织编码”字段非常重要，同步前需确保该字段配置正确，否则若配置错误且已经同步成功，后面再修改将无法同步更新，需要通过特殊方式处理（参考第八章：场景三）。在行政组织信息form视图上增加zipCode字段配置（可设置为必录避免未输入值导致同步失败），如下图：<fieldname="zipCode"label="金蝶云星空业务组织编码"required='true'placeholder="请在初次设置时确保正确，避免修改"></field>7/32金蝶s-HR与金蝶云星空集成应用指南设置行政组织上的“金蝶云星空业务组织编码”值为金蝶云星空要对应的组织机构编码，可单个设置也可通过调整组织导入模板新增该字段（对应导入模板“邮编”字段，选择后改显示名称，建议设置必录）后，通过行政组织的【更新导入】批量导入该值；若金蝶云星空是单组织模式，也可以在初始化时使用语句批量在后台更新为统一值100。参考：updatet_org_adminsetfzipcode='100'updatet_org_adminhissetfzipcode='100'updateT_ORG_OUPartAdminsetfzipcode='100'第二步：【金蝶云星空端配置】：Administrator登录金蝶云星空数据中心，进入菜单【公共设置】→【s-HR集成】→【s-HR集成配置】，按下图流程操作：8/32金蝶s-HR与金蝶云星空集成应用指南1.选择具有金蝶云星空部门、岗位、员工、任岗操作权限的用户，该用户将作为s-HR同步更新金蝶云星空数据的用户；2.在s-HR接口地址配置金蝶s-HR应用服务器地址和端口，按示例直接替换s-HR的服务器地址和端口号即可；3.点击【启用】，启用s-HR集成配置；4.点击【引出密钥文件】，引出密钥文件，注意引出文件名称不要修改；若后面修改了用户、修改s-HR接口地址或者重置密钥，需要重新引出密钥文件，并在s-HR系统的集成配置中引入，引入方法见【s-HR端配置】描述。【备注】：在设置的金蝶云星空用户名和密码时，请务必保障此用户有金蝶云星空内的部门、岗位、员工、员工任岗四个基础资料的所有权限。同时，确认部门、岗位两个基础资料的基础资料控制策略中，在相应的业务组织内可以创建此基础资料；同时，对于此用户及密码请勿修改。若有任何修改，需重新引出密钥文件并在s-HR端进行引入。因此，建议自行创建一个特殊的用户，作为同步用户；启用WEBAPI集成方式后，不能恢复使用WEBService的集成方式。9/32金蝶s-HR与金蝶云星空集成应用指南第三步：【s-HR单点登录配置】单点登录配置支持配置文件修改和可视化界面配置两种方式。其中，配置文件修改方式s-HRV2.0、s-HRV8.2和s-HRV8.5版本均支持；可视化配置方式仅支持s-HRV8.2SP2（安装s-HR基础平台最新补丁）、s-HRV8.5SP1版本。可视化配置方式（目前仅支持V8.2SP2及V8.5SP1）1、单点登录配置及白名单配置（1）管理员登录s-HR的网页版->系统设置->单点登录配置，参考下图设置，修改后保存。【备注】：V8.5SP1单点登录界面比V8.2SP2多了webservice勾选框，见下图，可以根据现场情况而定需要调用第三方WebService可以勾上，不需要可以不勾选，其余地方和V8.2SP2保持一致。10/32金蝶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.5版本，除了配置上面内容，还需配置下面内容：【V8.2版本】、【V8.5版本】默认监听配置集群部署的需要每个实例下的这个文件都需要增加1、修改安装目录\eas\server\profiles\server1\config\listenerconfig.data文件增加以下信息<listenername="com.kingdee.eas.hr.service.app.listener.HRModifyServerListener"enable="true"failOnError="false"/>2、修改配置文件后需要重启服务器。【V8.2版本】、【V8.5版本】启用跨域POST请求以及添加到白名单11/32金蝶s-HR与金蝶云星空集成应用指南s-HR8.2及以上版本或Apusic9及以上版本服务器的环境，安全策略有调整，默认禁用了跨站post请求，需要增加白名单（存在多个实例的情况下，每个实例都需要配置），如下：打开安装目录\apusic\domains\server1\config\web.xml文件，将初始化参数serverNameWhiteList的值设置为第三方系统的服务名称。以金蝶云星空系统(http://172.17.1.215/k3cloud/)中打开s-HR为例，需修改如下配置：另外还需要修改配置，如下：安装目录\apusic\domains\server1\config\web.xml文件，将初始化参数enableCSRFCheck_POST的值需要改为false，重启服务器后生效。第四步：【s-HR端配置】：administrator登录s-HR，进入菜单“开发平台->集成配置->金蝶云星空集成配置”，如下图：12/32金蝶s-HR与金蝶云星空集成应用指南1、在“消息接口服务地址”中配置所要集成的金蝶云星空应用服务器地址；2、引入从金蝶云星空引出的密钥文件，方法见【金蝶云星空端配置】描述；3、勾选需要启用的基础资料和薪酬发放结果同步集成接口后保存；4、点击【测试连接】，确认配置信息正确、网络正常。【备注】：若集成配置界面中的“启用基础资料同步集成接口”启用后取消勾选，则系统不再进行行政组织、职位、员工数据的自动同步，但不影响金蝶云星空手动发起的同步指令（即：金蝶云星空强制同步，见第五章第2节描述）。若“启用薪资发放结果同步集成接口”启用后需手动同步数据，取消勾选后，则系统不再允许同步数据。第五步：【初始化同步】：请完成以上配置后，再进行初始化同步。行政组织、职位、员工1.请在“开发平台->集成配置->金蝶云星空集成配置”界面，点击初始化同步（同步前请确保组织信息维护已完成）；2.同步完成后检查同步结果（同步结果参见第五章第3节同步日志记录及映射表的描述）。【备注】：初始化同步时，若金蝶云星空是空的数据中心，s-HR会以新增方式同步数据，后续会根据数据的ID进行匹配同步更新；若金蝶云星空当前组织下已有数据，需要确保相同组织s-HR和金蝶云星空的编码相同，通过金蝶云星空强制同步功能处理（即：金蝶云星空强制13/32金蝶s-HR与金蝶云星空集成应用指南同步，见第五章第2节描述）后，再将仅在s-HR中存在的组织进行初始化同步。初始化同步会按照基础资料顺序的级次顺序同步（部门->职位->员工，上级在前），强制同步亦然；强制同步前需确保选择的基础资料依赖的上一级次数据及上级已同步，即需要从同步数据的顶层开始，自上而下的级次顺序逐级选择记录进行操作，不可全选进行同步。初始化同步不对已经封存的组织、已禁用的岗位（禁用岗位下的员工）及已离职的员工（员工用工关系状态上的用户状态为禁用）进行同步。薪酬数据薪酬部分不需要初始化。五、同步功能说明1.基本功能集成同步配置完成并执行初始化同步后，后续系统将会自动同步更新组织、岗位、员工。在s-HR系统中组织岗位数据的更新，以及员工管理中对员工信息的更新及员工变动等都会触发数据同步至金蝶云星空。s-HR系统内进行行政组织的新增、修改、变更、封存、删除、批量组织架构调整。这些业务操作后，系统都会向金蝶云星空系统内自动同步。特别地，s-HR系统内行政组织封存、删除，金蝶云星空自动置为禁用，这可能影响金蝶云星空相关的行政组织架构部门的财务、供应链、制造等相关的业务，需谨慎处理。s-HR系统内进行岗位的新增、修改、变更、封存、删除、批量组织架构调整造成的岗位变更，系统都会向金蝶云星空系统内自动同步。特别地，s-HR系统岗位封存、删除，金蝶云星空自动置为禁用，这可能影响金蝶云星空相关的行政岗位的财务、供应链、制造等相关的业务及汇报关系，需谨慎处理。s-HR系统内进行员工的入职新增、员工信息的修改、员工信息的变更、调动事务、兼职事务、员工离职、删除、批量组织架构调整造成的员工岗位变更。这些业务操作后，系统都会向金蝶云星空系统内自动同步，同步时，HR员工数据分别会写入金蝶云星空基础资料中【人员】、【员工】、【员工任岗】三个基础资料对象中。前者记录的是企业员工的清单明细，后者为具体员工任岗关系的明细。特别地，s-HR系统内管理的企业员工更新、14/32金蝶s-HR与金蝶云星空集成应用指南转正、调动、离职、删除等，在金蝶云星空内可能自动置为禁用，这可能影响员工相关的财务、供应链、制造等相关的业务及供应链业务员的设置，以及工作流的应用，需谨慎处理。组织、岗位、员工数据更新机制及字段对应关系，请参考下面Excel的描述：组织、岗位、员工数据同步s-HR操作更新金蝶云星空数据说明如下：s-HR与金蝶云星空集成字段同步说明如下：若有同步失败的数据，可以在s-HR的日志里边重新同步（参见本章第3节），或者通过金蝶云星空的强制同步功能更新（参见本章第2节）。薪资数据同步在s-HR端【金蝶云星空集成配置】中启用薪资发放结果数据同步接口。通过【薪酬核算->薪酬核算->费用分配信息（金蝶云星空）】中的“同步薪酬项目”进行薪酬项目的同步，每期次的薪酬数据通过“提交财务”功能提交到金蝶云星空。手工同步操作后，会在s-HR和金蝶云星空中记录同步日志表和数据映射表。“同步薪酬项目”：只同步s-HR启用状态的薪酬项目，未同步的薪酬项目进行新增同步，已经同步的薪酬项目进行更新同步，如果是同步后s-HR删除或禁用了的项目，则不同步。“提交财务”：【费用分配信息（金蝶云星空）】列表中查询核算状态为“已审批”的计算规则，需要点击对应的计算规则，维护“总账业务组织编码、总账业务组织名称”（据此判断数据推到那个财务组织下，非常重要，如果弄错，只能提单联系金蝶云星空研发同事支持），提交财务时，需要录入“财务日期”（根据此日期找到金蝶云星空对应的会计期间）。提交前，先判断以下两个条件，不满足则提示，满足则同步。15/32金蝶s-HR与金蝶云星空集成应用指南计算规则的薪酬项目是否已经同步到金蝶云星空该期次的薪酬发放数据是否已经生成成本分摊若同一个计算规则同一个期次的成本分摊数据多次“提交财务”，则会判断对应的金蝶云星空薪资单是否已经生成凭证，如果已经生成凭证，则不允许同步，且不允许再生成成本分摊，以保证成本分摊的数据、薪酬发放的数据、同步到金蝶云星空的数据三者一致。如果要更新同步，必须先删除凭证，才能重新生成成本分摊和“提交财务”；如果未生成凭证，则允许更新同步，更新同步时，薪资单的内码不变，薪资单中单据体明细数据先删除，再新增本次的同步的数据。同一计算规则不同期次或不同计算规则“提交财务”均为新增同步。金蝶云星空中同步薪资发放界面默认不提供查看界面，只有在会计智能平台才可以选择；如果需要显示，可以通过BOS集成平台进行相应操作。薪资发放结果是部门级别，不涉及到个人级别，主要进行费用成本凭证的处理。例如：借：生产成本、管理费用、销售费用贷：应付工资1.1不进行同步推送的数据说明部分数据因关键数据不完整、关联的上级或前置基础资料未同步成功，将不会往金蝶云星空同步这些数据，这些数据的失败日志将写入s-HR和金蝶云星空的错误日志：同步组织：金蝶云星空业务组织为空的，失败原因为：“金蝶云星空业务组织编码为空，不进行同步推送”；同步组织：上级组织在映射表中不存在的（即上级组织未新增同步成功的），失败原因为：“上级组织【编码+名称】未同步成功，不进行同步推送”；同步组织：组织同步成功后又修改了金蝶云星空业务组织，更新的数据不进行同步，失败原因为：“组织**的金蝶云星空所属业务组织发生变化，不进行同步推送!需要采用人工方案进行变更，具体可参考指南！”（具体请参考第八章，场景八）；同步岗位：所属组织在映射表中不存在（即组织未新增同步成功的）的，失败原因为：“所属组织【编码+名称】未同步成功，不进行同步推送”；上级岗位在映射表中不存在（即上级岗位未新增同步成功的）的，失败原因为：“该岗位的上级岗位【编码+名称】未同步成功，不进行同步推送”；同步岗位：岗位同步成功后对应组织的金蝶云星空业务组织发生变化，更新的数16/32金蝶s-HR与金蝶云星空集成应用指南据不进行同步，失败原因为：“组织**的金蝶云星空所属业务组织发生变化，不进行同步推送!需要采用人工方案进行变更，具体可参考指南！”（具体请参考第八章，场景八）；同步员工：员工任职职位在映射表中不存在（即岗位未新增同步成功的）的，失败原因为：“任职职位【编码+名称】未同步成功，不进行同步推送”；同步员工任岗：员工的兼职任职岗位未同步成功，或岗位对应的金蝶云星空业务组织为空或组织同步后金蝶云星空业务组织发生变化，不进行同步推送，提示信息为：“该员工的所属组织为【编码+名称】，所属岗位为【编码+名称】的兼职任职，不进行同步推送！可能原因：1、该兼职的组织未同步2、该兼职的岗位未同步3、该兼职的组织的金蝶云星空所属业务组织为空或者发生变化，请检查！”；同步薪酬发放数据：只同步成本分摊了的数据，且员工如果没有同步成功，则该员工对应的薪酬成本分摊数据不会同步到金蝶云星空。1.2同步禁用金蝶云星空基础数据说明组织：s-HR组织删除和封存时，同步到金蝶云星空禁用对应部门；岗位：s-HR岗位删除和禁用时，同步到金蝶云星空禁用对应岗位；员工s-HR员工同步到金蝶云星空是否禁用该员工，根据员工当前用工关系状态上的用户状态设置进行判断。若用户状态为禁用，则同步至金蝶云星空禁用员工和所有任岗。如：员工离职后用工关系状态变为辞职（用工关系状态为“辞职”的基础数据上的用户状态为禁用），同步至金蝶云星空后该员工变为禁用状态。请根据需要设置对应用工关系状态上的用户状态，如下图：17/32金蝶s-HR与金蝶云星空集成应用指南员工任岗当s-HR员工变动所用的变动操作对应的事务类别为“离职”，则会根据变动操作配置终止员工任职，同步至金蝶云星空后员工对应的这些任职也相应会被禁用，如下图：【备注】：组织、岗位、员工、员工任岗在金蝶云星空同步禁用，将可能影响到相关的金蝶云星空业务，涉及：工作流/审批流、业务单据/基础资料/凭证等引用，若有特殊需要，请做好业务协调，在s-HR更新操作前，确保走完金蝶云星空业务或者不会影响到金蝶云星空业务。2.金蝶云星空强制同步功能18/32金蝶s-HR与金蝶云星空集成应用指南通过金蝶云星空强制更新同步功能，可以让客户自行决定是否从s-HR强行刷新数据，以免对历史数据产生影响。比如：金蝶云星空已存在员工0010张三（金蝶云星空手工新增），使用金蝶云星空岗位（业务员，上级是业务组长）进行审批流业务处理，且流程没有结束，s-HR上线后，维护员工0010张三的岗位（业务员，上级是部门经理），岗位上存在差异，如果自动同步则会造成金蝶云星空的审批流提交不正确。提供强制更新，可以让客户自行选择是否按照s-HR的员工0010张三的数据强行覆盖金蝶云星空同一编码0010张三的数据。金蝶云星空强制同步时，金蝶云星空与s-HR相同编码的数据（组织、岗位、员工），按照s-HR的数据内容进行同步覆盖，强制更新后，会返回同步结果信息，并在s-HR和金蝶云星空中记录同步日志和映射关系表，具体请参考本章第3节描述。【备注】：强制同步会针对所选记录按照编码完全匹配原则，以s-HR内容强行覆盖金蝶云星空对应内容，强制同步后可能会影响金蝶云星空的业务，例如：工作流、业务单据的引用等，需谨慎处理；若确实需要同步，请确保相同数据的编码一致；强制同步时，建议按s-HR组织及岗位层次进行分层分组，确保将上级先同步再同步下级或者所选数据同时包含上级，避免由于上级未同步成功，而导致同步失败；金蝶云星空选择员工任岗强制同步时，会将s-HR当前员工所有岗位信息同步覆盖金蝶云星空对应数据，任岗信息只在金蝶云星空记录映射关系；金蝶云星空进行强制同步时，当前登录用户要有s-HR基础资料的强制更新s-HR数据的权限；强制同步时，将仅从s-HR单点登录所配置的数据中心进行同步，并且该s-HR数据中心的集成配置中引入的是当前金蝶云星空数据中心的密钥文件。金蝶云星空强制同步入口，如下图：19/32金蝶s-HR与金蝶云星空集成应用指南对于员工，HR员工数据分别对应金蝶云星空基础资料中【人员】、【员工】、【员工任岗】三个基础资料对象中，金蝶云星空强制同步时，每1条员工强制更新，会同步更新3条数据（人员、员工、员工任岗），且这3条数据的编码一致，如下图所示：对于部门和岗位，s-HR的组织对应金蝶云星空的部门，s-HR的岗位对应金蝶云星空的岗位，金蝶云星空强制同步时，每1条部门或岗位强制更新，金蝶云星空同步更新1条对应数据。20/32金蝶s-HR与金蝶云星空集成应用指南3.同步日志记录及映射表在金蝶云星空和s-HR系统均可以查看同步数据的同步日志和映射关系表。通过同步日志可以直观查看同步失败的原因，便于分析原因，通过映射关系的查看可以溯源。初始化同步时，系统根据s-HR中的基础数据（组织、职位、员工）编码与金蝶云星空中的对应基础数据（部门、岗位、员工/人员）编码进行匹配，生成对应数据内码的映射表，后续数据更新均通过映射表中的ID进行匹配更新；新增的数据会在金蝶云星空中创建并返回内码记录到映射表中。数据同步成功和失败均在s-HR和金蝶云星空同时记录日志，s-HR可由管理员通过【开发平台-集成配置-金蝶云星空集成同步日志】进行查看，每次同步均会新增日志记录。薪酬的同步日志，可在【开发平台-集成配置-金蝶云星空集成同步日志】和【费用分配信息（金蝶云星空）】的“查看同步日志”中查看同步结果。s-HR同步日志有权限的用户进入【开发平台->集成配置->金蝶云星空集成同步日志】查看，每次同步都会新增一条日志记录。同步失败的数据，可以批量选择重新同步，同步后会以最新的同步结果更新金蝶云星空的数据，并生成最新的日志，如下图：金蝶云星空集成同步日志金蝶云星空由同步用户针对具体的s-HR基础资料分别查看同步日志，功能路径：【部门/岗位/员工/员工任岗】的【s-HR同步】->【s-HR同步日志】菜单；s-HR同步日志记录同步的类型、编码、名称、同步时间以及失败原因；映射关系表记录同步记录的金蝶云星空ID和s-HRID，如下图：21/32金蝶s-HR与金蝶云星空集成应用指南s-HR同步日志界面如下，该界面的工具栏，点击【查看映射关系】，可打开映射关系。s-HR同步映射关系界面如下：【备注】：金蝶云星空员工同步是按【人员】、【员工】、【员工任岗】的顺序依次同步，员工的s-HR同步日志，包括了【人员】、【员工】、【员工任岗】的同步日志内容。若【人员】同步失败，【员工】【员工任岗】都不再同步，此时同步日志只记录【人员】同步失败信息。22/32金蝶s-HR与金蝶云星空集成应用指南员工的默认过滤方案，过滤掉了【人员】的日志内容，如果希望看到信息，需要把过滤条件：单据头-资料类型不等于人员详细信息（公共）去掉即可，如下图：六、同步异常分析及处理初始化同步时，根据反馈的同步结果可直接关联查看同步日志明细，也可通过s-HR菜单“开发平台-集成配置-金蝶云星空集成同步日志”进入查看，同步失败的请检查失败原因，修复数据后重新同步。日常同步是由系统自动处理的，可通过监控同步日志的失败记录，及时知会相关人员进行处理；发现金蝶云星空未能同步更新的数据，也可以通过两边的日志进行分析。若有个别异常数据，或者先上金蝶云星空后上s-HR的应用情况，可以通过金蝶云星空强制同步更新功能，客户可以根据需要自行决定是否从s-HR强行刷新数据。七、应用服务器或数据库切换当需要进行应用服务器或数据库切换时，请根据以下指引选择正确的方式处理：s-HR或金蝶云星空服务器地址切换：需根据新的服务器地址调整s-HR和金蝶云星空端的配置（包括密钥文件需要重新引出引入）；s-HR或金蝶云星空数据库切换：23/32金蝶s-HR与金蝶云星空集成应用指南需清空未变化的数据库中的映射表（如s-HR数据库不变，金蝶云星空切换为另一个未执行过同步的数据库，则需要清空s-HR数据库的映射表；反之若s-HR切换为另一个未执行过同步的数据库，金蝶云星空数据库不变，则需要清空金蝶云星空数据库的映射表；数据库均切换成未执行过同步的数据库，则无需处理），重新配置后再进行初始化同步；若s-HR和金蝶云星空数据库均做过同步，需要重新以未同步状态进行初始化同步，则需要同时清空两个数据库中的映射表初始化同步：当数据库进行切换的情况下均需要在配置完成后进行初始化同步，仅服务器地址切换可无需处理。八、业务配置方案s-HR集成根据不同的业务场景有不同的操作步骤。【场景一】：先实施金蝶云星空，后实施金蝶s-HR【场景一】需区分下面两种情况：金蝶云星空的历史数据不再使用1、修改金蝶云星空历史数据的编码，避免与s-HR重复；【建议】：在编码增加前缀或者后缀标识（例如：_old）2、在金蝶云星空对历史数据进行【禁用】操作；3、s-HR按照实际情况维护数据；4、s-HR和金蝶云星空各自完成集成配置；5、s-HR执行【同步】，完成初始化同步。金蝶云星空的历史数据需要继续使用，但是要与s-HR保持一致1、金蝶云星空修改编码与s-HR一致；（尽量不要遗漏数据）；（例如：金蝶云星空历史存在001采购部，需要修改编码为201805001。）24/32金蝶s-HR与金蝶云星空集成应用指南2、s-HR按照实际情况维护数据；3、s-HR和金蝶云星空各自完成集成配置，不要点击【同步】；4、在金蝶云星空过滤与s-HR一致的数据，全选的情况下，进行【强制同步s-HR数据】（部门需自上而下选择，再进行强制同步）；5、在s-HR执行【同步】，完成初始化同步；操作步骤：1.先梳理需同步的数据主要分为两部分，一个是金蝶云星空尚不存在，需s-HR追加同步的数据，一个是对s-HR和金蝶云星空双方都已存在的数据同步。对于s-HR和金蝶云星空双方都已存在的数据：1)从业务层面决策是否需要与s-HR一致，如果保存一致是否会影响金蝶云星空的历史数据或者工作流之类的，最终确定需双方保持一致的数据范围；2)确定同步数据的顶层、自上而下的级次顺序；3)保证同步数据在两个系统的编码相同，且编码最好都是大写或者小写；特别是遇到编码不同名称相同的，重点检查确认是否要做同步，若需要，需要调整编码，保证两个系统编码完全一致。2.金蝶云星空A进行s-HR集成配置，并启用，引出密钥文件，然后s-HR1#在金蝶云星空集成配置中引入金蝶云星空A密钥文件，填写消息地址；3.对于s-HR和金蝶云星空双方都已存在的，且需做同步的数据：选择这些数据，在金蝶云星空使用【强制更新s-HR数据】，【注意】：金蝶云星空强制同步时，需要从同步数据的顶层开始，自上而下的级次顺序逐级选择记录进行操作。4.金蝶云星空尚不存在，需s-HR追加同步的数据：s-HR1#在金蝶云星空集成配置界面，点击【初始化同步】，系统进行初始化同步操作；5.若强制同步或者初始化同步存在不能同步的数据，需要根据同步日志检查。【场景二】：先实施s-HR，后实施金蝶云星空25/32金蝶s-HR与金蝶云星空集成应用指南1、金蝶云星空B进行s-HR集成配置，并启用，引出密钥文件；2、s-HR2#在金蝶云星空集成配置中引入金蝶云星空B密钥文件，填写消息地址，点击【同步】，系统进行初始化同步操作；3、后续s-HR2#的数据有异动，则系统会自动同步到金蝶云星空B。【场景三】：s-HR组织单元的业务组织编码调整（建议不改）业务场景：s-HR的组织同步后（含HR组织下的岗位以及员工），发现【金蝶云星空业务组织编码】填写错误，或者其他原因需要调整。若s-HR组织的金蝶云星空所属业务组织发生变化，系统不进行同步推送!需要采用人工方案进行变更，具体下面文档：【场景四】：金蝶云星空调整同步的数据中心操作步骤：1、s-HR4#手动执行脚本清除与金蝶云星空G的数据映射关系（向s-HR产品获取）；3、金蝶云星空H进行s-HR集成配置，并启用，引出密钥文件；4、s-HR4#在金蝶云星空集成配置中引入金蝶云星空H密钥文件，填写消息地址，点击【同步】，系统进行初始化同步操作；5、后续s-HR4#的数据有异动，则系统会自动同步到金蝶云星空H。26/32金蝶s-HR与金蝶云星空集成应用指南【场景五】：金蝶云星空调整同步的用户操作步骤：1、金蝶云星空L在s-HR集成配置执行【停用】，修改用户为“李四”，点击【重置密钥】，重新引出密钥文件；2、s-HR5#在金蝶云星空集成配置中重新引入金蝶云星空L的新密钥文件后，点击【同步】；3、后续s-HR5#的数据有异动，则系统会自动同步到金蝶云星空L。4、金蝶云星空站点的IP地址调整，也是重新执行步骤1和2，并且在2中修改消息地址。【场景六】：金蝶云星空调整地址IP操作步骤：1、金蝶云星空C在s-HR集成配置执行【停用】，点击【重置密钥】，重新引出密钥文件；2、s-HR11#在金蝶云星空集成配置中重新引入金蝶云星空C的新密钥文件，消息地址填上金蝶云星空的新IP地址，然后点击【同步】；3、后续s-HR11#的数据有异动，则系统会自动同步到金蝶云星空C。27/32金蝶s-HR与金蝶云星空集成应用指南【场景七】：s-HR调整同步的账套操作步骤：1、梳理s-HR7#与金蝶云星空F的同步数据，对于已同步到金蝶云星空的数据重点梳理（主要从s-HR6#同步过去的数据）；1）从业务层面决策是否需要与s-HR7#一致，如果保存一致是否会影响金蝶云星空的历史数据或者工作流之类的，最终确定需双方保持一致的数据范围；2）确定同步数据的顶层、自上而下的级次顺序；3）保证同步数据在两个系统的编码相同，且编码最好都是大写或小写；特别是编码不同名称相同的，重点检查确认是否要同步，若是则需要调整编码，保证两个系统编码完全一致。2、金蝶云星空F在s-HR集成配置执行【停用】；3、金蝶云星空F手动执行脚本清除与s-HR6#的数据映射关系（金蝶云星空提供脚本），同步数据依然在金蝶云星空F存在；4、金蝶云星空F重新启用，引出密钥文件；5、s-HR7#在金蝶云星空集成配置中引入金蝶云星空F密钥文件，填写消息地址，1）针对第1步梳理的数据，在金蝶云星空使用【强制更新s-HR数据】；【备注】：金蝶云星空强制同步时，需要从同步数据的顶层开始，自上而下的级次顺序逐级选择记录进行操作；2）点击【初始化同步】，进行初始化同步操作，确保s-HR7#后续追加数据的同步；6、后续s-HR7#的数据有异动，则系统会自动同步到金蝶云星空F。28/32金蝶s-HR与金蝶云星空集成应用指南【场景八】：WEBService（旧接口）调整为WEBAPI方式（新接口）操作步骤：1.金蝶云星空L进行s-HR集成配置，并启用，引出密钥文件；系统判断存在WEBService配置，清除同步数据的原映射关系，同步数据依然在金蝶云星空存在；2.s-HR8#在金蝶...