金蝶s-HR与EAS集成配置操作手册[金蝶HR产品事业部]导读金蝶s-HR支持与金蝶EAS的组织、岗位及员工的集成与同步。本文提供的是金蝶s-HR与EAS集成的原理、配置方法、同步操作流程及常见问题的解决方法。适用范围文档适用对象：实施顾问、服务顾问适用产品版本：1、金蝶s-HRV1.5+PTM093634、金蝶s-HRV2.0、金蝶s-HRV8.22、EASV7.5、EASV8.0、EASV8.2本文件只作为产品介绍之用，不属于您与金蝶签署的任何协议。本文件仅包括金蝶既定策略、产品及功能方面的信息，不能以本文件作为要求金蝶履行商务条款、产品策略以及开发义务的依据。本文件内容可能随时变更，恕不另行通知。金蝶s-HR与EAS集成配置操作手册目录1同步原理（可选）............................................................32集成同步字段内容说明（可选）................................................33同步前数据检查（必选，非常重要）............................................44同步集成部署（必选）........................................................44.1EAS端配置................................................................44.2金蝶s-HR端配置...........................................................65EAS同步设置（必选）........................................................95.1菜单分配..................................................................95.2同步方式配置..............................................................96金蝶s-HR参数值调整（必选）...............................................107EAS参数值调整（必选）.....................................................118同步初始化执行及自动同步（必选）...........................................129怎么判断EAS与金蝶s-HR的集成是否配置好了？................................1310同步常见错误..............................................................142金蝶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金蝶s-HR与EAS集成配置操作手册员工同步字段：名称、编码、性别、出生日期、手机号码、办公电话、家庭电话、电子邮件、身份证号、护照号、封存、员工状态、占人头数、备注、助记码、员工任职信息。3同步前数据检查（必选，非常重要）3.1同步时以编码来确定两边新加的记录是否为同一条。编码一致会认为是同一条记录（金蝶s-HR系统的相应数据会将EAS系统相应的数据字段覆盖），因此要求EAS，金蝶s-HR系统中已存在的组织、岗位、员工以及要同步的基础资料的编码必须一致；并且，在同步之前，要求EAS与金蝶s-HR的组织架构，岗位的行政汇报关系必须一致。如果不能确定两个系统的编码是否完全相同，建议在同步初始化前将两个系统中的数据导出到EXCEL表中做比对检查，编码不同的一定要在两个系统中修改为一致。3.2EAS方需要禁用组织，岗位，员工的编码规则，以免两个系统编码不一致。3.3金蝶s-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技术支持获取集成文件包，详细部署内容如下：4.1EAS端配置4.1.1：部署单点登录配置信息需要修改解压后的配置文件easDeploy\shrIntegradeEasConfig.properties中的参数：4金蝶s-HR与EAS集成配置操作手册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、解压凭证集成文件包（最新文件包请向金蝶s-HR技术支持获取），停止EAS服务器；（以下3个步骤适用于除了EASV8.2和金蝶s-HRV8.2集成且使用的是同一个数据中心以外的集成场景）a.将cmp_voucher-code.jar放在如下两个目录Server\server\lib\sp和Server\server\deploy\fileserver.ear\easWebClient\lib\sp下；b.将cmp_voucher-metas.jar放在Server\server\metas\sp和Server\server\deploy\fileserver.ear\easWebClient\metas\sp下；c.在管理控制台执行脚本compensation_create_insert_table.sql，启动EAS服务器。2、如果是EASV8.2和s-HRV8.2集成且使用的是同一个数据中心停止服务器1)将hr_compensation-client.jar包替换到以下路径：\eas\server\lib\client\eas和\eas\server\deploy\fileserver.ear\easWebClient\lib\client\eas；2)将hr_compensation-server.jar包替换到以下路径：\eas\server\lib\server\eas；3)将hr_compensation-metas.jar包替换到以下路径：\eas\server\deploy\fileserver.ear\easWebClient\metas\eas和\eas\server\metas\eas；4)执行脚本compensation_create_insert_table.sql。5金蝶s-HR与EAS集成配置操作手册该私包只适用于EASV8.2和金蝶s-HRV8.2集成且使用的是同一个数据中心这一种场景。4.2金蝶s-HR端配置4.2.1安装应用金蝶s-HRV1.5+PTM093634、金蝶s-HRV2.0和金蝶s-HRV8.2都已经包含了集成接口这个应用。对于金蝶s-HRV1.5+PTM093634或者金蝶s-HRV2.0，可以在应用中心查询到这个应用，如下图：4.2.2数据中心代码设置检查金蝶s-HR服务器安装目录\eas\server\profiles\server1\config\portalConfig\目录下autoLoginConfig文件中的datacenter值，其值应该为金蝶s-HR系统的数据中心代码。4.2.3配置数据中心登陆金蝶s-HR的GUI客户端，进入【集成管理->EAS系统集成->集成配置->源系统数据库连接】菜单：新建一个数据库连接信息(EAS系统生产库的链接)，请务必保证连接记录只有一条，配置时可以参考EAS管理控制台中的数据中心设置来配置,配置方法参考如下：6金蝶s-HR与EAS集成配置操作手册1）使用administrator登录金蝶s-HRGUI客户端，打开源系统数据库连接，如下图4.2.2.1)：图4.2.2.1：源系统数据库连接2）新增一个数据库连接，如下图4.2.2.2：图4.2.2.2：GUI端新增源系统数据连接金蝶s-HRV8.2增加了WEB端新增数据连接。用administrator登陆，开发平台-集成配置-EAS集成配置-新增。金蝶s-HRv8.2版本同时支持GUI和WEB端进行配置，只需要维护其7金蝶s-HR与EAS集成配置操作手册中一种就可以，如果两种都配置了，以GUI的配置为准。图4.2.2.3：web端新增源系统数据连接3）添加完数据库连接后，点一下“连接测试”，需要保证此时，可以连接数据库成功。4）修改配置文件，金蝶s-HR安装目录。\eas\Server\profiles\server1\config\listenerconfig.data添加金蝶s-HR监听器，一段如下图4.2.2.4：8金蝶s-HR与EAS集成配置操作手册图4.2.2.4：金蝶s-HR组织、岗位、员工监听5EAS同步设置（必选）5.1菜单分配执行完EAS的部署及脚本后，会在系统菜单中找到，现场根据情况把菜单分配到客户化菜单目录下，并分配对应的权限给用户。9金蝶s-HR与EAS集成配置操作手册图5.1s-HR数据集成菜单5.2同步方式配置金蝶s-HR同步到EAS支持两种模式：手动模式和自动模式。手动模式变化的记录在数据集成列表界面可以看到，手动点击“处理”按钮时，才会更新到EAS系统。自动模式是对金蝶s-HR变化的数据，在后台事务每天晚上自动执行，将金蝶s-HR的变化信息同步到EAS。默认是手动方式，现场可以根据情况进行配置，但无论哪种模式，都要先做初始化操作。10金蝶s-HR与EAS集成配置操作手册图5.2集成同步模式设置6金蝶s-HR参数值调整（必选）集成模式设置：使用administrator登录到金蝶s-HR的GUI客户端。由于金蝶s-HR目前支持与多种业务系统的集成，集成方式通过系统参数IntegratedPattern控制，金蝶s-HR同步到EAS，需要将参数IntegratedPattern设置为shr2eas,如下图6.1:金蝶s-HRV8.2，如果没有这个参数，请到金蝶s-HR管理控制台中执行脚本shr_initSQL.sql。11金蝶s-HR与EAS集成配置操作手册图6.1：调整集成模式参数7EAS参数值调整（必选）自动创建用户参数：集成时如果不需要金蝶s-HR系统在同步新增员工时到EAS时同时创建用户信息，则需要将EAS系统参数中的IS_Auto_User设置为否，以免在创建人员的时候，创建用户信息。12金蝶s-HR与EAS集成配置操作手册图7.1：调整新增员工自动创建用户参数8同步初始化执行及自动同步（必选）8.1集成初始化执行EAS与金蝶s-HR同步配置好后，与客户确认初始化开始执行时间点，确认好后就可以执行初始化同步了。初始化操作时，先选择初始化事务，然后手动触发点击“测试”按钮做初始化操作，执行初始化同步的后台事务可以在后台事务监控中看到，如果初始化操作成功完成，则后台事务状态会更新为成功，否则如果有异常信息，则需要检查是否与s-HR服务器连接畅通。"EAS集成s-HR初始化"是系统集成初始化的后台事务，建议在服务器启动后首先执行一下。这个过程可能比较漫长，最好闲时在做。事务执行成功后,即使再次执行也不会做数据同步。图8.1集成初始化后台事务8.2自动同步自动同步是通过后台事务“EAS集成s-HR自动同步”来执行的，后台事务默认每天执行，在手动模式下，后台事务同步不会被执行，只有在同步模式设置为自动时，后台事务才会自动同步金蝶s-HR的变化数据到EAS。13金蝶s-HR与EAS集成配置操作手册图8.2集成自动同步后台事务9怎么判断EAS与金蝶s-HR的集成是否配置好了？如果集成全部配置成功后，在金蝶s-HR系统修改组织、岗位、员工的信息，将会生成一条变更记录到EAS中，打开EAS的金蝶s-HR数据集成界面时，可以看到这条变化的记录，点击“处理”按钮时，这个变化信息就可以更新到EAS系统。具体验证步骤参考如下：1.1使用HR专业用户登录金蝶s-HRWEB端系统，进入员工管理—员工信息维护界面，修改一个人的个人信息，如护照号字段，如下图所示：1.2使用EAS用户登录GUI客户端，进入金蝶s-HR数据基础界面，可以看到金蝶s-HR系统修改的员工记录，如下图所示：14金蝶s-HR与EAS集成配置操作手册如果没有看到这条变化的数据，则说明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：金蝶s-HR集成参数调整中集成模式设置配置不对。需要将参数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数据集成菜单列表界面的异常信息来进行分析：15金蝶s-HR与EAS集成配置操作手册常见错误一：MissingRecord:AdminOrgUnitid='R8nTMPLqRvC99Ah7RUPtysznrtQ='，找不到组织分析过程：打开EAS查询分析器，使用以下SQL检查：selectfouteridfromt_shr_idmappingwherefinnerid='R8nTMPLqRvC99Ah7RUPtysznrtQ=';sql查询，找到fouterid字段值“R8nTMPLqRvC99Ah7RUPtysznrtQ=”；再到金蝶s-HR的查询分析器中查看一下，这个id对应的组织是哪个，查询语句：select*fromT_ORG_Adminwherefid='R8nTMPLqRvC99Ah7RUPtysznrtQ='，查询到组织后，根据组织的编码名称，到EAS那边看看这个组织是否同步过来了，如果没有同步过来，则需要先同步依赖的这个组织，才能接着同步当前报错的数据。常见错误二：MissingRecord:Positionid='fx/7k89YTqKZPJUPQHNhPXSuYS4='，找不到岗位（EAS的职位）分析过程：打开eas查询分析器，使用如下SQL检查：selectfouteridfromt_shr_idmappingwherefinnerid='fx/7k89YTqKZPJUPQHNhPXSuYS4=';sql查询，找到fouterid字段值“fx/7k89YTqKZPJUPQHNhPXSuYS4=”；再到金蝶s-HR的查询分析器中查看一下，这个id(fx/7k89YTqKZPJUPQHNhPXSuYS4=)对应的岗位是哪个，查询语句：select*fromT_ORG_Positionwherefid='fx/7k89YTqKZPJUPQHNhPXSuYS4='，查询到岗位后，16金蝶s-HR与EAS集成配置操作手册根据岗位的编码名称，到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服务器分析过程：对于初始化操作失败，且连接不上金蝶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/properties17金蝶s-HR与EAS集成配置操作手册#配置到\eas\Server\server\propertiestoken.expiration=30otp.domino.secret=erewqreqr876shr_server_address=http://172.19.112.114:6888/shr18
