金蝶s-HR与EAS集成配置操作手册[金蝶HR产品事业部]金蝶s-HR与EAS集成配置操作手册前言金蝶s-HR支持与金蝶EAS的组织、岗位（金蝶s-HRV8.2、金蝶s-HRV8.5名称变更为职位）及员工的集成与同步。本文提供的是金蝶s-HR与EAS集成的原理、配置方法、同步操作流程及常见问题的解决方法。2金蝶s-HR与EAS集成配置操作手册目录前言..................................................................................................................................................2一、适用范围..................................................................................................................................3二、综述..........................................................................................................................................41同步原理（可选）.......................................................................................................................42集成同步字段内容说明（可选）................................................................................................53同步前数据检查（必选，非常重要）........................................................................................54同步集成部署（必选）................................................................................................................64.1EAS端配置..................................................................................................................................64.2金蝶s-HR端配置.......................................................................................................................75EAS同步设置（必选）...............................................................................................................105.1菜单分配..................................................................................................................................105.2同步方式配置...........................................................................................................................116金蝶s-HR参数值调整（必选）.................................................................................................127EAS参数值调整（必选）..........................................................................................................138同步初始化执行及自动同步（必选）......................................................................................149怎么判断EAS与金蝶s-HR的集成是否配置好了？.................................................................1510同步常见错误...........................................................................................................................163金蝶s-HR与EAS集成配置操作手册一、综述本文将描述集成的一些配置信息，其中的“必选”是一定要处理的，“可选”是供现场根据情况调整配置或者仅供参考的，可以不处理；现场按照标题备注为（必选）的步骤依次操作下来，就可以完成集成的配置及执行。二、适用范围文档适用对象：实施顾问、服务顾问适用产品版本：1、金蝶s-HRV1.5+PTM093634、金蝶s-HRV2.0、金蝶s-HRV8.2（含SP1和SP2）、金蝶s-HRV8.5，金蝶s-HRV8.5SP12、金蝶EASV7.5、金蝶EASV8.0、金蝶EASV8.2、金蝶EASV8.5【注意】：各版本对应的集成文件包，请通过KSM提单获取。金蝶s-HR与金蝶EAS集成支持版本对照表序号金蝶s-HR版本金蝶EAS版本支持情况1金蝶s-HRV1.5金蝶EASV7.5、金蝶EASV8.0、金蝶EASV8.2支持，需安装最新补丁PTM0936342金蝶s-HRV2.0金蝶EASV7.5、金蝶EASV8.0、金蝶EASV8.2支持3金蝶s-HRV8.2金蝶EASV7.5、金蝶EASV8.0、金蝶EASV8.2支持4金蝶s-HRV8.5金蝶EASV7.5、金蝶EASV8.0、金蝶EASV8.2、金蝶EASV8.5金蝶EASV7.5、金蝶EASV8.5支持金蝶EASV8.0、金蝶EASV8.2暂不支持5金蝶s-HRV8.5SP1金蝶EASV7.5、金蝶EASV8.0、金蝶EASV8.2、金蝶EASV8.5金蝶EASV7.5、金蝶EASV8.5支持金蝶EASV8.0、金蝶EASV8.2暂不支持4金蝶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，同步字段内容如下：组织同步字段：名称、编码、简称、上级组织、组织单元类型、组织封存标记、行政组织封存时间、成立日期、营业有效期、是否法人单位、法人；职位同步字段：名称、编码、组织、上级职位、是否负责人职位、生效日期、职位类型、封存标记、职位行政汇报关系；员工同步字段：名称、编码、性别、出生日期、手机号码、办公电话、家庭电话、电子邮件、身份证号、护照号、封存、员工状态、占人头数、备注、助记码、员工任职信息。5金蝶s-HR与EAS集成配置操作手册3同步前数据检查（必选，非常重要）3.1同步时,以编码来确定s-HR与EAS新加的记录是否为同一条。编码一致会认为是同一条记录（金蝶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部署单点登录配置信息1、单点登录配置方式一：需要修改解压后的配置文件easDeploy\shrIntegradeEasConfig.properties中的参数：1）密钥参数在调用金蝶s-HR系统OSF服务取数时，需要登陆金蝶s-HR系统（后台自动登陆），这个参数是用来生成token的秘钥，以便实现单点登陆；6金蝶s-HR与EAS集成配置操作手册与s-HRV1.5、s-HRV2.0版本集成：otp.domino.secret这个参数值要与金蝶s-HR服务器安装目录:\eas\server\profiles\server1\config\portalConfig\LtpaToken.properties文件中的otp.domino.secret参数值一致；与s-HRV8.2、s-HRV8.5版本集成：domino.secret这个参数值要与金蝶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:8080/shr;注意，如果s-HR服务器配置了集群，则这里的服务器地址端口需配置为集群端口号；4）将修改好的shrIntegradeEasConfig.properties文件放入EAS服务器安装目录\Server\properties下。2、单点登录配置方式二（可视化配置）：注意：该配置方式只支持版本V8.2SP2（安装s-HR基础平台最新补丁）、s-HRV8.5SP1版本。1）管理员登录s-HR的网页版->系统设置->单点登录配置，参考下图设置，修改后保存。【备注】：V8.5SP1单点登录界面比V8.2SP2多了webservice勾选框，见下图，可以根据现场情况而定需要调用第三方WebService可以勾上，不需要可以不勾选，其余地方和V8.2SP2保持一致。7金蝶s-HR与EAS集成配置操作手册4.1.2部署同步文件包1、部署基础人事文件包a）解压部署的压缩包，进行部署（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目录；b）进入管理控制台，在数据中心的管理界面中执行以下的脚本文件easDeploy\eas_initSQL.sql,easDeploy\eas_initSQL.xml；c）部署完毕需要重启EAS服务器。2、若需要进行凭证集成，请参考《金蝶s-HR与EAS薪酬凭证集成配置手册》。4.2金蝶s-HR端配置4.2.1安装应用金蝶s-HRV1.5+PTM093634、金蝶s-HRV2.0、金蝶s-HRV8.2和金蝶s-HRV8.5都已经包含了集成接口这个应用。对于金蝶s-HRV1.5+PTM093634或者金蝶s-HRV2.0，可以在应用中心查询到这个应用，如下图：8金蝶s-HR与EAS集成配置操作手册图4.2.1：应用中心4.2.2数据中心代码设置将金蝶s-HR的应用服务端server\profiles\server(1…n)\config\portalConfig目录下的autoLoginConfig.properties文件中的datacenter参数修改为s-HR要登录的数据中心代码。【备注】：如果配置了集群，每一个实例下这个文件的datacenter参数都需要修改。4.2.3配置数据中心可在GUI或WEB进行配置，选择一个进行配置就可以了。如果GUI和WEB都进行了配置，则以GUI的配置为准。在检查集成数据中心连接时，先找GUI中的配置，如果没有找到则找WEB上的配置。登陆金蝶s-HR的GUI客户端，进入【集成管理->EAS系统集成->集成配置->源系统数据库连接】菜单：新建一个数据库连接信息(EAS系统生产库的链接)，请务必保证连接记录只有一条，配置时可以参考EAS管理控制台中的数据中心设置来配置，配置方法参考如下：1）使用administrator登录金蝶s-HRGUI客户端，打开源系统数据库连接，如下图4.2.3.1)：9金蝶s-HR与EAS集成配置操作手册图4.2.3.1：源系统数据库连接2）新增一个数据库连接，如下图4.2.3.2：图4.2.3.2：GUI端新增源系统数据连接金蝶s-HRV8.2、金蝶s-HRV8.5版本增加了WEB端新增数据连接。用administrator登陆，开发平台—>集成配置—>EAS集成配置—>【创建】。金蝶s-HRV8.2、金蝶s-HRV8.5版本同时支持GUI和WEB端进行配置，只需要维护其中一种就可以（如s-HR升级至V8.2、V8.5，升级后配置信息不保留，需要重新配置），如下图4.2.3.3：10金蝶s-HR与EAS集成配置操作手册图4.2.3.3：web端新增源系统数据连接3）添加完数据库连接后，点一下“连接测试”，需要保证此时，可以连接数据库成功。4）修改配置文件，金蝶s-HR安装目录：\eas\Server\profiles\server(1…n)\config\listenerconfig.data添加金蝶s-HR监听器：【备注】：如果配置了集群，每一个实例都需要添加这段监听。如下图4.2.3.4：11金蝶s-HR与EAS集成配置操作手册图4.2.3.4：金蝶s-HR组织、职位、员工监听5EAS同步设置（必选）5.1菜单分配执行完EAS的部署及脚本后，会在系统菜单中找到，现场根据情况把菜单分配到客户化菜单目录下，并分配对应的权限给用户。如下图5.1：图5.1金蝶s-HR数据集成菜单12金蝶s-HR与EAS集成配置操作手册5.2同步方式配置金蝶s-HR同步到EAS支持两种模式：手动模式和自动模式。手动模式变化的记录在数据集成列表界面可以看到，手动点击“处理”按钮时，才会更新到EAS系统。自动模式是对金蝶s-HR变化的数据，在后台事务每天晚上自动执行，将金蝶s-HR的变化信息同步到EAS。默认是手动方式，现场可以根据情况进行配置，但无论哪种模式，都要先做初始化操作。如下图5.2：图5.2集成同步模式设置6金蝶s-HR参数值调整（必选）集成模式设置：使用administrator登录到金蝶s-HR的GUI客户端。由于金蝶s-HR目前支持与多种业务系统的集成，集成方式通过系统参数IntegratedPattern控制，金蝶s-HR同步到EAS，需要将参数IntegratedPattern设置为shr2eas,如下图6.1:金蝶s-HRV8.2、金蝶s-HRV8.5版本，如果没有这个参数，请到金蝶s-HR管理控制台的数据中心页签中执行脚本shr_initSQL.sql（执行完需重启s-HR应用服务器，否则会找不到IntegratePatten这个集成的参数）：13金蝶s-HR与EAS集成配置操作手册图6.1：调整集成模式参数7EAS参数值调整（必选）自动创建用户参数：集成时如果不需要金蝶s-HR系统在同步新增员工时到EAS时同时创建用户信息，则需要将EAS系统参数中的IS_Auto_User设置为否，以免在创建人员的时候，创建用户信息。如下图7.1：14金蝶s-HR与EAS集成配置操作手册图7.1：调整新增员工自动创建用户参数8同步初始化执行及自动同步（必选）8.1集成初始化执行EAS与金蝶s-HR同步配置好后，与客户确认初始化开始执行时间点，确认好后就可以执行初始化同步了。初始化操作时，先选择初始化事务，然后手动触发点击“测试”按钮做初始化操作，执行初始化同步的后台事务可以在后台事务监控中看到，如果初始化操作成功完成，则后台事务状态会更新为成功，否则如果有异常信息，则需要检查是否与s-HR服务器连接畅通。"EAS集成s-HR初始化"是系统集成初始化的后台事务，建议在服务器启动后首先执行一下。这个过程可能比较漫长，最好闲时在做。事务执行成功后,即使再次执行也不会做数据同步。如下图8.1：15金蝶s-HR与EAS集成配置操作手册图8.1集成初始化后台事务8.2自动同步自动同步是通过后台事务“EAS集成s-HR自动同步”来执行的，后台事务默认每天执行，在手动模式下，后台事务同步不会被执行，只有在同步模式设置为自动时，后台事务才会自动同步金蝶s-HR的变化数据到EAS。如下图8.2：图8.2集成自动同步后台事务9怎么判断EAS与金蝶s-HR的集成是否配置好了？如果集成全部配置成功后，在金蝶s-HR系统修改组织、职位、员工的信息，将会生成一条变更记录到EAS中，打开EAS的金蝶s-HR数据集成界面时，可以看到这条变化的记录，16金蝶s-HR与EAS集成配置操作手册点击“处理”按钮时，这个变化信息就可以更新到EAS系统。具体验证步骤参考如下：使用HR专业用户登录金蝶s-HRWEB端系统，进入员工管理—员工信息维护界面，修改一个人的个人信息，如护照号字段，如下图所示：使用EAS用户登录GUI客户端，进入金蝶s-HR数据基础界面，可以看到金蝶s-HR系统修改的员工记录，如下图所示：如果没有看到这条变化的数据，则说明EAS与金蝶s-HR的配置没有成功，请从如下几方面查找原因：1.如果金蝶s-HR数据集成界面看不到这条数据，则说明“步骤4.2—金蝶s-HR端配置”配置有问题，请检查数据中心是否配置好了，在集成管理->EAS系统集成->集成配置->源系统数据库连接那里，数据连接一定要测试通过，因为客户现场环境经常有多个EAS账套切换，可能有配置不对的情况。（如果仅配置了WEB数据库连接，请到WEB端检查）2.如果金蝶s-HR数据集成界面看到一条数据，但是“变化简述”字段内容是空的，则请检查如下步骤：2.1可能是4.1.1：部署单点登录配置信息配置不对。请检查EAS服务器安装目录\Server\properties下的shrIntegradeEasConfig.properties文件内容是否配置的正17金蝶s-HR与EAS集成配置操作手册确，如果这里配置错了，进行修改，则需要重启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数据集成菜单列表界面的异常信息来进行分析：常见错误（1）：MissingRecord:AdminOrgUnitid='R8nTMPLqRvC99Ah7RUPtysznrtQ='，找不到组织。分析过程：打开EAS查询分析器，使用以下SQL检查：selectfouteridfromt_shr_idmappingwherefinnerid='R8nTMPLqRvC99Ah7RUPtysznrtQ=';SQL查询，找到fouterid字段值“R8nTMPLqRvC99Ah7RUPtysznrtQ=”；如下图所示：再到金蝶s-HR的查询分析器中查看一下，这个id对应的组织是哪个，查询语句：select*fromT_ORG_Adminwherefid='R8nTMPLqRvC99Ah7RUPtysznrtQ='，查询到组织后，根据组织18金蝶s-HR与EAS集成配置操作手册的编码名称，到EAS那边看看这个组织是否同步过来了，如果没有同步过来，则需要先同步依赖的这个组织，才能接着同步当前报错的数据。常见错误（2）：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='，查询到职位后，根据职位的编码名称，到eas那边看看这个职位是否同步过来了，如果没有同步过来，则要先同步依赖的这个职位，才能接着同步当前报错的数据常见错误（3）：全部配置成功后，还是初始化同步失败。分析过程：对于依旧无法完成初始化同步的话，可能存在以下问题：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日志，找开发人员处理，收集日志前，请多操作几次，保证报错信息写入到日志中。常见错误（4）：初始化操作失败，连接不上金蝶s-HR服务器。分析过程：对于初始化操作失败，且连接不上金蝶s-HR服务器的问题，可能是：4.1.1：部署单点登录配置信息配置不对。请检查EAS服务器安装目录\Server\properties下的shrIntegradeEasConfig.properties文件内容,在EAS服务器上，用服务器上的编辑器打开文件，看看格式是否错乱，正确的文件格式如下：#webserviceconfig#ThuSep1313:38:45CST201219金蝶s-HR与EAS集成配置操作手册#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/shr20
