Sun Microsystems eWay SAP BAPI User Manual
  1. Manuals
  2. Brands
  3. Sun Microsystems Manuals
  4. Adapter
  5. eWay SAP BAPI
  6. User manual
Sun Microsystems eWay SAP BAPI User Manual

Sun Microsystems eWay SAP BAPI User Manual

Adapter for sap bapi
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
SUN SEEBEYOND
eWAY™ ADAPTER FOR SAP BAPI
USER'S GUIDE
Release 5.1.3

Advertisement

Table of Contents
loading

Related Manuals for Sun Microsystems eWay SAP BAPI

Summary of Contents for Sun Microsystems eWay SAP BAPI

  • Page 1 SUN SEEBEYOND eWAY™ ADAPTER FOR SAP BAPI USER’S GUIDE Release 5.1.3...
  • Page 2 Java, Sun Java Composite Application Platform Suite, Sun, SeeBeyond, eGate, eInsight, eVision, eTL, eXchange, eView, eIndex, eBAM et eWay sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays. Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc.

  • Page 3: Table Of Contents

    What’s New in This Release What’s In This Document Scope Intended Audience Text Conventions Related Documents Sun Microsystems, Inc. Web Site Documentation Feedback Chapter 2 Installing the eWay Installing the SAP BAPI eWay Installing the SAP BAPI eWay on an eGate supported system...
  • Page 4 Creating the RFC Destination for the eWay Configuration Needed in SAP R/3 to Send and Receive IDocs Configuring the Distribution Model Naming the Logical System Specifying the Distribution Model Configuring Communications Defining the Communications Port eWay™ Adapter for SAP BAPI User’s Guide Sun Microsystems, Inc.
  • Page 5 Configure the eWays Configure the eWay Properties in the Connectivity Map Configure the File eWay External Environment Properties Configure the SAP BAPI eWay External Environment Properties Create the Deployment Profile eWay™ Adapter for SAP BAPI User’s Guide Sun Microsystems, Inc.
  • Page 6 About Sending IDocs to SAP R/3 Using tRFCs The RFC OTD used to send/receive IDOCs Client Mode - sending IDOCs to SAP R/3 via IDOC_INBOUND_ASYNCRONOUS Appendix A SAP Data Type Conversion Table Index eWay™ Adapter for SAP BAPI User’s Guide Sun Microsystems, Inc.

  • Page 7: Introducing The Sap Bapi Eway

    7 About the SAP BAPI eWay What’s New in This Release What’s In This Document Sun Microsystems, Inc. Web Site Documentation Feedback About SAP SAP creates software for the Enterprise Resource Planning (ERP) business sector. The company main product is SAP R/3 which uses a three-tier application architecture—...

  • Page 8: Invoking Bapi/Rfc Methods

    BAPI eWay SAP JCo BAPI Repository Figure 2 Meta Data Extraction IMPORT parameters EXPORT parameters TABLE parameters CHANGING parameters BAPI SAP R/3 IMPORT parameters EXPORT parameters TABLE parameters CHANGING parameters Section 1.2 About the SAP BAPI eWay Function Sun Microsystems, Inc.

  • Page 9: The Sap Bapi Eway Data Flows

    Adapter for SAP BAPI User’s Guide BAPI BAPI eWay execute() execute() “Creating the RFC Destination for the eWay” on page Section 1.2 About the SAP BAPI eWay SAP R/3 System Call RFM Call RFM Return Sun Microsystems, Inc.
  • Page 10 Adapter for SAP BAPI User’s Guide BAPI BAPI eWay CostCenter (JCo server) GetListReceive Populate OTD GetListReply exception Section 1.2 About the SAP BAPI eWay SAP R/3 System Call RFM Call RFM Return Sun Microsystems, Inc.

  • Page 11: What's New In This Release

    Adapter for SAP BAPI User’s Guide BAPI BAPI CostCenter eWay (JCo server) Call RFM GetListReceive GetListReply Call RFM Return onCommitTID() onCommitTID() Return onRollbackTID() exception onRollbackTID() Return Section 1.3 What’s New in This Release SAP R/3 System Commit Sequence Rollback Sequence Sun Microsystems, Inc.

  • Page 12: What's In This Document

    Date fields are now represented as Java data type strings in the JCD. What’s In This Document This document includes the following chapters: eWay™ Adapter for SAP BAPI User’s Guide Section 1.4 What’s In This Document Sun Microsystems, Inc.

  • Page 13: Scope

    Adapter for SAP BAPI User’s Guide Table 1 Text Conventions Used For Click OK. On the File menu, click Exit. Select the eGate.sar file. Section 1.4 What’s In This Document Examples Sun Microsystems, Inc.

  • Page 14: Related Documents

    Sun SeeBeyond eGate™ Integrator User’s Guide Composite Application Platform Suite Installation Guide Sun Microsystems, Inc. Web Site The Sun Microsystems web site is your best source for up-to-the-minute product news and technical support information. The site’s URL is: http://www.sun.com Documentation Feedback We appreciate your feedback.

  • Page 15: Installing The Eway

    After you have installed eGate or eInsight, do the following: From the Suite Installer, click the Administration tab, and then click the link to install additional products. eWay™ Adapter for SAP BAPI User’s Guide Chapter 2 Reviewing the Sun Microsystems, Inc.

  • Page 16: Adding The Eway To An Existing Sun Java Composite Application Platform Suite Installation

    When prompted, restart the IDE (Integrated Development Environment) to complete the installation. eWay™ Adapter for SAP BAPI User’s Guide Installing the SAP BAPI eWay on an eGate on page 15. Section 2.1 Installing the SAP BAPI eWay Sun Microsystems, Inc.

  • Page 17: After Installation

    Steps to extract the Javadoc include: Click the Documentation tab of the Suite Installer, then click the Add-ons tab. Click the Sun SeeBeyond eWay SAP BAPI Adapter link. Documentation for the SAP BAPI eWay appears in the right pane. Click the icon next to Javadoc and extract the ZIP file. Note that two separate Javadocs are contained within, including: Flight.zip...
  • Page 18 Check Out from the shortcut menu. The Version Control - Check Out dialog box appears. Select Recurse Project to specify all components, and click OK. eWay™ Adapter for SAP BAPI User’s Guide ICAN 5.0 Project Migration Procedures Section 2.2 Sun Microsystems, Inc.

  • Page 19: Installing Enterprise Manager Eway Plug-Ins

    From the Enterprise Manager’s Explorer toolbar, click the Configuration icon. Click the Web Applications Manager tab, go to the Auto-Install from Repository sub-tab, and connect to your Repository. eWay™ Adapter for SAP BAPI User’s Guide Installing Enterprise Manager eWay Plug-Ins Section 2.3 Sun Microsystems, Inc.

  • Page 20: Viewing Alert Codes

    SAP as a client. Make sure that the eWay is able to reach the SAP system. Also check your SAP BAPI External System values for the Outbound SAP BAPI eWay. In addition, check the SAP trace logs. None Sun Microsystems, Inc.
  • Page 21 BAPI External System values for the Inbound SAP BAPI eWay. In addition, check the SAP trace logs. None Check your domain server.log and the SAP trace logs for further information. Check your domain server.log for further information. Sun Microsystems, Inc.

  • Page 22: Deploying An Ear File

    Build the EAR file, which is generated in the Enterprise Designer. Use your WebLogic Admin console to deploy the EAR file. Refer to your application server’s documentation for requirements regarding working directories. eWay™ Adapter for SAP BAPI User’s Guide Section 2.4 Deploying an EAR File Sun Microsystems, Inc.

  • Page 23: Setting Sap Bapi Eway Properties

    Adapter for SAP BAPI User’s Guide on page 23 on page 23 on page 25 on page 30 on page 31 on page 84. For information on creating the Create an Environment Chapter 3 on page 86. Sun Microsystems, Inc.
  • Page 24 The properties default to the correct eWay direction. In this case, it opens properties for the outbound eWay. eWay™ Adapter for SAP BAPI User’s Guide Configuring the eWay Connectivity Map Properties SAP BAPI eWay Section 3.2 Sun Microsystems, Inc.

  • Page 25: Eway Connectivity Map Properties

    R/3 into Java CAPS. The following server connection settings are configured in the Inbound eWay Properties window. Server Connection Settings The following Server Connection Settings are used by the external database: eWay™ Adapter for SAP BAPI User’s Guide eWay Connectivity Map Properties Section 3.3 Sun Microsystems, Inc.
  • Page 26 RFC trace level. Integer value from 1 to 10. The default number is 1. A transaction mode of Non- Transactional or Transactional RFC(tRFC) The default mode is Non- Transactional. Section 3.3 eWay Connectivity Map Properties Required Value Sun Microsystems, Inc.

  • Page 27: Configuring The Outbound Eway Properties

    Adapter for SAP BAPI User’s Guide Description A valid path to the database file. For example, the default location is: C:\JavaCAPS51\data\SapTRFC.TIDdb Description Section 3.3 eWay Connectivity Map Properties Required Value Required Value Automatic or Manual. The default mode is Automatic. Sun Microsystems, Inc.
  • Page 28 Integer value from 0 to 5. The default number is 0. The Enable RFC Trace level only affects the JCo trace level. It has no effect on the RFC trace level. Section 3.3 eWay Connectivity Map Properties Required Value Sun Microsystems, Inc.
  • Page 29 Transactional or Transactional RFC(tRFC), via VIA COMMIT/ ROLLBACK BAPI. The default mode is NON- TRANSACTIONAL. A valid path to the database file. For example, the default location could be: C:\JavaCAPS\data\SapTRFC.TI Section 3.3 eWay Connectivity Map Properties Required Value Sun Microsystems, Inc.

  • Page 30: Configuring The Eway Environment Properties

    The default is 200 rows. Yes or No. The default mode is No; the ABAP Debug window is disabled. Yes or No. The default mode is No; load balancing is disabled by default. Section 3.4 Required Value Sun Microsystems, Inc.

  • Page 31: Eway External Properties

    External Properties The eWay External System consists of the following properties categories. Inbound SAP BAPI eWay Outbound SAP BAPI eWay eWay™ Adapter for SAP BAPI User’s Guide on page 32 on page 35 Section 3.5 eWay External Properties Sun Microsystems, Inc.

  • Page 32: Inbound Sap Bapi Eway

    Specifies the gateway hostname of the SAP R/3 application server. eWay™ Adapter for SAP BAPI User’s Guide Description An alphanumeric string. Do not omit leading zeros. There is no default setting. Section 3.5 eWay External Properties Required Value Sun Microsystems, Inc.
  • Page 33 Program ID is shown in the SAPGUI transaction SM59. This entry must match the SAPGUI exactly; this entry is case sensitive. There is no default setting. Any valid Hostname. There is no default setting. Section 3.5 eWay External Properties Required Value Sun Microsystems, Inc.

  • Page 34: Mdb Settings

    The default is EN, English. Any valid SAP System ID. There is no default setting. Unicode or Non-unicode. The default value is Non- unicode. Description Any numeric value. The default is 1000. Section 3.5 eWay External Properties Required Value Required Value Sun Microsystems, Inc.

  • Page 35: Outbound Sap Bapi Eway

    An alphanumeric string. There is no default setting. There are no required values. EN – English DE – German JA – Japanese KO – Korean The default is EN, English. Section 3.5 eWay External Properties Required Value Sun Microsystems, Inc.
  • Page 36 00, the gateway service is sapgw00. There is no default setting. There is no default value. There are no required values. There is no default setting. Section 3.5 eWay External Properties Required Value Sun Microsystems, Inc.

  • Page 37: Connection Retry Settings

    The following Connection Pool Settings are used by the external database: eWay™ Adapter for SAP BAPI User’s Guide Description A valid router string. There is no default setting. Description Section 3.5 eWay External Properties Required Value Required Value The default is 0. The default is 1000. Sun Microsystems, Inc.
  • Page 38 Adapter for SAP BAPI User’s Guide Description The default number of connections is 2. The default number of connections is 10. The default is 300. Section 3.5 eWay External Properties Required Value Sun Microsystems, Inc.

  • Page 39: Creating Sap Bapi Otds

    SAP R/3 to be correctly converted to a byte array of the desired encoding. eWay™ Adapter for SAP BAPI User’s Guide on page 39 on page 40 on page 40 on page 41 on page 45 Chapter 4 Sun Microsystems, Inc.

  • Page 40: Date And Time Stamp Requirements

    The sapjco.jar file is also required during runtime. For this, add the JAR file to <JavaCAPS51>\logicalhost\is\lib. Download the following DLL files. These are available, free of charge, from various sources on the Internet: msvcp71.dll msvcr71.dll eWay™ Adapter for SAP BAPI User’s Guide Date and Time Stamp Requirements Section 4.2 Sun Microsystems, Inc.

  • Page 41: Procedures (Unix)

    WebLogic Application Server, version 9.1. Creating BAPI and RFC OTDs You create BAPI and RFC OTDs with the SAP BAPI wizard in the Enterprise Designer. eWay™ Adapter for SAP BAPI User’s Guide Creating BAPI and RFC OTDs Section 4.4 Sun Microsystems, Inc.
  • Page 42 To convert a BAPI object to OTD, select the BAPI option. To convert an RFC object to OTD, select the RFC option. Click Next. The System Parameters page appears. eWay™ Adapter for SAP BAPI User’s Guide Creating BAPI and RFC OTDs Section 4.4 Sun Microsystems, Inc.
  • Page 43 Host and the SAP gateway host (optional). Language used for SAP R/3 access. NO to disable RFC tracing (default); YES to enable RFC tracing, which creates the trace files in: \edesigner\bin Section 4.4 Creating BAPI and RFC OTDs Sun Microsystems, Inc.
  • Page 44 Click Next. The Select BAPI/RFC page appears, showing the application components eWay™ Adapter for SAP BAPI User’s Guide Enter Client number of the SAP R/3 system. User name. Login password. Section 4.4 Creating BAPI and RFC OTDs Sun Microsystems, Inc.

  • Page 45: Bapi And Rfc Otds

    This creates an OTD which has methods corresponding to all BAPIs in the Cost Center Business Object of SAP R/3. eWay™ Adapter for SAP BAPI User’s Guide on page 71 and on page 92. The section below Controlling CostCenter. Section 4.5 BAPI and RFC OTDs Building Building and Sun Microsystems, Inc.
  • Page 46 If your Java Collaborations or Business Processes are using OTD nodes that are now absent in the relaunched BAPI/RFC OTD, you will be prompted to correct the business rules by validation errors. eWay™ Adapter for SAP BAPI User’s Guide Figure 13 CostCenter OTD Section 4.5 BAPI and RFC OTDs Sun Microsystems, Inc.
  • Page 47 Chapter 4 Section 4.5 Creating SAP BAPI OTDs BAPI and RFC OTDs Figure 14 CostCenter OTD — Relaunch eWay™ Adapter for SAP BAPI User’s Guide Sun Microsystems, Inc.

  • Page 48: Configuring Sap R/3

    In the SAP R/3 window, click the forward arrow to display the navigation box if necessary. Type SM59 into the text field and press ENTER. Figure 15 Navigating to the SM59 Transaction This displays the RFC Destination Maintenance window. eWay™ Adapter for SAP BAPI User’s Guide on page 48 Chapter 5 Sun Microsystems, Inc.
  • Page 49 Configuring SAP R/3 Figure 16 RFC Destination Maintenance Window Click TCP/IP connections and Create to display the RFC Destination entry window. eWay™ Adapter for SAP BAPI User’s Guide Creating the RFC Destination for the eWay Section 5.1 Sun Microsystems, Inc.
  • Page 50 Type in the name of the RFC Destination (use a Logical System name refer to Naming the Logical System <T> for the Connection Type (TCP/IP). eWay™ Adapter for SAP BAPI User’s Guide Creating the RFC Destination for the eWay on page 54), an accompanying Description, and enter Section 5.1 Sun Microsystems, Inc.
  • Page 51 This program ID must be exactly the same as that specified in the eWay Program ID property. This value is case sensitive. For information, refer to page eWay™ Adapter for SAP BAPI User’s Guide Figure 18 RFC Destination Section 5.1 Creating the RFC Destination for the eWay “Program ID” on Sun Microsystems, Inc.
  • Page 52 When the inbound Project is deployed and running, the results are displayed in a table; otherwise, return code 3 is displayed. eWay™ Adapter for SAP BAPI User’s Guide Figure 20 Connection Test Results Section 5.1 Creating the RFC Destination for the eWay Sun Microsystems, Inc.

  • Page 53: Configuration Needed In Sap R/3 To Send And Receive Idocs

    SAP R/3). The hierarchy of this Communication system is shown in Figure 22. The individual steps involved in the configuration are: eWay™ Adapter for SAP BAPI User’s Guide Configuration Needed in SAP R/3 to Send and Receive IDocs Client Logical System Name (eWay) Section 5.2 IDoc Name Sun Microsystems, Inc.

  • Page 54: Configuring The Distribution Model

    Naming the Logical System Specifying the Distribution Model Naming the Logical System 5.3.1 Transaction: SALE eWay™ Adapter for SAP BAPI User’s Guide Configuring the Distribution Model Communications Port Partner Profile on page 54 on page 57 Section 5.3 Sun Microsystems, Inc.
  • Page 55 Click the New entries button to display the New Entries window. Enter the logical name for your SAP eWay using capital letters and a brief descriptive name. eWay™ Adapter for SAP BAPI User’s Guide Figure 23 SAP R/3 System Window Section 5.3 Configuring the Distribution Model Sun Microsystems, Inc.
  • Page 56 Logical Systems Overview window, and the new Logical System appears in the list. Click Save and select the Back button repeatedly until the SAP R/3 System window appears. eWay™ Adapter for SAP BAPI User’s Guide Figure 25 New Entries Window Section 5.3 Configuring the Distribution Model Sun Microsystems, Inc.

  • Page 57: Specifying The Distribution Model

    In the SAP R/3 System home window, type SALE into the command field and click Enter to display the Distribution (ALE) Structure window. eWay™ Adapter for SAP BAPI User’s Guide Figure 27 SAP R/3 System Window Section 5.3 Configuring the Distribution Model Sun Microsystems, Inc.
  • Page 58 Figure 29 Maintain Distribution Model Window Select the Menu path Edit > Model View > Create to display the Create Model View dialog box. eWay™ Adapter for SAP BAPI User’s Guide Configuring the Distribution Model Section 5.3 Sun Microsystems, Inc.
  • Page 59 Type the desired values for the four parameters into the text boxes, or select them from the drop-down menus. For example, CREMAS is the message type used for Creditor Master Data. eWay™ Adapter for SAP BAPI User’s Guide Configuring the Distribution Model Section 5.3 Sun Microsystems, Inc.

  • Page 60: Configuring Communications

    62). In this step you specify the outbound file name, directory path, and any associated function modules. eWay™ Adapter for SAP BAPI User’s Guide on page 60 on page 62 on page 64 Section 5.4 Configuring Communications Creating Sun Microsystems, Inc.
  • Page 61 Select the desired Port from the list, or select Change to display the Port Definition for Asynchronous RFC Overview window. eWay™ Adapter for SAP BAPI User’s Guide Figure 34 SAP R/3 System Window Section 5.4 Configuring Communications Sun Microsystems, Inc.

  • Page 62: Creating A Partner Profile

    In the SAP R/3 System home window, type WE20 into the command field and then click Continue (Enter) to display the Partner Profile: Initial Screen window. eWay™ Adapter for SAP BAPI User’s Guide Figure 36 Port Details Window Figure 37 SAP R/3 System Window Section 5.4 Configuring Communications Sun Microsystems, Inc.
  • Page 63 Type the name of the logical system created previously into the Partner number field, select LS for the Partner type, and select Create. This creates the Partner, and displays the Create Partner Profile <Partner Number> window. eWay™ Adapter for SAP BAPI User’s Guide Configuring Communications Section 5.4 Sun Microsystems, Inc.

  • Page 64: Configuring A Partner Profile

    In this section, you configure the Inbound or Outbound Parameters in the Partner Profile. In the Partner Profile: Initial Screen window, select the desired Partner Number, for example ZSRINI. Select the Inbound parameters. eWay™ Adapter for SAP BAPI User’s Guide Configuring Communications Section 5.4 Sun Microsystems, Inc.
  • Page 65 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 Partner Profile: Inbound Parameters Overview window. eWay™ Adapter for SAP BAPI User’s Guide Configuring Communications Section 5.4 Sun Microsystems, Inc.
  • Page 66 Chapter 5 Section 5.4 Configuring SAP R/3 Configuring Communications Figure 41 EDI Partner Profile: Inbound Parameters Overview Window Follow the same procedure for Outbound parameters, as seen in Figure 42. eWay™ Adapter for SAP BAPI User’s Guide Sun Microsystems, Inc.

  • Page 67: Security Issues

    These settings are located under Cross-Application Authorization Objects. Refer to the SAP R/3 documentation for additional information. Function Group Access Under Auth. check for RFC access, select: ARFC EDIN ERFC eWay™ Adapter for SAP BAPI User’s Guide Section 5.5 Security Issues Sun Microsystems, Inc.
  • Page 68 Chapter 5 Configuring SAP R/3 RFC1 SCCR SYST ZDG1 Permission for Processing BAPI Type Under BAPI/EDI > Distributing master data and BAPI/EDI, select: Receiving BAPIs via RFC eWay™ Adapter for SAP BAPI User’s Guide Section 5.5 Security Issues Sun Microsystems, Inc.

  • Page 69: Reviewing The Sample Projects

    You must install these components into Java CAPS prior to running the samples. eWay™ Adapter for SAP BAPI User’s Guide on page 69 on page 70 on page 71 Chapter 6 on page 71 on page 92 Sun Microsystems, Inc.

  • Page 70: Prjbapioutbound.zip

    You must do the following before you can run an imported sample Project: Create an Environment Configure the eWays Create a Deployment Profile Create and start a domain eWay™ Adapter for SAP BAPI User’s Guide Section 6.2 SAP Version Support Sun Microsystems, Inc.

  • Page 71: Importing A Sample Project

    Create the Business Process Create a Connectivity Map Bind the eWay Components eWay™ Adapter for SAP BAPI User’s Guide on page 72 on page 73 on page 80 on page 84 on page 85 Section 6.4 Importing a Sample Project Sun Microsystems, Inc.

  • Page 72: Create A Project

    Select User Defined OTD from the list of OTD Wizards and click Next. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project on page 86 on page 87 on page 90 on page 91 on page 92 Creating SAP BAPI OTDs Section 6.5 Sun Microsystems, Inc.

  • Page 73: Create The Java Collaboration Definitions

    Select prjBAPIOutbound > Flight, then click Add. The Flight OTD appears in a list of selected OTDs. Click Finish, the jcdFlightGetList Collaboration is created. Figure 43 jcdFlightGetList Collaboration eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.

  • Page 74: Create The Collaboration Business Rules

    Give the number a value of 3 and connect this to MAX_ROWS under jcdFlightGetList > Flight_1 > GetList > ImportParams. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.
  • Page 75 Select the execute() method from the list of available methods. The execute() method now appears in the Business Rules Designer window. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.
  • Page 76 = in the String box and connect this to the String of the Concat. Next, drag TYPE, located under jcdFlightGetList > GetList > Return to str (String) in the concat. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.
  • Page 77 Number to str (Sting) with Literal String “NUM =” Message to str (Sting) with Literal String “MESSAGE =” The result should appear as seen in Figure 48. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.
  • Page 78 Reviewing the Sample Projects Figure 48 jcdFlightGetList Collaboration Connect the result (String) in the concat to the test1 field, located under jcdFlightGetList > output. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.
  • Page 79 ).getTYPE() + " ID = " + Flight_1.getGetList().getRETURN( i1 ).getID() + " NUM = " + Flight_1.getGetList().getRETURN( i1 ).getNUMBER() + " MESSAGE = " + Flight_1.getGetList().getRETURN( i1 ).getMESSAGE() ) ); eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.

  • Page 80: Create The Business Process

    Create a business rule between the start of the Scope and jcdFlightGetList.flightInput. Next, connect the text field under FileClient.receive.Output to the Test1 field located under jcdFlightGetList.flightInput.Input > CustBapi. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.
  • Page 81 Intermediate Events drop-down list) to the Fault Handler canvas icon (the icon on the bottom of the Scope). An un-configured Exception Handler appears on the canvas. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.
  • Page 82 Figure 56 bpBAPIOutbound eInsight Business Process — business rule Connect the activities in the Exception Handler together, as seen in Figure 57. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.
  • Page 83 Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.

  • Page 84: Create A Connectivity Map

    File2 to eaFileOut Queue1 to QueueError SAP BAPI1 to eaSAPBAPI The Connectivity Map components should appear as they do in Figure 59. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.

  • Page 85: Bind The Eway Components

    FileReceiver under Invoked Services of cmBAPIOutbound_bpBAPIOutbound to eaFileOut. Flight_1 under Invoked Services of cmBAPIOutbound_jcdFlightGetList to eaSAPBAPI. The connected components are seen in Figure 60. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.

  • Page 86: Create An Environment

    Right-click envBAPIOutbound and select New Logical Host. The LogicalHost1 box is added to the Environment Editor tree. Rename the Logical Host lhBAPIOutbound. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.

  • Page 87: Configure The Eways

    External Applications and the Business Process, as seen in Figure 62. You must configure eWay properties in both the Connectivity Map and the Environment Explorer. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Section 6.5 Sun Microsystems, Inc.

  • Page 88: Configure The Eway Properties In The Connectivity Map

    Client Connection Mode Enable RFC Trace RFC Trace Level Transaction Mode eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Outbound File eWay Outbound SAP BAPI eWay Required Value Automatic. NON-TRANSACTIONAL. Section 6.5 Sun Microsystems, Inc.

  • Page 89: Configure The File Eway External Environment Properties

    Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Required Value C:\JavaCAPS\data\SapTRFC.TIDdb Configuring the Outbound on page 27. Required Value Any valid Hostname. There is no default setting. Any numeric value. There is no default setting. Section 6.5 Sun Microsystems, Inc.

  • Page 90: Create The Deployment Profile

    There is no default setting. There are no required values. EN – English DE – German JA – Japanese KO – Korean The default is EN, English. Any valid Hostname. There is no default setting. Outbound SAP BAPI eWay Section 6.5 Sun Microsystems, Inc.

  • Page 91: Create And Start The Domain

    For more information about creating and managing domains see the eGate Integrator System Administration Guide. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjBAPIOutbound Sample Project Figure 63 Deployment Profile Section 6.5 Sun Microsystems, Inc.

  • Page 92: Build And Deploy The Project

    IDoc and then unmarshals it to the appropriate OTD. The IDoc data is then passed onto the respective JCDs for further processing. Steps required to create the sample project include: eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.

  • Page 93: Create A Project

    93 on page 95 on page 100 on page 106 on page 108 on page 109 on page 110 on page 113 on page 114 on page 115 on page 115 Section 6.6 Creating SAP BAPI OTDs Sun Microsystems, Inc.
  • Page 94 MATMAS04 IDoc type (Material Master). Click Next to review your selections. To close this wizard and create the OTD, click Finish. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.

  • Page 95: Create The Java Collaboration Definitions

    Select the OTDs used in this Collaboration by selecting Sun SeeBeyond > eWays > File > FileClient. Click Finish, the jcdProcessCREMAS Collaboration is created. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Figure 64 jcdProcessCREMAS Section 6.6 Sun Microsystems, Inc.

  • Page 96: Creating The Collaboration Business Rules

    From the Business Rules toolbar, select the Rule icon. Next, right-click FileClient_1 (located under jcdProcessCREMAS), and choose Select method to call... from the list of available options. Select the writeBytes() method. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.
  • Page 97 Enter a new Operation name. In this example enter inputMATMAS. Select the input message by selecting prjIDocInbound > IDOC_MATMAS04_4X_46C, then click Next. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.

  • Page 98: Creating The Collaboration Business Rules

    Business Rules Designer window. Connect result(byte[]) to byteArray under jcdProcessMATMAS > FileClient_1. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Figure 67 jcdProcessMATMAS Section 6.6 Sun Microsystems, Inc.
  • Page 99 The resulting Collaboration displays the following code: package prjIDocInbound; public class jcdProcessMATMAS public com.stc.codegen.logger.Logger logger; public com.stc.codegen.alerter.Alerter alerter; public com.stc.codegen.util.CollaborationContext collabContext; eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.

  • Page 100: Create The Business Process

    Figure 70 bpIDocInbound Business Rule From the Business Process toolbar, click the Branching Activities icon and drag a Decision from the drop-down list. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.
  • Page 101 From the Project Explorer, drag inputCREMAS operation, located under jcdProcessCREMAS and inputMATMAS operation, located under jcdProcessMATMAS to the Business Process canvas. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.

  • Page 102: Configuring The Bpidocinbound Business Rule Components

    Double-click the Decision gate to open the Decision Gate Properties window. Highlight the first row (Check if CREMAS) and then add an Equal Operator to the center column. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.
  • Page 103 Next, add a string literal and call it CREMAS. Connect the string literal to any 2 field. Figure 77 Decision Gate Properties Window eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.
  • Page 104 Open the Business Rule that follows the Check if CREMAS condition. Expand the output element located under RFC_IDOC_INBOUND_ASYNCHRONOUS.IDOC_INBOUND_ASYNCHRON OUSReceive.Input and connect the bytesToMarshal field to the bytes field of the IDOC_CREMAS03_4X_46A.unmarshal.Input. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.
  • Page 105 .IDOC_INBOUND_ASYNCHRONOUSReceive.Input and connect the bytesToMarshal field to the bytes field under IDOC_MATMAS04_4X_46C.unmarshal.Input. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Figure 79 CREMAS Business Rule Figure 80 CREMAS Business Rule Section 6.6 Sun Microsystems, Inc.

  • Page 106: Create A Connectivity Map

    From the Project Explorer tree, right-click the new prjIDocInbound Project and select New > Connectivity Map from the shortcut menu. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Figure 81 MATMAS Business Rule Figure 82 MATMAS Business Rule Section 6.6 Sun Microsystems, Inc.

  • Page 107: Populate The Connectivity Map

    SAP BAPI1 to eaSAPBAPIIn The Connectivity Map components should appear as they do in Figure 83. Figure 83 Connectivity Map Components eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.

  • Page 108: Bind The Eway Components

    FileClient under Invoked Services of cmIDocInbound_jcdProcessCREMAS1 to eaFileOutCREMAS. FileClient under Invoked Services of cmIDocInbound_jcdProcessMATMAS1 to eaFileOutMATMAS. The connected components are seen in Figure 60. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.

  • Page 109: Create An Environment

    Right-click envIDocInbound and select New SAP BAPI External System. Name the External System esBAPIExt. Click OK. eaBAPIExt is added to the Environment Editor. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.

  • Page 110: Configure The Eways

    External Applications and the Business Process, as seen in Figure 62. You must configure eWay properties in both the Connectivity Map and the Environment Explorer. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Section 6.6 Sun Microsystems, Inc.

  • Page 111: Configure The Eway Properties In The Connectivity Map

    Number of RFC Servers to create Transaction Mode Transaction ID Verification Database eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Outbound File eWay Outbound File eWay Required Value TRANSACTIONAL RFC (tRFC). C:\JavaCAPS51\data\SapTRFC.TIDdb Section 6.6 Sun Microsystems, Inc.

  • Page 112: Configure The File Eway External Environment Properties

    There is no default setting. Program ID is shown in the SAPGUI transaction SM59. This entry must match the SAPGUI exactly; this entry is case sensitive. There is no default setting. Section 6.6 Sun Microsystems, Inc.

  • Page 113: Create The Deployment Profile

    DE – German JA – Japanese KO – Korean The default is EN, English. Any valid SAP System ID. There is no default setting. Unicode or Non-unicode. The default value is Non-unicode. Inbound SAP BAPI eWay Section 6.6 Sun Microsystems, Inc.

  • Page 114: Create And Start The Domain

    If there are no existing domains, a dialog box indicates that you can create a domain now. Click Yes. The Create Domain dialog box appears. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project Figure 87 Deployment Profile Section 6.6 Sun Microsystems, Inc.

  • Page 115: Build And Deploy The Project

    Verify the output data by viewing the sample output files. See on page 70 for more details on the types of output files used in this sample Project. eWay™ Adapter for SAP BAPI User’s Guide Building and Deploying the prjIDocInbound Sample Project prjIDocInbound.zip Section 6.6 Sun Microsystems, Inc.

  • Page 116: Additional Sample Project Scenarios

    In the Project explorer, as seen in Figure 88, you see the following web service methods on the OTD: eWay™ Adapter for SAP BAPI User’s Guide Figure 88 RFC OTD OTD Methods Section 6.7 Additional Sample Project Scenarios Sun Microsystems, Inc.

  • Page 117: Client Mode - Sending Idocs To Sap R/3 Via Idoc_Inbound_Asyncronous

    FileClient.receive.Output to text in the text to bytes conversion box, and return bytes in the text to bytes conversion box to the bytesToUnmarshal field under RFC_IDOC_INBOUND_ASYNCHRONOUS.unmrshal.input. eWay™ Adapter for SAP BAPI User’s Guide Figure 89 Business Process Section 6.7 Additional Sample Project Scenarios Sun Microsystems, Inc.
  • Page 118 Assign a unique GUID to the EID node of the unmarshal output container. To do this: Create a link between RFC_IDOC_INBOUND_ASYNCHRONOUS.unmarshal and RFC_IDOC_INBOUND_ASYNCHRONOUS.IDOC_INBOUND _ASYNCHRONOUSExecute. eWay™ Adapter for SAP BAPI User’s Guide Additional Sample Project Scenarios Section 6.7 Sun Microsystems, Inc.
  • Page 119 Transaction Mode Configuration of the BAPI eWay in the Connectivity Map should always be set to “Transactional RFC” when using this OTD, as seen in Figure 93. eWay™ Adapter for SAP BAPI User’s Guide Additional Sample Project Scenarios Section 6.7 Sun Microsystems, Inc.
  • Page 120 Chapter 6 Section 6.7 Reviewing the Sample Projects Additional Sample Project Scenarios Figure 93 Client Mode Connectivity Map using BAPI eWay eWay™ Adapter for SAP BAPI User’s Guide Sun Microsystems, Inc.

  • Page 121: Sap Data Type Conversion Table

    Adapter for SAP BAPI User’s Guide JCo type code Java data type JCO.TYPE_INT1 JCO.TYPE_INT2 JCO.TYPE_INT JCO.TYPE_CHAR String JCO.TYPE_NUM Character String JCO.TYPE_BCD BigDecimal JCO.TYPE_DATE String JCO.TYPE_TIME String JCO.TYPE_FLOAT double JCO.TYPE_BYTE byte[ ] JCO.TYPE_STRING String JCO.TYPE_XSTRING byte[ ] Appendix A Sun Microsystems, Inc.

  • Page 122: Index

    Language 34, 35, 113 load balancing 30, 89 logical system name 54 Maximum TID Database Rows 30, 89 Middleware sapjco.jar 40 migration procedures 17 Number of RFC Servers to create 26, 111 objects, authorization 67 OTDs, IDoc 41 Sun Microsystems, Inc.
  • Page 123 13 Transaction ID Verification Database 27, 29, 89, 111 Transaction Mode 26, 29, 88, 111 Transactional RFC (tRFC) 9 uploading to the Logical Host 40 Use Load Balancing property 30, 89 User 35 User Name 34, 113 Sun Microsystems, Inc.

This manual is also suitable for:

Seebeyond eway

Table of Contents