Français dropdown-ico

BEA WebLogic Adapter for SAP manuel d'utilisation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

Aller à la page of

Les manuels d’utilisation similaires

Un bon manuel d’utilisation

Les règles imposent au revendeur l'obligation de fournir à l'acheteur, avec des marchandises, le manuel d’utilisation BEA WebLogic Adapter for SAP. Le manque du manuel d’utilisation ou les informations incorrectes fournies au consommateur sont à la base d'une plainte pour non-conformité du dispositif avec le contrat. Conformément à la loi, l’inclusion du manuel d’utilisation sous une forme autre que le papier est autorisée, ce qui est souvent utilisé récemment, en incluant la forme graphique ou électronique du manuel BEA WebLogic Adapter for SAP ou les vidéos d'instruction pour les utilisateurs. La condition est son caractère lisible et compréhensible.

Qu'est ce que le manuel d’utilisation?

Le mot vient du latin "Instructio", à savoir organiser. Ainsi, le manuel d’utilisation BEA WebLogic Adapter for SAP décrit les étapes de la procédure. Le but du manuel d’utilisation est d’instruire, de faciliter le démarrage, l'utilisation de l'équipement ou l'exécution des actions spécifiques. Le manuel d’utilisation est une collection d'informations sur l'objet/service, une indice.

Malheureusement, peu d'utilisateurs prennent le temps de lire le manuel d’utilisation, et un bon manuel permet non seulement d’apprendre à connaître un certain nombre de fonctionnalités supplémentaires du dispositif acheté, mais aussi éviter la majorité des défaillances.

Donc, ce qui devrait contenir le manuel parfait?

Tout d'abord, le manuel d’utilisation BEA WebLogic Adapter for SAP devrait contenir:
- informations sur les caractéristiques techniques du dispositif BEA WebLogic Adapter for SAP
- nom du fabricant et année de fabrication BEA WebLogic Adapter for SAP
- instructions d'utilisation, de réglage et d’entretien de l'équipement BEA WebLogic Adapter for SAP
- signes de sécurité et attestations confirmant la conformité avec les normes pertinentes

Pourquoi nous ne lisons pas les manuels d’utilisation?

Habituellement, cela est dû au manque de temps et de certitude quant à la fonctionnalité spécifique de l'équipement acheté. Malheureusement, la connexion et le démarrage BEA WebLogic Adapter for SAP ne suffisent pas. Le manuel d’utilisation contient un certain nombre de lignes directrices concernant les fonctionnalités spécifiques, la sécurité, les méthodes d'entretien (même les moyens qui doivent être utilisés), les défauts possibles BEA WebLogic Adapter for SAP et les moyens de résoudre des problèmes communs lors de l'utilisation. Enfin, le manuel contient les coordonnées du service BEA en l'absence de l'efficacité des solutions proposées. Actuellement, les manuels d’utilisation sous la forme d'animations intéressantes et de vidéos pédagogiques qui sont meilleurs que la brochure, sont très populaires. Ce type de manuel permet à l'utilisateur de voir toute la vidéo d'instruction sans sauter les spécifications et les descriptions techniques compliquées BEA WebLogic Adapter for SAP, comme c’est le cas pour la version papier.

Pourquoi lire le manuel d’utilisation?

Tout d'abord, il contient la réponse sur la structure, les possibilités du dispositif BEA WebLogic Adapter for SAP, l'utilisation de divers accessoires et une gamme d'informations pour profiter pleinement de toutes les fonctionnalités et commodités.

Après un achat réussi de l’équipement/dispositif, prenez un moment pour vous familiariser avec toutes les parties du manuel d'utilisation BEA WebLogic Adapter for SAP. À l'heure actuelle, ils sont soigneusement préparés et traduits pour qu'ils soient non seulement compréhensibles pour les utilisateurs, mais pour qu’ils remplissent leur fonction de base de l'information et d’aide.

Table des matières du manuel d’utilisation

  • Page 1

    BEA W ebLogic Adapter for SAP ® Use r Guide Release 7.0 Document Date: October 200 2[...]

  • Page 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 made available only pursuant to the terms of the BEA Systems License Agreement and may be used or copied only in accord ance with t he terms of that ag[...]

  • Page 3

    BEA WebLogic Adapter for SAP User Guide iii T able of Contents About This Document What You Need to Know .............. ......................... ......................... .................... vi Related Information .............. ......................... .......................... ......................... ... vi Contact Us! ............. .......[...]

  • Page 4

    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 ................ ......................... .............. .......................... 4-4 Creating a Partner Profile [...]

  • Page 5

    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.  Chapter 2, “Creating Schemas for SAP Busines[...]

  • Page 6

    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. It is assumed that readers know[...]

  • Page 7

    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.com if you have questions or com ments. Your comments will be reviewed directly by the BEA profession als who create and update the BEA WebLogic Adapte r for SAP documentatio[...]

  • Page 8

    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. italics Indicates emphasis or book titles. monospace text[...]

  • Page 9

    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 ]... [-l file-list ]... | Separates mutually exclusive cho[...]

  • Page 10

    x BEA W ebLogic Adapter for SAP User Guide[...]

  • Page 11

    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. It includes the foll owing topics:  W ebLogic Integ ration  How the BEA W ebLogic Adapter for SAP W orks You can use the[...]

  • Page 12

    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 objects such as SAP Remote Function Call (RFC) modules, BAPIs (Business Application Programming Interfaces), and IDocs (Intermediate Documents), which a[...]

  • Page 13

    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. W ebL ogic Integr ation WebLogic Integration is a single solu tion that delivers application serv[...]

  • Page 14

    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. An application view is a standard self-describing interface to an applicat ion. Th[...]

  • Page 15

    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. The deployed application view from BEA WebLogic Adapter for SAP has the following feat[...]

  • Page 16

    1 Introducing the BEA WebLogic Adapter for SAP 1-6 BEA W ebLogic Adapter for SAP User Guide[...]

  • Page 17

    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. It contains the following topi cs:  Overview  Generating Schemas Using the BEA Applicat ion Explorer Ov erview The BEA [...]

  • Page 18

    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 schema information that you enter and th at is created by the BEA Application Explor er, directly affects the connections, events, and services available [...]

  • Page 19

    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. Open the BEA A pplication Explo rer: z From the W indows Start menu, navigate to the Programs menu an d cho[...]

  • Page 20

    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. Figure 2-3 Enter Session Path Window 4. Right-click SAP [...]

  • Page 21

    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. Enter the appropriate connection informatio n in the System an[...]

  • Page 22

    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. Note that: z BAPIs are listed unde[...]

  • Page 23

    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 .[...]

  • Page 24

    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. Figure 2-9 BEA Application Explorer - Selecting a BAPI and Choosing Creating Service Schema After the schemas are created, the right pane displays the di fferent schemas w[...]

  • Page 25

    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 .[...]

  • Page 26

    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.xsd ), the response schema ( service_BAP I_COMPANY_GETD E[...]

  • Page 27

    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. The location of this repository is poin ted to in configuration [...]

  • Page 28

    2 Creating Schemas for SAP Business Objects 2-12 BEA W ebLogic Adapter for SAP User Guide[...]

  • Page 29

    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. It includes th e following topics:  Creating an Application V iew Folder  Event Adapter Application V iews ?[...]

  • Page 30

    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 lo cation: http:// hos t:port /wlai Here, host is the TCP/IP address or DNS nam e where W ebLogic Integrati on Server is installed, and port is the s[...]

  • Page 31

    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. To create a service adapter application view, see “Config[...]

  • Page 32

    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. Open the Application V iew Console, which is found at the following lo cation: http:// hos t:port /wlai Here, host is the TCP/IP address or DNS nam e where W ebLog[...]

  • Page 33

    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. Click OK. The Configure Connection Parameters win dow opens. The Configure Connection Parameters window enables you to enter the information required to commun icate wit[...]

  • Page 34

    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. 7. Enter the base directory holding your SAP connectio n[...]

  • Page 35

    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. Figure 3-6 Applic ation View A dministrat ion Window This window is also available at any time while the applicatio n is not deployed, and if deployed can be accessed by “undeploying”[...]

  • Page 36

    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. This process is also required when you want an SAP system to send ID[...]

  • Page 37

    Event Adapter Application Views BEA WebLogic Adapter for SAP User Guide 3-9 Figure 3-7 RFC D estinations Windows[...]

  • Page 38

    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. 6. Enter T in the field Co nnection type (destination type TCP/IP). 7. Enter comments in t[...]

  • Page 39

    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.[...]

  • Page 40

    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. Figure 3-10 Destination Menu Window[...]

  • Page 41

    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.[...]

  • Page 42

    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. As such, many services may[...]

  • Page 43

    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. Figure 3-13 Application View Console Administration Window The values that appear [...]

  • Page 44

    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 . z gwserv : SAP gateway server . z progid[...]

  • Page 45

    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 .[...]

  • Page 46

    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 .[...]

  • Page 47

    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. Figure 3-16 WebLogic Server Log Window[...]

  • Page 48

    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 . Figure 3-17 Application View Console Window At this point, you can test your service adapter as described in “Testing the E[...]

  • Page 49

    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 as described in “Creating the Event Adapter Ap plication View” on page 3-4 and “Configuring the Event Adapter Application View” on page 3-14 [...]

  • Page 50

    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.[...]

  • Page 51

    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). 4. Enter RFC target system, for example, BEAEVENTDEST . 5. Enter input data for the particu[...]

  • Page 52

    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[...]

  • Page 53

    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. Figure 3-22 Test Result for ListCustomer Window[...]

  • Page 54

    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.0, see http://edocs.bea.com/w[...]

  • Page 55

    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. This variable enables you to monitor the values pass[...]

  • Page 56

    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[...]

  • Page 57

    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. Cr eating a Service Adapter Application View To create a ser[...]

  • Page 58

    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.[...]

  • Page 59

    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 . Figure 3-26 Configure Co nnection Parameters Window The BSE Location represents the location of the connec[...]

  • Page 60

    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. For more information, see “Editing an Applicati on V iew” in “Defining an App[...]

  • Page 61

    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. The Application V iew Console Administration win dow opens. Figure 3-27 Application View Console Administration Window[...]

  • Page 62

    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. 2. Enter the properties as: traceOn Can be turned on to increase the mess[...]

  • Page 63

    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. user SAP User ID. password Associat ed SAP user’s password.[...]

  • Page 64

    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.” T esting the Service Adapter After you create and dep[...]

  • Page 65

    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 : <doc:RFC_CUST OMER_GET xmlns:doc="ur n:sap-com:d ocument:sap:bu siness:rfc "> <KUNNR></ KUNNR> <NAME1>Au to*</[...]

  • Page 66

    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.[...]

  • Page 67

    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[...]

  • Page 68

    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.Re sponse xmlns:doc="ur n:sap-com:d ocument:sap:bu siness:rfc "> <CUSTOMER_ T> <item> <KUN NR>00000001 10<[...]

  • Page 69

    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 . This section describes how to configure and test your SAP system to send IDocs to an event adapter[...]

  • Page 70

    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. The logical port can only be used if an RFC destination was previo[...]

  • Page 71

    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[...]

  • Page 72

    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. In the SAP Main screen, choose T o ols → AcceleratedSAP → Customizing → Project Man[...]

  • Page 73

    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. Figure 4-2 SAP Main Window / Display Structure 4. Select New E[...]

  • Page 74

    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. Save the sessi on.[...]

  • Page 75

    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 . 2. Select Partner type LS (Logical system) and select Create (F5). 3. [...]

  • Page 76

    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.[...]

  • Page 77

    Creating a Partner Profile BEA WebLogic Adapter for SAP User Guide 4-9 Figure 4-5 SAP Window / Partner Profiles Summary[...]

  • Page 78

    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 . 2. Select [...]

  • Page 79

    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[...]

  • Page 80

    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 . For example, BEALOG. z Message type: T ype of IDoc. For example, DEBMAS[...]

  • Page 81

    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. Figure 4-8 SAP Window / Distribution Model Changed (New Model View) You are now ready to[...]

  • Page 82

    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. 1[...]

  • Page 83

    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. Figure 4-9 SAP Window / Send Customers[...]

  • Page 84

    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[...]

  • Page 85

    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). This section describes how to send RFC or BA PIs to the [...]

  • Page 86

    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. CALL FUNCTION 'Z_EV ENT_DISPAT CH' DESTINATION &apos[...]

  • Page 87

    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. It includes the following samples:  Sample RFC Request Document  Sample RFC Response Document  Sample IDoc XML f or Message T ype DEBMAS Sample R F C Reques[...]

  • Page 88

    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.0" ?> <doc:RFC_WALK _THR[...]

  • Page 89

    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.0" ?> <DEBMAS01> <IDOC BEGI N="1"> <EDI_DC 40 SEGMENT= "1"> <TAB NAM>EDI_DC4 0</TABNA[...]

  • Page 90

    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 "> <MSGF N>005</MSGF N> <KUNN R>000000000 1</KUNNR> <ANRE D></ANRED> <AUFS D></AUFSD> <BAHN E></BAH[...]

  • Page 91

    Sample IDoc XML for Message Type DEBMAS BEA WebLogic Adapter for SAP User Guide A-5 <TELBX ></TELBX> <TELF1 ></TELF1> <TELF2 ></TELF2> <TELFX ></TELFX> <TELTX ></TELTX> <TELX1 ></TELX1> <LZONE >0000000001 </LZONE> <XZEMP ></XZEMP> <VBUND ></VBUN[...]

  • Page 92

    A Sample Files A-6 BEA W ebLogic Adapter for SAP User Guide <TXLW2 ></TXLW2> <CCC01 ></CCC01> <CCC02 ></CCC02> <CCC03 ></CCC03> <CCC04 ></CCC04> <CASSD ></CASSD> <KDKG1 ></KDKG1> <KDKG2 ></KDKG2> <KDKG3 ></KDKG3> <KDKG4 ></KDKG4> [...]

  • Page 93

    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> <KVGR 3></KVGR3> <KVGR 4></KVGR4> <KVGR 5></KVGR5> <BOKR E></BOKRE> <KURS T></KURST> <P[...]

  • Page 94

    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> < PARZA>000</ PARZA> </E1K NVPM> <E1KN VIM SEGMENT ="1"> <MSGFN>005< /MSGFN> <ALAND>DE</ ALAND> <[...]