Sun Microsystems SAP BAPI manual

SUN SEEBEYOND eWAY™ ADAPTER FOR SAP BAPI USER’S GUIDE Release 5.1.3[...]

eWay™ Adapter for SAP BAPI User’s Guid e 2 Sun Micros ystems, Inc. Copyright © 2007 Sun Microsystems, Inc., 4150 Network Circle, Sa nta Clara, California 95054, U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual property rights relating to te chnology embodied in the product that is described in this document. In particular, a[...]

Contents eWay™ Adapter for SAP BAPI User’s Guid e 3 Sun Micros ystems, Inc. Contents Chapter 1 Introducing the SAP BAPI eWay 7 About SAP 7 About the SAP BAPI eWay 7 Invoking B API/RFC Method s 8 The SAP BAPI eW ay Data Flows 9 Outbound Data Flow: Java CAPS to SAP R/3 9 Inbound Data Flow: SAP R/3 to Java CAPS 9 What’s New in This Release 11 Wh[...]

Contents eWay™ Adapter for SAP BAPI User’s Guid e 4 Sun Micros ystems, Inc. Chapter 3 Setting SAP BAPI eWay Properties 23 Creating and Configuring a SAP BAPI eWay 23 Configuring the eWay Connectivity Map Properties 23 eWay Connectivity Map Properties 25 Configuring the Inbou nd eWay Properties 25 Server Connection Settings 25 Configuring the Ou[...]

Contents eWay™ Adapter for SAP BAPI User’s Guid e 5 Sun Micros ystems, Inc. Creating a Partner Pr ofile 62 Configuring a Partner Pr ofile 64 Security Issues 67 Chapter 6 Reviewing the Sample Projects 69 About the Sample Projects 69 prjBapiOutbound.zip 70 prjIDocInbound.zip 70 SAP Version Support 70 Steps Required to Run the Sample Project 70 Im[...]

Contents eWay™ Adapter for SAP BAPI User’s Guid e 6 Sun Micros ystems, Inc. Create and Start the Domain 114 Build and Depl oy the Projec t 115 Run the Sample 115 Additional Sample Project Scenarios 116 About Sending ID ocs to SAP R/3 Using tRFC s 11 6 The RFC OTD used to send/r eceive IDOCs 116 Client Mode - sending IDOCs to SAP R/3 via IDOC_IN[...]

eWay™ Adapter for SAP BAPI User’s Guid e 7 Sun Micros ystems, Inc. Chapter 1 Introducing the SAP BAPI eWay The Sun SeeBeyond eWay™ Adapter for SAP BAPI, also not ed throughout this book as the SAP BAPI eWay, provides Sun Java Composite Applica tion Platform Suite (Java CAPS) Projects with the ability to exchange data with SAP R/3 software. Th[...]

Chapter 1 Section 1.2 Introducing the SAP B API eWay About the SAP BAPI e Way eWay™ Adapter for SAP BAPI User’s Guid e 8 Sun Micros ystems, Inc. Figure 1 BAPI eWay The functionality of the SAP BAPI eWay simplifies the process of determining the requisite IMPORT, EXPORT, CHANGING, and TABLE parameters—collecting all the necessary data using th[...]

Chapter 1 Section 1.2 Introducing the SAP B API eWay About the SAP BAPI e Way eWay™ Adapter for SAP BAPI User’s Guid e 9 Sun Micros ystems, Inc. The meta data for a BAPI/RFC in SAP R/3 is extracted by the BAPI wizard, which uses it to build the BAPI/RFC OTD. This OTD is used in Java Collaborations and eInsight Business Processes t o invoke or r[...]

Chapter 1 Section 1.2 Introducing the SAP B API eWay About the SAP BAPI e Way eWay™ Adapter for SAP BAPI User’s Guid e 10 Sun Micros ystems, Inc. Inbound Data Flow via RFC The sequence diagram uses a sample C ostCenter OTD to d escribe the RFC inbound sequenc e. Figure 4 Inbound Data Flow via RFC The figure above shows th e following steps for [...]

Chapter 1 Section 1.3 Introducing the SAP B API eWay What’s New in This Release eWay™ Adapter for SAP BAPI User’s Guid e 11 Sun Micros ystems, Inc. Figure 5 Inbound Data Flow via tRFC The figure above shows the following st eps for the inbound data flow via tRFC: 1 The Business Process is activated when an RFM call is received from SAP R/3. 2[...]

Chapter 1 Section 1.4 Introducing the SAP B API eWay What’s In This Documen t eWay™ Adapter for SAP BAPI User’s Guid e 12 Sun Micros ystems, Inc. What’s New in Version 5.1.2  Support for SAP ECC 6.0 (Unicode only) What’s New in Version 5.1.1  Supports automatic dep loyment of EAR fi les to WebLogic Application Server (version 9.1). [...]

Chapter 1 Section 1.4 Introducing the SAP B API eWay What’s In This Documen t eWay™ Adapter for SAP BAPI User’s Guid e 13 Sun Micros ystems, Inc.  Chapter 1 “Introducing the SAP BAPI eWay” : Provides an overview description of the product as well as high-level information about this document.  Chapter 2 “Installing the eWay” : D[...]

Chapter 1 Section 1.5 Introducing the SAP B API eWay Sun Microsystem s, Inc. Web Site eWay™ Adapter for SAP BAPI User’s Guid e 14 Sun Micros ystems, Inc. 1.4.4 Related Documents The following Sun documents provide addition al information about the Sun Java CAPS product:  Sun SeeBeyond eGate™ Integrator User’s Guide  Composite Applicat[...]

eWay™ Adapter for SAP BAPI User’s Guid e 15 Sun Micros ystems, Inc. Chapter 2 Installing the eWay This chapter describes the requireme nts an d procedures for inst alling the SAP BAPI eWay. Procedures for im plementing sample proj ects, are described in Reviewing the Sample Projects on page 69. What’s In This Chapter  “Installing the SAP[...]

Chapter 2 Section 2.1 Installing the eWay Installing the SAP BAPI eWay eWay™ Adapter for SAP BAPI User’s Guid e 16 Sun Micros ystems, Inc. 2 Select the following products from t he eWay category:  FileeWay (the File eWay is used by most sample Projects)  SAPALEeWay (the SAP ALE eWay is used by the SAP BAPI eWay sample Project)  SAPBAPI[...]

Chapter 2 Section 2.2 Installing the eWay ICAN 5.0 Project Migration Procedures eWay™ Adapter for SAP BAPI User’s Guid e 17 Sun Micros ystems, Inc. After Installation You must incorporate the installed eWay co mponents into a Proje ct before using the intended function s. See the Sun SeeBeyond eGate™ Integrator User’s Guide for more informa[...]

Chapter 2 Section 2.2 Installing the eWay ICAN 5.0 Project Migration Procedures eWay™ Adapter for SAP BAPI User’s Guid e 18 Sun Micros ystems, Inc. 2 From the Project Explorer, right-click your Project and select Export from the shortcut menu . Th e Export Manager appears. 3 Select the Project that you want to export in the left pane of the Exp[...]

Chapter 2 Section 2.3 Installing the eWay Installing Ente rprise Manager eWay Plu g-Ins eWay™ Adapter for SAP BAPI User’s Guid e 19 Sun Micros ystems, Inc. C Select the Environment Explorer tab, an d from the Environme nt Explorer, right- click the Project’s Environment and select Version Control > Check Out from the shortcut menu. D Selec[...]

Chapter 2 Section 2.3 Installing the eWay Installing Ente rprise Manager eWay Plu g-Ins eWay™ Adapter for SAP BAPI User’s Guid e 20 Sun Micros ystems, Inc. 3 Select the application plug-ins you require, and click Install . The application plug- ins are installed and deployed. Alternately, you can install eWay pl ug-ins using the following s tep[...]

Chapter 2 Section 2.3 Installing the eWay Installing Ente rprise Manager eWay Plu g-Ins eWay™ Adapter for SAP BAPI User’s Guid e 21 Sun Micros ystems, Inc. Note: An alert cod e is a warning that a n error ha s occurred. It is not a diagnostic. The user actions noted above are just some possible corrective measures you may take. Refer to the log[...]

Chapter 2 Section 2.4 Installing the eWay Deploying an EAR File eWay™ Adapter for SAP BAPI User’s Guid e 22 Sun Micros ystems, Inc. 2.4 Deploying an EAR File The Sun Java CAPS Enterpr ise Designer can be configured to automatically deploy an EAR file to the Sun Java System Applic ation Se rver. To configure the Enterprise Designer for deploymen[...]

eWay™ Adapter for SAP BAPI User’s Guid e 23 Sun Micros ystems, Inc. Chapter 3 Setting SAP BAPI eWay Properties This chapter describes how to set the SAP BAPI eWay properti es to en able data exchange betwee n the SAP R/3 softw are and a Java CAPS p roject. What’s In This Chapter  Creating and Configuring a SAP BAPI eWay on page 23  Conf[...]

Chapter 3 Section 3.2 Setting SAP BAPI eWay Properties Configurin g the eWay Connectivity Map Properties eWay™ Adapter for SAP BAPI User’s Guid e 24 Sun Micros ystems, Inc. template containing default configuratio n properties that are accessible on the Connectivity Ma p. To configure the eWay properties: 1 On the Enterprise Designer’s Connec[...]

Chapter 3 Section 3.3 Setting SAP BAPI eWay Properties eW ay Connectivity Map Propert ies eWay™ Adapter for SAP BAPI User’s Guid e 25 Sun Micros ystems, Inc. Figure 7 Outbou nd eWay Properties 3.3 eWay Connectivity Map Properties The eWay Connectivity Map consists of the following properties categories. Inbound eWay Configurat ion Sections Incl[...]

Chapter 3 Section 3.3 Setting SAP BAPI eWay Properties eW ay Connectivity Map Propert ies eWay™ Adapter for SAP BAPI User’s Guid e 26 Sun Micros ystems, Inc. Table 4 Inbound eWay—Serve r Connection Settings Name Description Required Value Enable RFC Trace You enab le RFC tracing with th e Enable RFC Trace property. The trace file contains RFC[...]

Chapter 3 Section 3.3 Setting SAP BAPI eWay Properties eW ay Connectivity Map Propert ies eWay™ Adapter for SAP BAPI User’s Guid e 27 Sun Micros ystems, Inc. 3.3.2 Configuring the Outbound eWay Properties The Outbound eWay Properties include pa rameters re quired to communicate from Java CAPS to SAP/R3. The foll owing se rver connection sett in[...]

Chapter 3 Section 3.3 Setting SAP BAPI eWay Properties eW ay Connectivity Map Propert ies eWay™ Adapter for SAP BAPI User’s Guid e 28 Sun Micros ystems, Inc. Enable RFC Trace You enable RFC tracing wi th the Enable RFC Trace property. The trace file is rfc number .trc , for example, rfc00310_0156. trc. Yes or No . The default mode is No ; the R[...]

Chapter 3 Section 3.3 Setting SAP BAPI eWay Properties eW ay Connectivity Map Propert ies eWay™ Adapter for SAP BAPI User’s Guid e 29 Sun Micros ystems, Inc. Transaction Mode Specifies the transaction mod e. Non-Transactional Actions performed by BAPI call are committed immediately and automatically by SAP R/3 (auto commit) . In this mode, use [...]

Chapter 3 Section 3.4 Setting SAP BAPI eWay Properties Configuring the eWay Enviro nment Properties eWay™ Adapter for SAP BAPI User’s Guid e 30 Sun Micros ystems, Inc. 3.4 Configuring the eWay Environment Properties The eWay Environment Configuration properti es contain parameters that define how the eWay connects to and interacts with SAP R/3 [...]

Chapter 3 Section 3.5 Setting SAP BAPI eWay Properties eWay External Properties eWay™ Adapter for SAP BAPI User’s Guid e 31 Sun Micro systems, Inc. 2 Expand the Environ ment created for the SAP BAPI P roject and locate the SAP BAPI External System. Note: For more information on creating an Environment, see the “Sun SeeBeyond eGate™ Integrat[...]

Chapter 3 Section 3.5 Setting SAP BAPI eWay Properties eWay External Properties eWay™ Adapter for SAP BAPI User’s Guid e 32 Sun Micro systems, Inc. Inbound eWay Configurat ion Sections Include:  Server Connection Settings  MDB Settings Outbound eWay Configuration Settings Include:  Client Connection Settings  Connection Retry Settin[...]

Chapter 3 Section 3.5 Setting SAP BAPI eWay Properties eWay External Properties eWay™ Adapter for SAP BAPI User’s Guid e 33 Sun Micro systems, Inc. Router String (optional) Specifies th e router string needed to access the SAP R/3 Applicati on Server. This property is opt ional; use it only to gain access to an SA P system that is behind a fire[...]

Chapter 3 Section 3.5 Setting SAP BAPI eWay Properties eWay External Properties eWay™ Adapter for SAP BAPI User’s Guid e 34 Sun Micro systems, Inc. MDB Settings The following MDB Setting s are used: System Numb er Specifies th e system numbe r of the SAP R/3 application server. Use this property when you are not using SAP load balancing. For in[...]

Chapter 3 Section 3.5 Setting SAP BAPI eWay Properties eWay External Properties eWay™ Adapter for SAP BAPI User’s Guid e 35 Sun Micro systems, Inc. 3.5.2 Outbound SAP BAPI eWay The outbound eWay Environment properties incl ude client connection parameters that are required to implement the projec t using the eWay in outbound mode communication.[...]

Chapter 3 Section 3.5 Setting SAP BAPI eWay Properties eWay External Properties eWay™ Adapter for SAP BAPI User’s Guid e 36 Sun Micro systems, Inc. System ID Specifies the System I D of the SAP R/3 instanc e. Any valid SAP System ID. There is no default se tting. Gateway Hostname (optional) Specifies an Gateway host na me for the Application Se[...]

Chapter 3 Section 3.5 Setting SAP BAPI eWay Properties eWay External Properties eWay™ Adapter for SAP BAPI User’s Guid e 37 Sun Micro systems, Inc. Connection Retry Settings The following Connecti on Retry Settings are used: Connection Pool Settings The following Connec tion Pool Settings a re used by the external database: Router String (optio[...]

Chapter 3 Section 3.5 Setting SAP BAPI eWay Properties eWay External Properties eWay™ Adapter for SAP BAPI User’s Guid e 38 Sun Micro systems, Inc. Table 10 Outbound SAP BAPI eWay—Connection P ool Settings Name Descripti on Required Val ue Steady pool size The minimum number of physical connections the p ool should keep available at all times[...]

eWay™ Adapter for SAP BAPI User’s Guid e 39 Sun Micros ystems, Inc. Chapter 4 Creating SAP BAPI OTDs The SAP BAPI wizard is used to create BA PI and RFC OTDs. You use these OTDs in Java Collaborations and eInsight business pr ocesses to create the needed busines s rules to communicate with SAP R/13. What’s In This Chapter  SAP BAPI Encodin[...]

Chapter 4 Section 4.2 Creating SAP BAPI OTDs Date and Time Stamp Requiremen ts eWay™ Adapter for SAP BAPI User’s Guid e 40 Sun Micros ystems, Inc. 4.2 Date and Time Stamp Requirements Date and time stamp fields in the OTD are now typed as java.lang.String fields. This means that the OTD expect s values assign ed to date fields as YYYYMMDD, wher[...]

Chapter 4 Section 4.4 Creating SAP BAPI OTDs Creating BAPI and RFC OTDs eWay™ Adapter for SAP BAPI User’s Guid e 41 Sun Micros ystems, Inc. You must manually add these files to the following location: c:WINNTsystem32 Note: Restart both Enterprise Designer and th e domain after installing the JAR file. 4.3.2 Procedures (UNIX) The instructions [...]

Chapter 4 Section 4.4 Creating SAP BAPI OTDs Creating BAPI and RFC OTDs eWay™ Adapter for SAP BAPI User’s Guid e 42 Sun Micros ystems, Inc. To create BAPI OTDs 1 In the Explorer tab of the Enterprise Designer, right click the Project, c lick New , and click Object Type Definition . The New Object Type Definition Wizard dialog box appears. 2 Cli[...]

Chapter 4 Section 4.4 Creating SAP BAPI OTDs Creating BAPI and RFC OTDs eWay™ Adapter for SAP BAPI User’s Guid e 43 Sun Micros ystems, Inc. Figure 10 BAPI Wiza rd—System Parameters 5 Enter the information for the SAP R/3 sy st em for the SAP eWay to connect to : 6 Click Next . The Login Parameters page appears. For this option Enter System ID[...]

Chapter 4 Section 4.4 Creating SAP BAPI OTDs Creating BAPI and RFC OTDs eWay™ Adapter for SAP BAPI User’s Guid e 44 Sun Micros ystems, Inc. Figure 11 BAPI Wizard—Login Parameters 7 Enter the information to log into the SAP system: 8 Click Next . The Select BAPI/RFC page appears, show ing the application components For this option Enter Client[...]

Chapter 4 Section 4.5 Creating SAP BAPI OTDs BAPI and RFC OTDs eWay™ Adapter for SAP BAPI User’s Guid e 45 Sun Micros ystems, Inc. Figure 12 BAPI Wizard—Select BAPI/RFC In the BAPI tree, you can na vigate to a particular SAP application component and select a BAPI object. 9 Expand the SAP application componen t folder, click a BAPI, and click[...]

Chapter 4 Section 4.5 Creating SAP BAPI OTDs BAPI and RFC OTDs eWay™ Adapter for SAP BAPI User’s Guid e 46 Sun Micros ystems, Inc. Figure 13 CostCenter OTD The figure above shows the CostCe nter OTD. The OTD has nodes for each of t he BAPIs in the CostCenter business object. The OTD also has WSDL operations such as GetListExecute and GetListRec[...]

Chapter 4 Section 4.5 Creating SAP BAPI OTDs BAPI and RFC OTDs eWay™ Adapter for SAP BAPI User’s Guid e 47 Sun Micros ystems, Inc. Figure 14 CostCenter OTD — Relaunch[...]

eWay™ Adapter for SAP BAPI User’s Guid e 48 Sun Micros ystems, Inc. Chapter 5 Configuring SAP R/3 For the SAP BAPI eWay to interact successful ly with SAP R/3, you must configure the SAP R/3 application as described in th is chapter. The SAP R/3 screen captures in this chapter corres pond to SAPGUI version 6.2, and SAP R/3 version 4.7. They are[...]

Chapter 5 Section 5.1 Configuring SAP R/3 Creating the RFC Destination for the eWay eWay™ Adapter for SAP BAPI User’s Guid e 49 Sun Micro systems, Inc. Figure 16 RFC Destination Mainte nance Window 3 Click TCP/IP connections and Create to display the RFC Destination entry window.[...]

Chapter 5 Section 5.1 Configuring SAP R/3 Creating the RFC Destination for the eWay eWay™ Adapter for SAP BAPI User’s Guid e 50 Sun Micro systems, Inc. Figure 17 RFC Destination Entry Window 4 Type in the name of the RFC Destination (use a Logical Sy stem name refer to Naming the Logical System on page 54 ) , an accompanying Descr iption , and [...]

Chapter 5 Section 5.1 Configuring SAP R/3 Creating the RFC Destination for the eWay eWay™ Adapter for SAP BAPI User’s Guid e 51 Sun Micro systems, Inc. Figure 18 RFC Destination 5 Click Save to display the RFC Destination window corresponding to your entry. 6 Select the Registered as Server Program option. 7 Enter the Program ID and click Save [...]

Chapter 5 Section 5.1 Configuring SAP R/3 Creating the RFC Destination for the eWay eWay™ Adapter for SAP BAPI User’s Guid e 52 Sun Micro systems, Inc. Figure 19 RFC Destin ation Window 8 Click Test Connection , which tests the connection for logon speed and message transfer speed. When the inbound Project is deployed and running, the results a[...]

Chapter 5 Section 5.2 Configuring SAP R/3 Configuration Need ed in SAP R/3 to Se nd and Receive IDocs eWay™ Adapter for SAP BAPI User’s Guid e 53 Sun Micros ystems, Inc. 5.2 Configuration Needed in SAP R/3 to Send and Receive IDocs For the SAP BAPI eWay to interact successfully with the SAP R/3 syste m, you must configure the SAP R/3 system as [...]

Chapter 5 Section 5.3 Configuring SAP R/3 Configuring the Distribution Model eWay™ Adapter for SAP BAPI User’s Guid e 54 Sun Micros ystems, Inc. Figure 22 Communications Hierarchy The RFC Destination defines the e ntity to which Remote Function Calls (RFCs) can be made; it is the same as the Logical Syst em in the Distrib ution Model. The Commu[...]

Chapter 5 Section 5.3 Configuring SAP R/3 Configuring the Distribution Model eWay™ Adapter for SAP BAPI User’s Guid e 55 Sun Micros ystems, Inc. Figure 23 SAP R/3 System Window 1 In the SAP R/3 System home window, type SA LE into the command field and click Enter to display the Distribution (ALE) Structure window. Figure 24 Distribution (ALE) S[...]

Chapter 5 Section 5.3 Configuring SAP R/3 Configuring the Distribution Model eWay™ Adapter for SAP BAPI User’s Guid e 56 Sun Micros ystems, Inc. Figure 25 New Entries Window 6 Click Save . The Change Request Entry window appears. Figure 26 Change Request Entry Win dow (1) 7 Click the Create request button, to display the Create Request wind ow.[...]

Chapter 5 Section 5.3 Configuring SAP R/3 Configuring the Distribution Model eWay™ Adapter for SAP BAPI User’s Guid e 57 Sun Micros ystems, Inc. 5.3.2 Specifying the Distribution Model Cautionary Notes Two notes of caution are appropriate at this point: 1 We recommend that you should use the Z prefix when defining a name. This prefix is reserve[...]

Chapter 5 Section 5.3 Configuring SAP R/3 Configuring the Distribution Model eWay™ Adapter for SAP BAPI User’s Guid e 58 Sun Micros ystems, Inc. Figure 28 Distribution S tructure Window 1 Click the Activity button next to Maintain Distribution Model and Distribute Views to display the Maintain Distribution Model window. Figure 29 Maintain Distr[...]

Chapter 5 Section 5.3 Configuring SAP R/3 Configuring the Distribution Model eWay™ Adapter for SAP BAPI User’s Guid e 59 Sun Micros ystems, Inc. Figure 30 Create Model View Dialog Box 3 Enter the logical name you want for the ne w Distribution Model View, along with a brief descriptive name or mess age (for your own use). 4 Click Continue ( Ent[...]

Chapter 5 Section 5.4 Configuring SAP R/3 Configuring Communic ations eWay™ Adapter for SAP BAPI User’s Guid e 60 Sun Micros ystems, Inc. 7 Select Continue ( Enter) , which returns you to the previous window. The values you select now appear in the Distribution Model tree, as sh own in Figure 33. Figure 33 Maintain Distribution Model Tree 8 Sav[...]

Chapter 5 Section 5.4 Configuring SAP R/3 Configuring Communic ations eWay™ Adapter for SAP BAPI User’s Guid e 61 Sun Micros ystems, Inc. Figure 34 SAP R/3 System Window 1 In the SAP R/3 System home window, type WE21 into the command field and click Continue (Enter) to display the WF-EDI Port Definition window. Figure 35 WF-EDI Port Definition [...]

Chapter 5 Section 5.4 Configuring SAP R/3 Configuring Communic ations eWay™ Adapter for SAP BAPI User’s Guid e 62 Sun Micros ystems, Inc. Figure 36 Port Details Window 4 Type in a Version (specifies IDoc record type), L ogical destinat ion , and Description , matching the entries made previously. 5 Select Enter , which displays the Chang e Requ[...]

Chapter 5 Section 5.4 Configuring SAP R/3 Configuring Communic ations eWay™ Adapter for SAP BAPI User’s Guid e 63 Sun Micros ystems, Inc. Figure 38 Partner Profile: Initial Screen Window 2 Type the name of the logical sys tem crea ted previously into the Partner number field, select LS for the Partner type, and select Create . This creat es the[...]

Chapter 5 Section 5.4 Configuring SAP R/3 Configuring Communic ations eWay™ Adapter for SAP BAPI User’s Guid e 64 Sun Micros ystems, Inc. Figure 39 Create Partner Profile Window 3 Under the Classi fication tab, selec t ALE for the Partner class and A (Active) for the Partner status, then Save . You now have created the Partner, and need to cont[...]

Chapter 5 Section 5.4 Configuring SAP R/3 Configuring Communic ations eWay™ Adapter for SAP BAPI User’s Guid e 65 Sun Micros ystems, Inc. Figure 40 New Entries: Details of Created Entries Window 3 Select CREMAS as a Message type and CRE1 as a Process code from the drop-down menus, then click Save . The entries now appear in the list in the EDI [...]

Chapter 5 Section 5.4 Configuring SAP R/3 Configuring Communic ations eWay™ Adapter for SAP BAPI User’s Guid e 66 Sun Micros ystems, Inc. Figure 41 EDI Partner Profile: Inbound Parameters Overview Window 4 Follow the same procedure for Outbound parameters , as seen in Figure 42.[...]

Chapter 5 Section 5.5 Configuring SAP R/3 Security Issues eWay™ Adapter for SAP BAPI User’s Guid e 67 Sun Micros ystems, Inc. Figure 42 EDI Partner Profile: Outbound Parameters 5 After making your entries, Save and then Back to ge t to the main SAP R/3 System window. 5.5 Security Issues SAP R/3 uses authorization objects to allow access to vari[...]

Chapter 5 Section 5.5 Configuring SAP R/3 Security Issues eWay™ Adapter for SAP BAPI User’s Guid e 68 Sun Micros ystems, Inc.  RFC1  SCCR  SYST  ZDG1 Permission for Processing BAPI Type Under BAPI/EDI > Distributing master data and BAPI/EDI , sele ct:  Receiving BAPIs via RFC[...]

eWay™ Adapter for SAP BAPI User’s Guid e 69 Sun Micros ystems, Inc. Chapter 6 Reviewing the Sample Projects This chapter provides an in troduction to t he SAP BAPI eWay components, and information on how these components are created and implemented in a Java CAPS Project. It is assumed that the reade r understands th e basics of creating a Proj[...]

Chapter 6 Section 6.2 Reviewing the Sample Projects SAP Vers ion Sup port eWay™ Adapter for SAP BAPI User’s Guid e 70 Sun Micros ystems, Inc. 6.1.1 prjBapiOutbound.zip The prjBapiOutbound.zip file contains the prjBAPIOutbound sample project, which demonstrates how t o access flight ID and type by passing the airline code via an outbound BAPI. I[...]

Chapter 6 Section 6.4 Reviewing the Sample Projects Importing a Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 71 Sun Micros ystems, Inc.  Deploy the Project 3 Check the output. 6.4 Importing a Sample Project Sample eWay Projects ar e included as part of the i nstallation package. To import a sample eWay Project to the Enter prise D[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 72 Sun Micros ystems, Inc.  Create an Environment on page 86  Configure the eWays on page 87  Create the Deployment Profile on page 90  Create and Start the Domain on page 91  Ru[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 73 Sun Micros ystems, Inc. 3 Enter a new name for the OTD. F or this example, use CustBAPI . 4 Click Finish to create the CustBAPI OTD. 5 Open the new CustBAPI OTD and add a new field under the[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 74 Sun Micros ystems, Inc. Create the Collaboration Business Rules The following steps demonstrate how t o create the business rules for the jcdFlightGetList Collaboration. 1 From the Business [...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 75 Sun Micros ystems, Inc. Figure 45 jcdFlightGetList Collaboration 3 From the Business Rule s toolbar, select the Rul e icon. Next, right-click GetList (located under Flight_1) , and choose Se[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 76 Sun Micros ystems, Inc. Figure 46 jcdFlightGetList Collaboration 4 Select a new rule from the Business Rule s toolbar. Next, sele ct String > Concat from the Business Rules Designer toolb[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 77 Sun Micros ystems, Inc. Figure 47 jcdFlightGetList Collaboration 6 Using the same procedures documented in the previous step, make the following field connections to the concat in the Busine[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 78 Sun Micros ystems, Inc. Figure 48 jcdFlightGetList Collaboration 7 Connect the result (String) in the concat to the test1 field, located under jcdFlightGetList > output .[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 79 Sun Micros ystems, Inc. Figure 49 jcdFlightGetList Collaboration 8 The resulting collaboration shou ld display the following code: package prjBAPIOutbound; public class jcdFlightGetList { pu[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 80 Sun Micros ystems, Inc. 6.5.4 Create the Business Process The next step in the s ample is to create the bpBAPIOutbound eInsight Business Process in which the busine ss rules are defined. Ste[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 81 Sun Micros ystems, Inc. Figure 53 b pBAPIOutbound eInsight Business Process — business rule 6 Create a business rule betwe en jcdFlightGetList.flightInput and the end of the Scope. Next, c[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 82 Sun Micros ystems, Inc. Figure 55 bpBAPIOutbound eInsight Business Process 8 Double-click to open the Exception handler box. 9 From the Business Proc ess toolbar, drag a Business Rule activi[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 83 Sun Micros ystems, Inc. Figure 57 bpBAPIOutbound eInsight Business Process 12 Click on the Exception Hand ler box and then from the Business Process toolbar, click the Show Property Sheet ic[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 84 Sun Micros ystems, Inc. 6.5.5 Create a Connectivity Map The Connectivity Map provides a canvas for assembling and configuring a Project’s components. Steps required to create a new Connect[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 85 Sun Micros ystems, Inc. Figure 59 Connectivity Map Components 6.5.6 Bind the eWay Components The final step in cre ating a Connectivi ty Map is binding the eWay components together. Steps re[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 86 Sun Micros ystems, Inc. Figure 60 Connectivity Map - Binding the Components 3 Minimize the Binding dialog boxes by c licking the chev rons in the upper -right corners. 4 Save your current ch[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 87 Sun Micros ystems, Inc. 7 Right-click lhBAPIOutbound and select New Integration Server . A new Integration Server ( IntegrationSvr1 ) is added to the Envi ronment Explorer tree under lhBAPIO[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 88 Sun Micros ystems, Inc. Figure 62 eWays in the cmDelete Connectivity Map Configure the eWay Properties in the Connectivity Map The prjBAPIOutbound sample Project requires outbound eWay prope[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 89 Sun Micros ystems, Inc. 2 Click OK to save your changes and close the wind ow. Note: For additional information on these properties, see Configuring the Outbound eWay Properties on page 27. [...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 90 Sun Micros ystems, Inc. Note: For additional information on these properties, see Outbound SAP BAPI eWay on page 35. 6.5.9 Create the Deployment Profile A Deployment Profile is used to assig[...]

Chapter 6 Section 6.5 Reviewing the Sample Projects Building and De ploying the prjBAPI Outbound Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 91 Sun Micros ystems, Inc. Figure 63 Deployment Profile 6.5.10 Create and Start the Domain To build and deploy your Project, you mu st first create a domain. A domain is an instance of a Logica[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 92 Sun Micros ystems, Inc. 6.5.11 Build and Deploy the Project The Build process compiles and validates the Project’s Java files and cre ates the Project EAR file. Build the Project 1 From th[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 93 Sun Micros ystems, Inc.  Create a Project on page 93  Create the OTDs on page 93  Create the Java Collaboration Definitions on page 95  Create the Business Process on page 100 ?[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 94 Sun Micros ystems, Inc. 4 Specify the SAP R/3 login parameters for your system, and click Next . 5 select IDOC_ INBOUND_ASYNCHRONOU S from the list of RFCs to retrieve, and then click Finish[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 95 Sun Micros ystems, Inc. 6.6.3 Create the Java Collaboration Definitions The next step is to create the Java C oll aboration Defin itions or JCDs using the Collaboration Definition Wizard (Ja[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 96 Sun Micros ystems, Inc. Creating the Collaboration Bu siness Rules The following steps demonst rate how the business rules for the jcdProce ssCREMAS Collaboration. 1 From the Business Rules [...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 97 Sun Micros ystems, Inc. Figure 66 j cdProcessCREMAS Business Rule 4 The resultin g Collaboration displays the follo wing code: package prjIDocInbound; public class jcdProcessCREMAS { public [...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 98 Sun Micros ystems, Inc. 6 Select the output me ssage by selecting prjIDocInbound > IDOC_MATMAS04_4X_46C , then click N ext . 7 Select the OTDs used in this Collaboration by selecting Sun [...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 99 Sun Micros ystems, Inc. Figure 68 jcdProcessMATMAS Business Rule 3 From the Business Rules toolbar, select the Rule icon. Next, right-click FileClient_1 (located under jcdProcessMATMAS ), an[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 100 Sun Micro systems, Inc. public com.stc.codegen.util.TypeCon verter typeConverter; public void inputMATMAS( com.stc.sa pale.iDOC_MATMAS04_4X_46C.IDOC_MATMAS04_4X_46 C input, com.stc.sapale.i[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 101 Sun Micro systems, Inc. Figure 71 bpIDocInbound Business Rule 4 From the Business Process tool bar, drag two Business Rule act ivities to the Business Process canvas . Figure 72 bpIDocInbou[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 102 Sun Micro systems, Inc. Figure 74 bpIDocInbound Business Rule 7 Connect the canvas elements tog ether as seen in Figure 75. Figure 75 bpIDocInbound Business Rule Configuring the bpIDocInbou[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 103 Sun Micro systems, Inc. Figure 76 Decision Gate Properties Wi ndow 4 Next, add a string literal and call it CREMAS . Connect the string lite ral to any 2 field. Figure 77 Decision Gate Prop[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 104 Sun Micro systems, Inc. 5 Drag the MESTYP (under IDOC_CONTROL_REC_40) to any 1 , and drag return boolean to Result . Figure 78 Decision Gate Properties Wi ndow 6 Repeat the same procedure f[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 105 Sun Micro systems, Inc. Figure 79 CREMAS Bus iness Rule 3 Create and open the bus iness rule between the IDOC_CREMAS03_4X_46A.unm arshal an d jcdProcessCREMAS.inputCREMAS activities. 4 Conn[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 106 Sun Micro systems, Inc. Figure 81 MATMAS Business Rule 3 Create and open the bus iness rule between the IDOC_MATMAS04_4X_46C.unmarsha l and jcdProcessMATMAS.inputMATMAS activities. 4 Connec[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 107 Sun Micro systems, Inc. 2 The New Connectivity Map appears and a no de for the Connecti vity Map is added under the Project, on the Project Explorer tree labeled CMap1 . Rename this project[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 108 Sun Micro systems, Inc. 6.6.6 Bind the eWay Components The final step in cre ating a Connectivi ty Map is binding the eWay components together. Steps required to bind eW ay components toget[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 109 Sun Micro systems, Inc. Figure 84 Conn ectivity Map - Binding the JCD Components 3 Minimize the Binding dialog boxes by c licking the chev rons in the upper -right corners. 4 Save your curr[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 110 Sun Micro systems, Inc. 5 Right-click envIDocInbound and select New File External System . Name the External System esFileExt . Click OK . esFileExt is added to the Environment Editor. 6 Ri[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 111 Sun Micro systems, Inc. Figure 86 eWays in the cmDelete Connectivity Map Configure the eWay Properties in the Connectivity Map The prjIDocInbound sample Project includes inboun d and outbou[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 112 Sun Micro systems, Inc. 2 Click OK to save your changes and close the wind ow. Note: For additional information on these properties, see Configuring the Inbound eWay Properties on page 25. [...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 113 Sun Micro systems, Inc. Note: For additional information on these properties, see Inbound SAP BAPI eWay on page 32. 6.6.9 Create the Deployment Profile A Deployment Profile is used to assig[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 114 Sun Micro systems, Inc. 2 Enter a name for the Deployment Profile (for this sample dpSAPBAPI ). Select envIDocInbound as the Environment and click OK . 3 From the Deployment Edi tor toolbar[...]

Chapter 6 Section 6.6 Reviewing the Sample Projects Building and De p loying the prjIDocInbo und Sample Project eWay™ Adapter for SAP BAPI User’s Guid e 115 Sun Micro systems, Inc. 5 Make any necessary changes to the Create Domain dialog box and click Create . The new domain is added to the Domain Mana ger. Select the domain and click the Start[...]

Chapter 6 Section 6.7 Reviewing the Sample Projects Addi tional Sample Project Sce narios eWay™ Adapter for SAP BAPI User’s Guid e 116 Sun Micro systems, Inc. 6.7 Additional Sample Project Scenarios The following section describes an additio nal scenario invol ving Transact ional Remote Function Calls (tRFCs) 6.7.1 About Sending IDocs to SAP R/[...]

Chapter 6 Section 6.7 Reviewing the Sample Projects Addi tional Sample Project Sce narios eWay™ Adapter for SAP BAPI User’s Guid e 117 Sun Micro systems, Inc.  Unmarshal - To unmarshal IDOC data to this OTD  IDOC_INBOUND _ASYNCRONOUSExecute - To send IDOC to SAP  IDOC_INBOUND _ASYNCRONOUSRe ceive - To receive I DOc from SAP The IDOC_IN[...]

Chapter 6 Section 6.7 Reviewing the Sample Projects Addi tional Sample Project Sce narios eWay™ Adapter for SAP BAPI User’s Guid e 118 Sun Micro systems, Inc. Figure 90 File — Unmarshal business rule 2 Click the RFC_IDOC_INBOUND_A SYNCHRONOUS.IDOC_INBOUND_ ASYNCHRONOUSExecute business rule and then click the Property Sheet icon. The property [...]

Chapter 6 Section 6.7 Reviewing the Sample Projects Addi tional Sample Project Sce narios eWay™ Adapter for SAP BAPI User’s Guid e 119 Sun Micro systems, Inc. B Add a business rule between RFC_IDOC_INBOUND_ASYNCHRONOUS. unmarshal and RFC_IDOC_INBOUND_ASYNC HRONOUS.IDOC_INBOUND_ ASYNCHRONOUSExecute. Next, from th e Business Rules Designer toolba[...]

Chapter 6 Section 6.7 Reviewing the Sample Projects Addi tional Sample Project Sce narios eWay™ Adapter for SAP BAPI User’s Guid e 120 Sun Micro systems, Inc. Figure 93 Client Mode Connectivity Map using BAPI eWay[...]

eWay™ Adapter for SAP BAPI User’s Guid e 121 Sun Micro systems, Inc. Appendix A SAP Data Type Conversion Table Use the following SAP data type conversion table to help map th e data type in the ABAP Directory to thei r respective JCo and Jav a data types. Table 15 Data Type Con version Table ABAP type Description JCo type code Java data type b [...]

Index eWay™ Adapter for SAP BAPI User’s Guid e 122 Sun Micro systems, Inc. Index A alert codes 20 Application Server Group 36 Application Server Hostname 33 , 35 , 113 architecture, eWay 7 authorization objects 67 Automap 90 , 114 B binding dialog box 86 , 109 building business logic 39 business logic building 39 C Character Set 34 , 113 Client[...]

Index eWay™ Adapter for SAP BAPI User’s Guid e 123 Sun Micro systems, Inc. outbound eWay properties 25 outbound properties 27 overview sample Projects 69 P partner profile 62 , 64 Password 34 , 35 , 113 port, communications (SAP) 60 profile, partner 62 , 64 Project importing 71 R RFC destination 48 RFC Trace Level 26 , 28 , 88 , 111 Router Stri[...]