| Oracle® Application Server Adapter for SAP User's Guide 10g Release 3 (10.1.3.1.0) Part Number E10044-01 |
|
|
View PDF |
| Oracle® Application Server Adapter for SAP User's Guide 10g Release 3 (10.1.3.1.0) Part Number E10044-01 |
|
|
View PDF |
Oracle Application Server connects to a MySAP ERP system through Oracle Application Server Adapter for MySAP ERP (OracleAS Adapter for mySAP ERP). OracleAS Adapter for mySAP ERP provides connectivity and carries out interactions on a MySAP ERP system. This chapter discusses the following topics:
OracleAS Adapter for mySAP ERP 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 mySAP ERP. OracleAS Adapter for mySAP ERP 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 mySAP ERP uses XML messages to enable non-mySAP ERP applications to communicate and exchange transactions with MySAP ERP using services and events.The role of services and events is outlined. Services and events are described as follows:
Services: Enable applications to call an MySAP ERP business object or business operation.
Events: Enable applications to access MySAP ERP data only when an event occurs.
To support event functionality, the following two features are implemented:
Port: A port associates a particular business object exposed by an adapter with a particular disposition. A disposition defines the protocol and location of the event data. The port defines the end point of the event consumption.
The port is the Oracle adapter component that pushes the event received from the enterprise information system (EIS) to the adapter client.
Note:
You are not required to create or configure ports for use with BPEL Process Manager. However, in this release you can associate an event schema to a port under a J2CA configuration.The port validation feature is currently not available.
Channel: A channel represents configured connections to particular instances of back-end or other types of systems. A channel binds one or more event ports to a particular listener managed by an adapter.
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. This 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.
OracleAS Adapter for mySAP ERP provides:
Support for bidirectional message interactions.
OracleAS Adapter Application Explorer (Application Explorer), a GUI tool which uses MySAP ERP object repository metadata to build XML schemas and Web services to handle adapter requests or event data.
Support for Remote Function Calls (RFC), Business Application Programming Interfaces (BAPI), and Intermediate Documents (IDoc) interfaces to MySAP ERP.
XML schemas for the J2CA 1.0 resource adapter.
Web services for BSE.
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.
The following MySAP ERP platforms are supported by OracleAS Adapter for mySAP ERP:
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.
Note:
Release versions may vary by product component. In addition, SAP functions may vary by SAP product version and support package.OracleAS Adapter for mySAP ERP is designed to provide standard access to MySAP ERP 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, please contact your iWay Software Sales Representative.
These business components and methods are available to the adapter as requests of MySAP ERP and to the event adapter when SAP invokes its remote requests and work in the following ways:
Business Application Programming Interfaces (BAPIs) are interfaces within the business framework that are used to link SAP components to one another or to third-party components. BAPIs are called synchronously and return information.
Remote Function Call (RFC) Modules are SAP application interfaces that enable clients to invoke SAP technologies and receive responses.
Note:
Depending on the release or service pack installed, certain RFCs, for example,
RFC_CUSTOMER_GET, may not exist in your particular MySAP ERP system. Therefore, the examples included in this document may not be relevant to your system. If this is the case, then you should use the examples as a general reference for adapter functionality and choose an RFC that exists within your MySAP ERP application environment.As described in SAP Release Note 109533, SAP Function Modules (RFCs) can be delivered with different release statuses. SAP supports only RFCs that are awarded with the Released for Customer status. There is no claim to the release independencies of the interfaces and the continued existence/functionality of the modules. For more information on the status of a specific function module, consult the SAP Service Marketplace.Intermediate Documents (IDocs) are the Òlogical messagesÓ that correspond to different business processes. They enable different application systems to be linked by a message-based interface. The IDoc type indicates the SAP format to use to transfer the data for a business transaction. An IDoc is a real business process in the form of an IDoc type that can transfer several message types. An IDoc type is described by the following components:
Control records. A control record contains data that identifies the sender, the receiver, and the IDoc structure. An IDoc contains one control record.
Data records. A data record consists of a fixed administration part and a data part (segment). The number and format of the segments can be different for each IDoc type.
Status records. A status record describes the processing stages through which an IDoc passes. The following scenario is an example of IDoc functionality and its components:
Purchase order number 4711 was sent to a vendor as IDoc number 0815. IDoc number 0815 is formatted in IDoc type ORDERS01 and has the status records ÒcreatedÓ and Òsent.Ó The purchase order corresponds to the ÒlogicalÓ message ORDERS.
You can use OracleAS Adapter for mySAP ERP to initiate a MySAP ERP business process, such as add/update account, or you can use the adapter as part of an integration effort to connect MySAP ERP and non-MySAP ERP systems.All functions are processed synchronously, but all content in ALE IDocs is asynchronous..In service mode, the OracleAS Adapter for mySAP ERP can send requests to SAP using the BAPI, RFC, or ALE interfaces.
The adapter quickly and easily integrates your MySAP ERP IDocs, RFCs, and BAPIs with mission critical MySAP ERP system applications and other enterprise applications. The benefits of the adapter include:
Elimination of the requirement for custom coding.
Consistent data representation.
Provides a standard XML representation of event data and request/response documents for MySAP ERP.The developer is freed from the specific details of the MySAP ERP interface (BAPI, RFC, IDoc) and the specific configuration details of the target MySAP ERP system.
Adherence to MySAP ERP ABAP serialization rules and MySAP ERP Interface Repository standards published by SAP AG.
During event processing, the adapter receives RFCs and IDocs directly from MySAP ERP. The MySAP ERP 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 MySAP ERP can be in any of the following forms:
OracleAS Adapter for mySAP ERP 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
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
If you are using OracleAS Adapter for mySAP ERP with BPEL Process Manager, please note that:
Only OracleAS Adapter J2CA deployment supports inbound integration (event notification) with BPEL Process Manager.
Both OracleAS Adapter J2CA and BSE deployments support outbound integration (request-response service) with BPEL Process Manager.
The following three factors explain the differences between deploying BSE and OracleAS Adapter J2CA. Understanding the factors can help in selecting a deployment option.
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.
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.
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.
