金蝶s-HRCloud配置数据迁移使用指南金蝶s-HRCloudV8.8及以上版本_配置数据迁移使用指南云金蝶中国HR云产品部领域s-HRCloud应用核心平台金蝶软件（中国）有限公司2023年10月前言第1页/共19页金蝶s-HRCloud配置数据迁移使用指南概述本手册主要介绍金蝶s-HRCloudV8.8及以上版本，系统初始化期间，针对配置类数据通过工具进行迁移的使用指南。读者对象本手册适用于金蝶s-HRCloudV8.8及以上版本的客户。约定1、请在产品实施期间使用该工具迁移配置项数据；2、请确保两边环境的版本号一致；3、迁移期间无业务人员操作使用系统；4、迁移期间，禁止两边环境同时对配置项进行配置操作，如果两边同时配置数据，可能会导致配置项数据导入目标环境后，覆盖目标环境配置项数据。第2页/共19页金蝶s-HRCloud配置数据迁移使用指南目录1.概述..............................................................................41.1.工具介绍..........................................................................................................................................41.2.运行环境介绍..................................................................................................................................41.3.基本概念（术语）..........................................................................................................................51.4.约束说明..........................................................................................................................................61.5.联系我们..........................................................................................................................................61.6.动态与公告......................................................................................................................................61.6.1.s-HRCloudV8.8版本................................................................................................61.6.2.s-HRCloudV8.8SP1版本........................................................................................72.应用..............................................................................72.1.操作说明..........................................................................................................................................72.2.常见问题..........................................................................................................................................82.2.1.查询配置导入失败.......................................................................................................82.3.应用场景........................................................................................................................................102.3.1.初始化迁移VS独立迁移某项...................................................................................102.3.2.基础配置项说明........................................................................................................102.3.3.基础资料迁移说明*...................................................................................................122.3.4.人事配置项说明........................................................................................................122.3.5.薪酬配置项说明........................................................................................................132.3.6.考勤配置项说明........................................................................................................17第3页/共19页②机密信息严禁泄露1.概述1.1.工具介绍系统实施运维期间，将源环境的配置项迁移到目标环境中，系统提供工具处理，在源环境中选择配置项需要迁移的配置数据导出脚本，再到目标环境导入脚本，实现快速迁移，可以通过一体化配置数据迁移工具执行迁移，也支持到具体配置项中进行单独导出导入脚本迁移，如OSF、视图、权限项等具体功能菜单下操作…1.2.运行环境介绍s-HRCloudV8.8及以上版本客户端支持的软硬件环境说明如下：环境类型具体配置硬件环境ARM：鲲鹏、飞腾MIPS：龙芯X86：Intel、AMD、海光操作系统Windows7、10、11Linux:Ubuntu20.01、22.04银河麒麟V10统信UOSV20macOS10.10.3及以上（EASCA不支持macOS）浏览器IE11及以上（新工作台不支持包括管理者分析、员工自助、我的工作台、任务管理页面，包括“数据集配置”、“页面配置”设计器，以及设计器设计的页面都不支持通过IE浏览器访问）ChromeV88.0及以上Edge83及以上Safari10及以上奇安信V14/19②机密信息严禁泄露二代身份证读卡器的支持：对于华视CVR-100UC型号，不限客户端操作系统，但浏览器仅支持IE；关于中控智慧ID200型号，客户端只支持windows系统，不限浏览器类型，浏览器版本按以上要求(s-HRV8.5以及上版本推荐中控智慧ID200)。客户端JDKOracle1.8系统部署详细说明参考：《金蝶EASCloudV8.8系统部署方案》https://pan.yunzhijia.com/index#/preview/file?ftype=2&skey=NTI5NTg0MTU3NDgzODk2ODMyLGQ1ZjEzYzRlY2M2MGQxNWEyZWM1OWRhMzc0MWU1YTM4&isAppData=0&fromModule=21.3.基本概念（术语）属于说明术语说明配置项指系统中属于配置类的项，用户使用系统前需要配置好的各类配置项，如基础资料、OSF、视图、考勤项目、薪酬项目等，非用户操作产生的业务数据表关系配置（多表导出需配置，单表可不配置）主实体：表关系配置中第一行的主实体必须和表头配置的主实体保持一致，由第二行开始主实体必须是前面行出现过的实体（主实体或者关联实体）。主表名：主实体对应的表名，填写主实体后自动带出主表关联字段：主实体和关联实体相关联的字段（一般为FID）关联实体：主实体中连接属性对应的关联实体（关系类型为Composition）关联表名：关联实体对应的表名，填写关联实体后自动带出关联表字段：关联实体和主实体关联的字段序号：序号为数值由小到大映射配置（非必须配置）实体：实体必须是表关系中出现过的主实体或者关联实体表名：实体对应的表名，填写实体后自动带出表字段：实体和映射实体关联的字段映射实体：实体中连接属性对应的关联实体（关系类型为Association）映射表：映射实体对应的表名，填写映射实体后自动带出映射字段：映射实体中和实体关联的字段（一般为FID）匹配条件字段：映射实体中能唯一确定一条数据的字段，可以选多个，不能选FID5/19②机密信息严禁泄露匹配失败处理策略：导入时通过匹配条件字段无法找到数据时的处理策略1.抛出异常，给出提示信息并阻断导入。2.置空：将表字段值设置为空字符3.不处理：表字段值原值导入更新字段配置（非必须配置）（非必须配置，配置的实体数据导入时如果存在就更新，不存在就新增，表关系中未配置的其他实体数据一律采用先删后插）实体：实体必须是表关系中出现过的主实体或者关联实体表名：更新字段：需要更新的字段（一般不要选择FID）过滤字段：实体中能唯一确定一条数据的字段，可以选多个，不能选FID1.4.约束说明场景使用说明是否支持新购买上线前1、请确保要迁移配置项测试环境与目标环境的“版本号一致”“配置迁移项一致”、“表名和字段名一致”，仅限配置类数据通过脚本迁移；2、客户配置迁移服务操作期间，生产环境不产生真实业务数据；是低版本升级上线前1、请确保要迁移配置项测试环境与目标环境的“版本号一致”“配置迁移项一致”、“表名和字段名一致”，仅限配置类数据通过脚本迁移；2、客户配置迁移服务操作验证期间，生产环境不产生真实业务数据。是使用期间业务验证1、客户使用期间禁止操作：即源环境和目标环境禁止客户真实业务数据操作期间使用迁移，迁移操作前请先确保客户停止使用，迁移完成后及时验证2、源环境和目标环境禁止同时修订配置项，再操作导出导入，会造成导入后覆盖目标环境数据。否特殊场景测试环境与目标环境的“版本号不一致”“配置迁移项不一致”、“表名和字段名不一致”无法使用。否业务数据迁移，不支持，仅限配置类迁移。否1.5.联系我们有疑问请联系手册编写者：武晨曦13510427167（云之家同号）1.6.动态与公告1.V8.8版本开始支持配置数据迁移工具6/19②机密信息严禁泄露1.6.1.s-HRCloudV8.8版本发布日期：2023年3月更新内容：新增配置数据迁移工具，提供迁移配置项：结构配置、查询配置、视图、页面查询方案、页面设置方案、菜单、权限项、公共基础数据、考勤基础数据、导入模板、声明协议、脱敏字段配置、OSF、员工变动操作配置、员工单据配置、人事事务单据字段映射配置、薪酬核算公式配置（包含薪酬信息集数据）、考勤信息集配置、考勤项目、班次设置。发布日期：2023/7/4更新补丁：PT170927更新内容：新增考勤公式迁移，将考勤信息集迁移入合并到考勤公式迁移1.6.2.s-HRCloudV8.8SP1版本发布日期：2023年11月更新内容：新增配置项考勤公式配置、考勤制度迁移、假期制度迁移、提报方案分类、提报方案配置迁移、申报要素、申报要素分类、申报周期。2.应用2.1.操作说明第一步：源环境、目标环境备份环境、数据库，通知客户停止使用，确保业务数据不产生差异；（必须）第二步：源环境中与目标环境将关键的信息更新一致，如业务组织、行政组织、其他业务配置关联的必须项，确保两边环境的必须关联项id一致；（必须）第三步：登录GUI端先导入DEP方案；（非必须）第四步：通过【配置数据迁移】导出“查询配置”、“结构配置”，导出前请先看配置项后面的“说明”，再依次将基础配置项：视图、公共基础资料&其他业务基础资料（基础资料迁移前请重点看应用场景2.3.2.基础资料迁移）、系统级查询方案、系统级页面设置方案、OSF、导入模板、菜单、权限项、声明协议、脱敏字段配置导出脚本；（非必须，可根据实际使用，对单独配置项进行迁移，参考2.3.1.初始化迁移VS独立迁移某项）7/19②机密信息严禁泄露第五步：到目标环境通过【配置数据迁移】执行导入脚本；第六步：目标环境验证测试。建议：1、导出配置项脚本前，请查看每个配置项的“说明”内容；2、导入脚本时，工具会根据脚本中涉及的表自动备份相关表，如验证过程中出现异常或错误，可通过【配置数据迁移】—>【备份处理】选中备份表点击【一键还原】备份表。2.2.常见问题2.2.1.查询配置导入失败导入查询配置诗失败，提示如下截图提示：查询配置，T_HR_QueryConfigField表更新配置的过滤字段无法确保数据唯一性，请重新配置过滤字段或者维护数据，保证数据唯一性！产生原因：查询配置中存在重复内容，如下截图中存在可能重复项，导致脚本导入时校验数据无法确保唯一性，无法导入成功。8/19②机密信息严禁泄露处理方案：1、在“配置数据迁移”—>找到“查询配置”点击“编码”进入详情页如下图，找到“更新字段配置”对应表名下，找到“过滤字段”2、在查询分析器中执行脚本查询“过滤字段”，参考如下sql：selectcount(*),FSchemeID,fNumberfromT_HR_QueryConfigFieldgroupby9/19②机密信息严禁泄露FParentID,FFACTFIELDIDhavingcount(*)>12、修改重复项3、再进行导入操作。2.3.应用场景2.3.1.初始化迁移VS独立迁移某项如果系统处于初始化阶段，可选择“配置迁移初始化”按照初始化流程对配置项进行迁移，此流程仅作为初始化配置迁移使用参考，实际可根据具体迁移项进行独立迁移，迁移时请查看说明；针对某一配置项进行单独迁移，可以选择“配置迁移全部”单独对具体配置项进行迁移，迁移时注意查看“说明”，确保迁移过程正确。2.3.2.基础配置项说明基础业务相关配置项：配置项说明前置步骤注意事项10/19②机密信息严禁泄露结构配置基于DEP实体配置关联关系，为各业务信息集提供基础查询结构，DEP方案导入后会自动生成结构配置，一般无需单独对结构配置进行迁移，直接在查询配置中迁移脚本会自动将关联的结构配合内容一起携带到脚本中。DEP方案导入目标环境1、如果单独对结构配置中的字段进行了修订，需要单独对结构配置进行迁移2、进入结构配置中点击执行【检查】按钮查询配置定义业务信息集，引用结构配置中已经配置好的实体字段，再按业务需要进行新增、修订等处理，导入查询配置脚本，会自动将关联的结构配置一起导入。DEP方案导入目标环境1、如果单独对结构配置中的字段进行了修订，需要单独对结构配置进行迁移2、进入结构配置中点击执行【检查】按钮视图只展示扩展的视图（标准被扩展后的视图）和客制化自定义视图，标准视图两边环境都相同无需迁移，所以非扩展的标准视图不会在“选择”视图F7弹框中展示。页面查询方案1、支持视图中的“系统级页面查询”方案迁移；2、支持个人用户级页面查询方案迁移。视图已经迁移个人用户的方案必须与用户id关联，请确保目标环境中有个人用户信息，如没有用户，导入用户方案后，页面中找不到该信息，但是不影响系统正常使用，不会产生异常，只会在数据库中产生垃圾数据。页面设置方案1、支持视图中的“系统级页面设置”方案迁移；2、支持个人用户级页面设置方案迁移。视图已经迁移菜单自定义菜单迁移系统预置无需迁移，只选扩展的迁移即可权限项自定义权限项迁移菜单系统预置无需迁移，只选扩展的迁移即可公共基础数据自定义或修改的迁移参考2.3.3基础资料迁移说明系统预置无需迁移，只选扩展的迁移即可导入模板自定义或修改的迁移DEP方案、视系统预置无需迁移，只选扩展的迁移即可11/19②机密信息严禁泄露图声明协议自定义或修改的迁移视图系统预置无需迁移，只选扩展的迁移即可脱敏字段配置自定义或修改的迁移视图系统预置无需迁移，只选扩展的迁移即可OSF自定义或修改的迁移系统预置无需迁移，只选扩展的迁移即可2.3.3.基础资料迁移说明*场景迁移流程在s-HR系统中对已有基础资料（可使用、可维护中）新增或修改了基础资料值只选“基础资料”迁移即可DEP扩展新增基础资料DE迁移完成—>查询配置&结构配置迁移（非必选，如果配置了需要迁移）—>视图迁移—>对应生成的权限项迁移—>导入模板迁移—>基础资料迁移—>进入基础资料点击【启用】重新生成可维护可使用关系2.3.4.人事配置项说明人事相关配置项：配置项说明前置步骤后置相关注意事项员工变动操作配置自定义或修改的变动操作配置迁移需要先完成变动原因、变动类型、用工关系状态的迁移和映射关系的匹配请先确保本次迁移涉及到的用工关系状态、变动类型、变动原因等基础资料已完成迁移或数据映射。单据配置自定义或修改的单据配置迁移需要先完成员工变动操作的迁移或映射关系的匹配请先确保本次迁移涉及到的员工变动操作已完成迁移或数据映射。人事事务单据字段映射配置自定义的人事事务单据字段映射方案的迁移DEP方案人事事务单据字段映射配置基于人事事务单据实体，若对应单12/19②机密信息严禁泄露据有扩展字段请先将对应DEP扩展方案导入目标库后并启用，或在目标库手动完成扩展配置。2.3.5.薪酬配置项说明薪酬相关配置项：配置项说明前置步骤后置相关注意事项薪酬信息集和计算公式配置迁移内容：计算规则下薪酬项目的引用关系及设置的属性、计算公式、薪酬信息集。导出脚本适用场景：支持所有场景的脚本导出。导入脚本适用场景：仅支持目标计算规则和源计算规则的名称和编码相同的场景。导入脚本前准备：1.请确保已在目标环境创建所需的计算规则；2.请确保会使用到的薪酬项目（编码和名称与源环境的相同）、结构配置、函数、变量、临时表在目标环境中已创建或迁移。1.请确保已创建所需计算规则；2.请确保会使用到的薪酬项目、结构配置、函数、变量、临时表已创建或迁移。方式一：在配置数据迁移界面导入脚本路径：【系统设置】→【运维服务】→【配置数据迁移】方式二：在计算规则界面迁入路径：【薪酬核算】→【薪酬业务设置】→【计算规则】其他迁移场景使用：若存在目标计算规则和源计算规则名称或编码不同场景，请在“薪酬核算-薪酬业务设置-计算规则”下使用【迁入规则】功能进行迁入。2.3.5.1.薪酬信息集和计算公式迁移步骤导出薪酬信息集和计算公式脚本路径：【系统设置】→【运维服务】→【配置数据迁移】操作说明：在需迁移的源环境中：13/19②机密信息严禁泄露1)进入配置数据迁移列表；2)选择配置项【薪酬信息集和计算公式配置】；3)点击【选择导出数据】字段的【选择＋】按钮，在弹窗中选中需要导出计算公式所属的计算规则，点击确认；4)点击【导出脚本】功能按钮，在弹窗中设置导出脚本的加密密码；5)通过以上操作，需要迁移的薪酬信息集、计算规则下的薪酬项目引用关系和计算公式的脚本已导出完成。迁入前的准备工作：1)请确保已在目标环境创建所需的计算规则——需手动创建；2)请确保会使用到的薪酬项目（编码和名称需相同）——通过薪酬项目导入模板导入或手动创建；3)结构配置、函数、变量、临时表在目标环境中已创建或迁移。迁入薪酬信息集和计算公式迁入薪酬信息集和计算公式有两种方式，分别适用于不同的场景：方式一：在配置数据迁移界面导入脚本，该方式适用于目标环境和源环境中计算规则的编码和名称一一对应的场景；方式二：在计算规则界面导入，该方式使用于目标环境和源环境中计算规则的编码和名称可能不同或不是一一对应的场景。两种方式的操作方法分别如下：方式一：在配置数据迁移界面导入脚本路径：【系统设置】→【运维服务】→【配置数据迁移】操作说明：在需迁移的目标环境中做如下操作：1)进入配置数据迁移列表；2)点击【导入脚本】功能按钮，在弹窗中输入导入脚本文件的密码并确认；3)系统即会将文件中相关内容导入目标环境中，其中薪酬信息集导入薪酬信息集中，计算公式和薪酬项目引用关系及属性会导入目标环境中相同编码和名称的计算规则下。方式二：在计算规则界面迁入路径：【薪酬核算】→【薪酬业务设置】→【计算规则】操作说明：在需迁移的目标环境中做如下操作：14/19②机密信息严禁泄露1)进入计算规则列表界面；2)点击【迁移规则】按钮；3)在弹窗中点击【点击上传】按钮，上传准备好的脚本，并出入密码，点击开始解析；4)在第三步中选择是否要迁移薪酬信息集；5)在第四步中为解析出来的源计算规则设置需要导入的目标计算规则；6)设置完成后点击第五步【迁入】按钮，系统将执行迁入计算规则功能；7)迁入完成后可在第五步查看迁入情况并下载导入结果日志查看迁入详细情况；2.3.5.2.提报方案配置迁移步骤【V8.8SP1新增】导出提报方案配置脚本路径：【系统设置】→【运维服务】→【配置数据迁移】操作说明：在需迁移的源环境中：1)进入配置数据迁移列表；2)选择配置项【提报方案配置迁移】；3)点击【选择导出数据】字段的【选择＋】按钮，在弹窗中选中需要导出的提报方案，点击确认；4)点击【导出脚本】功能按钮，在弹窗中设置导出脚本的加密密码；5)通过以上操作，需要迁移的提报方案及其相关的基础资料的脚本已导出完成。迁入前的准备工作：1)确保“是否启用申报要素”、“循环方案”参数在源方案和目标方案一致，否则迁移中断；2)已完成基础资料：提报项目、提报项目分类的迁移和维护；3)若需迁移提报信息集，需先完成对应结构配置的迁移。迁入提报方案配置迁入提报方案配置两种方式，分别适用于不同的场景：方式一：在配置数据迁移界面导入脚本，该方式适用于目标环境和源环境中计算规则的编码和名称一一对应，且仅迁移提报项目和公式的场景；方式二：在计算规则界面导入，该方式使用于目标环境和源环境中计算规则的编码和名称可能不同或不是一一对应的场景，或需导入申报要素等其他资料的场景。15/19②机密信息严禁泄露两种方式的操作方法分别如下：方式一：在配置数据迁移界面导入脚本路径：【系统设置】→【运维服务】→【配置数据迁移】操作说明：在需迁移的目标环境中做如下操作：1)进入配置数据迁移列表；2)点击【导入脚本】功能按钮，在弹窗中输入导入脚本文件的密码并确认；3)系统即会将文件中提报项目和公式相关内容导入目标环境。方式二：在提报方案界面迁入路径：【薪酬核算】→【提报管理】→【提报方案】操作说明：在需迁移的目标环境中做如下操作：1)进入提报方案列表界面；2)点击【迁入方案】按钮；3)在弹窗中点击【点击上传】按钮，上传准备好的脚本，并出入密码，点击开始解析；4)在第三步中选择是否需要迁移提报信息集；5)在第四步中为解析出来的源提报方案设置需要导入的目标提报方案和相关数据及覆盖方式等；6)设置完成后点击第五步【迁入】按钮，系统将执行迁入提报方案功能；迁入完成后可在第五步查看迁入情况并下载导入结果日志查看迁入详细情况；2.3.5.3.提报方案分类、申报要素等基础资料迁移步骤【V8.8SP1新增】导出提报方案配置脚本路径：【系统设置】→【运维服务】→【配置数据迁移】操作说明：在需迁移的源环境中：1)进入配置数据迁移列表；2)选择相关配置项；3)点击【选择导出数据】字段的【选择＋】按钮，在弹窗中选中需要导出的内容，点击确认；4)点击【导出脚本】功能按钮，在弹窗中设置导出脚本的加密密码；16/19②机密信息严禁泄露迁入前的准备工作：1)如果迁移的是申报要素，则需要先迁移申报要素分类。迁入提报方案分类、申报要素等基础资料在配置数据迁移界面导入脚本路径：【系统设置】→【运维服务】→【配置数据迁移】操作说明：在需迁移的目标环境中做如下操作：1)进入配置数据迁移列表；2)点击【导入脚本】功能按钮，在弹窗中输入导入脚本文件的密码并确认；3)系统即会将文件中提报项目和公式相关内容导入目标环境。2.3.6.考勤配置项说明配置项说明前置步骤后置相关注意事项考勤项目考勤项目迁移支持新增，不支持更新。班次设置源环境对应的班次取卡规则为新建规则（非系统预置）则班次迁移到目标环境后需要手动编辑维护取卡规则请确保目标环境已创建需要的取卡规则.班次迁移后需要手动维护取卡规则考勤基础数据基础资料导入目标环境为未启用状态，需要手动启用迁移后请手动启用迁移后的基础资料考勤信息集配置1.此信息集主要提供考勤公式、报表设计使用，2.只导出新考勤信息集是是针对源环境非系统预置整体迁移17/19②机密信息严禁泄露增、修改内容，系统预置出厂内容不导出，删除内容不在导出范围，如有删除请在目标环境删除考勤公式迁移迁移内容：考勤制度下考勤项目的引用关系、考勤公式、考勤信息集。导出脚本适用场景：支持所有场景的脚本导出。导入脚本适用场景：仅支持目标考勤制度和源考勤制度的名称和编码相同的场景。导入脚本前准备：1.请确保已在目标环境创建所需的考勤制度；2.请确保会使用到的考勤项目（编码和名称与源环境的相同）、结构配置、函数、变量、临时表在目标环境中已创建或迁移。1.请确保已创建所需考勤制度；2.请确保会使用到的考勤制度、结构配置、函数、变量、临时表已创建或迁移。方式一：在配置数据迁移界面导入脚本路径：【系统设置】→【运维服务】→【配置数据迁移】方式二：在计算规则界面迁入路径：【考勤管理】→【考勤制度】→【更多】→【迁入考勤公式】其他迁移场景使用：若存在目标考勤制度和源考勤制度名称或编码不同场景，请在【考勤管理】→【考勤制度】→【更多】→【迁入考勤公式】功能进行迁入。考勤制度迁移考勤制度导入目标环境为未启用状态，需要手动启用请确保目标环境已创建需要的“工作日历”、“考勤周路径：【系统设置】→【运维服务】→【配置数据迁移】迁入新增后，考勤制度的状态都是“未启用”状态，需要到考18/19②机密信息严禁泄露期”、“加班补偿方式”迁入新增后，需要考勤制度中维护关联的“工作日历”、“考勤周期”、“加班补偿方式”基础数据勤制度列表进行启用，才能正常使用。迁入覆盖后，考勤制度的状态保持不变假期制度迁移假期制度导入目标环境为未启用状态，需要手动启用请确保目标环境已创建需要的“工作日历”“假期类型”、“额度规则”路径：【系统设置】→【运维服务】→【配置数据迁移】迁入新增后，需要考假期度中维护关联的“工作日历”“假期类型”、“额度规则”基础数据迁入后，假期制度的状迁入新增后，假期制度的状态都是“未启用”状态，需要到假期制度列表进行启用，才能正常使用。迁入覆盖后，假期制度的状态保持不变19/19
