记录ABAP开发的日常——SAP_PO开发同步接口案例

前言：在项目中遇到任务PO接口，需求是SRM发送采购订单信息给SAP,SAP根据信息调用BAPI同步数据，在此作为案例记录。

本次接口采用的协议是SOAP,当然也有其他的协议比如REST等等，在此不做说明。

同步PO接口开发步骤:

通过SAP NetWeaver注册PO接口服务；
通过SAP SPROXY创建服务实施代理类；

1.注册接口服务

1.1 登录SAP NetWeaver网页

根据BASIC提供的PO组件网址以及账号密码登录:https://{ip}:{port}/dir/start/index.jsp

PO接口配置相关的属性都会在这个网页中进行。

1.2 配置ESR( Enterprise Services Repository)

会下载一个repository.jnlp文件，这个文件必须用java开发工具集JDK里面的JRE运行环境中的javaws.exe文件运行打开,在java高版本中JRE里面是没有这个文件的，本人亲测大概只有JDK1.8.2-1.8.5这几个版本目前存在javaws.exe文件，如果电脑无法运行jnlp文件可以尝试更换JDK版本。

在此附上几个国内JDK镜像下载地址：

确认电脑JRE中存在javaws.exe文件后，我们用下载repository.jnlp文件后，选择用电脑JRE中的javaws.exe文件打开：

有些浏览器可能会报异常消息，忽略保留文件

上图的Java(TM) Web Start Launcher 就是用来打开jnlp文件的应用，这里显现是因为我已经不是第一次打开了，如果你是第一次打开jnlp，需要选择下面的更多应用，找到JRE中的javaws.exe文件打开，后续就会出现JWSL图标，不用再重新选择。

打开后会有陆续画面闪过，第一次可能还要同意，允许之类的，我们都选择允许。

最后会打开一个如下图的界面：

里面有多个已经创建好的技术系统，我们这次的例子是跟SRM进行交互，所以接口配置会放在SRM下，如果是刚开始配置PO接口，我们就需要从头开始创建产品、技术系统等等，本例中因篇幅的关系不做过多说明。

1.3 ESR详细配置

1.3.1 创建命名空间

打开SRM技术系统后看见多个命名空间，我们的接口配置属性都会放在命名空间下，命名空间能够保证接口的唯一性。

命名空间的命名规则：一般为技术系统域名/平台/模块，如上面的:https://srm.com/SAP/MM

如何创建命名空间：

1.3.2 创建文件夹

打开命名空间，发现有许多的文件夹，这里每一个文件夹对应一个接口，我们要配置采购订单创建修改接口，自然也需要创建一个文件夹：

选中命名空间：

创建完成后，在命名空间里就能看到文件夹，左上角有个红色标记，表示未激活，所以我们需要激活文件夹：

激活完成后，红色标识会消失，表示成功激活

1.3.3 创建DT(Data Type)

命名规则：DT_{系统}_{接口描述：首字母大写}_In/Out

创建：DT_ERP_Po_Create_And_Update_In

选择文件夹，右键New:

同样的步骤创建采购订单创建修改接口传出数据类型结构：DT_ERP_Po_Create_And_Update_Out

1.3.4 创建MT(Message Type)

命名规则：MT_{系统}_{接口描述：首字母大写}_In/Out

创建：MT_ERP_Po_Create_And_Update_In

选择文件夹，右键New:

先保存，再激活；然后以同样的步骤创建：MT_ERP_Po_Create_And_Update_Out

1.3.5 创建SI(Service Interface)

命名规则：SI_{系统}_{接口描述：首字母大写}_In/Out

创建：SI_ERP_Po_Create_And_Update_In

选择文件夹，右键New:

先保存，再激活；然后以同样的步骤创建：SI_ERP_Po_Create_And_Update_Out 但是有些区别：如下图

1.3.6 创建MM(Message Mapping)

命名规则：MM_{系统}_{接口描述：首字母大写}_In/Out

创建：MM_ERP_Po_Create_And_Update_In

选择文件夹，右键New:

右边也是选择同一个MT

先保存，再激活；然后以同样的步骤创建：MM_ERP_Po_Create_And_Update_Out

1.3.7 创建OM(Operation Mapping)

命名规则：OM_{系统}_{接口描述：首字母大写}

OM只需要创建一个，所以不分In和Out

创建：MM_ERP_Po_Create_And_Update

选择文件夹，右键New:

如此我们在ESR中的配置就完成了，接下来需要去配置IB

1.4 配置ID(Integration Directory)

点击IB之后会现在一个directory.jnlp文件。我们同样下载并打开。

最后打开一个如下界面：

打开社区组件，看到有Business System 和 Business Component,由于本接口是SRM作为发送方，SAP作为接收方，所以需要在各自业务系统里创建用于接受数据协议的适配器类型：

SRM方面：

上面WSDL的地址就是该接口的访问地址，等下在后面测试的时候要用到,回头提供给第三方SRM调用。

注意：如果后来有调整DT的字段，一定要重新映射下字段即把之前MM的映射删除，重联一下。

2.SAP端创建代理实施类

登录SAP GUI,使用事务码:SPROXY

在这个事务码下可以看见之前在ESR配置技术系统下的所有接口信息，依次打开路径:Source->ESR->技术系统->命名空间，找到我们配置的接口SI:

同步代理类激活的时候会自动产生一些结构和代理实施类，我们可以在类方法中查看参数，进行逻辑处理，后续有接口字段调整，需要右键重新生成，然后再激活。

然后激活代理类，这样整个接口从配置到开发就完成了，接下来测试下我们开发的接口

3.测试

如果是同步接口，可以直接通过SPROXY测试，点击激活按钮旁边的执行，可以看到接口的XML形参，点击工具栏的编辑按钮，输入实际数据，再点击执行，就可以看到接口的返回结果；

除此之外，还可以用第三方工具测试接口的功能，接口测试工具很多，本次选择SOAP UI，是一款免费开源的接口测试工具，同意有付费版本，不过免费的就可以满足日常的使用了，这里简单介绍如何用SOAP UI测试我们开发的接口。

3.1 打开SOAP UI软件，新建SOAP PROJECT:

看到以上就说明我们PO接口开发从配置->开发->测试圆满的成功了。本次案例是一个同步接口作为说明，至于异步模式以及其他协议的接口，以后有机会再说明。