金蝶s-HRV2.0与EAS集成指南金蝶软件（中国）有限公司2015年1月目录前言...........................................................................................................31与EAS组织人事数据集成应用......................................................................41.1集成应用准备......................................................................................................................................51.1.1环境准备......................................................................................................................................51.1.2同步前数据检查（非常重要）..................................................................................................61.1.3同步原则......................................................................................................................................61.2EASV7.5/EASV8.0与s-HRV2.0组织人事数据集成环境配置......................................................61.2.1EAS端配置（必要条件）..........................................................................................................71.2.2s-HR端配置（必要条件）.........................................................................................................71.2.3EAS同步设置（必要条件）......................................................................................................91.2.4集成模式设置（必要条件）....................................................................................................101.2.5EAS参数值调整（必要条件）................................................................................................111.2.6EAS与s-HR的集成配置验证.................................................................................................121.2.7S-HR到EAS同步常见错误....................................................................................................131.2.8初始化同步................................................................................................................................151.3数据同步应用....................................................................................................................................161.3.1组织人事基础数据同步............................................................................................................162与EAS薪酬凭证数据集成应用....................................................................172.1EASV7.5/EASV8.0与s-HRV2.0薪酬凭证数据集成环境配置....................................................172.1.1EAS端配置................................................................................................................................172.1.2s-HR端配置...............................................................................................................................172.2数据同步应用....................................................................................................................................182.2.1薪酬凭证数据同步操作............................................................................................................183与EASV8.0门户集成应用...........................................................................253.1环境部署............................................................................................................................................253.2门户配置............................................................................................................................................25前言本文档提供s-HRV2.0与EAS集成指南，包括集成环境部署、数据同步应用范围等。旨在为EAS和s-HRV2.0集成应用的客户实施提供参考和指导，仅支持人力资源及组织人事、薪酬核心数据只在s-HRV2.0中维护，同步集成到EASV7.5或EASV8.0的情况。1与EAS组织人事数据集成应用EASHR老客户迁移到s-HRV2.0后，人力资源以外的模块在EAS上应用，人力资源在s-HRV2.0上应用，需要分别搭建EASV7.5/EASV8.0和s-HRV2.0的环境，两个环境下分别使用不同的数据中心，在两个数据中心之间进行数据传递从而实现同步集成。可以支持EAS7.5/EASV8.0与s-HRV2.0的集成应用，针对不同的客户情况请参考以下表格进行处理，确保初始数据准确。EASs-HRs-HRV2.0新客户s-HRV2.0的EAS迁移客户EASV7.5/8.0新客户对于EAS新客户，请不要在EAS中初始化导入组织、岗位、员工等数据，均通过s-HR同步至EAS；如果EAS先上线实施才购买s-HR，则在s-HR中做初始数据导入时，必须与EAS中的组织、岗位、员工的编码保持一致。组织岗位员工等核心数据均在s-HR中初始化，通过初始化同步将数据同s-HR中已经存在组织岗位员工等核心数据，只需根据需要步至EAS。调整后通过初始化同步将数据同步至EAS。EASV8.0升级客户在s-HR中初始化组织、岗位、员工数据时，需要保持与EAS中的数据对应，编码一致。如果是同时进行EAS升级和s-HR的迁移，两边的数据应该是一致的，请根据1.1.2进行同步数据检查。EAS中已有组织、岗位、员工数据的客户初始化步骤：1、在EAS系统中按客户要求完成最新行政组织架构调整；2、从EAS系统中导出行政组织架构，在s-HR组织管理\组织日常维护中下载EXCEL导入模板把EAS系统中的行政组织架构（名称、编码、上级组织必须与EAS相同）导入到s-HR；3、在s-HR中建立s-HR职位体系（职等、职层、职位族\职位类\职位子类、职位）；4、在s-HR中建立岗位；5、在EAS中的各行政组织下的职位名称、编码、上级职位（行政汇报关系）确保与s-HR中行政组织下的岗位名称、编码、上级岗位（行政汇报关系）一一对应（即确保EAS中的职位与s-HR中的岗位数据完全相同）；6、在EAS中确保每个员工都有对应的职位，并且EAS中的职位与s-HR中的岗位一一对应；7、从EAS系统中导出员工信息，在s-HR员工管理\员工档案维护中下载EXCEL导入模板把EAS中的员工导入到s-HR(姓名、编码、所属组织、所属岗位必须与EAS相同)。；8、部署并启动s-HR与EAS同步服务。EAS中还没有建立组织、岗位、员工基础数据的客户初始化步骤：1、在s-HR中建立行政组织架构，在s-HR组织管理\组织日常维护中下载EXCEL按模板导入；2、在s-HR中建立s-HR职位体系（职等、职层、职位族\职位类\职位子类、职位）；3、在s-HR中建立岗位；4、在s-HR中导入员工；5、部署并启动s-HR与EAS同步服务，执行初始化同步；6、在EAS中初始化其他数据。1.1集成应用准备1.1.1环境准备要对EAS和s-HR做集成应用，前提是已经部署好了EAS和s-HR的应用服务器和数据中心，且都能正常使用。EAS和s-HR的环境部署请分别参考对应产品的部署说明。在同步初始化前请将数据库做好备份，以免做初始化时由于s-HR组织，岗位，员工数据不是最新的，引发数据问题。1.1.2同步前数据检查（非常重要）1)同步时是以编码来确定两边新加的记录是否为同一条，编码一致会认为是同一条记录（s-HR系统的相应数据会将EAS系统相应的数据字段覆盖），因此要求EAS，s-HR系统中已存在的组织，岗位，员工，以及要同步的基础资料的编码必需一致，并且，在同步之前，要求EAS与s-HR的组织架构，岗位的行政汇报关系必需一致。如果不能确定两个系统的编码是否完全相同，建议在同步初始化前将两个系统中的数据导出到excel中做比对检查，编码不同的一定要在两个系统中修改一致。2)EAS方需要禁用组织，岗位，员工的编码规则，以免两个系统编码不一致。3)s-HR下的根节点岗位的编码与EAS的要一致，如果EAS那边没有根节点岗位，则要手工建立一个与s-HR编码相同的岗位根节点。s-HR这边的岗位根节点的上级岗位与EAS那边相同要设置为本身（例如：根节点岗位董事长的上级是董事长本身）。4)另外还要确认s-HR的组织，岗位，员工及其员工任职信息可以在恰当的时间点更新到EAS系统，避免s-HR系统的数据滞后，同步到EAS系统后，引起EAS系统的数据问题。1.1.3同步原则同步在自动模式下，可以通过后台事务定时每天执行一次，晚上从s-HR拉取变化的数据到EAS，进行新增或者更新操作，不需要人工手动执行。启用系统集成后，不建议在EAS系统中新增人员、组织、岗位信息，但是可以进行修改（仅限于未同步字段）。1.2EASV7.5/EASV8.0与s-HRV2.0组织人事数据集成环境配置要在EAS和s-HRV2.0之间实现数据同步和集成，需要对两个环境分别进行一些配置部署。EAS取s-HR数据通过s-HR对外提供的osf获取，需要配置单点登录信息，同时需要部署同步功能jar到EAS服务器，同步压缩包可以在s-HR安装目录\eas\server\deploy\easweb.ear\eas_web.war\addon\inte_shr2eas目录获取easDeploy.zip，部署时，先解压easDeploy目录，详细部署内容如下：1.2.1EAS端配置（必要条件）1.2.1.1部署单点登录配置信息需要修改解压后的配置文件easDeploy\shrIntegradeEasConfig.properties中的参数：1)otp.domino.secret参数：在调用s-HR系统osf服务取数时，需要登陆s-HR系统（后台自动登陆），这个参数是用来生成token的秘钥，以便实现单点登陆；这个参数值要与s-HR服务器安装目录\eas\server\profiles\server1\config\portalConfig\LtpaToken.properties文件中的otp.domino.secret参数值一致；2)token.expiration=30：生成的token的有效期，这里是30分钟,可不改；3)shr_server_address：s-HR系统服务器地址，如：http://172.19.76.46:6888/shr;4)将修改好的shrIntegradeEasConfig.properties文件放入EAS服务器安装目录\Server\properties下；1.2.1.2部署同步私包组织人事核心数据同步私包1)找到解压后的，部署私包（jar和metas）,将easDeploy\shrIntegratedEas_class.jar（适应EAS60以上版本）或easDeploy\shrIntegratedEas60_class.jar（适用于EAS60版本）部署到eas\Server\lib\sp目录和eas\Server\deploy\fileserver.ear\easWebClient\lib\sp目录；easDeploy\shrIntegratedEas_metas.jar部署到eas\Server\metas\sp目录和eas\Server\deploy\fileserver.ear\easWebClient\metas\sp目录；2)找到解压后的脚本文件，进入EAS管理控制台中按照现场情况执行脚本文件easDeploy\eas_initSQL.sql,easDeploy\eas_initSQL.sql,easDeploy\eas_initSQL.xml（适应EAS60以上版本）,easDeploy\eas_initSQL_60.xml（适用于EAS60版本）;1.2.2s-HR端配置（必要条件）1.2.2.1数据中心代码设置检查s-HR服务器安装目录\eas\server\profiles\server1\config\portalConfig\目录下autoLoginConfig文件中的datacenter值，其值应该为s-HR系统的数据中心代码；1.2.2.2配置数据中心登陆s-HR的GUI客户端，进入【集成管理->EAS系统集成->集成配置->源系统数据库连接】菜单：新建一个数据库连接信息(EAS系统生产库的链接)，请务必保证连接记录只有一条,配置时可以参考EAS管理控制台中的数据中心设置来配置,配置方法参考如下：1）使用administrator登录s-HR客户端，打开源系统数据库连接，如下图5.1.2-1)：图5.1.2-1：源系统数据库连接2）新增一个数据库连接，如下图5.1.2-2：图5.1.2-2：新增源系统数据连接3）添加完数据库连接后，点一下“连接测试”，需要保证此时，可以成功连接数据库。1.2.3EAS同步设置（必要条件）1.2.3.1菜单分配执行完EAS的部署及脚本后，会在系统菜单中找到，现场根据情况把菜单分配到客户化菜单目录下，并分配对应的权限给用户。图5.1.3-1s-HR数据集成菜单1.2.3.2同步方式配置s-HR同步到EAS支持两种模式，手动模式和自动模式。默认是手动方式，现场可以根据情况进行配置，但无论哪种模式，都要先做初始化操作。图5.1.3-2集成同步模式设置手动模式变化的记录在s-HR数据集成菜单进入的列表界面可以看到，手动点击“处理”按钮时，才会更新到EAS系统；自动同步是通过后台事务EAS集成s-HR自动同步来执行，后台事务默认每天执行，在手动模式下，后台事务同步不会被执行，只有在同步模式设置为自动时，后台事务才会自动同步s-HR的变化数据到EAS.。1.2.4集成模式设置（必要条件）使用administrator登录到s-HR的GUI客户端，由于s-HR目前支持与多种业务系统的集成，集成方式通过系统参数IntegratedPattern控制，s-HR同步到EAS，需要将参数IntegratedPattern设置为shr2eas,如下图6.1:图5.1.4-1：调整集成模式参数1.2.5EAS参数值调整（必要条件）自动创建用户参数集成时如果不需要s-HR系统在同步新增员工时到EAS时同时创建用户信息，则需要将系统参数中的IS_Auto_User设置为否，以免在创建人员的时候，创建用户信息。图5.1.5-：调整新增员工自动创建用户参数1.2.6EAS与s-HR的集成配置验证在全部的部署和配置完成后，可以对一条变化数据进行同步，验证配置是正确。如果集成全部配置成功后，在s-HR系统修改组织，岗位，员工的信息，将会生成一条变更记录到EAS中，打开EAS的s-HR数据集成界面时，可以看到这条变化的记录，点击“处理”按钮时，这个变化，可以更新到EAS系统。具体验证步骤参考如下：1)使用HR专业用户登录s-HR系统web系统，进入员工管理-员工信息维护界面，修改一个人的个人信息，如护照号字段，如下图所示：2)使用EAS用户登录GUI客户端，进入s-HR数据集成界面，可以看到s-HR系统修改的员工记录，如下图所示：没有看到这条变化的数据，则说明EAS与s-HR的配置没有成功，请从如下几方面查找原因：1)如果s-HR数据集成界面看不到这条数据，则说明步骤1.2.2s-HR端配置配置的有问题，请检查数据中心是否配置好了，在集成管理->EAS系统集成->集成配置->源系统数据库连接那里，数据连接一定要测试通过，因为客户现场环境经常有多个EAS账套切换，可能有配置不对的情况。2)如果s-HR数据集成界面看到一条数据，但是“变化简述”字段内容是空的，则请检查如下步骤：可能是1.2.1.1部署单点登录配置信息配置的不对，请检查EAS服务器安装目录\Server\properties下的shrIntegradeEasConfig.properties文件内容是否配置的正确，如果这里配置错了，做了修改，则需要重启EAS服务器才能生效。可能是1.2.4集成模式设置配置的不对，需要将参数IntegratedPattern设置为shr2eas；可能是1.2.2.1数据中心代码设置配置的不对，检查s-HR服务器安装目录\eas\server\profiles\server1\config\portalConfig\目录下autoLoginConfig文件中的datacenter值，其值应该为s-HR系统的数据中心代码，如果这里配置错了，做了修改，则需要重启s-HR服务器才能生效。1.2.7S-HR到EAS同步常见错误同步时，处理需保证顺序为先同步组织，岗位，再同步员工，如果同步组织，岗位时要保证上级组织，岗位先同步过来才行，否则下级的组织，岗位，员工同步都不会正常。如果出现同步问题时，可以参考EAS客户端的s-HR数据集成菜单列表界面的异常信息来进行分析：常见错误一：MissingRecord:AdminOrgUnitid='R8nTMPLqRvC99Ah7RUPtysznrtQ='，找不到组织分析过程：打开eas查询分析器，使用selectfouteridfromt_shr_idmappingwherefinnerid='R8nTMPLqRvC99Ah7RUPtysznrtQ=';sql查询，找到fouterid字段值“R8nTMPLqRvC99Ah7RUPtysznrtQ=”；再到s-HR的查询分析器中查看一下，这个id对应的组织是哪个，查询语句：select*fromT_ORG_Adminwherefid='R8nTMPLqRvC99Ah7RUPtysznrtQ='，查询到组织后，根据组织的编码名称后，到eas那边看看这个组织是否同步过来了，如果没有同步过来，则需要先同步依赖的这个组织，才能接着同步当前报错的数据。常见错误二：MissingRecord:Positionid='fx/7k89YTqKZPJUPQHNhPXSuYS4='，找不到岗位（EAS的职位）分析过程：打开eas查询分析器，使用selectfouteridfromt_shr_idmappingwherefinnerid='fx/7k89YTqKZPJUPQHNhPXSuYS4=';sql查询，找到fouterid字段值“fx/7k89YTqKZPJUPQHNhPXSuYS4=”；再到s-HR的查询分析器中查看一下，这个id(fx/7k89YTqKZPJUPQHNhPXSuYS4=)对应的岗位是哪个，查询语句：select*fromT_ORG_Positionwherefid='fx/7k89YTqKZPJUPQHNhPXSuYS4='，查询到岗位后，根据岗位的编码名称，到eas那边看看这个岗位是否同步过来了，如果没有同步过来，则要先同步依赖的这个岗位，才能接着同步当前报错的数据。常见错误三：全部配置成功后，还是初始化同步失败可能问题：s-HR的根节点岗位的上级岗位需要设置为其本身；EAS的根节点组织，岗位与s-HR编码不一致；如果以上两点都正常，请收集EAS服务器安装目录\eas\server\profiles\server1\logs\apusic.log.0,s-HR服务器安装目录\eas\server\profiles\server1\logs\apusic.log.0日志，找开发人员处理，收集日志前，请多操作几次，保证报错信息写入到日志中。常见错误四：初始化操作失败，连接不上s-HR服务器可能问题：1.2.1.1部署单点登录配置信息配置的不对，请检查EAS服务器安装目录\Server\properties下的shrIntegradeEasConfig.properties文件内容,在linux环境下，用linux的编辑器打开，看看格式是否错乱，格式如下：#webserviceconfig#ThuSep1313:38:45CST2012#eas.properties.dir=${EAS_HOME}/server/properties#配置到\eas\Server\server\propertiestoken.expiration=30otp.domino.secret=erewqreqr876shr_server_address=http://172.19.112.114:6888/shr如果出现多余的换行如下，则需要修改后重新上传：#webserviceconfig#ThuSep1313:38:45CST2012#eas.properties.dir=${EAS_HOME}/server/properties#配置到\eas\Server\server\propertiestoken.expiration=30otp.domino.secret=erewqreqr876shr_server_address=http://172.19.112.114:6888/shr1.2.8初始化同步EAS与s-HR同步配置好后，首先要进行初始化同步。初始化需要通过手动执行后台事务执行（操作只执行一次）；执行时，会取s-HR的所有组织，岗位，员工（包含员工任职信息）信息按照编码进行对应，与EAS的信息进行比对，如果相同编码的数据，有需要同步的字段不同，则将s-HR的数据覆盖更新到EAS,同时将两个系统的数据id对应关系记录到id映射表中，建立id对应关系；后续s-HR的组织，岗位，员工的信息发生变化时，写变化记录到EAS的同步状态表中，如果id映射表中不存在的，则取s-HR的信息同步新增到EAS,如果id映射表中存在的，则取s-HR的信息同步更新到EAS。与客户确认初始化开始执行时间点，确认好后就可以执行初始化同步了，初始化操作时，先选择初始化事务，然后手动触发点击“测试”按钮做初始化操作，执行初始化同步的后台事务可以在后台事务监控中看到，如果初始化操作成功完成，则后台事务状态会更新为成功，否则如果有异常信息，则需要检查是否与s-HR服务器连接畅通。"EAS集成SHR初始化"是系统集成初始化的后台事务，建议在服务器启动后首先执行一下。这个过程可能比较漫长，最好闲时在做。事务执行成功后,即使再次执行也不会做数据同步。图5.1.7-1集成初始化后台事务之后就可以根据1.2.3.2同步方式配置中配置的方式进行手动或自动同步了。1.3数据同步应用1.3.1组织人事基础数据同步s-HR的组织，岗位，员工数据会同步到EAS,同步字段内容如下：组织同步字段：名称，编码，简称，上级组织，组织单元类型，组织封存标记，行政组织封存时间，成立日期，营业有效期，是否法人单位，法人；岗位同步字段：名称，编码，组织，上级岗位，是否负责人岗位，生效日期，岗位类型，封存，岗位行政汇报关系；员工同步字段：名称，编码，性别，出生日期，手机号码，办公电话，家庭电话，电子邮件，身份证号，护照号，封存，员工状态，占人头数，备注，助记码，员工任职信息；日常操作：在s-HR中新增、维护、删除组织、岗位、员工等信息，通过手动方式干预或自动处理两种方式进行同步。2与EAS薪酬凭证数据集成应用2.1EASV7.5/EASV8.0与s-HRV2.0薪酬凭证数据集成环境配置2.1.1EAS端配置薪酬凭证数据同步私包1)解压凭证集成私包，停止EAS服务器，将cmp_voucher-code.jar放如下两个目录Server\server\lib\sp和Server\server\deploy\fileserver.ear\easWebClient\lib\sp。将cmp_voucher-metas.jar放Server\server\metas\sp和Server\server\deploy\fileserver.ear\easWebClient\metas\sp下。2)在管理控制台执行脚本compensation_create_insert_table.sql，启动EAS服务器2.1.2s-HR端配置安装集成接口应用包，应用包名称为：APPIntegrated.zip1)管理员登陆，给薪酬专员分配薪酬核算下费用分配信息（EAS）的权限。2)管理员登陆，在开发平台－＞集成配置－＞EAS财务凭证集成配置中配置EAS数据中心连接信息,数据库服务器地址、端口、数据中心名称、管理员以及密码，配置完成后，点击测试连接，确保连接成功2.2数据同步应用2.2.1薪酬凭证数据同步操作1.sHR薪酬专员每月把审批通过的数据提交财务。每一期计算规则在审批通过后，在薪酬发放-薪酬成本分摊中，生成成本分摊数据（必要条件，非常重要）2.在薪酬核算->费用分配信息（EAS）菜单中可以看到该期数据。提交财务前，要先维护一下总账业务组织编码和总账业务组织名称，这个组织用于生成凭证时，这些薪酬数据取匹配财务组织用的（必要条件，非常重要）。配好后，选中计算规则，点击“提交财务”。3.EAS增加两个菜单，放在人力资源管理->薪酬管理->业务设置下：同步shr薪酬项目和薪酬凭证模板。sHR数据提交财务后，首先可以看到“同步shr薪酬项目”菜单中，shr的薪酬项目同步过来。薪酬项目上增加了核算项目属性。用途就是：这个薪酬项目在EAS当做核算项目来用，在凭证模板中可以选择EAS对应的核算项目，生成凭证的时候，辅助账中核算项目数据来源于此。4.凭证模板设置新增凭证模板：维护凭证模板编码、凭证模板名称、选择薪酬方案（对应shr的计算规则）、选择凭证类型。财务组织必须选择财务组织实体，一个凭证模板只能有一个财务组织和一个薪酬方案。shr中每个计算规则会设置对应的总账业务组织要跟此处的财务组织一致。维护凭证模板分录设置凭证分录信息，选择会计科目信息:选择借贷方向：设置核算项目信息。选择核算项目对应的薪酬发放表中薪酬项目选择薪酬项目明细，薪酬项目为薪酬方案中已选择的薪酬项目取数来源可通过选择费用承担组织、员工、薪酬项目录入的信息过滤设置凭证分录摘要信息设置凭证分录期间偏离值，一般为0和-1，0为当期凭证，-1为期间减1凭证设置凭证模板过程中，可保存模板信息5.sHR薪酬数据提交到EAS后，EAS每月通过凭证模板，生成凭证。检查生成的凭证信息3与EASV8.0门户集成应用3.1环境部署3.2门户配置
