1转自:https://www.cnblogs.com/fanjb/p/10677018.html

8年进入国网项目后陆陆续续做了一些接口,按实现方法去分有RFC和代理类sproxy类型,按服务提供方向分有提供服务给外围的也有调用外围服务的。随笔本身是为了有一天离开项目时送给交接人的开发手册,放上来给大家做个学习参考。由于这边项目普遍要经过ESB通道,在IA的开发配置方面大家自行理解吧。本篇是一个ERP发布服务供外围系统调用的RFC类型同步接口,其余三篇有时间再慢慢传。 

一、      文档信息

版本号*

更新日期*

姓名*

更新内容及更新理由*

备注*

V1.0

2019/02/19

fanjb

文档创建

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

V1.1

2019/04/04

fanjb

文档修正

格式调整

二、      接口内容

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

1.      接口详细信息

T_ Z00HR_GJJ_ACCOUNT_BACK XML格式:

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

<?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)

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

1.      导入RFC

右键进行导入

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

导入后,右键激活该RFC

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

2.      创建External definitions

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

3.                      创建Data types

1)      发送方

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

DT_SHARE_SGHRERP2CEERP_REQ

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

DT_SHARE_SGHRERP2CEERP_RESP

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

2)      接收方

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

4.      创建Message types

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

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

outbound :SI_13589_SGHRERP2CEERP_Z00HRJGJJREVFI

inbound:RFC

具体参数如下:

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

类型:outbound

模式:同步

消息类型:MT

激活SI

6.      创建Imported Archives

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

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

7.      创建 Operation Mappings

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

发出方:SI_13589_SGHRERP2CEERP_Z00HRJGJJREVFI

接收方:Z00HRJ_GJJ_REV_FI

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

B.     配置IB(Integration Builder)

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

1.      创建Configuration Scenario

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

2.      添加Business System

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

4.      创建Sender Agreement

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

5.      创建Receiver Determination

RD用于确认接收方系统

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

6.      创建Interface Determination

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

8.      创建Receiver Agreement

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

10.  导出wsdl

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

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

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

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

选择对应接口SI_13589_SGHRERP2CEERP_Z00HRJGJJREVFI

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

填写CC:BS_SGHRERP

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

11.  RFC逻辑实现

SAP PI开发手册-ERP发布服务供外围系统调用(RFC类型)-LMLPHP

05-14 09:46