财务与人力资源接口部署培训手册.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测试服务器应用程序的完整路径，例如：/XineM8WS 然后输入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后缀：年（四位）月（两位）日（两位）。例如：2007-8-9做测试，则产生的日志文件全名是：M8Log2007-08-09.log用记事本打开该文件查看出错详细信息：内容大致如下：-时间: 2007-8-8 20:58:00用户错误描述:系统错误描述: 开始解析明细表XML严重性: UnspecifiedM8用户ID:M8模块名:GLM8服务文件名:GL_VoucherWSM8服务方法名:CreateHRVou机器名:5C2ULHTC9ZV9S3P应用程序名:/LM/W3SVC/1/Root/FREESKY.M8.WEBSERVICE.GL-2-128310216128281250)-时间: 2007-8-8 20:58:03用户错误描述:系统错误描述: 完成解析明细表XML严重性: UnspecifiedM8用户ID:M8模块名:GLM8服务文件名:GL_VoucherWSM8服务方法名:CreateHRVou机器名:5C2ULHTC9ZV9S3P应用程序名:/LM/W3SVC/1/Root/FREESKY.M8.WEBSERVICE.GL-2-128310216128281250)-时间: 2007-8-8 20:58:03用户错误描述:开始检查凭证！系统错误描述: 开始检查凭证！严重性: UnspecifiedM8用户ID:M8模块名:GLM8服务文件名:GL_VoucherWS.asmxM8服务方法名:CreateHRVou机器名:5C2ULHTC9ZV9S3P应用程序名:/LM/W3SVC/1/Root/FREESKY.M8.WEBSERVICE.GL-2-128310216128281250)-时间: 2007-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-128310216128281250)如果要查看用友传过来的XM文件，可以按CYRL+F，然后输入：Ifservice XML=，再按回车，即可看到用友传过来的XML信息，格式如下：时间: 2007-8-8 20:57:47用户错误描述:Service系统错误描述: Ifservice XML=999冯琰1000-10012007-07-3099转账hr2007071发钱啦611190122011999.990200391999.992就这点630102060200011999.99严重性: UnspecifiedM8用户ID:M8模块名:GLM8服务文件名:M8服务方法名:机器名:5C2ULHTC9ZV9S3P应用程序名:/LM/W3SVC/1/Root/FREESKY.M8.WEBSERVICE.GL-2-1283102161282812504.