Resumen del contenido incluido en la página 1 
                    
                        SUN SEEBEYOND
eWAY™ ADAPTER FOR SAP BAPI 
USER’S GUIDE
Release 5.1.3                                                                                                                                                                                                                                                                                                                                                                                                                                                
                    
                    Resumen del contenido incluido en la página 2 
                    
                        Copyright © 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. Sun  Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this  document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents  listed at http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and 
                    
                    Resumen del contenido incluido en la página 3 
                    
                        Contents  Contents Chapter 1 Introducing the SAP BAPI eWay 7 About SAP 7 About the SAP BAPI eWay 7 Invoking BAPI/RFC Methods 8 The SAP BAPI eWay 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 What’s In This Document 12 Scope 13 Intended Audience 13 Text Conventions 13 Related Documents 14 Sun Microsystems, Inc. Web Site 14 Documentation Feedback 14 Chapter 2 Installing the eWay 15 Installing the SAP BAPI eWay 15 Ins
                    
                    Resumen del contenido incluido en la página 4 
                    
                        Contents  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 Inbound eWay Properties 25 Server Connection Settings 25 Configuring the Outbound eWay Properties 27 Client Connection Settings 27 Configuring the eWay Environment Properties 30 eWay External Properties 31 Inbound SAP BAPI eWay 32 Server Connection Settings 32 MDB Settings 34 Outbound SAP BAPI e
                    
                    Resumen del contenido incluido en la página 5 
                    
                        Contents  Creating a Partner Profile 62 Configuring a Partner Profile 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 Importing a Sample Project 71 Building and Deploying the prjBAPIOutbound Sample Project 71 Create a Project 72 Create the OTDs 72 Create the Java Collaboration Definitions 73 Create the Collaboration Business Rules 74 Create
                    
                    Resumen del contenido incluido en la página 6 
                    
                        Contents  Create and Start the Domain 114 Build and Deploy the Project 115 Run the Sample 115 Additional Sample Project Scenarios 116 About Sending IDocs to SAP R/3 Using tRFCs 116 The RFC OTD used to send/receive IDOCs 116 Client Mode - sending IDOCs to SAP R/3 via IDOC_INBOUND_ASYNCRONOUS 117 Appendix A SAP Data Type Conversion Table 121 Index 122 eWay™ Adapter for SAP BAPI User’s Guide 6 Sun Microsystems, Inc.                                                                                    
                    
                    Resumen del contenido incluido en la página 7 
                    
                        Chapter 1 Introducing the SAP BAPI eWay The Sun SeeBeyond eWay™ Adapter for SAP BAPI, also noted throughout this book as  the SAP BAPI eWay, provides Sun Java Composite Application Platform Suite (Java  CAPS) Projects with the ability to exchange data with SAP R/3 software. This chapter  provides an overview of the SAP BAPI eWay. What’s In This Chapter  About SAP on page 7  About the SAP BAPI eWay on page 7  What’s New in This Release on page 11  What’s In This Document on page 12  Sun Microsyst
                    
                    Resumen del contenido incluido en la página 8 
                    
                        F R C Chapter 1 Section 1.2 Introducing the SAP BAPI eWay About the SAP BAPI eWay Figure 1   BAPI eWay eGate Integrator SAP R/3 BAPI eWay Business Object  RFC Repository Function A OTD SAP JCo Cost BAPI A A Center B BAPI  BAPI B Repository 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 the correct type and format, calling the Remote Function  Module (RFM) that repr
                    
                    Resumen del contenido incluido en la página 9 
                    
                        Chapter 1 Section 1.2 Introducing the SAP BAPI eWay About the SAP BAPI eWay 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 to invoke or receive the BAPI/RFC call. 1.2.2 The SAP BAPI eWay Data Flows When the SAP BAPI eWay communicates with the SAP R/3 software, it uses the RFC  protocol. The list below shows the RFC types of communication used:  Outbound (Ja
                    
                    Resumen del contenido incluido en la página 10 
                    
                        Chapter 1 Section 1.2 Introducing the SAP BAPI eWay About the SAP BAPI eWay Inbound Data Flow via RFC The sequence diagram uses a sample CostCenter OTD to describe the RFC inbound  sequence. Figure 4   Inbound Data Flow via RFC Business Process BAPI BAPI eWay SAP R/3  CostCenter (JCo server) System OTD Call RFM Time GetListReceive Populate OTD GetListReply Call RFM Return exception The figure above shows the following steps for the inbound data flow via RFC:  1 The Business Process is activated 
                    
                    Resumen del contenido incluido en la página 11 
                    
                        Chapter 1 Section 1.3 Introducing the SAP BAPI eWay What’s New in This Release Figure 5   Inbound Data Flow via tRFC Business BAPI BAPI SAP R/3  Process CostCenter eWay System OTD (JCo server) Call RFM GetListReceive Populate OTD Time GetListReply Call RFM Return onCommitTID() Commit Sequence onCommitTID() Return OR onRollbackTID() Rollback exception Sequence onRollbackTID() Return The figure above shows the following steps for the inbound data flow via tRFC:  1 The Business Process is activated
                    
                    Resumen del contenido incluido en la página 12 
                    
                        Chapter 1 Section 1.4 Introducing the SAP BAPI eWay What’s In This Document 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 deployment of EAR files to WebLogic Application Server  (version 9.1). What’s New in Version 5.1  Version Control: An enhanced version control system allows you to effectively  manage changes to the eWay components.  Manual Connection Management: Establishing a connection can now be performed  manually (usi
                    
                    Resumen del contenido incluido en la página 13 
                    
                        Chapter 1 Section 1.4 Introducing the SAP BAPI eWay What’s In This Document  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”: Describes the system requirements and provides  instructions for installing the SAP BAPI eWay.  Chapter 3 “Setting SAP BAPI eWay Properties”: Describes how to configure the  SAP BAPI eWay properties to enable data exchange between the SAP R/3
                    
                    Resumen del contenido incluido en la página 14 
                    
                        Chapter 1 Section 1.5 Introducing the SAP BAPI eWay Sun Microsystems, Inc. Web Site Table 1   Text Conventions (Continued) Text Convention Used For Examples Monospaced Command line arguments, code  java -jar filename.jar samples; variables are shown in  bold italic Hypertext links within  Blue bold See Text Conventions on page 13 document Hypertext links for Web  Blue underlined http://www.sun.com addresses (URLs) or email  addresses 1.4.4 Related Documents The following Sun documents provide ad
                    
                    Resumen del contenido incluido en la página 15 
                    
                        Chapter 2 Installing the eWay This chapter describes the requirements and procedures for installing the SAP BAPI  eWay. Procedures for implementing sample projects, are described in Reviewing the  Sample Projects on page 69. What’s In This Chapter  “Installing the SAP BAPI eWay” on page 15  “ICAN 5.0 Project Migration Procedures” on page 17  “Installing Enterprise Manager eWay Plug-Ins” on page 19  “Deploying an EAR File” on page 22 2.1 Installing the SAP BAPI eWay The Java CAPS Installer, a web
                    
                    Resumen del contenido incluido en la página 16 
                    
                        Chapter 2 Section 2.1 Installing the eWay Installing the SAP BAPI eWay 2 Select the following products from the 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)  SAPBAPIeWay Select the following in the Documentation category to upload the User’s Guide,  Help file, Javadoc, Readme, and sample Projects for the Sun SeeBeyond eWay  Adapter for SAP BAPI:  SAPBAPIeWayDocs 3 Once you have selected all of
                    
                    Resumen del contenido incluido en la página 17 
                    
                        Chapter 2 Section 2.2 Installing the eWay ICAN 5.0 Project Migration Procedures After Installation You must incorporate the installed eWay components into a Project before using the  intended functions. See the Sun SeeBeyond eGate™ Integrator User’s Guide for more  information on incorporating the eWay into an eGate Project. 2.1.3 Extracting the Sample Projects and Javadocs The SAP (BAPI) eWay includes sample Projects and Javadocs. The sample Projects are  designed to provide you with a basic un
                    
                    Resumen del contenido incluido en la página 18 
                    
                        Chapter 2 Section 2.2 Installing the eWay ICAN 5.0 Project Migration Procedures 2 From the Project Explorer, right-click your Project and select Export from the  shortcut menu. The Export Manager appears. 3 Select the Project that you want to export in the left pane of the Export Manager and  move it to the Selected Projects field by clicking the Add to Select Items (arrow)  button, or click All to include all of your Projects. 4 In the same manner, select the Environment that you want to export
                    
                    Resumen del contenido incluido en la página 19 
                    
                        Chapter 2 Section 2.3 Installing the eWay Installing Enterprise Manager eWay Plug-Ins C Select the Environment Explorer tab, and from the Environment Explorer, right- click the Project’s Environment and select Version Control > Check Out from  the shortcut menu. D Select Recurse Environment to specify all components, and click OK. 2 If your imported Project includes File eWays, these must be reconfigured in your  Environment prior to deploying the Project. To reconfigure your File eWays, do the 
                    
                    Resumen del contenido incluido en la página 20 
                    
                        Chapter 2 Section 2.3 Installing the eWay Installing Enterprise Manager eWay Plug-Ins 3 Select the application plug-ins you require, and click Install. The application plug- ins are installed and deployed. Alternately, you can install eWay plug-ins using the following steps: 1 From the Suite Installer’s Download tab, select the Plug-Ins you require and save  them to a temporary directory.  2 From the Enterprise Manager’s Explorer toolbar, click the Configuration icon. 3 Click the Web Application