财务与人力资源接口部署培训手册.doc

财务与人力资源接口部署培训手册1. 部署前提条件i. 应用服务器组建需求升级以下最新的三个M8服务端组件：Freesky.M8.DAL.GL.dll, Freesky.M8.BLL.BusinessProcess.GL.dll, Freesky.M8.WebService.GL.dll。分别部署到freeskywebservicebin目录下。例如：假如M8应用服务器程序安装在c:program filesfreesky目录的话，直接将三个最新的组建存放到c:program filesfreeskywebservicebin目录下，假如存在旧版本的三个相应组件，直接替换掉就可以了。ii. 数据需求1) 凭证来源在PL/SQL的command window窗口执行hr.sql脚本，增长一种凭证来源：HR 2) 组织主数据序号名称备注01公司代码人力系统与财务系统进行数据同步。若编码有差异，需建立相应关系。02公司名称注：财务系统中若对公司代码及名称产生了变化，需发送数据变化提醒信息给人力资源系统。人力资源系统的系统管理员根据提醒同步人力资源系统内的公司代码数据表。在人力资源系统向财务系统通过接口传递凭证时，凭证中的公司代码信息如与财务系统不符，返回错误提醒给人力资源系统。3) 成本中心主数据序号名称备注01成本中心编号人力系统与财务系统进行数据同步。02成本中心名称注：财务系统中若对成本中心的编码及名称的数据表发生了变化，需发送数据变化提醒信息给人力资源系统。人力资源系统系统管理员根据提醒同步人力资源系统内的成本中心数据表。在人力资源系统向财务系统通过接口传递凭证时，凭证中的成本中心信息如与财务系统不符，返回错误提醒给人力资源系统。4) 人员信息主数据序号名称备注01身份证号财务系统与人力系统保持数据的一致性02姓名5) 会计科目主数据编号字段名称备注01科目编号人力系统与财务系统进行会计科目数据列表的同步。并在人力资源系统中建立人工成本项目依据不同的影响与会计科目的相应关系，实现系统间数据集成。02科目名称注：财务系统中若对会计科目的数据表发生了变化，需发送数据变化提醒信息给人力资源系统。人力资源系统系统管理员根据提醒同步人力资源系统内的会计科目数据表。在人力资源系统向财务系统通过接口传递凭证时，凭证中的会计科目信息如与财务系统不符，返回错误提醒给人力资源系统。6) 报账项目主数据 序号名称备注01报账项目编号与人力系统的“人工成本项目分类”建立相应关系，实现系统间数据同步。02报账项目名称注：财务辅助系统中报账项目类型按照集团规定的人工成本项目末级分类进行相应。2. 接口交互信息i. 工资计提子接口交互信息字段字段中文名内容选择数据类型备注userid用户姓名非必选此用户是指接受发放凭证的财务人员的用户姓名。在接口传递时由人力资源系统指定相应的人员姓名。corpcode公司代码必选ztcode账套代码非必选Hr系统初始化为空makedate制证日期非必选voucherkey凭证字必选hrbillid凭证号必选Hr系统单据idattachcount附件数必选vouchersource凭证来源必选Hr系统填写为hr(小写)cyear会计年度必选cperiod会计月度必选linenumber行号必选Abstractstr摘要必选Flowitemcode钞票流量代码非必选假如科目规定钞票流量，则必输，否则为空Mnyflowitem钞票流流量金额非必选假如科目规定钞票流量，则必输，否则为0accountcode科目代码必选debit借方金额必选credit贷方金额必选costcode成本中心编码非必选current币别CNY非必选默认为人民币ii. 工资发放子接口交互信息字段字段中文名内容选择数据类型备注userid用户姓名非必选此用户是指接受发放凭证的财务人员的用户姓名。在接口传递时由人力资源系统指定相应的人员姓名。corpcode公司代码必选ztcode账套代码非必选Hr系统初始化为空makedate制证日期必选voucherkey凭证字必选hrbillid凭证号必选attachcount附件数必选vouchersource凭证来源必选Hr系统填写为hr(小写)linenumber行号必选Flowitemcode钞票流量代码非必选假如科目规定钞票流量，则必输，否则为空Mnyflowitem钞票流流量金额非必选假如科目规定钞票流量，则必输，否则为0cyear会计年度必选cperiod会计月度必选Abstractstr摘要必选accountcode科目代码必选debit借方金额必选credit贷方金额必选costcode成本中心编码非必选current币别CNY必选默认为人民币iii. 人工成本数据回写子接口交互信息字段字段中文名内容选择数据类型备注compcode公司代码必选makedate记账日期必选billid报账单号必选hrbillid凭证号必选labourcostcode人工成本分类编码必选costcode成本中心编码必选cyear会计年度必选4位cperiod会计月份必选2位money金额必选type类型必选 “实发”psnidcardcode人员身份证号必选假如是集体的人工成本，此字段值则为“0000”personname人员姓名必选假如是集体的人工成本，此字段值则为“0000”3. 联调前期准备i. 测试用例准备1) 工资计提子接口xml数据准备userid corpcode 按照以上格式准备测试用例，然后保存该xml数据为文献例如：c:1.xml2) 工资发放子接口xml数据准备userid corpcode 按照以上格式准备测试用例，然后保存该xml数据为文献例如：c:2.xml3) 人工成本数据回写子接口xml数据准备 /makedate /makedate . .按照以上格式准备测试用例，然后保存该xml数据为文献例如：c:3.xmlii. 测试环境前端用用友客户端模拟小工具interfacetest.exe结合验证码生成器prjGetUserAuth.exe测试应用程序服务器部署的对的性，以及主数据准备的完整性。测试环节如下：1) 第一步、获取用户验证码运营prjGetUserAuth.exe，打开如下界面：在应用服务器相应的输入框中输入M8测试服务器应用程序的完整途径，例如：登陆名，例如：chy, 再输入密码和帐套，再点“获取验证码”，再将该用户验证码拷贝出来，并保存起来，例如：保存到文献（authcode.txt）。2) 第二步：用友客户端模拟小工具interfacetest.exe工资计提子接口、工资发放接口与人工成本数据回写子接口的用户编码和用户密码都同样，分别是：用户编码：hr用户密码：#hr$datasync$接口标记：工资计提子接口：hr_sal_calculate工资发放接口: hr_sal_issue人工成本数据回: PCMTOHRCOST。输入以上用户名，密码，验证码接口标记以后，再输入相应的XML文献全途径。再点击最上面一排的按钮“HR接口”，然后就可以测试接口了。假如部署环境有问题或者应用程序服务器IP地址不对，系统会提醒以下错误：假如应用服务器搭建成功的话，会出现以下提醒：调用成功。3) 验证凭证生成进入凭证查询界面，根据凭证来源(当前的三个接口产生的凭证来源是HR)进行筛选，查看刚才做的凭证是否已经生成。4) 查看日记假如未生成，进入应用服务器的c:program filesfreeskywebservicelog目录查看日记文献，里边会记录具体错误信息。日记文献的命名规范是：前缀:M8Log后缀：年（四位）月（两位）日（两位）。例如：2023-8-9做测试，则产生的日记文献全名是：M8Log2023-08-09.log用记事本打开该文献查看犯错具体信息：内容大体如下：-时间: 2023-8-8 20:58:00用户错误描述:系统错误描述: 开始解析明细表XML严重性: UnspecifiedM8用户ID:M8模块名:GLM8服务文献名:GL_VoucherWSM8服务方法名:CreateHRVou机器名:5C2ULHTC9ZV9S3P应用程序名:/LM/W3SVC/1/Root/FREESKY.M8.WEBSERVICE.GL-2-1283102)-时间: 2023-8-8 20:58:03用户错误描述:系统错误描述: 完毕解析明细表XML严重性: UnspecifiedM8用户ID:M8模块名:GLM8服务文献名:GL_VoucherWSM8服务方法名:CreateHRVou机器名:5C2ULHTC9ZV9S3P应用程序名:/LM/W3SVC/1/Root/FREESKY.M8.WEBSERVICE.GL-2-1283102)-时间: 2023-8-8 20:58:03用户错误描述:开始检查凭证！系统错误描述: 开始检查凭证！严重性: UnspecifiedM8用户ID:M8模块名:GLM8服务文献名:GL_VoucherWS.asmxM8服务方法名:CreateHRVou机器名:5C2ULHTC9ZV9S3P应用程序名:/LM/W3SVC/1/Root/FREESKY.M8.WEBSERVICE.GL-2-1283102)-时间: 2023-8-8 20:58:03用户错误描述:Error Xml=凭证来源不存在！系统错误描述: 集团人力资源接口调用生成凭证检查Write Error log严重性: UnspecifiedM8用户ID:M8模块名:GLM8服务文献名:IfserviceM8服务方法名:CreateHRVou机器名:5C2ULHTC9ZV9S3P应用程序名:/LM/W3SVC/1/Root/FREESKY.M8.WEBSERVICE.GL-2-1283102)假如要查看用友传过来的XM文献，可以按CYRL+F，然后输入：Ifservice XML=，再按回车，即可看到用友传过来的XML信息，格式如下：时间: 2023-8-8 20:57:47用户错误描述:Service系统错误描述: Ifservice XML=999冯琰1000-10012023-07-3099转账hr2023071发钱啦611190122011999.990202391999.992就这点630102060202311999.99严重性: UnspecifiedM8用户ID:M8模块名:GLM8服务文献名:M8服务方法名:机器名:5C2ULHTC9ZV9S3P应用程序名:/LM/W3SVC/1/Root/FREESKY.M8.WEBSERVICE.GL-2-12831024. 与用友HR系统联调把我们的URL地址告诉用友测试人员，URL格式是：http:/M8应用服务器IP/XineM8WS/GL_VoucherWS.asmx?wsdl, 统一入口方法是IfService。用友HR系统根据这个URL推送请求，调用我们的三个接口。用友HR系统发送成功以后，进入凭证查询界面查找凭证来源是HR的凭证，看看是不是当天生成的同批凭证，假如成功生成，表白联调成功，否则联调失败，按照联调前期准备查看日记方法，查看日记。根据犯错信息排查用友传递的数据是否有效。