10-SAP PI开发手册-ERP发布服务供外围系统调用（RFC类型）

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

一、文档信息

版本号*	更新日期*	姓名*	更新内容及更新理由*	备注*
V1.0	2019/02/19	fanjb	文档创建	以福利接口13589（Z00HRJ_GJJ_REV_FI）为例，外围系统调用集中部署ERP
V1.1	2019/04/04	fanjb	文档修正	格式调整

二、接口内容

1. 接口详细信息

T_ Z00HR_GJJ_ACCOUNT_BACK XML格式：

1.1 传入报文（外围系统提供）

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

　　　　<Item>

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

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

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

　　　　</ITEM>

　　</Document>

1.2 返回报文（外围系统提供）

T_OUTPUT XML格式：

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

　　　　<Item>

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

　　　　　　</ITEM>

　　</Document>

三、接口配置

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

事物码登陆：SXMB_IFR

A. 配置ESR（enterprise service builder）

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

1. 导入RFC

右键进行导入

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

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

导入后，右键激活该RFC

2. 创建External definitions

外部调用定义。（此接口不需要）

3. 创建Data types

1) 发送方

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

DT_SHARE_SGHRERP2CEERP_REQ

DT_SHARE_SGHRERP2CEERP_RESP

2) 接收方

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

4. 创建Message types

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

5. 创建Service interface（服务接口）

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

outbound ：SI_13589_SGHRERP2CEERP_Z00HRJGJJREVFI

inbound：RFC

具体参数如下：

类型：outbound

模式：同步

消息类型：MT

激活SI

6. 创建Imported Archives

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

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

7. 创建 Operation Mappings

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

发出方：SI_13589_SGHRERP2CEERP_Z00HRJGJJREVFI

接收方：Z00HRJ_GJJ_REV_FI

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