RFC-to-Web Service Scenario

by Neeraja
This document describes how the Custom RFC client application in SAP R/3 System invokes a free
Web service (that is hosted over the internet) using SAP XI. For our demo purpose, we have used a
free web service available on the Internet. Details for the same are provided in the next section.
About the web service:
In this example scenario we will be using GetQuote method of Web service DelayedStockQuote.
This method retrieves the Stock quote for the given Stock symbol. The method GetQuote has an
input that takes in two parameters Stock Symbol and License Key and returns the following
information.

StockSymbol,
LastTradeAmount,
LastTradeDateTime,
StockChange,
OpenAmount,
DayHigh,
DayLow,
StockVolume,
PrevCls,
ChangePercent,
FiftyTwoWeekRange,
EarnPerShare,
PE,
CompanyName.

Link to webservice:
http://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?op=GetQuote
WSDL of the webservice:
http://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?WSDL
Download WSDL from the above link.
1.

Configurations at the Sender System (SAP R/3)

1.1 Create
RFC
destination:
To
create
the
RFC
go
to
TCODE:
SM59
Create
new
destination
of
type
T
(TCP/IP)
Make sure you select Registered Server Program option before writing your program ID
Write
your
program
ID
(remember
it's
case-sensitive)
In the gateway host and gateway service write the values of your "Application system" business
system (R/3
System)

1.2 Create Remote function module

Create Remote Function module in R/3 system with the following parameters.
Import:

Export:

Source
code:

1.3 Create Report Program

Create a report program in the R/3 system which makes Synchronous call of a remote-enabled
function module ZN_GET_QUOTE.
Code snippet
REPORT ZTEST_WEBSERVICE.
parameters: p_stsym(30).
data:
StockSymbol type char30,
LastTradeAmount type char30,
LastTradeDateTime type char30,
StockChange type char30,
OpenAmount type char30,
DayHigh type char30,
DayLow type char30,
StockVolume type char30,
PrevCls type char30,
EarnPerShare type char30,
companyname type char30,
QuoteError type char30.
CALL FUNCTION 'ZN_GET_QUOTE' destination 'RFC'
EXPORTING ST_SYM = p_stsym LKEY = '0' IMPORTING
StockSymbol = StockSymbol
LastTradeAmount = LastTradeAmount
StockChange = StockChange
OpenAmount = OpenAmount
DayHigh = DayHigh
DayLow = DayLow
StockVolume = StockVolume
PrevCls = PrevCls
EarnPerShare = EarnPerShare
companyname = companyname
QUOTEERROR = QuoteError.
if quoteerror NE 'true' and quoteerror NE 'TRUE'.
write:
/'StockSymbol:',StockSymbol,
/'LastTradeAmount:',LastTradeAmount,
/'LastTradeDateTime:',LastTradeDateTime,
/'StockChange:',StockChange,
/'OpenAmount:',OpenAmount,
/'DayHigh:',DayHigh,
/'DayLow:',DayLow,
/'StockVolume:',StockVolume ,
/'PrevCls:',PrevCls,
/'EarnPerShare:',EarnPerShare,
/'companyname:',companyname,
/'QuoteError:',QuoteError.
else.
write:/ 'Invalid Stock symbol'.
endif.
2.

Configurations in the Integration Repository

2.1 Import the WSDL:

Import the WSDL of the webservice as an External Definition; these structures are needed as we
need to accomplish the mapping between the RFC.Request to SOAP.Request and SOAP Response
to RFC Response.

Note: Usually when we import the WSDL as an External Definition, we get the relevant messages for
the request and response structures along with it.

2.2 Import RFC

Import

the

RFC

ZN_GET_QUOTE

created

in

the

previous

step

from

R/3

system.

Note: Usually when we import the RFC from R/3 system, we get the relevant messages for the
request and response structures along with it.
2.3 Define Message Interface
As imported WSDL and RFC messages can be used as Data types, Message types and outbound
message interface we dont require creating those.
Define inbound synchronous message Interface

2.4 Create Message Mappings

Here we need to create two mappings, first between RFC Request (ZN_GET_QUOTE.Request) to
SOAP Request (GetQuoteSoapIn) and second between SOAP Response (GetQuoteSoapOut) to
RFC Response (ZN_GET_QUOTE.Response).

2.5 Define Interface Mapping

Define Interface mapping for the above created mappings.

Request mapping

Response mapping

Continued...
3.

Configurations in the Integration Directory

3.1 Create sender communication channel

Create Sender Communication channel (RFC adapter) under the Sender Business system

Make sure the Program id specified here and the Program id specified in the RFC destination created
above are same.
3.2 Create receiver communication channel
Create Receiver communication channel (SOAP adapter) under the Receiver business service.

We

need

to

specify

the

following

in

the

SOAP

adapter;

1. Target Url : http://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?WSDL

2. Configure Proxy: If your network has a proxy setup you need to provide the details of the same.
3. Configure
proxy
User
Authentication: to
be
specified
in
case.
4. SOAP Action: we can find out the SOAP Action for the GetQuote method of the Webservice
DelayedStockQuote in WSDL.

3.3 Create Sender Agreement

Sender adapter in the sender agreement converts the message into XML format

3.4 Create Receiver Agreement

Receiver Agreement defines to which receiver the message, has to be routed.

3.6 Create Interface Determination

Interface Determination identifies the Mapping between the sender interface and Receiver interface.

3.5 Create Receiver Determination

Receiver Determination defines the possible receivers for a sender and an outbound interface
combination.

4.

Testing the Scenario

In the Sender R/3 system Execute the Report program we have created earlier. When the program is
executed with Stock symbol it should get the details of that stock symbol from the Webservice.
Below is the screenshot of the output we got when the program is executed with the StockSymbol R