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

1、 财务与人力资源接口部署培训手册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 目录下，如果存在旧版本的三个对应组件，直接替换掉

2、就可以了。ii. 数据需求1) 凭证来源在 PL/SQL 的 command window 窗口执行 hr.sql 脚本，增加一种凭证来源：HR 2) 组织主数据序号 名称 备注01 公司代码02 公司名称人力系统与财务系统进行数据同步。若编码有差异，需建立对应关系。注：财务系统中若对公司代码及名称产生了变化，需发送数据变化提示信息给人力资源系统。人力资源系统的系统管理员根据提示同步人力资源系统内的公司代码数据表。在人力资源系统向财务系统通过接口传递凭证时，凭证中的公司代码信息如与财务系统不符，返回错误提示给人力资源系统。3) 成本中心主数据序号 名称 备注01 成本中心编号02 成本中心名称

3、人力系统与财务系统进行数据同步。注：财务系统中若对成本中心的编码及名称的数据表发生了变化，需发送数据变化提示信息给人力资源系统。人力资源系统系统管理员根据提示同步人力资源系统内的成本中心数据表。在人力资源系统向财务系统通过接口传递凭证时，凭证中的成本中心信息如与财务系统不符，返回错误提示给人力资源系统。4) 人员信息主数据序号 名称 备注01 身份证号02 姓名财务系统与人力系统保持数据的一致性5) 会计科目主数据编号 字段名称 备注01 科目编号02 科目名称人力系统与财务系统进行会计科目数据列表的同步。并在人力资源系统中建立人工成本项目依据不同的影响与会计科目的对应关系，实现系统间数据集成

4、。注：财务系统中若对会计科目的数据表发生了变化，需发送数据变化提示信息给人力资源系统。人力资源系统系统管理员根据提示同步人力资源系统内的会计科目数据表。在人力资源系统向财务系统通过接口传递凭证时，凭证中的会计科目信息如与财务系统不符，返回错误提示给人力资源系统。6) 报账项目主数据 序号 名称 备注01 报账项目编号02 报账项目名称与人力系统的“人工成本项目分类”建立对应关系，实现系统间数据同步。注：财务辅助系统中报账项目类型按照集团规定的人工成本项目末级分类进行对应。2. 接口交互信息i. 工资计提子接口交互信息字段 字段中文名 内容 选择 数据类型 备注userid 用户姓名 非必选 此

5、用户是指接收发放凭证的财务人员的用户姓名。在接口传递时由人力资源系统指定相应的人员姓名。corpcode 公司代码 必选ztcode 账套代码 非必选 Hr 系统初始化为空makedate 制证日期 非必选voucherkey 凭证字 必选hrbillid 凭证号 必选 Hr 系统单据 idattachcount 附件数 必选vouchersource 凭证来源 必选 Hr 系统填写为 hr(小写)cyear 会计年度 必选cperiod 会计月度 必选linenumber 行号 必选Abstractstr 摘要 必选Flowitemcode 现金流量代码 非必选 如果科目要求现金流量，则必输

6、，否则为空Mnyflowitem 现金流流量金额非必选 如果科目要求现金流量，则必输，否则为 0accountcode 科目代码 必选debit 借方金额 必选credit 贷方金额 必选costcode 成本中心编码 非必选current 币别 CNY 非必选 默认为人民币ii. 工资发放子接口交互信息字段 字段中文名 内容 选择 数据类型 备注userid 用户姓名 非必选 此用户是指接收发放凭证的财务人员的用户姓名。在接口传递时由人力资源系统指定相应的人员姓名。corpcode 公司代码 必选ztcode 账套代码 非必选 Hr 系统初始化为空makedate 制证日期 必选vouche

7、rkey 凭证字 必选hrbillid 凭证号 必选attachcount 附件数 必选vouchersource 凭证来源 必选 Hr 系统填写为 hr(小写)linenumber 行号 必选Flowitemcode 现金流量代码 非必选 如果科目要求现金流量，则必输，否则为空Mnyflowitem 现金流流量金额非必选 如果科目要求现金流量，则必输，否则为 0cyear 会计年度 必选cperiod 会计月度 必选Abstractstr 摘要 必选accountcode 科目代码 必选debit 借方金额 必选credit 贷方金额 必选costcode 成本中心编码 非必选current

8、 币别 CNY 必选 默认为人民币iii. 人工成本数据回写子接口交互信息字段 字段中文名 内容 选择 数据类型 备注compcode 公司代码 必选makedate 记账日期 必选billid 报账单号 必选hrbillid 凭证号 必选labourcostcode 人工成本分类编码 必选costcode 成本中心编码 必选cyear 会计年度 必选 4 位cperiod 会计月份 必选 2 位money 金额 必选type 类型 必选 “实发”psnidcardcode 人员身份证号 必选 如果是集体的人工成本，此字段值则为“0000”personname 人员姓名 必选 如果是集体的人工

9、成本，此字段值则为“0000”3. 联调前期准备i. 测试用例准备1) 工资计提子接口xml 数据准备useridcorpcode 按照以上格式准备测试用例，然后保存该 xml 数据为文件例如：c:1.xml2) 工资发放子接口xml 数据准备useridcorpcode 按照以上格式准备测试用例，然后保存该 xml 数据为文件例如：c:2.xml3) 人工成本数据回写子接口xml 数据准备按照以上格式准备测试用例，然后保存该 xml 数据为文件例如：c:3.xmlii. 测试环境前端用用友客户端模拟小工具 interfacetest.exe 结合验证码生成器 prjGetUserAuth.e

10、xe 测试应用程序服务器部署的正确性，以及主数据准备的完整性。测试步骤如下：1) 第一步、获取用户验证码运行 prjGetUserAuth.exe，打开如下界面：在应用服务器对应的输入框中输入 M8 测试服务器应用程序的完整路径，例如： http:/132.148.13.7/XineM8WS 然后输入M8 登陆名，例如：chy, 再输入密码和帐套，再点“获取验证码” ，再将该用户验证码拷贝出来，并保存起来，例如：保存到文件（authcode.txt） 。2) 第二步：用友客户端模拟小工具 interfacetest.exe工资计提子接口、工资发放接口与人工成本数据回写子接口的用户编码和用户密码

11、都一样，分别是：用户编码：hr用户密码：#hr$datasync$接口标识：工资计提子接口：hr_sal_calculate工资发放接口: hr_sal_issue人工成本数据回: PCMTOHRCOST。输入以上用户名，密码，验证码接口标识以后，再输入对应的 XML 文件全路径。再点击最上面一排的按钮“HR 接口” ，然后就可以测试接口了。如果部署环境有问题或者应用程序服务器 IP 地址不对，系统会提示以下错误：如果应用服务器搭建成功的话，会出现以下提示：调用成功。3) 验证凭证生成进入凭证查询界面，根据凭证来源(当前的三个接口产生的凭证来源是 HR)进行筛选，查看刚才做的凭证是否已经生成。

12、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 服务方法

13、名: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-1283102

14、16128281250)-时间: 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=凭证来源不存在！系统错误描述: 集团人力资源接口调用生成凭证

15、检查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=999冯琰1000-10012007-07-3099转账hr2007071发钱啦611190122011999.990200391999.992就这点

16、630102060200011999.99严重性: UnspecifiedM8 用户 ID:M8 模块名:GLM8 服务文件名:M8 服务方法名:机器名:5C2ULHTC9ZV9S3P应用程序名:/LM/W3SVC/1/Root/FREESKY.M8.WEBSERVICE.GL-2-1283102161282812504. 与用友 HR 系统联调把我们的 URL 地址告诉用友测试人员，URL 格式是：http:/M8 应用服务器 IP/XineM8WS/GL_VoucherWS.asmx?wsdl, 统一入口方法是 IfService。用友 HR 系统根据这个 URL 推送请求，调用我们的三个接口。用友 HR 系统发送成功以后，进入凭证查询界面查找凭证来源是 HR 的凭证，看看是不是当天生成的同批凭证，如果成功生成，表明联调成功，否则联调失败，按照联调前期准备查看日志方法，查看日志。根据出错信息排查用友传递的数据是否有效。