SAP WebService发布实战：从RFC函数到WSDL的完整指南

简介面向SAP实施顾问与开发人员围绕ERP系统间接口集成场景讲解如何在SAP中发布和调用Web Service。文档以docx格式提供共1个文件压缩包约1.64MB内容包含完整操作截图与关键配置说明。文档从SE37创建函数模块、生成无认证Web服务、激活并发布再到通过SOAMANAGER完成服务配置与WSDL查看同时覆盖SAP作为客户端调用外部服务的全流程包括SE80创建企业服务代理、导入外部WSDL、激活代理类、创建逻辑端口并完成连通性测试。整个操作链条完整并针对不同SAP版本界面差异和常见配置点给出提示适合正在学习SAP接口开发或需要快速实现系统对接的读者参考。目前已有864人学习下载对掌握SAP Web Service发布与调用有直接帮助。1. 在SAP上发布WebService先纠正一个关于集成成本的老观念做SAP集成的这些年我见过太多甲方被中间件厂商的报价吓退转头让ABAP开发手工拼XML去调外部接口。其实SAP系统自己就能当服务提供者把RFC函数、类方法或BAPI发布成标准WebService外部系统拿个WSDL就能接。这件事在ECC和S/4HANA的NetWeaver栈上都是原生能力不需要额外买PI/PO也不碰SAP Cloud Platform。适合所有ABAP开发者和做系统集成的顾问——尤其当对方系统是Java、.NET或者低代码平台时让SAP把一个函数模块暴露成SOAP服务比你给对方写RFC SDK要快得多联调成本也低。本篇就把从函数模块到WSDL这条完整路径讲清楚重点在SE80生成服务、SOAMANAGER运行时配置和后面躲不开的坑。2. 发布WebService前先摸清家底SOA架构、权限与工具链2.1 SAP的WebService能力从哪来NetWeaver SOA架构与ICMSAP从NetWeaver 7.0起就内置了完整的SOA技术栈ABAP AS应用服务器通过ICMInternet Communication Manager进程接收HTTP请求把SOAP报文转给ABAP runtime里的WebService框架处理。这意味着在一个标准的ECC 6.0或者S/4HANA系统上只要ICM是活的、ICFInternet Communication Framework服务节点是绿的你就有发布WebService的全部条件。很多ABAP开发不知道自己的开发机其实装了完整的WebService工具集——SE80里建企业服务的向导、SOAMANAGER运行时管理、事务码LPCONFIG看逻辑端口全都在。这套东西统一叫SAP NetWeaver Application Server的WebService框架所有SAP发布的SOAP服务最终都落在一个Endpoint上由ICM监听HTTP(S)端口接收入站请求。这里要澄清一个常见误解SAP WebService分两条线。一条是这里讲的基于ABAP AS的WebService直接由RFC函数或ABAP类生成另一条是走ESREnterprise Services Repository的Enterprise Service那是PI/PO中间件生态里的概念。我们做系统集成时大多数场景用前者就够ESR那一套反而重、实施周期长。判断依据很简单对方只是要数据或触发功能不是要完全遵循你企业服务治理体系直接走ABAP WebService。2.2 发布前要确认的三件事函数模块、权限与SICF服务状态动手之前我先确认三件事任何一个没满足都会在发布后让你怀疑人生。第一函数模块必须是Remote-Enabled的。SE80进函数模块属性找到Processing Type勾上Remote-Enabled ModuleRFC enabled。普通函数模块不能直接发布成WebService向导里根本选不中。第二当前用户要有SE80在线修改、SOAMANAGER操作和SICF的权限。SAP Basis管理员经常把开发者的权限收得很紧导致发布向导走到一半报权限不足。项目上遇到过几次最后都是让basis在角色里补了S_ICF授权字段。第三ICF服务节点/sap/bc/soap/是激活状态——事务码SICF里展开default_host → sap → bc → soap看到绿色勾就说明正常。很多幺蛾子都是这个节点被误删或停用导致的后文避坑章节还会提到。提示如果你用的是S/4HANA 2020及以后版本SQL上要留意AMDP和CDS view的调用习惯但发布WebService的路径和经典ECC基本一致。3. 用SE80从RFC函数生成WebService最小可跑通路径3.1 写一个RFC启用的函数模块从ABAP代码到可发布状态我一般习惯先写函数模块再发布比直接用类方法直观也方便后续做权限检查和日志埋点。用一个查询物料主数据的例子最直观输入物料号返回物料描述、物料类型和基本计量单位。SE80里新建一个函数组然后创建函数模块Z_GET_MATERIAL_INFO属性里勾上Remote-Enabled Module再写代码FUNCTION Z_GET_MATERIAL_INFO. *---------------------------------------------------------------------- **本地接口 * IMPORTING * VALUE(IV_MATNR) TYPE MATNR * EXPORTING * VALUE(EV_MTART) TYPE MTART * VALUE(EV_MAKTX) TYPE MAKTX * VALUE(EV_MEINS) TYPE MEINS * EXCEPTIONS * MATERIAL_NOT_FOUND *---------------------------------------------------------------------- CLEAR: ev_mtart, ev_maktx, ev_meins. SELECT SINGLE maktx FROM makt INTO ev_maktx WHERE matnr iv_matnr AND spras sy-langu. IF sy-subrc 0. RAISE material_not_found. ENDIF. SELECT SINGLE mtart meins FROM mara INTO (ev_mtart, ev_meins) WHERE matnr iv_matnr. ENDFUNCTION.这里有几个参数值得讲。IV_MATNR是导入参数发布成WebService后会在SOAP请求的IV_MATNR元素里传进来EV_MAKTX、EV_MTART、EV_MEINS是导出参数会出现在SOAP响应的对应元素中MATERIAL_NOT_FOUND异常会映射成SOAP Fault外部系统拿到后可以走异常分支而不是解析空数据。spras sy-langu是按当前登录语言取物料描述发布后外部系统调用时描述语言取决于调用时的语言环境——这是一个我后面会讲到的坑最好直接固定成sy-langu 1中文或让调用方传语言参数。表类型参数在发布时会展开成复杂类型外部系统那边解析会麻烦一点能不用就不用。3.2 SE80发布向导从函数模块到WSDL生成函数模块保存并激活后开始最核心的一步。SE80的对象树里找到Z_GET_MATERIAL_INFO右键选创建 → 企业服务/Web服务弹出来的窗口选Service Provider提供者。这里一定要选Provider选成Consumer就变成SAP去调外部服务了方向完全相反。接下来向导会有几步配置其中比较关键的是服务名和接口命名空间。服务名我习惯直接用函数模块名比如Z_GET_MATERIAL_INFO_SVC方便在SOAMANAGER里搜索。命名空间建议用企业域名反写比如urn:sap:com:document:sap:soap:functions:mc-style这种风格或者直接写http://yourcompany.com/z_get_material_info关键是命名空间一旦发布出去就不要再改改了客户端那边WSDL全部失效。我见过有人发布时随意填了一个临时命名空间后来想改正规的结果所有对接方都返工。这个命名空间是SOAP协议定位服务的重要依据外部系统生成客户端代码后写死在代码里。向导完成后系统会自动生成一个WebService对象进入激活状态。此时你可以用浏览器直接访问WSDL地址http://服务器:端口/sap/bc/srt/wsdl/srvc_服务名/wsdl11/allinone/ws_policy?wsdl。如果这个地址能打开且能看到wsdl:definitions标签说明服务已经在ICM上注册成功了。SAP的端口默认是8000HTTP或443HTTPS具体看你的ICM配置。3.3 SOAMANAGER运行时配置让外部系统真正能调到发布向导生成服务只是第一步运行时配置才是多数人卡住的地方。打开事务码SOAMANAGER这是SAP WebService的运行时管理入口点Web Service配置搜索刚发布的服务进入详情页。这里要做三件事第一创建绑定Binding。绑定相当于给服务定一个对外暴露的URL和传输协议没有绑定外部系统就没有可访问的endpoint。进入绑定配置后传输协议选HTTP身份认证方式我一般选用户ID/密码这也是通用性最好的——外部系统用Basic Auth传SAP账号密码就能调用。如果你对接的是银行或大企业他们可能要求证书认证或SAML那就要再配WS-Security策略复杂度高一个量级不建议首次发布就上。第二配置逻辑端口Logical Port。逻辑端口是SAP侧调用服务时的配置单元虽然外部调用不需要它但你后文要用ABAP客户端自测这个服务时就必须配一个。事务码LPCONFIG里新增逻辑端口填上服务名和endpoint即可。第三激活配置。绑定创建完一定要点激活而且要在SOAMANAGER里检查服务的配置状态是已激活。我见过太多人绑定配好了忘了激活外部系统拿着WSDL地址能看到XML却永远调不通。这个状态检查就是一个习惯问题但也是让乙方摸不着头脑的玄学重灾区——其实都不是玄学就是配置状态没看。4. 测试与调用从SoapUI到ABAP客户端4.1 用SoapUI验证服务排错最快的路径服务发布完成我永远先用SoapUI验证一遍再通知外部对接方。原因很简单SoapUI的报错信息比SAP侧友好得多而且能直接看到完整的SOAP报文结构。SoapUI里新建SOAP项目WSDL地址填上一步拿到的地址SoapUI会自动解析出所有操作。双击Z_GET_MATERIAL_INFO这个operation右侧会出现Request XML模板填入物料号soapenv:Envelope xmlns:soapenvhttp://schemas.xmlsoap.org/soap/envelope/ xmlns:urnurn:sap:com:document:sap:soap:functions:mc-style soapenv:Header/ soapenv:Body urn:Z_GET_MATERIAL_INFO IV_MATNR100-100/IV_MATNR /urn:Z_GET_MATERIAL_INFO /soapenv:Body /soapenv:Envelope点击运行如果一切正常响应部分会返回物料类型、描述和计量单位。如果返回401说明认证没带上在SoapUI的Request属性里加一个Authorization: Basic Base64编码的用户名:密码头。如果返回403但认证没问题大概率是ICF节点/sap/bc/soap/状态不对去SICF里查。苏ICP备返回500的话去事务码STRUST看SSL证书就是个容易忽略的方向——如果服务器用的是自签名证书SoapUI第一次连接时会因为证书不受信任直接拒绝握手你在SoapUI设置里关掉SSL验证才能继续测。4.2 ABAP侧调用自己发布的WebService验证逻辑端口是否正常有时候没有外系统只想快速验证服务逻辑对不对我就在ABAP里写个简单的调用程序。用SE80创建一个报表程序REPORT Z_TEST_WS_CALL. DATA: lo_client TYPE REF TO zco_z_get_material_info, lo_input TYPE zget_material_info, lo_output TYPE zget_material_info_response. PARAMETERS: p_matnr TYPE matnr OBLIGATORY. START-OF-SELECTION. CREATE OBJECT lo_client EXPORTING logical_port_name Z_GET_MATERIAL_INFO_LP. lo_input-iv_matnr p_matnr. CALL METHOD lo_client-z_get_material_info EXPORTING input lo_input IMPORTING output lo_output. WRITE: / 物料类型:, lo_output-ev_mtart, / 描述:, lo_output-ev_maktx, / 计量单位:, lo_output-ev_meins.这个方式调用的是SAP内部的WS Runtime走的是逻辑端口而不是HTTP外部地址。也就是说逻辑端口配错了、服务绑定没激活、甚至SOAMANAGER里安全配置有问题都会在这个程序里暴露出来。在通知外围系统正式联调之前先在ABAP侧跑通这条链路是血泪经验换来的习惯。很多集成问题根本不在SAP侧就在客户方防火墙和外网代理你在自己系统里先跑通一遍联调时就少一项排查变量。4.3 WSDL里必须记住的三个参数命名空间、SOAPAction与编码外部系统拿到WSDL后开发人员经常会跑来问三个问题端点地址填哪个、SOAPAction要不要填、为什么返回的中文乱码。我这边的标准答案是端点地址就是SOAMANAGER里那个Binding对应的URL通常长这样http://服务器:端口/sap/bc/srt/soap/后面跟着一堆路径参数直接复制即可。SOAPAction在SAP发布的服务里一般不用填SAP的WS框架不校验SOAPAction头置空或填urn:get都不会错。但如果你对接的是老系统如Oracle EBS它可能必须要有SOAPAction这个要看对方框架的规矩。编码方面SAP的SOAP服务默认UTF-8外部系统如果拿ISO-8859-1解析WSDL或报文中文必然变问号。所以我在发布前就会跟对方强调所有字符串字符集用UTF-8协议版本用SOAP 1.1或1.2都行但WSDL里的soap:address要跟SoapUI实测结果保持一致。5. WebService发布避坑指南5个真实踩坑记录5.1 服务发布成功但外部访问403ICF服务节点被停现象WSDL地址在浏览器能打开但外部系统POST请求返回HTTP 403 ForbiddenSAP侧SM21日志里没有ABAP异常。原因SAP默认的WebService运行时需要ICF服务树里的sap/bc/soap节点处于激活状态。很多basis做安全加固时会按SAP Note停用一批高危ICF节点有些操作过于激进会把soap节点也停掉导致外部HTTP请求被ICM直接拒绝根本进不了ABAP层。解决事务码SICF展开default_host → sap → bc找到soap节点右键激活。激活后立刻回SoapUI重测。这个坑的特点是你自己浏览器访问WSDL正常因为静态WSDL走的是另一个路径但POST就不通。我也遇到过ssl节点的ssl_handshake禁用导致的类似问题逻辑一致处理手段如上。5.2 SoapUI返回401 Unauthorized认证方式与客户端不匹配现象SoapUI点击运行后返回401SAP侧SWNC_HTTP日志能看到请求进来了但被拒绝。原因SOAMANAGER里绑定的认证方式与你SoapUI里带的认证头不一致。比如你绑定配置用的用户ID/密码但SoapUI的Auth标签页没加Basic Auth或者用户名密码错了。解决在SoapUI的Request右键点击Auth填入SAP登录账号密码。注意这是SAP系统用户不是数据库账号而且该用户要有访问该服务的授权——SE80创建服务时默认会在RFC授权里放开但如果你们环境有严格的角色控制还需要检查S_RS_ADMIN或S_RFC角色的授权参数。SAP的PS模块用户经常没有WS调用权限让basis加就好。这个坑在联调阶段占了我排查时间的四成不算技术难点纯属协作习惯问题。5.3 函数模块的表类型参数WSDL生成时直接报错现象函数模块里用了标准表做导入参数SE80发布向导走到一半报错提示不能生成WSDL的复杂类型。原因SAP WebService框架无法直接映射某些ABAP表类型——特别是带表头的标准表、或者内表参数没有设置Alias的。经典案例是函数模块里声明了TYPE TABLE OF而没有定义行结构对应的DDIC类型。解决把参数改成引用了DDIC结构的内表比如TYPE TABLE OF ZSMAT_INFO不要用TYPE STANDARD TABLE这种匿名行类型。更要命的情况是传的是LIKE TABLE OF一个工作区这种在WSDL生成时必报错必须改成TYPE TABLE OF DDIC类型。顺带建议对外发布的函数不要用TABLES参数那是老式RFC的写法WebService向导还能生成但外部解析起来痛苦极了。5.4 修改函数模块后外部拿到的还是旧接口缓存与版本幻觉现象你改了函数模块的代码或签名发布、激活、通知对方对方测试了半天发现行为还是旧的甚至参数都对不上。原因SAP的WS框架对WSDL和运行时类有缓存。函数模块签名变了以后SE80里生成的WS代理类不一定同步更新SOAMANAGER里的服务定义也可能还是旧版本。解决修改签名后必须删掉原有WS对象重新生成而不是在原有对象上改参数。代码内容修改可以原地改签名类修改请重新发布。另外客户端那边如果是Java的CXF或Axis2它们的WSDL客户端代码也需要重新生成。这个坑从SAP NetWeaver 7.0起就有到现在还没根治——所以我的规矩是接口设计阶段签一次定好测试阶段改代码无所谓联调阶段签名冻结不要平移参数名。5.5 中文乱码全是字符集没对齐现象外部系统调用服务返回的物料描述是???或者乱码。原因SAP系统常见的code page是多字节的但SOAP报文用的是UTF-8编码。外部系统解析时如果按本地字符集解码中文就废了。还有一种情况是函数模块里处理字符串时用了非Unicode的操作比如直接在内存中做变长操作破坏了UTF-8字节序列。解决SDCCN层面确保系统安装的是Unicode版本——ECC 6.0以上基本都是Unicode系统非Unicode系统是极老的4.x时代。函数模块边界上不要用CL_ABAP_CODEPAGECONVERT_FROM做手工转换让WS框架自己处理。外部系统那边检查HTTP响应的Content-Type是否有charsetUTF-8没有就要在框架配置里补上。我记得有个项目对接一个C#写的客户端对方在HttpWebRequest里没有设置AcceptCharset抓包看到SAP返回的是UTF-8客户端按GB2312解码后来加了一行代码就解决了。字符集问题九成是客户端解析问题SAP侧反倒很简单。6. 发布之后的活儿版本管理、回归测试与我的日常习惯服务上线不等于项目结束恰恰是麻烦的开始。我给自己定了几条规矩这几条在后续维护时帮我省了不计其数的时间。第一接口升级改服务名不改WSDL。需要加字段时保留原服务不动新建一个服务名带版本号比如Z_GET_MATERIAL_INFO_V2命名空间也用V2。等所有老调用方都迁移后SICF里把老服务停掉。这样做的唯一缺点是SOAMANAGER里服务列表会越堆越多但换来的是随时可回滚的后悔药——联调现场翻车了也能瞬间切回老版本。第二每次修改后自动导出WSDL存档。在SoapUI里把WSDL文件另存到项目目录文件名带上日期。这个积累很重要真出问题时能拿出你发布当天的原始WSDL跟对方的SDK代码对比谁改了什么一目了然。我吃过一次亏对方说我们改了接口结果一查是他们用的旧版WSDL生成的代理类有存档就能当场甩证据。第三维护一个SoapUI回归工程。把每个服务的正常场景、异常场景物料不存在、无权限都存成test case服务每次发版本就跑一遍全部用例。改造服务时这个回归工程就是你的安全网。除了SoapUISAP侧也可以用事务码SXI_MONITOR查看WS接口消息日志但这个事务码主要监控XI/PI消息ABAP WebService的调用日志在SWNC_HTTP里查两个日志互补使用。做SAP WebService这件事技术上没有多难难的是把接口契约、命名规范、验证手段这些流程坚持做下去一年后你回头看就会发现所有的线上事故都发生在踩了流程省略的坑的地方。希望帮到你。本文还有配套的精品资源点击获取