Summary of Contents for BEA WebLogic Adapter for SAP
Page 1
WebLogic Adapter for ® User Guide Release 7.0 Document Date: October 2002...
Page 2
Restricted Rights Legend This software and documentation is subject to and made available only pursuant to the terms of the BEA Systems License Agreement and may be used or copied only in accordance with the terms of that agreement. It is against the law to copy the software except as specifically allowed in the agreement.
Documentation Conventions ... viii 1. Introducing the BEA WebLogic Adapter for SAP WebLogic Integration... 1-3 How the BEA WebLogic Adapter for SAP Works ... 1-4 2. Creating Schemas for SAP Business Objects Overview ... 2-1 Generating Schemas Using the BEA Application Explorer... 2-3 3.
Page 4
4. The BEA WebLogic Adapter for SAP and IDocs Defining a Logical Port ... 4-2 Creating a Logical System... 4-4 Creating a Partner Profile ... 4-7 Creating a Distribution Model for the Partner and Message Type... 4-10 Manually Sending an IDoc ... 4-14 5.
The BEA WebLogic Adapter for SAP is organized as follows: Chapter 1, “Introducing the BEA WebLogic Adapter for SAP,” introduces the BEA WebLogic Adapter for SAP and describes SAP business objects and WebLogic Integration. Chapter 2, “Creating Schemas for SAP Business Objects,”...
This document is written for system integrators who develop client interfaces between SAP and other applications. It describes how to use the BEA WebLogic Adapter for SAP in order to integrate SAP IDocs, RFCs, and BAPIs with WebLogic Integration. It...
In your e-mail message, please indicate which version of the BEA WebLogic Adapter for SAP documentation you are using. If you have any questions about this version of BEA WebLogic Adapter for SAP, or if you have problems using the BEA WebLogic Adapter for SAP, contact BEA Customer...
UPPERCASE TEXT viii BEA WebLogic Adapter for SAP User Guide Item Indicates terms defined in the glossary. Indicates that you must press two or more keys simultaneously. Indicates emphasis or book titles. Indicates code samples, commands and their options, data structures and their members, data types, directories, and file names and their extensions.
Page 9
The ellipsis itself should never be typed. Example: buildobjclient [-v] [-o name ] [-f file-list]... [-l file-list]... Indicates the omission of items from a code example or from a syntax line. The vertical ellipsis itself should never be typed. BEA WebLogic Adapter for SAP User Guide...
Page 10
BEA WebLogic Adapter for SAP User Guide...
WebLogic Integration How the BEA WebLogic Adapter for SAP Works You can use the BEA WebLogic Adapter for SAP to mine your existing SAP business procedures and applications for reuse with other applications and to participate in distributed e-business processes. High-speed, low-impact access to SAP exposes the critical business logic, and the data contained within, for reuse.
Page 12
As a result, the sender should not be on standby awaiting an answer. The BEA WebLogic Adapter for SAP quickly and easily integrates your SAP IDocs, RFCs, and BAPIs via WebLogic Integration workflows. The adapter and WebLogic Integration provide all the functionality you need to integrate your mission critical SAP system with other enterprise applications.
SAP R/3 is probably the most widely used packaged application that must be accessible from WebLogic Integration for companies to successfully complete their integration projects. The BEA WebLogic Adapter for SAP allows an organization to fully integrate its SAP R/3, mySAP.com, SAP Markets, or SAP Portals application systems with virtually any other legacy system, DBMS, EDI, B2B, ERP, CRM, or SCM application on any platform.
These include Task nodes, which specify the operations to be performed by a BEA WebLogic Adapter for SAP, and Event nodes, which set the business processes that occur when a specific event is “pushed” from the adapter.
Page 15
WebLogic Integration repository. This shields users from the details of executing SAP IFR XML, IDoc, BAPIs, and RFCs. The deployed application view from BEA WebLogic Adapter for SAP has the following features: Support for Remote Function Calls (RFC), Business Application Programming Interfaces (BAPI), and Intermediate Documents (IDoc) interfaces to SAP.
Page 16
Introducing the BEA WebLogic Adapter for SAP BEA WebLogic Adapter for SAP User Guide...
Overview Generating Schemas Using the BEA Application Explorer Overview The BEA WebLogic Adapter for SAP, in order to interact with your SAP business objects, requires schemas describing those objects. You can generate the schemas using the BEA Application Explorer: 1. Specify the directory in which you want the schemas to reside.
Page 18
GUI screen connected directly to SAP. This SAP event may trigger a process that makes a remote call to the BEA WebLogic Adapter for SAP, which arrives at the event adapter.
Generating Schemas Using the BEA Application Explorer To generate schemas for an SAP business object using the BEA Application Explorer: 1. Open the BEA Application Explorer: From the Windows Start menu, navigate to the Programs menu and choose the command for the BEA Application Explorer.
Page 20
Creating Schemas for SAP Business Objects Figure 2-2 BEA Application Explorer Window - Selecting Session from File 3. Enter a session path. You may want to specify one that corresponds to your project or logical grouping of services and events.
Page 21
Generating Schemas Using the BEA Application Explorer Figure 2-4 BEA Application Explorer Window - Selecting New Connection 5. Enter a descriptive name for this connection and click OK. Figure 2-5 Enter New Connection Name Input Window 6. Enter the appropriate connection information in the System and the User tabs.
Page 22
8. Select a type of business object, browse its objects, and select the object for which you wish to create a schema. Note that: BAPIs are listed under Application Components. RFCs are listed under Remote Function Modules. IDocs are listed under IDOC Repository. BEA WebLogic Adapter for SAP User Guide...
Page 23
Generating Schemas Using the BEA Application Explorer Figure 2-8 BEA Application Explorer - Selecting Application Components In this example, navigate through Application Components into Financial Accounting, Company and select the BAPI named BAPI_COMPANY_GETDETAIL BEA WebLogic Adapter for SAP User Guide...
Page 24
9. Right-click the desired business object to create the service schema or event schema. Figure 2-9 BEA Application Explorer - Selecting a BAPI and Choosing Creating Service Schema After the schemas are created, the right pane displays the different schemas when you select the appropriate tabs.
Page 25
Generating Schemas Using the BEA Application Explorer Figure 2-10 BEA Application Explorer - Displaying the BAPI’s Schemas The following is a sample directory structure generated for the SAP connection named under the session named SAPIDES fi_dev BEA WebLogic Adapter for SAP User Guide...
Page 26
The generated metadata includes a manifest file ( request schema ( schema ( schema ( The following is a sample of the generated Figure 2-12 Manifest.xml File 2-10 BEA WebLogic Adapter for SAP User Guide service_BAPI_COMPANY_GETDETAIL.xsd service_BAPI_COMPANY_GETDETAIL_response.xsd event_BAPI_COMPANY_GETDETAIL.xsd ), the service manifest.xml ), the response ), and the event file.
Page 27
Generating Schemas Using the BEA Application Explorer The BEA WebLogic Adapter for SAP uses the file and accompanying manifest.xml schema(s) to connect to and define the interaction with the application system from an application view. The location of this repository is pointed to in configuration of the adapter during application view creation, as described in Chapter 3, “Configuring the...
Page 28
Creating Schemas for SAP Business Objects 2-12 BEA WebLogic Adapter for SAP User Guide...
Application views reside within WebLogic Integration. WebLogic Integration provides you with a root folder in which you can store all of your application views. If you wish, you can create additional folders to organize related application views into groups. BEA WebLogic Adapter for SAP User Guide...
Page 30
TCP/IP address or DNS name where WebLogic Integration is the socket on which the server is listening. The port , it must be included in the system group, see the BEA WebLogic Adapter for SAP Installation and group. adapter...
“Event Adapter Application Views” on page Event Adapter Application Views Event adapters allow WebLogic Integration to receive incoming events and associated documents. The following topics describe how to configure an event adapter for SAP. BEA WebLogic Adapter for SAP User Guide...
Configuring the BEA WebLogic Adapter for SAP Creating the Event Adapter Application View To create an event adapter application view: 1. Open the Application View Console, which is found at the following location: http://host:port/wlai Here, host Server is installed, and default port at the time of installation is 7001.
Page 33
Figure 3-4 Define New Application View Window 6. Click OK. The Configure Connection Parameters window opens. The Configure Connection Parameters window enables you to enter the information required to communicate with the EIS system. Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide...
Page 34
Configuring the BEA WebLogic Adapter for SAP For SAP, the required communication and schema information was created in the BEA Application Explorer. The location of the base session repository appears on this screen to access this information. 7. Enter the base directory holding your SAP connection and schema information.
Page 35
After adding an application view, the Application View Administration window opens. Figure 3-6 Application View Administration Window This window is also available at any time while the application is not deployed, and if deployed can be accessed by “undeploying” the application. BEA WebLogic Adapter for SAP User Guide...
Configuring the BEA WebLogic Adapter for SAP Creating an SAP Remote Destination To enable your SAP system to issue remote function calls (RFCs) or BAPIs to the SAP event adapter, you must define an RFC destination on the SAP system. This process is also required when you want an SAP system to send IDocs to the SAP event adapter.
Page 37
Event Adapter Application Views Figure 3-7 RFC Destinations Windows BEA WebLogic Adapter for SAP User Guide...
Page 38
Configuring the BEA WebLogic Adapter for SAP Figure 3-8 RFC Destination for BEA Event Adapter for SAP Window 5. In field RFC destination, enter a name, for example, BEAEVENTDEST. Note: This is case sensitive. 6. Enter T in the field Connection type (destination type TCP/IP).
Page 39
Event Adapter Application Views The following window opens. Figure 3-9 RFC Destination BEAEVENTDEST Window 9. Click Registration as Activation Type. 10. In field Registration Program ID field, type BEAID. BEA WebLogic Adapter for SAP User Guide 3-11...
Page 40
Configuring the BEA WebLogic Adapter for SAP 11. Click Change on the toolbar or choose Save from the Destination menu. Figure 3-10 Destination Menu Window 3-12 BEA WebLogic Adapter for SAP User Guide...
Page 41
Figure 3-11 Gateway Options Window 13. Enter the host name of the machine in field Gateway host. 14. Enter sapgw and the SAP system number in field Gateway service, for example, sapgw00. BEA WebLogic Adapter for SAP User Guide 3-13...
Configuring the BEA WebLogic Adapter for SAP 15. Click OK. Figure 3-12 Gateway Host and Service Window Configuring the Event Adapter Application View The event adapter application view contains all events that are expected to arrive at this instance of the event adapter. As such, many services may be added to the application view.
Page 43
The values that appear in the window are based on the connection information originally used in the Application Explorer. You are free to change these design time values for your particular run-time behavior. Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-15...
Page 44
A flag indicating whether this event adapter should be active. The schema drop-down list box corresponds to the manifest generated for you during your BEA Application Explorer session. All event schemas created during the session should be listed. 3-16...
Page 45
Event Adapter Application Views 5. Select Add and then, Continue, from the Application View Administration window. Figure 3-14 Application View Administration Window 6. Select Continue to display the Deploy Application View window. BEA WebLogic Adapter for SAP User Guide 3-17...
Page 46
Configuring the BEA WebLogic Adapter for SAP Figure 3-15 Deploy Application View Window 7. If required, update the settings, and click Deploy to save and deploy the event adapter. 3-18 BEA WebLogic Adapter for SAP User Guide...
Page 47
Event Adapter Application Views In the WebLogic Server log or command console, you should see the following entries as the event adapter starts up. Figure 3-16 WebLogic Server Log Window BEA WebLogic Adapter for SAP User Guide 3-19...
Page 48
Configuring the BEA WebLogic Adapter for SAP There should be two created and deployed application views now visible, one for the service adapter and one for the event adapter. Figure 3-17 Application View Console Window At this point, you can test your service adapter as described in Adapter in the Application View Console”...
After deployment, the Summary for Application View window opens. 1. Click Test for the service configured in the service adapter. Figure 3-18 Summary for Application View Window Event Adapter Application Views 3-14, you can test its events. BEA WebLogic Adapter for SAP User Guide “Configuring the 3-21...
Page 50
Figure 3-19 Test Event Window In the SAP Server, the transaction send RFCs to any logical system; in this case to the BEA WebLogic Adapter for SAP with an SAP event adapter configured for Program ID BEAID. 3-22...
Page 51
Figure 3-20 Function Builder: Initial Window 3. Choose single test (PF8). 4. Enter RFC target system, for example, BEAEVENTDEST 5. Enter input data for the particular RFC module; for example, Auto* in NAME1 BEA WebLogic Adapter for SAP User Guide 3-23...
Page 52
Configuring the BEA WebLogic Adapter for SAP 6. Execute (PF8). Figure 3-21 Test Function Module: Initial Window 3-24 BEA WebLogic Adapter for SAP User Guide...
Page 53
Event Adapter Application Views 7. A results screen appears with an RFC XML document sent to the BEA WebLogic Adapter for SAP. Figure 3-22 Test Result for ListCustomer Window BEA WebLogic Adapter for SAP User Guide 3-25...
Configuring the BEA WebLogic Adapter for SAP You can now write custom code to exploit the adapter or create a process flow in Studio. For more information, see “Using Application Views in the Studio” in Using Application Integration: For WebLogic Integration 7.0, see http://edocs.bea.com/wli/docs70/aiuser/3usruse.htm...
Page 55
4. After the workflow configuration is complete, save the template. After you save the template, you may monitor the running instances (right-click the template and select Instances). BEA WebLogic Adapter for SAP User Guide 3-27...
Page 56
Configuring the BEA WebLogic Adapter for SAP Figure 3-24 Start Properties Form Window 3-28 BEA WebLogic Adapter for SAP User Guide...
IP address or host name on which the WebLogic is the socket on which the server is port , it must be included in the system group, see the BEA WebLogic Adapter for SAP Installation and BEA WebLogic Adapter for SAP User Guide group. adapter 3-29...
Page 58
Configuring the BEA WebLogic Adapter for SAP 7. Select BEA_SAP_1_0 Figure 3-25 Define New Application View Window 8. Click OK. The Configure Connection Parameters window opens. 3-30 BEA WebLogic Adapter for SAP User Guide from the Associated Adapter list.
Page 59
The Configure Connection Parameters window enables you to specify parameters for connecting to the BEA WebLogic Adapter for SAP and creating a schema repository. Figure 3-26 Configure Connection Parameters Window The BSE Location represents the location of the connection session information to the particular type of EIS system, in this case, SAP.
Configuring the BEA WebLogic Adapter for SAP Configuring the Service Adapter Application View To configure the service adapter application view: 1. If it is not already open, open the application view to be modified. For more information, see “Editing an Application View” in “Defining an Application View”...
Page 61
Service Adapter Application Views 3. In the left pane, click Administration from the Configure Connection list. The Application View Console Administration window opens. Figure 3-27 Application View Console Administration Window BEA WebLogic Adapter for SAP User Guide 3-33...
Page 62
Configuring the BEA WebLogic Adapter for SAP 1. Click Add Service. Figure 3-28 Add Service Window The BEA WebLogic Adapter for SAP is based on a JDBC interface, so the properties of this connection are based on this framework. 2. Enter the properties as:...
Page 63
EN for English. user SAP User ID. password Associated SAP user’s password. 3. Click Add. The Deploy Application View window opens. Figure 3-29 Deploy Application View Window Service Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-35...
Configuring the BEA WebLogic Adapter for SAP 4. If required, update the settings, and click Deploy. The Summary for Application View window opens. At this point, you can test your service adapter as described in Adapter.” Testing the Service Adapter After you create and deploy an application view as described in Adapter Application View”...
Page 65
The Test Service window opens. 2. Enter a sample BEA WebLogic Adapter for SAP Request, for example, RFC_CUSTOMER_GET <doc:RFC_CUSTOMER_GET xmlns:doc="urn:sap-com:document:sap:business:rfc"> <KUNNR></KUNNR> <NAME1>Auto*</NAME1> </doc:RFC_CUSTOMER_GET> Service Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-37...
Page 66
Configuring the BEA WebLogic Adapter for SAP Figure 3-31 Test Service Window 3. Click Test to send the request through the SAP service adapter to the SAP EIS system. 3-38 BEA WebLogic Adapter for SAP User Guide...
Page 67
Service Adapter Application Views The response document should look similar to the following. Figure 3-32 Test Results Window BEA WebLogic Adapter for SAP User Guide 3-39...
Page 68
Configuring the BEA WebLogic Adapter for SAP The full response document follows. Listing 3-1 Full Response Document from ListCustomer <doc:RFC_CUSTOMER_GET.Response xmlns:doc="urn:sap-com:document:sap:business:rfc"> <CUSTOMER_T> <item> <KUNNR>0000000110</KUNNR> <ANRED>Firma</ANRED> <NAME1>Auto Klement</NAME1> <PFACH/> <STRAS>Bert-Brecht-Allee 29</STRAS> <PSTLZ>81737</PSTLZ> <ORT01>Mnnchen</ORT01> <TELF1>089/93534</TELF1> <TELFX>089/93530</TELFX> </item> <item> <KUNNR>0000001012</KUNNR> <ANRED>Firma</ANRED> <NAME1>Autohaus Franzl GmbH</NAME1>...
HAPTER The BEA WebLogic Adapter for SAP and IDocs The BEA WebLogic Adapter for SAP’s event adapter receives IDocs from SAP using the RFCs INBOUND_IDOC_PROCESS describes how to configure and test your SAP system to send IDocs to an event adapter;...
The BEA WebLogic Adapter for SAP and IDocs Defining a Logical Port The lower level networking requires that a system port number be associated with the RFC destination. The logical port identifies the port to which messages are sent. The logical port can only be used if an RFC destination was previously created.
Page 71
Defining a Logical Port 6. Save the session, making note of the system-generated RFC Port. Figure 4-1 SAP Main Window / Creating a tRFC port BEA WebLogic Adapter for SAP User Guide...
The BEA WebLogic Adapter for SAP and IDocs Creating a Logical System One type of partner is a logical system. A logical system manages one or more RFC destinations. To create a logical system called BEALOG: 1. In the SAP Main screen, choose Tools Management (transaction 2.
Page 73
System. Click the green hook beside Define Logical System. Figure 4-2 SAP Main Window / Display Structure 4. Select New Entries. Creating a Logical System → Application Link Enabling → Logical Systems BEA WebLogic Adapter for SAP User Guide → Define Logical...
Page 74
The BEA WebLogic Adapter for SAP and IDocs 5. Enter a meaningful name for your partner and provide a short description (for example, BEALOG). Figure 4-3 SAP Main Window / New Entries: Overview of Added Entries 6. Save the session.
8. Enter message type of the IDoc (for example, DEBMAS). 9. Enter receiver port for example (A000000040 from the previous example screens). → Business Communication → Partner profile, or else execute transaction BEA WebLogic Adapter for SAP User Guide Creating a Partner Profile → IDOC WE20...
Page 76
The BEA WebLogic Adapter for SAP and IDocs 10. Save the session. Figure 4-4 SAP Window / Partner Profiles: Outbound Parameters 11. Exit the session. The SAP Partner Profiles summary window opens, displaying information for the logical system that you just created.
Page 77
Creating a Partner Profile Figure 4-5 SAP Window / Partner Profiles Summary BEA WebLogic Adapter for SAP User Guide...
The BEA WebLogic Adapter for SAP and IDocs Creating a Distribution Model for the Partner and Message Type To create a distribution model called BEAMOD: 1. In the SAP Main screen, choose Tools Management, or else execute transaction 2. Select Create model view. (You may need to switch processing mode to edit, within Distribution Model/Switch Processing).
Page 79
Creating a Distribution Model for the Partner and Message Type Figure 4-6 SAP Window / Distribution Model Changed BEA WebLogic Adapter for SAP User Guide 4-11...
Page 80
The BEA WebLogic Adapter for SAP and IDocs In the dialog box, you can view: Sender: for example, I46_CLI800, which points to the SAP system that will SEND the IDoc (in this case, an SAP 4.6B system). Receiver: Logical system. For example, BEALOG.
Page 81
Figure 4-8 SAP Window / Distribution Model Changed (New Model View) You are now ready to test the connection to the WebLogic Server, as described in “Manually Sending an IDoc” on page 4-14. BEA WebLogic Adapter for SAP User Guide 4-13...
SAP event adapter (RFC listener) for program ID BEAID. 1. Add an SAP event adapter to WebLogic Integration. 2. Use the BEA Application Explorer to create appropriate schemas. 3. Enter the IDoc message type DEBMAS in the Output type field.
Page 83
Manually Sending an IDoc 6. The event adapter receives the IDoc in XML format. No response is expected from WebLogic Integration. Figure 4-9 SAP Window / Send Customers BEA WebLogic Adapter for SAP User Guide 4-15...
Page 84
The BEA WebLogic Adapter for SAP and IDocs Figure 4-10 SAP Window / Master IDocs Set Up for Message Type DEBMAS 4-16 BEA WebLogic Adapter for SAP User Guide...
HAPTER Sending SAP Events Using ABAP Programs Once the BEA WebLogic Adapter for SAP’s event adapter and the RFC destination are configured, you can write ABAP code to execute calls at your new destination (that is, the event adapter). This section describes how to send RFC or BAPIs to the event adapter. It includes the...
PPENDIX Sample Files This section provides sample request and response documents sent between SAP and the BEA WebLogic Adapter for SAP. It includes the following samples: Sample RFC Request Document Sample RFC Response Document Sample IDoc XML for Message Type DEBMAS...
Need help?
Do you have a question about the WebLogic Adapter for SAP and is the answer not in the manual?
Questions and answers