Summary of the content on the page No. 1
SUN SEEBEYOND
eWAY™ ADAPTER FOR SAP BAPI
USER’S GUIDE
Release 5.1.3
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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.
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
Summary of the content on the page No. 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
