一、      文档信息

版本号*

SRE实战 互联网时代守护先锋,助力企业售后服务体系运筹帷幄!一键直达领取阿里云限量特价优惠。

更新日期*

姓名*

更新内容及更新理由*

备注*

V1.0

2019/02/19

fanjb

文档创建

以福利接口13589(Z00HRJ_GJJ_REV_FI)为例,外围系统调用集中部署ERP

V1.1

2019/04/04

fanjb

文档修正

格式调整

 

 

 

 

 

二、      接口内容

1.      接口详细信息

接口编号

13589

接口功能描述

测试:二级ERP财务系统发送过账信息到集中部署

发送方

财务网省ERP系统

发送方接口名称*

SI_13589_SGHRERP2CEERP_Z00HRJGJJREVFI

接收方

集中部署ERP系统

接收方接口名称*

RFC:Z00HRJ_GJJ_REV_FI

交互模式

同步

触发机制

实时/按需/定时作业

后台作业名称

作业频率

 

发生频度

每日

集成方式

PI+ESB

接口类型

RFC

技术链路

财务网省ERP系统-总部ESB-PI-集中部署ERP系统

服务提供方

集中部署ERP系统

备注

填写需要强调的重要信息

1.1                  传入报文(外围系统提供)

T_ Z00HR_GJJ_ACCOUNT_BACK XML格式:

<?xml version="1.0" encoding="UTF-8"?>

  <Document>

    <Item>

      <ZPAYMENTID>缴费申请号</ZPAYMENTID>

      <ZFIGRJCE>财务实缴个人缴存额</ZFIGRJCE>

      <ZFIDWJCE>财务实缴单位缴存额</ZFIDWJCE>

      <ZDATE>传输日期</ZDATE>

      <ZTIME>传输时间</ZTIME>

      <ZESTIMATEDTIME>计提时间</ZESTIMATEDTIME>

      <ZWITHDRAWAVOUCHER>计提凭证</ZWITHDRAWAVOUCHER>

      <ZPAYMENTTIME>支付时间</ZPAYMENTTIME>

      <ZPAYMENTVOUCHER>支付凭证</ZPAYMENTVOUCHER>

      <ZAPPROVALSTATUS>审批状态</ZAPPROVALSTATUS>

      <ZPAYMENTSTATUS>支付状态</ZPAYMENTSTATUS>

      <ZERROR>错误消息</ZERROR>

      <Z00HRJBY1></Z00HRJBY1>

      <Z00HRJBY2></Z00HRJBY2>

    </ITEM>

  </Document>

1.2                  返回报文(外围系统提供)

T_OUTPUT XML格式:

<?xml version="1.0" encoding="UTF-8"?>

  <Document>

    <Item>

      <ZPAYMENTID>缴费申请号</ZPAYMENTID>

      <ZSTATE>反馈状态</ZSTATE>

      <ZMASSAGE>错误消息</ZMASSAGE>

      </ITEM>

  </Document>

三、      接口配置

登陆网址:http://sgnwpid.sgcc.com.cn:50000/dir/start/index.jsp

事物码登陆:SXMB_IFR

A.     配置ESR(enterprise service builder)

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第1张 

在对应命名空间下进行配置

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第2张 

1.      导入RFC

右键进行导入

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第3张 

输入目标RFC的服务器地址,实例编号,gui账号密码。点击继续

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第4张 

展开,找到对应RFC,勾选导入

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第5张 

导入后,右键激活该RFC

 10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第6张

2.      创建External definitions

外部调用定义。(此接口不需要)

3.                      创建Data types

1)      发送方

接口经过ESB通道,所传数据以<![CDATA[*]]>包裹xml报文形式进行传输,所以发出方只需要输入输出各一个参数即可,此处我们使用公共数据类型:

DT_SHARE_SGHRERP2CEERP_REQ

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第7张 

DT_SHARE_SGHRERP2CEERP_RESP

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第8张 

2)      接收方

RFC类型接口,RFC侧不需要进行DT配置。RFC的导入导出参数定义就是。

4.      创建Message types

参考data types进行创建即可,RFC侧同理

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第9张 

5.      创建Service interface(服务接口)

 10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第10张

RFC侧接口无需继续创建,只需创建外围系统侧的SI即可,关于如何判断SI的类别(或出入站),可以从接口设计去考虑,发送方(sender)将数据发送到出站接口(outbound),再到集成引擎(PI),集成引擎将消息发送给入站接口(inbound)再到接收方(reciver);所以对于示例接口来说,如上图:

outbound :SI_13589_SGHRERP2CEERP_Z00HRJGJJREVFI

inbound:RFC

具体参数如下:

 10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第11张

类型:outbound

模式:同步

消息类型:MT

激活SI

6.      创建Imported Archives

按照字段映射写好xml文档,循环取输入出结构拼入RFC的导入导出参数中。具体如下:

 

创建IA,并导入以上4个xsl文档,激活

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第12张

7.      创建 Operation Mappings

分别指定发出方接口、接收方接口。

发出方:SI_13589_SGHRERP2CEERP_Z00HRJGJJREVFI

接收方:Z00HRJ_GJJ_REV_FI

外围系统作为发出方,数据链路显示需先经过ESB通道才会到达PI,同样ERP返回消息时由PI到外围同样需经过ESB。经过ESB的数据均需使用<![CDATA[….]]>进行封装,故在PI内需进行转换。将ESB发送进来的cdata转成xml在进行接口间字段映射,返回时先进性接口间字段映射后将其封装成cdata。

 10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第13张

 10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第14张

B.     配置IB(Integration Builder)

 10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第15张

1.      创建Configuration Scenario

创建场景,将各个组件添加到场景中。

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第16张 

2.      添加Business System

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第17张

3.      创建发送方Communication Channel,对象BS_SGHRERP

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第18张

4.      创建Sender Agreement

 10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第19张

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第20张

5.      创建Receiver Determination

RD用于确认接收方系统

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第21张

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第22张

6.      创建Interface Determination

ID用于确认接收方系统的接收接口

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第23张

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第24张

7.      创建接收方Communication Channel,对象PD1CLNT201

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第25张 

8.      创建Receiver Agreement

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第26张

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第27张

9.      一步一激活,最后激活CC

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第28张 

10.  导出wsdl

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第29张

点击望远镜, 按照如下格式修改URL并填入

http://10.1.169.34:50000/XISOAPAdapter/MessageServlet?channel=:BS_SGHRERP: CC_13589_SGHRERP2CEERP_Z00HRJGJJREVFI_OU

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第30张 

选择对应接口SI_13589_SGHRERP2CEERP_Z00HRJGJJREVFI

 10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第31张

填写CC:BS_SGHRERP

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第32张

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第33张

11.  RFC逻辑实现

10-PI开发手册-ERP发布服务供外围系统调用(RFC类型) 随笔 第34张

扫码关注我们
微信号:SRE实战
拒绝背锅 运筹帷幄