SAP Receive RFC activity

Use the SAP Receive RFC activity to act as a server and listen on the configured SAP endpoint, during run time. The activity receives RFC from the specified SAP endpoint and converts it to XML data. The SAP Receive RFC activity is a starter activity. This activity can be configured in both synchronous and asynchronous mode.

For the SAP Receive RFC activity, you must specify the inbound gateway connection parameters. The Receive RFC activity accepts requests only from the configured Program ID in the endpoint. For more information see Creating or editing a SAP endpoint.

To connect to the SAP system from Studio, you must download and install the SAP Jar files and DLLs on your Window's development machine. For more information, see Downloading and installing the SAP Jar Files and DLLs.

Note: An orchestration that contains an SAP Receive RFC activity must have persistence enabled to run in asynchronous mode. For more information, see Enabling persistence.

Adding a SAP Receive RFC activity to the orchestration

  1. Create or open an orchestration. A graphical representation of the orchestration is displayed.
  2. Select the Activities tab and expand the SAP folder.
  3. Drag the Receive RFC activity onto the orchestration.
  4. Select the activity. The Checklist is displayed.

Creating, selecting, or editing a SAP endpoint

  1. Click Pick Endpoint task from the Checklist and choose from one of the following actions:
    • Select an existing endpoint:
      1. Select Browse. The Project Explorer is displayed.
      2. Select an existing endpoint and click OK. Go to the Configuring the activity procedure.
    • Select an existing endpoint and edit the endpoint:
      1. Select Browse. The Project Explorer is displayed.
      2. Select an existing endpoint and click OK.
      3. Click Edit. The Edit Endpoint panel is displayed.
    • Create a new endpoint: Select New. The Create Endpoint panel is displayed.
  2. Create or Edit a SAP endpoint.

Configuring the activity

  1. Select the Configure task from the Checklist. The Configure panel is displayed.
  2. In the RFC Name field, click Browse.... The RFC List dialog box is displayed.
  3. In the RFC Search Pattern field, enter a combination of characters and the * wildcard character to find the desired RFC name as shown in the following examples:
    • AB* —Finds all the RFC names that begin with the AB prefix.
    • AB*TRANSACTION —Finds all the RFC names that begin with the AB prefix and end with the string: TRANSACTION.

      The SAP system is interrogated and the RFC names that match the wildcard expression are listed in the Matching SAP Functions table.

  4. In the Options panel, you can either select the Synchronous mode check box or clear it. The processing can be handled either synchronously or asynchronously. By default, the Receive RFC activity is configured to the asynchronous mode.
    • Synchronous mode - Both SAP and Cast Iron (the SAP Receive RFC activity) must be available during processing. SAP sends an RFC request to Cast Iron and waits for a response from the Receive RFC activity.
    • Asynchronous mode - The SAP Receive RFC activity need not be available when SAP invokes the function call. SAP sends an RFC request to Cast Iron and does not wait for a response from the Receive RFC activity.
  5. From the Matching SAP Functions table, select one of the SAP Functions and click OK.

Mapping the outputs of the activity

  1. Select the Map Outputs task in the Checklist. The output parameter of the activity is displayed in the From Activity panel. The XML Schema generated from the selected RFC becomes the output parameter of the activity.
  2. Create a map between the RFC output parameters and tables and orchestration variables. See Creating a map for general instructions on mapping.

Note about Deploying a SAP Orchestration

Before you can deploy an orchestration with SAP activities using the WMC, the Integration Appliance must first be able to establish a connection to the SAP System. If the Integration Appliance is unable to establish the connection to the SAP System, the orchestration is not deployed.




Feedback | Notices


Timestamp icon Last updated: Wednesday, February 17, 2016


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/SAP_Receive_RFC_Activity.html