s-HR到EAS同步综述：下文将描述同步的一些配置信息，其中的“必要条件”是一定要处理的，“可选”是供现场根据情况调整配置或者仅供参考的，可以不处理；现场按照标题备注为（必要条件）的步骤依次操作下来，就可以完成同步的配置及执行；1.同步原理（可选）集成第一步先要做同步初始化，初始化需要通过手动执行后台事务执行（操作只执行一次）；执行时，会取s-HR的所有组织，岗位，员工（包含员工任职信息）信息按照编码进行对应，与EAS的信息进行比对，如果相同编码的数据，有需要同步的字段不同，则将s-HR的数据覆盖更新到EAS,同时将两个系统的数据id对应关系记录到id映射表中，建立id对应关系；后续s-HR的组织，岗位，员工的信息发生变化时，写变化记录到EAS的同步状态表中，如果id映射表中不存在的，则取s-HR的信息同步新增到EAS,如果id映射表中存在的，则取s-HR的信息同步更新到EAS;同步在自动模式下，可以通过后台事务定时每天执行一次，晚上从s-HR拉取变化的数据到EAS，进行新增或者更新操作，不需要人工手动执行。启用系统集成后，不建议在EAS系统中新增人员、组织、岗位信息，但是可以进行修改（仅限于未同步字段）。2.集成同步字段内容说明（可选）s-HR的组织，岗位，员工数据会同步到EAS,同步字段内容如下：组织同步字段：名称，编码，简称，上级组织，组织单元类型，组织封存标记，行政组织封存时间，成立日期，营业有效期，是否法人单位，法人；岗位同步字段：名称，编码，组织，上级岗位，是否负责人岗位，生效日期，岗位类型，封存，岗位行政汇报关系；员工同步字段：名称，编码，性别，出生日期，手机号码，办公电话，家庭电话，电子邮件，身份证号，护照号，封存，员工状态，占人头数，备注，助记码，员工任职信息；3.同步前数据检查（必要条件，非常重要）3.1同步时以编码来确定两边新加的记录是否为同一条，编码一致会认为是同一条记录（s-HR系统的相应数据会将EAS系统相应的数据字段覆盖），因此要求EAS，s-HR系统中已存在的组织，岗位，员工，以及要同步的基础资料的编码必需一致，并且，在同步之前要求EAS与s-HR的组织架构，岗位的行政汇报关系必需一致。如果不能确定两个系统的编码是否完全相同，建议在同步初始化前将两个系统中的数据导出到excel中做比对检查，编码不同的一定要在两个系统中修改一致。3.2EAS方需要禁用组织，岗位，员工的编码规则，以免两个系统编码不一致。3.3s-HR下的根节点岗位的编码与EAS的要一致，如果EAS那边没有根节点岗位，则要手工建立一个与s-HR编码相同的岗位根节点。s-HR这边的岗位根节点的上级岗位与EAS那边相同要设置为本身（例如：根节点岗位I董事长的上级是董事长本身）。3.4另外还要确认s-HR的组织，岗位，员工及其员工任职信息可以在恰当的时间点更新到EAS系统，避免s-HR系统的数据滞后，同步到EAS系统后，引起EAS系统的数据问题。4.同步集成部署（必要条件）EAS取s-HR数据通过s-HR对外提供的osf获取，需要配置单点登录信息，同时需要部署同步功能jar到EAS服务器，同步压缩包可以在s-HR安装目录\eas\server\deploy\easweb.ear\eas_web.war\addon\inte_shr2eas目录获取easDeploy.zip，部署时，先解压easDeploy目录，详细部署内容如下：4.1．EAS端配置4.1.1：部署单点登录配置信息需要修改解压后的配置文件easDeploy\shrIntegradeEasConfig.properties中的参数：1）domino.secret参数：在调用s-HR系统osf服务取数时，需要登陆s-HR系统（后台自动登陆），这个参数是用来生成token的秘钥，以便实现单点登陆；这个参数值要与s-HR服务器安装目录\eas\server\profiles\server1\config\portalConfig\LtpaToken.properties文件中的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下；4.1.2：部署同步私包1）找到解压后的，部署私包（jar和metas）,将easDeploy\shrIntegratedEas_class.jar部署到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;4.2.s-HR端配置4.2.1数据中心代码设置检查s-HR服务器安装目录\eas\server\profiles\server1\config\portalConfig\目录下autoLoginConfig文件中的datacenter值，其值应该为s-HR系统的数据中心代码；4.2.2配置数据中心登陆s-HR的GUI客户端，进入【集成管理->EAS系统集成->集成配置->源系统数据库连接】菜单：新建一个数据库连接信息(EAS系统生产库的链接)，请务必保证连接记录只有一条,配置时可以参考EAS管理控制台中的数据中心设置来配置,配置方法参考如下：1）使用administrator登录s-HRGU客户端，打开源系统数据库连接，如下图4.2.2.1)：图4.2.2.1)：源系统数据库连接2）新增一个数据库连接，如下图4.2.2.2)：图4.2.2.2)：新增源系统数据连接3）添加完数据库连接后，点一下“连接测试”，需要保证此时，可以连接数据库成功。4）修改配置文件，s-HR安装目录\eas\Server\profiles\server1\config\listenerconfig.data添加s-HR监听器，一段如下图4.2.2.3)：图4.2.2.3)：s-HR组织，岗位，员工监听5.EAS同步设置（必要条件）5.1菜单分配执行完EAS的部署及脚本后，会在系统菜单中找到，现场根据情况把菜单分配到客户化菜单目录下，并分配对应的权限给用户。图5.1s-HR数据集成菜单5.2同步方式配置s-HR同步到EAS支持两种模式，手动模式和自动模式，手动模式变化的记录在数据集成列表界面可以看到，手动点击“处理”按钮时，才会更新到EAS系统；自动模式是s-HR变化的数据，后台事务每天晚上自动执行，将s-HR的变化记录同步到EAS，默认是手动方式，现场可以根据情况进行配置，但无论哪种模式，都要先做初始化操作。图5.2集成同步模式设置遇到问题D:\kingdee820\eas\client\libhttp://172.17.51.44:6888/easupdater/clear6.S-HR参数值调整（必要条件）6.1集成模式设置使用administrator登录到s-HR的GUI客户端，由于s-HR目前支持与多种业务系统的集成，集成方式通过系统参数IntegratedPattern控制，s-HR同步到EAS，需要将参数IntegratedPattern设置为shr2eas,如果没有这个参数，请到s-HR管理控制台中执行同步私包的以下脚本，easDeploy\shr_initSQL.sql如下图6.1:图6.1：调整集成模式参数7.EAS参数值调整（必要条件）7.1自动创建用户参数集成时如果不需要s-HR系统在同步新增员工时到EAS时同时创建用户信息，则需要将系统参数中的IS_Auto_User设置为否，以免在创建人员的时候，创建用户信息。图7.1：调整新增员工自动创建用户参数8.同步初始化执行及自动同步（必要条件）8.1集成初始化执行EAS与s-HR同步配置好后，与客户确认初始化开始执行时间点，确认好后就可以执行初始化同步了，初始化操作时，先选择初始化事务，然后手动触发点击“测试”按钮做初始化操作，执行初始化同步的后台事务可以在后台事务监控中看到，如果初始化操作成功完成，则后台事务状态会更新为成功，否则如果有异常信息，则需要检查是否与s-HR服务器连接畅通。"EAS集成SHR初始化"是系统集成初始化的后台事务，建议在服务器启动后首先执行一下。这个过程可能比较漫长，最好闲时在做。事务执行成功后,即使再次执行也不会做数据同步。图8.1集成初始化后台事务8.2自动同步自动同步是通过后台事务EAS集成s-HR自动同步来执行，后台事务默认每天执行，在手动模式下，后台事务同步不会被执行，只有在同步模式设置为自动时，后台事务才会自动同步s-HR的变化数据到EAS.图8.2集成自动同步后台事务9.怎么判断EAS与s-HR的集成是否配置好了？如果集成全部配置成功后，在s-HR系统修改组织，岗位，员工的信息，将会生成一条变更记录到EAS中，打开EAS的s-HR数据集成界面时，可以看到这条变化的记录，点击“处理”按钮时，这个变化，可以更新到EAS系统。具体验证步骤参考如下：9.1使用HR专业用户登录s-HR系统web系统，进入员工管理-员工信息维护界面，修改一个人的个人信息，如护照号字段，如下图所示：9.2使用EAS用户登录GUI客户端，进入s-HR数据基础界面，可以看到s-HR系统修改的员工记录，如下图所示：没有看到这条变化的数据，则说明EAS与s-HR的配置没有成功，请从如下几方面查找原因：1.如果s-HR数据集成界面看不到这条数据，则说明步骤4.2.s-HR端配置配置的有问题，请检查数据中心是否配置好了，在集成管理->EAS系统集成->集成配置->源系统数据库连接那里，数据连接一定要测试通过，因为客户现场环境经常有多个EAS账套切换，可能有配置不对的情况。2.如果s-HR数据集成界面看到一条数据，但是“变化简述”字段内容是空的，则请检查如下步骤：2.1可能是4.1.1：部署单点登录配置信息配置的不对，请检查EAS服务器安装目录\Server\properties下的shrIntegradeEasConfig.properties文件内容是否配置的正确，如果这里配置错了，做了修改，则需要重启EAS服务器才能生效。2.2可能是6.1集成模式设置配置的不对，需要将参数IntegratedPattern设置为shr2eas；2.3可能是4.2.1数据中心代码设置配置的不对，检查s-HR服务器安装目录\eas\server\profiles\server1\config\portalConfig\目录下autoLoginConfig文件中的datacenter值，其值应该为s-HR系统的数据中心代码，如果这里配置错了，做了修改，则需要重启s-HR服务器才能生效。10.同步常见错误同步时，处理需保证顺序为先同步组织，岗位，再同步员工，如果同步组织，岗位时要保证上级组织，岗位先同步过来才行，否则下级的组织，岗位，员工同步都不会正常。如果出现同步问题时，可以参考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那边看看这个岗位是否同步过来了，如果没有同步过来，则要先同步依赖的这个岗位，才能接着同步当前报错的数据常见错误三：全部配置成功后，还是初始化同步失败可能问题：1.s-HR的根节点岗位的上级岗位需要设置为其本身；2.EAS的根节点组织，岗位与s-HR编码不一致；如果，以上两点都正常，请收集EAS服务器安装目录\eas\server\profiles\server1\logs\apusic.log.0,s-HR服务器安装目录\eas\server\profiles\server1\logs\apusic.log.0日志，找开发人员处理，收集日志前，请多操作几次，保证报错信息写入到日志中。常见错误四：初始化操作失败，连接不上s-HR服务器可能问题：4.1.1：部署单点登录配置信息配置的不对，请检查EAS服务器安装目录\Server\properties下的shrIntegradeEasConfig.properties文件内容,在EAS服务器上，用服务器上的编辑器打开文件，看看格式是否错乱，正确的文件格式如下：#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/shr
