Skip Headers
Oracle® Fusion Middleware Application Adapter for SAP R/3 User's Guide for Oracle WebLogic Server
11g Release 1 (11.1.1)
  Go To Table Of Contents
Go To Index


1 Introduction

Oracle WebLogic Server connects to a SAP R/3 system through Oracle Application Adapter for SAP R/3 Oracle Application Adapter for SAP R/3 provides connectivity and carries out interactions on a SAP R/3 system. This chapter discusses the following topics:

Adapter Features

Oracle Application Adapter for SAP R/3 is a remote function call adapter that provides a means to exchange real-time business data between SAP Enterprise Central Component (ECC) 5.0/6.0 systems and other application, database, or external business partner systems. The adapter enables external applications for inbound and outbound processing with SAP R/3. Oracle Application Adapter for SAP R/3 can be deployed as a J2EE Connector Architecture (J2CA) version 1.0 resource adapter. This deployment is referred to as Oracle Adapter J2CA. It can also be deployed as a Web services servlet and is referred to as Oracle Adapter Business Services Engine (BSE).

Oracle Application Adapter for SAP R/3 uses XML messages to enable non-SAP R/3 applications to communicate and exchange transactions with SAP R/3 using services and events.The role of services and events is outlined. Services and events are described as follows:

To support event functionality, channels are supported. A channel represents configured connections to particular instances of back-end or other types of systems.

The channel is the adapter component that receives events in real time from the EIS application. The channel component can be a File reader, an HTTP listener, a TCP/IP listener, or an FTP listener. A channel is always EIS specific. The adapter supports multiple channels for a particular EIS, which enables the user to choose the optimal channel component based on deployment requirements. In the case of this adapter, the channel is an RFC server.

Oracle Application Adapter for SAP R/3 provides:

Data Type Limitation: Data types h and g are not supported. Type h represents a deep structure. Type g represents a variable length string. RFCTYPE_XSTRING and RFCTYPE_XMLDATA, as defined in SAPRFC.H, are not supported due to a limitation in the RFC Protocol.

See Also:

Oracle Application Server Adapter Concepts Guide

Supported Versions and Platforms

The following SAP R/3 platforms are supported by Oracle Application Adapter for SAP R/3:

  • SAP R/3 Enterprise 47x100

  • SAP R/3 Enterprise 47x200

  • mySAP ERP Central Component (ECC) 5.0, deployed on SAP NetWeaver 2004

  • mySAP ERP Central Component (ECC) 6.0, deployed on SAP NetWeaver 2004s

  • SAP Java Connector (SAP JCo) Version 2.18.

    For the current release status of the SAP Java Connector, refer to SAP Note #549268 in the SAP Service Marketplace.


Release versions may vary by product component. In addition, SAP functions may vary by SAP product version and support package.

Classical SAP Technologies for ABAP

Oracle Application Adapter for SAP R/3 is designed to provide standard access to SAP R/3 interfaces such as Remote Function Call (RFC) modules, BAPIs (Business Application Programming Interfaces), and IDocs (Intermediate Documents), that are used to support existing business processes.

The adapter only supports Enterprise Central Components (ECC) that are accessed by classical SAP technologies. If you require support for additional SAP functionality and components, contact your iWay Software Sales Representative.

These business components and methods are available to the adapter as requests of SAP R/3 and to the event adapter when SAP invokes its remote requests and work in the following ways:

Integration with SAP R/3

You can use Oracle Application Adapter for SAP R/3 to initiate a SAP R/3 business process, such as add/update account, or you can use the adapter as part of an integration effort to connect SAP R/3 and non-SAP R/3 systems.All functions are processed synchronously, but all content in ALE IDocs is asynchronous..In service mode, the Oracle Application Adapter for SAP R/3 can send requests to SAP using the BAPI, RFC, or ALE interfaces.

The adapter quickly and easily integrates your SAP R/3 IDocs, RFCs, and BAPIs with mission critical SAP R/3 system applications and other enterprise applications. The benefits of the adapter include:

During event processing, the adapter receives RFCs and IDocs directly from SAP R/3. The SAP R/3 system can be configured to send an IDoc or RFC to a logical system when a certain event occurs, in this case to the adapter. The output sent by SAP R/3 can be in any of the following forms:

Adapter Architecture

Oracle Application Adapter for SAP R/3 uses Application Explorer with the following components:

Application Explorer (used to configure SAP connections and create Web services and events) can be configured to work in a Web services environment with BSE. When working in a J2CA environment, the connector uses the Common Client Interface (CCI) to provide integration services using adapters instead of Web services.

Oracle Adapter Business Services Engine (BSE) Architecture

Figure 1-1 shows the generic architecture for BSE for packaged applications. The adapter works with BSE, as deployed to a Web container in a J2EE application server.

Application Explorer, a design-time tool deployed along with BSE, is used to configure adapter connections, browse EIS objects, configure services, and configure listeners to listen for EIS events. Metadata created while you perform these operations are stored in the repository by BSE.

BSE uses SOAP as a protocol for receiving requests from clients, interacting with the EIS, and sending responses from the EIS back to clients.

BSE supports both a file-based and an Oracle database repository. The BSE repository stores the EIS connection information and the Web Service Definition Language (WSDL) for adapter services. A single instance of BSE can connect to multiple EIS applications.


Do not use a file repository for BSE in production environments.

Figure 1-1 Oracle Adapter Business Services (BSE) Architecture

Adapter Business Services Architecture
Description of "Figure 1-1 Oracle Adapter Business Services (BSE) Architecture"

Oracle Adapter J2CA Architecture

Figure 1-2 shows the generic architecture for Oracle Adapter J2CA for packaged applications. This is a pure J2CA 1.0 resource adapter deployed in managed mode to the Oracle WebLogic Server. It is a universal adapter. One adapter can connect to many EIS applications.

The Oracle Adapter J2CA repository contains the list of EIS connection names and the associated connection parameters. The repository can be a file system or an Oracle database. It is deployed as a RAR file and has an associated deployment descriptor called ra.xml. You can create multiple connector factories by editing the Oracle WebLogic Server deployment descriptor ra.xml. See Chapter 4, "Oracle WebLogic Server Deployment and Integration" for more information.

Figure 1-2 Oracle Adapter J2CA Architecture

Generic JCA architecture
Description of "Figure 1-2 Oracle Adapter J2CA Architecture"

See Also:

  • Oracle Application Server Adapter Concepts Guide

  • Oracle Fusion Middleware Application Adapters Installation Guide for Oracle WebLogic Server

BSE Versus Oracle Adapter J2CA Deployment

If you are using Oracle Application Adapter for SAP R/3 with Business Process Execution Language (BPEL) Process Manager, note that:

The following three factors explain the differences between deploying BSE and Oracle Adapter J2CA. Understanding the factors can help in selecting a deployment option.

  1. BSE is the preferred deployment option because it:

    • Can be deployed in a separate instance of Oracle WebLogic Server.

    • Provides better distribution of load.

    • Provides better isolation from any errors from third party libraries.

    • Provides better capability to isolate issues for debugging purposes.

    • Conforms more closely to the Service Oriented Architecture (SOA) model for building applications.

  2. Oracle Adapter J2CA provides slightly better performance.

    Oracle Adapter J2CA does provide slightly better performance than BSE. However, the difference decreases as the transaction rate increases.

  3. Oracle Adapter J2CA and the BSE option both provide identity propagation at run-time.

    The BSE option provides the capability to pass identity using the SOAP header. For Oracle Adapter J2CA, user name and password can be passed using the connection specification of the CCI.