Skip Headers
Oracle® Application Server Adapter for SAP R/3 User's Guide
10g Release 2 (10.1.2)
B14061-03
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
 
Next
Next
 

1 Introduction

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

Adapter Features

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

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

To support event functionality, the following two features are implemented:

OracleAS Adapter for SAP 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.

SAP Certification

OracleAS Adapter for SAP provides state-of-the-art middleware solutions for SAP Basis and SAP Web application server-based systems. This adapter has achieved the following three interface certifications that promote cost-effective and low-risk solutions.

  • CA-ALE (Certified Adapter - Application Link Enabling) certification. Enhances electronic data interchange (EDI) subsystem interface with SAP Basis and SAP Web Application Server. Using direct program-to-program remote communication and transformation from non-SAP systems to SAP solution-based systems, OracleAS Adapter for SAP expedites the conversion, import, and export of critical IDocs.

  • CA-AMS (Andrew Message System) certification. Rapidly bridges SAP Basis and SAP Web Application Server data exchange with other applications through pure message delivery. As an Application Link Enabling (ALE) Message Handler, the adapter sends IDoc messages without a requirement for conversion from one or more SAP solution-based systems.

  • CA-XML (Extensible Markup Language) certification. Eases the communication between external middleware with SAP Basis and SAP Web Application Server over the Internet using XML, HTTP, or HTTPS. The adapter immediately transfers SAP solution specifications into XML for straight transfer into application subsystem repositories. The CA-XML-certified adapter directly receives and converts messages to be transformed from or into XML formats to or from SAP solution-based systems over the Internet.

Supported Versions and Platforms

The following SAP platforms are supported by OracleAS Adapter for SAP:

  • SAP Web Application Server version 6.20 or 6.40

  • SAP R/3 4.6C and 4.6D

  • SAP R/3 Enterprise 47x100 and 47x200

  • SAP Java Connector (SAP JCo) 2.16.

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


Note:

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

OracleAS Adapter for SAP is supported on the following operating systems:

  • Windows 2000/2003/XP

  • Solaris version 2.8, 2.9, and later

  • Linux x86 Red Hat Advanced Server version 2.1 and higher, SuSE version 8.1 and later, United Linux version 1.0 and later

  • IBM AIX version 5.1 and later

  • HP-UX version 11i and later

  • HP Tru64 version 5.1a and later

SAP R/3 Versions and APIs

Adapter Platform SAP R/3 Release API
UNIX (HP-UX, Solaris) SAP R/3 4.6C, 4.6D;

SAP R/3 Enterprise 47x100 and 47x200*

SAP Java Connector (SAPJCo) 2.16**
Windows SAP R/3 4.6C, 4.6D;

SAP R/3 Enterprise 47x100 and 47x200*

SAP Java Connector (SAPJCo) 2.16**

*SAP R/3 Enterprise Version 47x100 and 47x200 is supported on the SAP Web Application Server Versions 6.20 and 6.40.

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

Integration with SAP

You can use OracleAS Adapter for SAP to initiate an SAP business process, such as add/update account, or you can use the adapter as part of an integration effort to connect SAP and non-SAP systems.BAPI and RFC are called synchronously by the adapter and always return data (either technical error information or a well-formed response document). IDocs are processed asynchronously.The adapter is bidirectional and can process an event in SAP by receiving RFC and IDocs directly from SAP. The output sent by SAP can be in any of the following forms:

For request processing, OracleAS Adapter for SAP can send requests to SAP using the BAPI, RFC, or IDoc interfaces. For details, see "SAP Business Components".

OracleAS Adapter for SAP integrates SAP IDocs, RFC, and BAPI with mission-critical SAP system applications and other enterprise applications. The benefits of the adapter include:

SAP Business Components

OracleAS Adapter for SAP is designed to provide standard access to SAP business objects such as Remote Function Call (RFC) modules, Business Application Programming Interfaces (BAPI), and Intermediate Documents (IDocs) that are used to support existing business processes. The business objects and methods are available to the adapter as requests of SAP and to the event adapter when SAP initiates its remote requests. These objects work in the following ways:

Adapter Architecture

OracleAS Adapter for SAP works with Application Explorer in conjunction with one of 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 in conjunction 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 Application Server Adapter Business Services Engine (BSE) Architecture

Figure 1-1 shows the generic architecture for BSE for packaged applications. Application Explorer works in conjunction with BSE, as deployed to the Oracle Containers for J2EE (OC4J) container of Oracle 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.


Note:

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

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

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

Oracle Application Server Adapter Generic J2CA Architecture

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

The OracleAS 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 OC4J deployment descriptor oc4j-ra.xml. See Chapter 3, "OC4J Deployment and Integration" for more information on OC4J deployment.

Figure 1-2 Oracle Application Server Adapter Generic J2CA Architecture

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

BSE Versus OracleAS Adapter J2CA Deployment

If you are using OracleAS Adapter for SAP with BPEL Process Manager, please note that:

The following three factors explain the differences between deploying BSE and OracleAS 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 Application 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. OracleAS Adapter J2CA provides slightly better performance.

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

  3. OracleAS Adapter J2CA and the BSE option both provide identity propagation at runtime.

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