Manuale d’uso / di manutenzione del prodotto WebLogic Adapter for SAP del fabbricante BEA
Vai alla pagina of 94
BEA W ebLogic Adapter for SAP ® Use r Guide Release 7.0 Document Date: October 200 2.
Copyright Copyright © 2002 BEA Systems, Inc. All Rights Reserved. Copyright © 2002 iWay Softwa re. All Rights Reserved. Restricted Rights Legen d This software and documentat ion is subject to and m.
BEA WebLogic Adapter for SAP User Guide iii T able of Contents About This Document What You Need to Know .............. ......................... ......................... .................... vi Related Information .............. ....................
iv BEA W ebLogic Adapter for SAP User Guide 4. The BEA WebLogic Adapter for SAP and IDocs Defining a Logical Port .............. .............. .......................... .............. ................. 4-2 Creating a Logical System ................ .
BEA WebLogic Adapter for SAP User Guide v About T his Document The BEA WebLogic Adapter for SAP is organized as follows: Chapter 1, “Introducing the BE A W e bLogic Adapter for SAP ,” introduces the BEA W ebLogic Adapter for SAP and describes SAP business objects and W ebLogic Integ ration.
vi BEA W ebLogic Adapter for SAP User Guide W hat Y ou Need to Know This document is written fo r 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 IDo cs, RFCs , and BAPIs with We bLogic Integration.
BEA WebLogic Adapter for SAP User Guide vii Cont act Us! Your feedback on the BEA WebLogic Adapter for SAP docu mentation is important to us. Send us e-mail at docsupport@b ea.
viii BEA W ebLogic Adapter for SAP User Guide Document ation Conventions The following documentation conv entions are used throughout this document. Convention Item boldface text Indicates terms define d in the glossary. Ctrl+Tab Indicates that you must press two or more keys simultaneously.
BEA WebLogic Adapter for SAP User Guide ix { } Indicates a set of cho ices in a syntax line. The brac es themselves shou ld never be typed. [ ] Indicates optional items in a syntax line. The brac kets themselves should never be typed. Example : buildobjclien t [-v] [-o name ] [-f fil e-list ].
x BEA W ebLogic Adapter for SAP User Guide.
BEA WebLogic Adapter for SAP User Guide 1-1 C HAPTER 1 Intr oducing the B EA W ebL ogic Adapter f or SAP This section introduces the BEA WebLogi c Adapter for SAP and describes SAP business objects and WebLogic Integration.
1 Introducing the BEA WebLogic Adapter for SAP 1-2 BEA W ebLogic Adapter for SAP User Guide The BEA WebLogic Adapter for SAP is desi gned specifically to provide simple, standard access to business ob.
WebLogic Integration BEA WebLogic Adapter for SAP User Guide 1-3 As a JCA and JMS-based service and even t adapter , ensuring reusability from the entire W ebLogic Server platform. Integrating SAP events and services with W ebLogic Integration.
1 Introducing the BEA WebLogic Adapter for SAP 1-4 BEA W ebLogic Adapter for SAP User Guide How the B EA W ebL ogic Adapter f or SAP Wo r k s The paradigm that the BEA WebLogic Adap ter for SAP uses in cludes application views, event adapters, and services adapte rs.
How the BEA WebLogic Adapter for SAP Works BEA WebLogic Adapter for SAP User Guide 1-5 from the physical connection data, which is stored in the WebLogic Integration repository. This shields users from the detail s of executing SAP IFR XML, IDoc, BAPIs, and RFCs.
1 Introducing the BEA WebLogic Adapter for SAP 1-6 BEA W ebLogic Adapter for SAP User Guide.
BEA WebLogic Adapter for SAP User Guide 2-1 C HAPTER 2 Cr eating Schemas f or SAP Business Objects This section describes how to use the BEA A pplication Explorer to generate sch emas that describe your SAP business objects.
2 Creating Schemas for SAP Business Objects 2-2 BEA W ebLogic Adapter for SAP User Guide Note: It is important to underst and that the connection in formation and the event, request, and response sche.
Generating Schemas Using the BEA Application Explore r BEA WebLogic Adapter for SAP User Guide 2-3 Gener ating Schemas Using the B EA Application Explor er To generate schemas for an SAP business object using the BEA A pplication Explorer: 1.
2 Creating Schemas for SAP Business Objects 2-4 BEA W ebLogic Adapter for SAP User Guide Figure 2-2 BEA Application Explorer Window - Selecting Session from File 3. Enter a session path. Y ou may want to specify one that correspond s to your project or logical grouping of services and events.
Generating Schemas Using the BEA Application Explore r BEA WebLogic Adapter for SAP User Guide 2-5 Figure 2-4 BEA Application Explo rer Window - Selecting New Connection 5. Enter a descriptive name for this connection and click OK. Figure 2-5 Enter New Co nnection N ame Input W indow 6.
2 Creating Schemas for SAP Business Objects 2-6 BEA W ebLogic Adapter for SAP User Guide 7. Click OK when co mpleted. Figure 2-6 SAP Logon Window - System Tab Figure 2-7 SAP Logon Window - User Tab 8. Select a type of business object, browse its objects, and select the object for which you wish to create a schema.
Generating Schemas Using the BEA Application Explore r BEA WebLogic Adapter for SAP User Guide 2-7 Figure 2-8 BEA Application Explo rer - Selecting Application Components In this example, n avigate through Application Comp onents into Financial Accounting, Company and select the BAPI named BAPI_COMPA NY_GETDETAIL .
2 Creating Schemas for SAP Business Objects 2-8 BEA W ebLogic Adapter for SAP User Guide 9. Right-click the desired busi ness object to create the service schema or event schema.
Generating Schemas Using the BEA Application Explore r BEA WebLogic Adapter for SAP User Guide 2-9 Figure 2-10 BEA Application Explo rer - Displaying the BAPI’s Schemas The following is a sample directory structure generated for the SAP conn ection named SAPIDES und er the session named fi_dev .
2 Creating Schemas for SAP Business Objects 2-10 BEA W ebLogic Adapter for SAP User Guide Figure 2-11 Explorer Window - Direct ory Structure for an SAP connection The generated metadata includes a manifest file ( manifest .xml ), the service request sc hema ( service_BAPI_COMP ANY_GETDETA IL.
Generating Schemas Using the BEA Application Explore r BEA WebLogic Adapter for SAP User Guide 2-1 1 The BEA WebLogic Adapter for SAP uses the manifest.xml file and accompanying schema(s) to connect to and defin e the inter action with the applica tion system from an application view.
2 Creating Schemas for SAP Business Objects 2-12 BEA W ebLogic Adapter for SAP User Guide.
BEA WebLogic Adapter for SAP User Guide 3-1 C HAPTER 3 Configuring the B E A W ebL ogic Adapter f or SAP This section describes how to create, conf igure, and test event adapter application views and service adapter application vi ews.
3 Configuring the BEA WebLogic Adapter for SAP 3-2 BEA W ebLogic Adapter for SAP User Guide To create an application view folder: 1. Open the Application V iew Console, which is found at the following.
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-3 4. Double-click the new fol der icon. The Add Fol der window opens. Figure 3-2 Application View Console Window 5. Enter a name for the folder and click Save. You have finished creating th e application view folder.
3 Configuring the BEA WebLogic Adapter for SAP 3-4 BEA W ebLogic Adapter for SAP User Guide Cr eating the Ev ent Adapter Application V iew To create an event adapter application view: 1.
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-5 5. Select BEA_SAP_1_0 from the Associated Adapter list. Figure 3-4 Define New Application View Window 6.
3 Configuring the BEA WebLogic Adapter for SAP 3-6 BEA W ebLogic Adapter for SAP User Guide For SAP , the required communication and sc hema information was created in the BEA Application Explorer. The location of the base session repository appears on this screen to acces s this information.
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-7 After adding an application view , the Application V iew Administratio n window opens.
3 Configuring the BEA WebLogic Adapter for SAP 3-8 BEA W ebLogic Adapter for SAP User Guide Cr eating 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 dest ination on the SAP system.
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-9 Figure 3-7 RFC D estinations Windows.
3 Configuring the BEA WebLogic Adapter for SAP 3-10 BEA W ebLogic Adapter for SAP User Guide Figure 3-8 RFC De stination for BEA Event Adapter for SAP Window 5. In field RFC destinatio n, enter a name, for example, BEAEVENTDEST . Note: This is case sensitive.
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-1 1 The following window opens. Figure 3-9 RFC De stination BEAEVENTDEST Window 9. Click Registration as Activati on T yp e. 10. In field Registration Prog ram ID field, type BEAID.
3 Configuring the BEA WebLogic Adapter for SAP 3-12 BEA W ebLogic Adapter for SAP User Guide 1 1. Click Change on the toolb ar or choose Save from the Destination menu.
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-13 12. From the Destination Menu , choose Gateway options. Figure 3-11 Gateway Options Window 13. Enter the host name of the machine in field Gatew ay host. 14. Enter sapgw and the SAP system nu mber in field Gateway service, for example, sapgw00.
3 Configuring the BEA WebLogic Adapter for SAP 3-14 BEA W ebLogic Adapter for SAP User Guide 15. Click OK . Figure 3-12 Gatewa y Host and Service Window Configuring the E vent Adapter Application V iew The event adapter application view contains all events that are expected to arrive at this instance of the event adapter.
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-15 3. In the left pan e, click Adm inistration from t he Configure Connectio n list. The Application V iew Console Administration win dow opens. 4. Click Add Event. The following windo w opens.
3 Configuring the BEA WebLogic Adapter for SAP 3-16 BEA W ebLogic Adapter for SAP User Guide The settings on t his window correspond to the TCP connectivity that the adapter creates with SAP to recei ve SAP events in BAPI, RFC, or IDoc format. z gwhost : Host name of the machine ru nning SAP gateway server .
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-17 5. Select Add and then, Continue, from the Applicatio n V iew Administration window . Figure 3-14 Application View Administration Window 6. Select Continue to display the Deploy Appl ication V iew window .
3 Configuring the BEA WebLogic Adapter for SAP 3-18 BEA W ebLogic Adapter for SAP User Guide Figure 3-15 Deploy Application View Window 7. If required, update the settings, and click Deploy to save and deploy th e event adapter .
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-19 In the W ebLo gic Server log or command console, you shoul d see the following entries as the event adapter starts up.
3 Configuring the BEA WebLogic Adapter for SAP 3-20 BEA W ebLogic Adapter for SAP User Guide There should be two created and deployed application views now visible, one for the service adapter and one for the event adapter .
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-21 T esting the E vent Adapter in the Application V iew Console After you create and deploy an event adap ter application view.
3 Configuring the BEA WebLogic Adapter for SAP 3-22 BEA W ebLogic Adapter for SAP User Guide Y ou manually invo ke the request fro m SAP to t he SAPEvent event adapt er . 2. From the test screen, enter a suitable wait time (in milliseconds, for example, 30,000 or 30 secon ds) to enable you to navigate to SAP GUI and invoke the remote function call.
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-23 From SAP GUI: 1. Execute transaction /nSE37 . 2. Select a function module, for example, RFC_C USTOMER_GET . Figure 3-20 Function Builder: Initial Window 3. Choose single test (PF8).
3 Configuring the BEA WebLogic Adapter for SAP 3-24 BEA W ebLogic Adapter for SAP User Guide 6. Execute (PF8). Figure 3-21 Test Function Module: Initial Window.
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-25 7. A results screen appears with an RFC XML document sent to the BEA W ebLogic Adapter for SAP.
3 Configuring the BEA WebLogic Adapter for SAP 3-26 BEA W ebLogic Adapter for SAP User Guide You can now write custom code to exploit the adapter or create a process flow in Studio. For more information, see “Using Ap plication Views in the Studio” in Using Application Integration : For W ebLogi c Integration 7.
Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-27 1. Create a new template. Figure 3-23 New Template Window From the Start Pr operties form: 2. Choose Event → AI Start and select the SAP event adapter . 3. Create a <new> Event Document V ariable and type a name.
3 Configuring the BEA WebLogic Adapter for SAP 3-28 BEA W ebLogic Adapter for SAP User Guide Figure 3-24 Start Properties Form W indow.
Service Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-29 Service Adapter Application V iews This section describes how to create, confi gure, and test a servi ce adapter application view . Service adapters allow WebLogic Inte gration to request information fro m SAP.
3 Configuring the BEA WebLogic Adapter for SAP 3-30 BEA W ebLogic Adapter for SAP User Guide 7. Select BEA_SAP_1_0 from the Associated Adapter list. Figure 3-25 Define New Application View Window 8. Click OK. The Configure Connection Parameters win dow opens.
Service Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-31 The Configure Connection Parameters window enables you to specify parameters for connecting to the BEA W e bLogic Adapter for SAP and creating a schema repository .
3 Configuring the BEA WebLogic Adapter for SAP 3-32 BEA W ebLogic Adapter for SAP User Guide Configuring the Service Adapter Application V iew To configure the service adapter application view: 1. If it is not already open, open the application view to be modi fied.
Service Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-33 3. In the left pan e, click Adm inistration from t he Configure Connectio n list.
3 Configuring the BEA WebLogic Adapter for SAP 3-34 BEA W ebLogic Adapter for SAP User Guide 1. Click Add Service. Figure 3-28 Add Service Window The BEA W ebLogic Adapter for SAP is based on a JDBC interface, so the properties of this connection ar e based on this framework.
Service Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-35 3. Click Add. The D eploy Applicatio n V iew window opens. Figure 3-29 Deploy Application View Window systemNumber SAP System Number. clientNumber SAP Client. language EN for English.
3 Configuring the BEA WebLogic Adapter for SAP 3-36 BEA W ebLogic Adapter for SAP User Guide 4. If required, update the settings, and click Deploy . The Summary for Application View window open s. At this point, you can test your service adapter as described in “Testing the Service Adapter.
Service Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-37 The T est Service window opens. 2. Enter a sample BEA W ebLogic Adap ter fo r SAP Request, for example, RFC_CUSTOMER_ GET.
3 Configuring the BEA WebLogic Adapter for SAP 3-38 BEA W ebLogic Adapter for SAP User Guide Figure 3-31 Te st Service Window 3. Click T est to send the request through the SAP service adapter to the SAP EIS system.
Service Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-39 The response document shoul d look similar to the following. Figure 3-32 Test Results Window.
3 Configuring the BEA WebLogic Adapter for SAP 3-40 BEA W ebLogic Adapter for SAP User Guide The full response document fol lows. Listing 3- 1 Full Respo nse Document from ListCustomer <doc:RFC_CUST OMER_GET.
BEA WebLogic Adapter for SAP User Guide 4-1 C HAPTER 4 T he B EA W ebL ogic Adapter f or SAP and ID o c s The BEA WebLogic Adapter fo r SAP’s event adapter receives IDocs from SAP using the RFCs INBOUND_IDO C_PROCESS or IDOC_IN BOUND_ASYNCHR ONOUS .
4 The BEA WebLogic Adapter for SAP and IDocs 4-2 BEA W ebLogic Adapter for SAP User Guide Defining a L ogical P ort The lower level networking requires that a system port number be associated with the RFC destination. The logical port identifies th e port to which messages are sent.
Defining a Logical Port BEA WebLogic Adapter for SAP User Guide 4-3 6. Save the session, makin g note of the system-generated RFC Port. Figure 4-1 SAP Main Window / Creating a tRFC port.
4 The BEA WebLogic Adapter for SAP and IDocs 4-4 BEA W ebLogic Adapter for SAP User Guide Cr eating a L ogical S ystem One type of partner is a logical system. A logical system manages one or more RFC destinations. To create a lo gical system called BEALOG: 1.
Creating a Logical System BEA WebLogic Adapter for SAP User Guide 4-5 3. Expand the following nodes: Basis Component s → Application Link Enabling (ALE) → Sending and Receiving Systems → Logical Systems → Define Logical System. Click the green hook be side Define Logical System.
4 The BEA WebLogic Adapter for SAP and IDocs 4-6 BEA W ebLogic Adapter for SAP User Guide 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.
Creating a Partner Profile BEA WebLogic Adapter for SAP User Guide 4-7 Cr eating a P artner Pr ofile To create a partner profile: 1. In the SAP Main screen, choose T ools → B usiness Communication → IDO C Basis → IDOC → Partner profile, or else execute transaction WE20 .
4 The BEA WebLogic Adapter for SAP and IDocs 4-8 BEA W ebLogic Adapter for SAP User Guide 10. Save the session. Figure 4-4 SAP Window / Partner Profiles: Outbound Parameters 1 1. Exit the session. The SAP Partner Profiles summary windo w opens, displaying information for the logical sy stem that you just created.
Creating a Partner Profile BEA WebLogic Adapter for SAP User Guide 4-9 Figure 4-5 SAP Window / Partner Profiles Summary.
4 The BEA WebLogic Adapter for SAP and IDocs 4-10 BEA W ebLogic Adapter for SAP User Guide Cr eating a Distribution Model f or the P artner and Message T ype To create a distribution model called BEAMOD: 1. In the SAP Main screen, choose T o ols → AcceleratedSAP → Customizing → Project Management, or else execute transaction BD64 .
Creating a Distribution Model fo r the Partner and Message Type BEA WebLogic Adapter for SAP User Guide 4-1 1 Figure 4-6 SAP Window / Distribution Model Changed.
4 The BEA WebLogic Adapter for SAP and IDocs 4-12 BEA W ebLogic Adapter for SAP User Guide In the dialog box, you can view: z Sender: for example, I46_CLI800, which points to the SAP system that will SEND the IDoc (in this case, an SAP 4.6B system). z Receiver: Logical system .
Creating a Distribution Model fo r the Partner and Message Type BEA WebLogic Adapter for SAP User Guide 4-13 The following screen shows the new mode l view that can be used to send message type DEBMAS from the I46_CLI800 SAP system to the BEALOG logical system.
4 The BEA WebLogic Adapter for SAP and IDocs 4-14 BEA W ebLogic Adapter for SAP User Guide Manually Sending an I Doc In the SAP Server , the transaction B D12 brings you to the following screen where you can send IDocs to any logical system, in th is example to WebLogic Integrati on with an SAP event adapter (RFC list ener) for pro gram ID BEAID.
Manually Sending an IDoc BEA WebLogic Adapter for SAP User Guide 4-15 6. The event adapter receives the IDoc in XML format. No response is expected from W ebLo gic Integration.
4 The BEA WebLogic Adapter for SAP and IDocs 4-16 BEA W ebLogic Adapter for SAP User Guide Figure 4-10 SAP Window / Master IDocs Set Up for Message Type DEBMAS.
BEA WebLogic Adapter for SAP User Guide 5-1 C HAPTER 5 Sending SAP E v ents Using AB AP Pr ogr a ms Once the BEA WebLogic Adapte r for SAP’s event adapt er and the RFC destination are configured, you can write ABAP code to execute calls at your new destination (th at is, the event adapter).
5 Sending SAP Events Using ABAP Programs 5-2 BEA W ebLogic Adapter for SAP User Guide W r iting an R F C Module The following is sample code that makes use of the user-defined RFC module Z_EVENT_DISPA TCH . Listing 5- 1 Sample Co de With User- Defined RFC FUNCTION Z_01 _EVENT_DISP ATCH.
BEA WebLogic Adapter for SAP User Guide A-1 A PPENDIX A Sample Files This section provides sample request and response docum ents sent between SAP and the BEA WebLogic Adapter for SAP.
A Sample Files A-2 BEA W ebLogic Adapter for SAP User Guide <RFCDAT A2></RFCDAT A2> </TEST_IN> <DESTINATI ONS> </DESTINAT IONS> <LOG> </LOG> </doc:RFC_WAL K_THRU_TEST > Sample R F C Response Document Listing A-3 Sample RFC Response Document <?xml version ="1.
Sample IDoc XML for Message Type DEBMAS BEA WebLogic Adapter for SAP User Guide A-3 Sample I Doc X M L f or Message T ype DE BM A S Listing A-4 Sample IDoc XML for Message Type DEBMAS <?xml version ="1.
A Sample Files A-4 BEA W ebLogic Adapter for SAP User Guide <ARC KEY></ARCKE Y> <SER IAL>2001090 4164452</SERIA L> </EDI_DC 40> <E1KNA1M SEGMENT="1 "> <.
Sample IDoc XML for Message Type DEBMAS BEA WebLogic Adapter for SAP User Guide A-5 <TELBX ></TELBX> <TELF1 ></TELF1> <TELF2 ></TELF2> <TELFX ></TELFX> .
A Sample Files A-6 BEA W ebLogic Adapter for SAP User Guide <TXLW2 ></TXLW2> <CCC01 ></CCC01> <CCC02 ></CCC02> <CCC03 ></CCC03> <CCC04 ></CCC04.
Sample IDoc XML for Message Type DEBMAS BEA WebLogic Adapter for SAP User Guide A-7 <VKBU R></VKBUR> <VSOR T></VSORT> <KVGR 1></KVGR1> <KVGR 2></KVGR2> .
A Sample Files A-8 BEA W ebLogic Adapter for SAP User Guide < PARVW>WE</P ARVW> < KUNN2>00000 00001</KUNN2> < DEFPA></DEF PA> < KNREF></KNR EF> < PAR.
Un punto importante, dopo l’acquisto del dispositivo (o anche prima di acquisto) è quello di leggere il manuale. Dobbiamo farlo per diversi motivi semplici:
Se non hai ancora comprato il BEA WebLogic Adapter for SAP è un buon momento per familiarizzare con i dati di base del prodotto. Prime consultare le pagine iniziali del manuale d’uso, che si trova al di sopra. Dovresti trovare lì i dati tecnici più importanti del BEA WebLogic Adapter for SAP - in questo modo è possibile verificare se l’apparecchio soddisfa le tue esigenze. Esplorando le pagine segenti del manuali d’uso BEA WebLogic Adapter for SAP imparerai tutte le caratteristiche del prodotto e le informazioni sul suo funzionamento. Le informazioni sul BEA WebLogic Adapter for SAP ti aiuteranno sicuramente a prendere una decisione relativa all’acquisto.
In una situazione in cui hai già il BEA WebLogic Adapter for SAP, ma non hai ancora letto il manuale d’uso, dovresti farlo per le ragioni sopra descritte. Saprai quindi se hai correttamente usato le funzioni disponibili, e se hai commesso errori che possono ridurre la durata di vita del BEA WebLogic Adapter for SAP.
Tuttavia, uno dei ruoli più importanti per l’utente svolti dal manuale d’uso è quello di aiutare a risolvere i problemi con il BEA WebLogic Adapter for SAP. Quasi sempre, ci troverai Troubleshooting, cioè i guasti più frequenti e malfunzionamenti del dispositivo BEA WebLogic Adapter for SAP insieme con le istruzioni su come risolverli. Anche se non si riesci a risolvere il problema, il manuale d’uso ti mostrerà il percorso di ulteriori procedimenti – il contatto con il centro servizio clienti o il servizio più vicino.
