金蝶s-HR-金蝶s-HRCloudV8.6.1.2与金蝶云星空集成配置操作手册.doc

s-HRV8.6.1.2与金蝶云星空集成配置操作手册s-HRCloudV8.6.1.2与金蝶云星空集成配置操作手册【免责声明】：本文档仅用于学习使用，未经授权，禁止转载。本文档中所涉及的数据均为虚构的模拟数据，不代表任何一家企业的真实情况，如有权利人认为其中的任何内容存在侵权情况，请反馈给金蝶官方邮箱（DataSubjectRequest@kingdee.com），我们将在7个工作日内处理。金蝶软件（中国）有限公司2022年6月目录前言..........................................................................5一、功能目标....................................................................6二、版本支持....................................................................61s-HRV8.6.1.2与金蝶云星空集成配置操作手册三、集成同步要求................................................................7四、集成同步配置及初始化........................................................7第一步：【行政组织信息维护】..................................................7第二步：【金蝶云星空端配置】..................................................9第三步：【S-HR单点登录配置】.................................................10第四步：【S-HR端配置】.......................................................13第五步：【初始化同步】.......................................................14五、组织人事集成同步功能说明...................................................141.基本功能...................................................................141.1不进行同步推送的数据说明..............................................161.2同步禁用金蝶云星空基础数据说明........................................162.金蝶云星空强制同步功能.....................................................183.同步日志记录及映射表.......................................................204.业务配置方案...............................................................22【场景一】：先实施金蝶云星空，后实施金蝶s-HR...............................22【场景二】：先实施s-HR，后实施金蝶云星空...................................23【场景三】：s-HR组织单元的业务组织编码调整（建议不改）.....................24【场景四】：金蝶云星空调整同步的数据中心...................................24【场景五】：金蝶云星空调整同步的用户.......................................25【场景六】：金蝶云星空调整地址IP...........................................25【场景七】：s-HR调整同步的账套.............................................26【场景八】：WEBService（旧接口）调整为WEBAPI方式（新接口）..............275.同步异常分析及处理.........................................................27六、薪酬业务集成配置及功能说明.................................................281.财务凭证集成.............................................................281.1集成配置说明............................................................281.1.1金蝶s-HR端配置.....................................................281.1.1.1【费用分摊设置】................................................281.1.1.2【计算规则配置】................................................291.1.1.3【同步薪酬项目】................................................301.1.1.4【币别映射关系设置】（可选）....................................311.1.2金蝶云星空端配置....................................................321.1.2.1【检查同步数据】...............................................321.1.2.2【配置凭证模板】................................................351.2凭证集成功能说明........................................................371.2.1提交财务前s-HR处理.................................................371.2.1.1【薪酬数据准备】................................................372s-HRV8.6.1.2与金蝶云星空集成配置操作手册1.2.1.2【维护总账业务组织】............................................381.2.2提交财务............................................................391.2.2.1第一步：核算数据已审批..........................................391.2.2.2第二步：总账业务组织维护正确....................................391.2.2.3第三步：选择财务日期............................................391.2.2.4第四步：参数勾选................................................401.2.2.5第五步：提交前检查..............................................411.2.2.6第六步：查看同步日志............................................411.2.3财务生成凭证........................................................411.2.3.1第一步：凭证生成................................................411.2.3.2第二步：凭证生成情况查询........................................421.3常见问题分析及处理......................................................431、提交财务报错..........................................................432、同步薪酬项目失败......................................................443、点击反审核提示失败....................................................452银行代发单集成...........................................................452.1集成配置说明............................................................452.1.1金蝶s-HR端配置.....................................................452.1.1.1【设置编码规则】................................................452.1.1.2【员工银行信息维护】............................................452.1.1.3【计算规则配置】................................................462.1.1.4【薪资发放币别设置】（可选）....................................462.1.1.5【代发单生成规则方案】（可选）..................................472.1.1.6【币别映射关系设置】（可选）....................................482.1.2金蝶云星空端配置....................................................492.2代发单集成功能说明......................................................502.2.1生成s-HR代发单.....................................................502.2.1.1【生成发放金额】................................................502.2.1.2【生成s-HR代发单】.............................................512.2.1.3【付款失败处理（s-HR）】........................................512.2.2查看s-HR代发单.....................................................522.2.2.1第一步：检查数据................................................522.2.2.2第二步：维护付款公司............................................522.2.2.3第三步：查看同步日志............................................532.2.2.4第四步：获取状态................................................542.2.3出纳银行付款.......................................................542.2.3.1【查看付款单数据】..............................................543s-HRV8.6.1.2与金蝶云星空集成配置操作手册2.2.3.2【银行付款操作】................................................552.2.3.3【付款失败处理（金蝶云星空）】..................................562.3代发单业务配置方案......................................................56【场景一】：已实施部署了金蝶云星空集成配置，组织人事数据已同步...........56【场景二】：首次集成，未实施部署金蝶云星空集成配置.......................572.4注意事项...............................................................57七、应用服务器或数据库切换.....................................................57八、老客户升级.................................................................58九、注意事项...................................................................59前言本文档是针对金蝶s-HR与金蝶云星空使用新接口集成应用的说明，包括应用环境、数据中心的支持，同步配置及同步机制说明等；还针对组织人事数据（组织、岗位、员工等）、薪酬业务数据（财务凭证、银行代发单）同步金蝶云星空的方法与步骤进行介绍。4s-HRV8.6.1.2与金蝶云星空集成配置操作手册一、功能目标金蝶s-HR和金蝶云星空集成主要为支持在包含人力资源的整体ERP解决方案当中，需要同时部署金蝶云星空系统，以及相应的金蝶s-HR人力资源管理系统，可以保持组织部门、岗位、员工基础资料的统一，以及s-HR薪资数据同步至金蝶云星空财务系统，进行财务凭证和付款单业务处理。最终保障整个业务系统的信息流连贯通常，及全程的自动化处理。s-HR和金蝶云星空集成新接口，改用WebAPI的同步方式，提供同步效率和稳定性。同步过程中记录同步日志和映射关系，以便在出现同步异常时，可以通过同步日志和映射关系快速查找原因，并结合业务应用，根据需要进行修复。二、版本支持金蝶s-HR（以下简称s-HR）支持s-HRV2.0、s-HRV8.2（含SP1及SP2）、V8.5版本（含SP1）、s-HRCloud、s-HRCloudV8.6SP1、s-HRCloud2021H1、s-HRCloudV8.6.1.2版本，金蝶云星空（以下简称云星空）需要安装金蝶云星空V6.X、V7.X及以上版本+最新补丁。具体s-HR与云星空各版本的支持情况参见《金蝶s-HR与金蝶云星空集成支持版本对照表》。s-HR补丁要求：金蝶s-HRV2.0必须安装：PT106843（前置补丁）、集成补丁PT109256、薪酬补丁PT110113；【备注】：s-HRV8.5以上版本只同步已初始化s-HR应用的组织及其下级组织、职位和员工，不包括无职位人员；金蝶s-HRV2.0中的岗位在s-HRV8.2及以上版本中更名为职位；金蝶s-HRV2.0、s-HRV8.2中的组织在s-HRV8.5、s-HRV8.5SP1、s-HRCloud、s-HRCloudV8.6SP1、s-HRCloud2021H1、s-HRCloudV8.6.1.2版本中改名为行政组织。5s-HRV8.6.1.2与金蝶云星空集成配置操作手册金蝶云星空补丁要求：云星空V6.X+最新补丁（多语言补丁除外）；云星空V7.X+最新补丁；云星空V8.0+最新补丁；说明：s-HRCloudV8.6.1.2版本（仅此版本）支持与【星空付款单】集成银行代发功能金蝶云星空补丁要求：云星空V8.0+最新补丁。若金蝶云星空为企业版，需要部署补丁PT-146915；若是标准版则部署补丁PT-146914。金蝶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（含SP1及SP2）云星空V6.X及以上版本支持，需安装最新补丁（若安装的是V6.X，则必须打V6.X版本2017年4月20日发布的补丁，或者后续更新补丁）4s-HRV8.5（含V8.5SP1）云星空V6.X及以上版本支持，需安装最新补丁（若安装的是V6.X，则必须打V6.X版本2017年4月20日发布的补丁，或者后续更新补丁）5s-HRCloud云星空V7.3仅支持云星空V7.36s-HRCloudV8.6SP1云星空V7.5目前仅支持云星空V7.57s-HRCloud2021H1云星空V7.6目前仅支持云星空V7.68s-HRCloudV8.6.1.2云星空V8.0目前仅支持云星空V8.0三、集成同步要求仅支持从s-HR一个数据中心到金蝶云星空一个数据中心进行单向集成同步，不支持一对多或多对一的数据中心集成同步，也不支持同一应用服务器下挂多个数据中心分别同步。【重要】：s-HR的基础数据编码是大小写敏感的，不区分数据库；金蝶云星空区分数据库，Oracle默认大小写敏感，SQLServer默认大小写不敏感（可配置）。若金蝶云星空使用的是SQLServer数据库，请配置为大小写敏感或注意在s-HR中维护数据时编码统一使用大写或小写，不要出现字符相同仅大小写不一致的编码的数据，否则可能因与金蝶云星空编码重复导致同步失败。6s-HRV8.6.1.2与金蝶云星空集成配置操作手册四、集成同步配置及初始化第一步：【行政组织信息维护】s-HR的组织数据要与金蝶云星空集成同步，需要指定该行政组织对应金蝶云星空业务组织，请在同步之前维护完整（所有需要同步的行政组织都需要配置）；【备注】:“金蝶云星空业务组织编码”字段非常重要，同步前需确保该字段配置正确，否则若配置错误且已经同步成功，后面再修改将无法同步更新，需要通过特殊方式处理（参考第五章第4节：【场景三】）。在行政组织信息form视图上增加zipCode字段配置（可设置为必录避免未输入值导致同步失败），如下图：<fieldname="zipCode"label="金蝶云星空业务组织编码"required='true'placeholder="请在初次设置时确保正确，避免修改"></field>7s-HRV8.6.1.2与金蝶云星空集成配置操作手册设置行政组织上的“金蝶云星空业务组织编码”值为金蝶云星空要对应的组织机构编码，可单个设置也可通过调整组织导入模板新增该字段后，通过行政组织的【更新导入】批量导入该值（注意使用导入时，需要将组织上所有值的信息填写完整，否则会将已有字段的值清空）；若金蝶云星空是单组织模式，也可以在初始化时使用语句批量在后台更新为统一值100。参考：updatet_org_adminsetfzipcode='100'updatet_org_adminhissetfzipcode='100'updateT_ORG_OUPartAdminsetfzipcode='100'第二步：【金蝶云星空端配置】Administrator登录云星空数据中心，进入菜单【公共设置】→【s-HR集成】→【s-HR集成配置】，按下图流程操作：8s-HRV8.6.1.2与金蝶云星空集成配置操作手册1.选择具有云星空部门、岗位、员工、任岗操作权限的用户，该用户将作为s-HR同步更新金蝶云星空数据的用户；2.在s-HR接口地址配置s-HR应用服务器地址和端口，按示例直接替换s-HR的服务器地址和端口号即可；3.点击【启用】，启用s-HR集成配置；4.点击【引出密钥文件】，引出密钥文件，注意引出文件名称不要修改；若后面修改了用户、修改s-HR接口地址或者重置密钥，需要重新引出密钥文件，并在s-HR系统的集成配置中引入，引入方法见【s-HR端配置】描述。【备注】：9s-HRV8.6.1.2与金蝶云星空集成配置操作手册在设置的云星空用户名和密码时，请务必保障此用户有金蝶云星空内的部门、岗位、员工、员工任岗四个基础资料的所有权限。同时，确认部门、岗位两个基础资料的基础资料控制策略中，在相应的业务组织内可以创建此基础资料；同时，对于此用户及密码请勿修改。若有任何修改，需重新引出密钥文件并在s-HR端进行引入。因此，建议自行创建一个特殊的用户，作为同步用户；启用WEBAPI集成方式后，不能恢复使用WEBService的集成方式。第三步：【s-HR单点登录配置】单点登录配置支持配置文件修改和可视化界面配置两种方式。其中，配置文件修改方式适用于金蝶s-HRV2.0、s-HRV8.2和s-HRV8.5版本；可视化配置方式适用于s-HRV8.2SP2（安装s-HR基础平台最新补丁）、s-HRV8.5SP1、s-HRCloud、s-HRCloudV8.6SP1、s-HRCloud2021H1、s-HRCloudV8.6.1.2版本。配置文件修改方式——如已配置，请检查：(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-HRV2.0此处仅需配置上面内容即可，s-HRV8.2、s-HRV8.5版本，除了配置上面内容，还需配置下面内容：V8.2（含SP1）、V8.5默认监听配置集群部署的需要每个实例下的这个文件都需要增加1、修改安装目录\eas\server\profiles\server1\config\listenerconfig.data文件增加以下信息<listenername="com.kingdee.eas.hr.service.app.listener.HRModifyServerListener"enable="true"failOnError="false"/>2、修改配置文件后需要重启服务器。启用跨域POST请求以及添加到白名单因安全控制要求，s-HRV8.2及以上版本需要增加白名单，方法有两种：修改文件配置方式（必选：s-HRV8.2、s-HRV8.2SP1、s-HRV8.5）修改配置文件的方法如下：（存在多个实例的情况下，每个实例都需要配置）打开安装目录\apusic\domains\server1\config\web.xml文件，将初始化参数serverNameWhiteList的值设置为第三方系统的服务名称。以金蝶云星空系统(http://172.17.1.215/k3cloud/)中打开s-HR为例，需修改如下配置：10s-HRV8.6.1.2与金蝶云星空集成配置操作手册另外还需要修改配置，如下：（必选：s-HRV8.2及以上版本）安装目录\apusic\domains\server1\config\web.xml文件，将初始化参数enableCSRFCheck_POST的值需要改为false，重启服务器后生效。可视化配置方式（目前仅支持V8.2SP2、V8.5SP1、s-HRCloud、s-HRCloudV8.6SP1、s-HRCloud2021H1、s-HRCloudV8.6.1.2）1、单点登录配置及白名单配置（1）管理员登录s-HR的网页版->系统设置->单点登录配置，参考下图设置，修改后保存。【备注】：V8.5SP1、s-HRCloud、s-HRCloudV8.6SP1、s-HRCloud2021H1、s-HRCloudV8.6.1.2单点登录界面比V8.2SP2多了webservice勾选框，见下图，可以根据现场情况而定需要调用第三方WebService可以勾上，不需要可以不勾选，其余地方和V8.2SP2保持一致。11s-HRV8.6.1.2与金蝶云星空集成配置操作手册第四步：【s-HR端配置】administrator登录s-HR，进入菜单“开发平台->集成配置->金蝶云星空集成配置”，如下图：1、在“消息接口服务地址”中配置所要集成的金蝶云星空应用服务器地址；2、引入从金蝶云星空引出的密钥文件，方法见【金蝶云星空端配置】描述；3、勾选需要启用的基础资料和薪酬发放结果同步集成接口后保存；4、点击【测试连接】，确认配置信息正确、网络正常。【备注】：若集成配置界面中的“启用基础资料同步集成接口”启用后取消勾选，则系统不再进行行政组织、职位、员工数据的自动同步，但不影响金蝶云星空手动发起的同步指令（即：金12s-HRV8.6.1.2与金蝶云星空集成配置操作手册蝶云星空强制同步，见第五章第2节描述）。若“启用薪资发放结果同步集成接口”启用后需手动同步数据，取消勾选后，则系统不再允许同步数据。第五步：【初始化同步】请完成以上配置后，再进行初始化同步。行政组织、职位、员工1.请在“开发平台->集成配置->金蝶云星空集成配置”界面，点击初始化同步（同步前请确保组织信息维护已完成）；2.同步完成后检查同步结果（同步结果参见第五章第3节同步日志记录及映射表的描述）。【备注】：初始化同步时，若金蝶云星空是空的数据中心，s-HR会以新增方式同步数据，后续会根据数据的ID进行匹配同步更新；若金蝶云星空当前组织下已有数据，需要确保相同组织s-HR和金蝶云星空的编码相同，通过金蝶云星空强制同步功能处理（即：金蝶云星空强制同步，见第五章第2节描述）后，再将仅在s-HR中存在的组织进行初始化同步。初始化同步会按照基础资料顺序的级次顺序同步（部门->职位->员工，上级在前），强制同步亦然；强制同步前需确保选择的基础资料依赖的上一级次数据及上级已同步或同时选择进行同步。初始化同步不对已经封存的组织、已禁用的岗位（禁用岗位下的员工）及已离职的员工（员工用工关系状态上的用户状态为禁用）进行同步。薪酬数据薪酬部分不需要初始化。具体请参考第六章节。五、组织人事集成同步功能说明1.基本功能集成同步配置完成并执行初始化同步后，后续系统将会自动同步更新组织、岗位、员工。在s-HR系统中组织岗位数据的更新，以及员工管理中对员工信息的更新及员工变动等都会触发数据同步至金蝶云星空。s-HR系统内进行行政组织的新增、修改、变更、封存、删除、批量组织架构调整。这些业务操作后，系统都会向金蝶云星空系统内自动同步。特别地，s-HR系统内行政组织封存、删除，金蝶云星空自动置为禁用，这可能影响金蝶云星空相关的行政组织架构部门的财务、供应链、制造等相关的业务，需谨慎处理。s-HR系统内进行岗位的新增、修改、变更、封存、删除、批量组织架构调整造成的岗位变更，系统都会向金蝶云星空系统内自动同步。特别地，s-HR系统岗位封存、删除，金蝶云星空自动置为禁用，这可能影响金蝶云星空相关的行政岗位的财务、供应链、制造等相关的业务及汇报关系，需谨慎处理。13s-HRV8.6.1.2与金蝶云星空集成配置操作手册s-HR系统内进行员工的入职新增、员工信息的修改、员工信息的变更、调动事务、兼职事务、员工离职、删除、批量组织架构调整造成的员工岗位变更。这些业务操作后，系统都会向金蝶云星空系统内自动同步，同步时，HR员工数据分别会写入金蝶云星空基础资料中【人员】、【员工】、【员工任岗】三个基础资料对象中。前者记录的是企业员工的清单明细，后者为具体员工任岗关系的明细。特别地，s-HR系统内管理的企业员工更新、转正、调动、离职、删除等，在金蝶云星空内可能自动置为禁用，这可能影响员工相关的财务、供应链、制造等相关的业务及供应链业务员的设置，以及工作流的应用，需谨慎处理。组织、岗位、员工数据更新机制及字段对应关系，请参考下面Excel的描述：组织、岗位、员工数据同步（标准预置）s-HR操作更新金蝶云星空数据说明如下：s-HR与金蝶云星空集成字段同步标准预置说明如下：若有同步失败的数据，可以在s-HR的日志里边重新同步（参见本章第3节），或者通过金蝶云星空的强制同步功能更新（参见本章第2节）。组织、岗位、员工数据增加自定义字段进行集成同步s-HRCloud2021H1版本（需安装集成补丁PT16200）和s-HRCloudV8.6.1.2，支持行政组织、职位、员工基本信息、银行卡实体上的自定义字段同步至金蝶云星空；配置说明如下：薪资数据同步薪酬数据同步详情请参考本文档第六章节。1.1不进行同步推送的数据说明部分数据因关键数据不完整、关联的上级或前置基础资料未同步成功，将不会往金蝶云星空同步这些数据，这些数据的失败日志将写入s-HR和金蝶云星空的错误日志：同步组织：金蝶云星空业务组织为空的，失败原因为：“金蝶云星空业务组织编码为空，不进行同步推送”；同步组织：上级组织在映射表中不存在的（即上级组织未新增同步成功的），失败原因为：“上级组织【编码+名称】未同步成功，不进行同步推送”；同步组织：组织同步成功后又修改了金蝶云星空业务组织，更新的数据不进行同步，失14s-HRV8.6.1.2与金蝶云星空集成配置操作手册败原因为：“组织**的金蝶云星空所属业务组织发生变化，不进行同步推送!需要采用人工方案进行变更，具体可参考指南！”（具体请参考第八章，场景八）；同步岗位：所属组织在映射表中不存在（即组织未新增同步成功的）的，失败原因为：“所属组织【编码+名称】未同步成功，不进行同步推送”；上级岗位在映射表中不存在（即上级岗位未新增同步成功的）的，失败原因为：“该岗位的上级岗位【编码+名称】未同步成功，不进行同步推送”；同步岗位：岗位同步成功后对应组织的金蝶云星空业务组织发生变化，更新的数据不进行同步，失败原因为：“组织**的金蝶云星空所属业务组织发生变化，不进行同步推送!需要采用人工方案进行变更，具体可参考指南！”（具体请参考第八章，场景八）；同步员工：员工任职职位在映射表中不存在（即岗位未新增同步成功的）的，失败原因为：“任职职位【编码+名称】未同步成功，不进行同步推送”；同步员工任岗：员工的兼职任职岗位未同步成功，或岗位对应的金蝶云星空业务组织为空或组织同步后金蝶云星空业务组织发生变化，不进行同步推送，提示信息为：“该员工的所属组织为【编码+名称】，所属岗位为【编码+名称】的兼职任职，不进行同步推送！可能原因：1、该兼职的组织未同步2、该兼职的岗位未同步3、该兼职的组织的金蝶云星空所属业务组织为空或者发生变化，请检查！”；同步薪酬发放数据：只同步成本分摊了的数据，且员工如果没有同步成功，则该员工对应的薪酬成本分摊数据不会同步到金蝶云星空。1.2同步禁用金蝶云星空基础数据说明组织：s-HR组织删除和封存时，同步到金蝶云星空禁用对应部门；岗位：s-HR岗位删除和禁用时，同步到金蝶云星空禁用对应岗位；员工s-HR员工同步到云星空是否禁用该员工，根据员工当前用工关系状态上的用户状态设置进行判断。若用户状态为禁用，则同步至云星空禁用员工和所有任岗。如：员工离职后用工关系状态变为辞职（用工关系状态为“辞职”的基础数据上的用户状态为禁用），同步至云星空后该员工变为禁用状态。请根据需要设置对应用工关系状态上的用户状态，如下图：15s-HRV8.6.1.2与金蝶云星空集成配置操作手册员工任岗当s-HR员工变动所用的变动操作对应的事务类别为“离职”，则会根据变动操作配置终止员工任职，同步至云星空后员工对应的这些任职也相应会被禁用，如下图：【备注】：组织、岗位、员工、员工任岗在金蝶云星空同步禁用，将可能影响到相关的金蝶云星空业务，涉及：工作流/审批流、业务单据/基础资料/凭证等引用，若有特殊需要，请做好业务协调，在s-HR更新操作前，确保走完金蝶云星空业务或者不会影响到金蝶云星空业务。2.金蝶云星空强制同步功能通过云星空强制更新同步功能，可以让客户自行决定是否从s-HR强行刷新数据，以免对历史数据产生影响。16s-HRV8.6.1.2与金蝶云星空集成配置操作手册比如：云星空已存在员工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数据中心的集成配置中引入的是当前云星空数据中心的密钥文件。云星空强制同步入口，如下图：17s-HRV8.6.1.2与金蝶云星空集成配置操作手册对于员工，HR员工数据分别对应金蝶云星空基础资料中【人员】、【员工】、【员工任岗】三个基础资料对象中，金蝶云星空强制同步时，每1条员工强制更新，会同步更新3条数据（人员、员工、员工任岗），且这3条数据的编码一致，如下图所示：对于部门和岗位，s-HR的组织对应金蝶云星空的部门，s-HR的岗位（或职位）对应金蝶云星空的岗位，金蝶云星空强制同步时，每1条部门或岗位强制更新，金蝶云星空同步更新1条对应数据。3.同步日志记录及映射表在云星空和s-HR系统均可以查看同步数据的同步日志和映射关系表。通过同步日志可以直观查看同步失败的原因，便于分析原因，通过映射关系的查看可以溯源。初始化同步时，系统根据s-HR中的基础数据（组织、职位、员工）编码与云星空中的对应基础数据（部门、岗位、员工/人员）编码进行匹配，生成对应数据内码的映射表，后续数据更新均通过映射表中的ID进行匹配更新；新增的数据会在金蝶云星空中创建并返回内码记录到映射表中。数据同步成功和失败均在s-HR和金蝶云星空同时记录日志，s-HR可由管理员通过【开发平台-集成配置-金蝶云星空集成同步日志】进行查看，每次同步均会新增日志记录。薪酬的同步日志，可在【开发平台-集成配置-金蝶云星空集成同步日志】和【费用分配信息（金蝶云星空）】的“查看同步日志”中查看同步结果。s-HR同步日志有权限的用户进入【开发平台->集成配置->金蝶云星空集成同步日志】查看，每次同步都会新增一条日志记录。同步失败的数据，可以批量选择重新同步，同步后会以最新的同步结果更新金蝶云星空的数据，并生成最新的日志，如下图：18s-HRV8.6.1.2与金蝶云星空集成配置操作手册金蝶云星空集成同步日志金蝶云星空由同步用户针对具体的s-HR基础资料分别查看同步日志，功能路径：【部门/岗位/员工/员工任岗】的【s-HR同步】->【s-HR同步日志】菜单；s-HR同步日志记录同步的类型、编码、名称、同步时间以及失败原因；映射关系表记录同步记录的金蝶云星空ID和s-HRID，如下图：s-HR同步日志界面如下，该界面的工具栏，点击【查看映射关系】，可打开映射关系。s-HR同步映射关系界面如下：19s-HRV8.6.1.2与金蝶云星空集成配置操作手册【备注】：金蝶云星空员工同步是按【人员】、【员工】、【员工任岗】的顺序依次同步，员工的s-HR同步日志，包括了【人员】、【员工】、【员工任岗】的同步日志内容。若【人员】同步失败，【员工】【员工任岗】都不再同步，此时同步日志只记录【人员】同步失败信息。员工的默认过滤方案，过滤掉了【人员】的日志内容，如果希望看到信息，需要把过滤条件：单据头-资料类型不等于人员详细信息（公共）去掉即可，如下图：4.业务配置方案s-HR集成根据不同的业务场景有不同的操作步骤。【场景一】：先实施金蝶云星空，后实施金蝶s-HR【场景一】需区分下面两种情况：金蝶云星空的历史数据不再使用1、修改金蝶云星空历史数据的编码，避免与s-HR重复；【建议】：在编码增加前缀或者后缀标识（例如：_old）2、在金蝶云星空对历史数据进行【禁用】操作；3、s-HR按照实际情况维护数据；20s-HRV8.6.1.2与金蝶云星空集成配置操作手册4、s-HR和金蝶云星空各自完成集成配置；5、s-HR执行【同步】，完成初始化同步。金蝶云星空的历史数据需要继续使用，但是要与s-HR保持一致1、金蝶云星空修改编码与s-HR一致；（尽量不要遗漏数据）；（例如：金蝶云星空历史存在001采购部，需要修改编码为201805001。）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.若强制同步或者初始化同步存在不能同步的数据，需要根据同步日志检查。21s-HRV8.6.1.2与金蝶云星空集成配置操作手册【场景二】：先实施s-HR，后实施金蝶云星空1、金蝶云星空B进行s-HR集成配置，并启用，引出密钥文件；2、s-HR2#在金蝶云星空集成配置中引入金蝶云星空B密钥文件，填写消息地址，点击【同步】，系统进行初始化同步操作；3、后续s-HR2#的数据有异动，则系统会自动同步到金蝶云星空B。【场景三】：s-HR组织单元的业务组织编码调整（建议不改）业务场景：s-HR的组织同步后（含HR组织下的岗位以及员工），发现【金蝶云星空业务组织编码】填写错误，或者其他原因需要调整。若s-HR组织的金蝶云星空所属业务组织发生变化，系统不进行...