前言:在项目中遇到任务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镜像下载地址:
- 编程宝库
- 清华大学开源镜像-OPENJDK
确认电脑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接口开发从配置->开发->测试圆满的成功了。本次案例是一个同步接口作为说明,至于异步模式以及其他协议的接口,以后有机会再说明。