Skip to content

Latest commit

 

History

History
78 lines (55 loc) · 5.37 KB

README.md

File metadata and controls

78 lines (55 loc) · 5.37 KB
Raw

Standalone SAP Queued RFC Destination Endpoint Quick Start

Demonstrates the sap-qrfc-destination component running in a standalone camel runtime.
SAP Tool Suite

Author: William Collins - Fuse Team
Level: Beginner
Technologies: SAP, Camel, Spring
Summary: This quickstart demonstrates how to configure and use the sap-qrfc-destination component in a standalone Camel environment to invoke remote function modules and BAPI methods in SAP. This component invokes remote function modules and BAPI methods within SAP using the Queued RFC (qRFC) protocol.
Target Product: Fuse
Source: http://github.com/punkhorn/sap-quickstarts/

What is it?

This quick start shows how to integrate Apache Camel with SAP using the JBoss Fuse SAP Queued Remote Function Call Destination Camel component. This component extends the capabilities of the JBoss Fuse Transactional Remote Function Call Destination camel component by adding IN-ORDER delivery and processing guarantees to the delivery and processing of requests through its endpoints. This component and its endpoints should be used in cases where a series of requests depend on each other and must be delivered to and processed by the receiving SAP system in the same order that they were sent (AT-MOST-ONCE and IN-ORDER). The component accomplishes the AT-MOST-ONCE delivery guarantees using the same mechanisms as the JBoss Fuse SAP Transactional Remote Function Call Destination Camel component. The ordering guarantee is accomplished by serializing the requests in the order they are received by the SAP system to an Inbound Queue. Inbound queues are processed by the QIN Scheduler within SAP. When the inbound queue is activated, the QIN Scheduler which execute in order the queue's requests.

This quick start contains a route with an initial timer endpoint which triggers and executes that route once. The route uses processor beans to build requests to the CreateFromData method of the FlightCustomer BAPI to create flight customer records in SAP. These requests are routed to sap-qrfc-destination endpoints which use the qRFC protocol to send these requests to SAP to invoke the BAPI method. The route logs to the console the serialized contents of the request messages it sends. These requests are serializes within SAP on the inbound queue QUICKSTARTQUEUE.

NOTE: The qRFC protocol used by this component is asynchronous and does not return a response and thus the endpoints of this component do not return a response message.

In studying this quick start you will learn:

  • How to configure the Camel runtime environment in order to deploy the JBoss Fuse SAP Queued Remote Function Call Destination Camel component.
  • How to define a Camel route containing the JBoss Fuse SAP Queued Remote Function Call Destination Camel component using the Spring XML syntax.
  • How to use the JBoss Fuse SAP Queued Remote Function Call Destination Camel component to reliably update data in SAP.
  • How to configure connections used by the component.

For more information see:

System requirements

Before building and running this quick start you will need:

  • Maven 3.1.1 or higher
  • JDK 1.8
  • JBoss Fuse 7.0.0
  • SAP JCo3 and IDoc3 libraries (sapjco3.jar, sapidoc3.jar and JCo native library for your OS platform)
  • SAP instance with Flight Data Application setup.

Configuring the Quickstart for your environment

To configure the quick start for your environment:

  1. Deploy the JCo3 library jar and native library (for your platform) and IDoc3 library jar to the lib folder of the project.
  2. Ensure that the SAP Instance Configuration Configuration Parameters in the parent pom.xml file (../../.pom.xml) of quick starts project has been set to match the connection configuration for your SAP instance.

Build and Run the Quickstart

To build and run the quick start:

  1. Change your working directory to the sap-qrfc-destination-standalone directory.
  • Run mvn clean install to build the quick start.
  • Run mvn camel:run to start the Camel runtime.
  • In the console observe the contents of the requests processed by the route.
  • Execute the queued requests waiting in the inbound queue QUICKSTARTQUEUE. Using the SAP GUI, run transaction SMQ2, the Inbound Queue qRFC Monitor:
    a. Select the QUICKSTARTQUEUE queue.
    b. Display the queue contents (Edit > Display Selection).
    c. Select the entry for your Client connection and activate the queue (Edit > Activate).
  • Using the SAP GUI, run transaction SE16, Data Browser, and display the contents of the table SCUSTOM.
  • Search the table (Edit > Find..) for the newly created Customer records: Fred Flintstone, Wilma Flintstone, Barney Rubble, and Betty Rubble.

Stopping the Quickstart

To stop the camel run-time:

  1. Enter Ctrl-c in the console.