Page 1 BEA WebLogic Adapter for SAP User’s Guide DN3501342.0406 April 19, 2006...
Page 2 Copyright © 2006, by BEA Systems, Inc. All rights reserved. Patent Pending. This manual, or parts thereof, may not be reproduced in any form without the written permission of Information Builders, Inc.
Page 3 This document is written for system integrators who develop client interfaces between SAP and other applications. It describes how to use the BEA WebLogic Adapter for SAP to integrate SAP IDocs, RFCs, and BAPIs with your BEA WebLogic Server. It is assumed that readers understand Web technologies and have a general understanding of Microsoft Windows and UNIX systems.
Page 4: Documentation Conventions
Web Services Using Application Explorer in Describes how to use Application Explorer in BEA BEA WebLogic Workshop for WebLogic Workshop to create events for SAP. In Event Handling addition, this section provides information on using events in a clustered BEA WebLogic environment.
Page 5 WebLogic Adapter for SAP and the version of the documentation. If you have any questions about this version of BEA WebLogic Adapter for SAP, or if you have problems using the BEA WebLogic Adapter for SAP, contact BEA Customer Support through BEA WebSUPPORT at www.bea.com.
Page 6 The following table lists the types of Application Explorer. Specify the version (and platform, if different than listed previously) in the columns provided. Application Explorer Type Version Platform Swing Servlet In the following table, specify the JVM version and vendor in the columns provided. Version Vendor BEA Systems, Inc.
Page 7 Specify the error message(s). The following table lists error/problem files that might be applicable. XML schema XML instances Other input documents (transformation) Error screen shots Error output files Trace and log files Log transaction BEA WebLogic Adapter for SAP User’s Guide...
Page 8 BEA Systems, Inc.
Page 9: Table Of Contents
Component Information for the BEA WebLogic Adapter for SAP ....... .1-7...
Page 10 Error Messages in JCA ............... . .9-6 BEA Systems, Inc.
Page 11 Calling a New Web Service for an RFC ..........C-10 Running the JWSNAME Web Service From WebLogic Workshop ......C-14 Confirming WebLogic Server is Running .
Page 12 Using Staging BAPIs to Retrieve SAP BW Metadata ......... . . D-12 BEA Systems, Inc.
Page 13: Introducing The Bea Weblogic Adapter For Sap
HAPTER Introducing the BEA WebLogic Adapter for SAP Topics: The following section provides an overview of the BEA WebLogic Adapter for SAP. • Features of the BEA WebLogic Adapter for SAP • SAP Certification • SAP Business Components • Integrating With SAP •...
Page 14: Features Of The Bea Weblogic Adapter For Sap
Features of the BEA WebLogic Adapter for SAP Features of the BEA WebLogic Adapter for SAP The BEA WebLogic Adapter for SAP is a remote function call adapter that provides a means to exchange real-time business data between SAP R/3 systems and other application, database, or external business partner systems.
Page 15: Supported Versions And Platforms
To access this document, use the following URL: http://service.sap.com/releasestrategy/ If the SAP R/3 version you are looking for is not listed in this table, please consult your BEA Customer Service Representative. The following 32-bit platforms are supported by the BEA WebLogic Adapter for SAP: •...
Page 16: Sap Business Components
Adapter for SAP, contact Customer Support. SAP Business Components The BEA WebLogic Adapter for SAP is designed to provide standard access to SAP business components such as Remote Function Call (RFC) modules, BAPIs (Business Application Programming Interfaces), and IDocs (Intermediate Documents), that are used to support existing business processes.
Page 17: Integrating With Sap
“sent.” The purchase order corresponds to the “logical” message ORDERS. Integrating With SAP You can use the BEA WebLogic Adapter for SAP to invoke an SAP business process, for example, add/update account, or you can use the adapter as part of an integration effort to connect SAP and non-SAP systems.
Page 18: Understanding Web Services And Java Connector Architecture Functionality
JCA acts as a type of envelope or “container” that will allow the adapter to run inside the BEA WebLogic Server and connect to SAP and immediately return the results. JCA is useful when your SAP system resides within a local intranet or is accesed directly.
Page 19: Component Information For The Bea Weblogic Adapter For Sap
, then no tea is produced. The container must physically possess the “tea, gas heat, water, and cup” components to receive the tea. Component Information for the BEA WebLogic Adapter for SAP The BEA WebLogic Adapter for SAP works in conjunction with one of the following components: •...
Page 20: Integration Business Services Engine
Integration Business Services and XML schemas can be shared as resources within a WebLogic WorkShop application. For more information, see Appendix A, Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services. Note: To use Application Explorer within WebLogic WorkShop, you must deploy the Integration Business Services Engine (iBSE).
Page 21: Enterprise Connector For J2Ee Connector Architecture (Jca)
The Enterprise Connector for J2EE Connector Architecture (JCA) enables developers of JCA-compliant applications to deploy adapters as JCA resources. The connector is supported on J2EE-compliant application servers, such as your BEA WebLogic Server. The Connector for JCA is distributed as a standard Resource Adapter Archive (RAR) for deployment to the application server.
Page 22 Component Information for the BEA WebLogic Adapter for SAP 1-10 BEA Systems, Inc.
Page 23: Configuring Sap Inbound Processing
Configuring SAP Inbound Processing Topics: The following section describes how to configure your SAP system for inbound (client) processing. • Overview • Configuring a Logical System • Configuring a Distribution Model • Defining a Partner Profile BEA WebLogic Adapter for SAP User’s Guide...
Page 24: Overview
SAP documentation. ALE IDocs used for transmission of Electronic Data Interchange (EDI) messages require information about the intended target and method of transmission stored on the BEA WebLogic Server. An IDoc consists of a Header that contains sender, processing type, receiver and other information, and multiple data segments, which contain the information to be processed.
Page 25: Configuring A Logical System
The Display IMG window opens as shown in the following image. a. Expand Sending and Receiving Systems and then, Logical Systems. b. Select Define Logical System. 2. Click the IMG - Activity icon. BEA WebLogic Adapter for SAP User’s Guide...
Page 26 3. To continue, click the checkmark icon. The Change View “Logical Systems” window opens with a list of logical systems and their names as shown in the following image. 4. Click the New entries button. BEA Systems, Inc.
Page 27 5. Click Save. The Prompt for Workbench request window opens as shown in the following image. It includes fields for View maintenance and Request as well as several buttons. 6. Click the Create Request icon. BEA WebLogic Adapter for SAP User’s Guide...
Page 28: Configuring A Distribution Model
A distribution model is used to describe the ALE message flow between logical systems. Business objects are distributed to connected recipients according to a unique distribution model that can contain rules of varying complexity depending on the type of business objects involved. BEA Systems, Inc.
Page 29 The Display Distribution Model window opens and displays a list of available distribution models and their descriptions as shown in the following image. 2. In the menu bar, click Distribution model. The Distribution model menu opens as shown in the following image. BEA WebLogic Adapter for SAP User’s Guide...
Page 30 In the Technical name filed, type a technical name, for example, ziwayale, which also serves as a description. 5. To enter the information, click the checkmark icon. You are returned to the main Change Distribution Model window. BEA Systems, Inc.
Page 31: Defining A Partner Profile
You are returned to the main Change Distribution Model window. 8. Click Save. Defining a Partner Profile Partner profiles are a requirement for data exchange. You define who can exchange messages with the SAP system using a specified port. BEA WebLogic Adapter for SAP User’s Guide...
Page 32 The Partner profiles window opens and displays two panes with information about the logical system as shown in the following image. 2. In the left pane, expand Partner type LS and select the logical system you configured from the list, for example, IWAY_IN. 2-10 BEA Systems, Inc.
Page 33 Note: The Partn.number field refers to the name of the logical system. 3. Click Save. 4. From the Inbound parameters table in the lower right, click the Create inbound parameter icon. BEA WebLogic Adapter for SAP User’s Guide 2-11...
Page 34 Trigger by background program. In this case, the BEA WebLogic Adapter for SAP writes IDocs to the SAP database, which are processed immediately. Trigger immediately. In this case, the BEA WebLogic Adapter for SAP waits for the SAP system to process IDocs. This can take from one to fifteen minutes.
Page 35: Creating Xml Schemas For Sap
Application Explorer to provide examples. • Creating an XML Schema For information on running Application Explorer in WebLogic Workshop, see Appendix A, Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services. BEA WebLogic Adapter for SAP User’s Guide...
Page 36: Overview
Overview Overview The BEA WebLogic Adapter for SAP enables the processing of SAP BAPIs, RFCs, and IDocs. External applications that access SAP through the adapter use either XML schemas or Web services to pass data between the external application and the adapter. You can use Servlet Application Explorer to create the required XML schemas and Web services.
Page 37: Establishing A Target For Sap
Is the name of the machine where your application server is running. port Is the port for the domain you are using for BEA. The port for the default domain is 7001. After you start Application Explorer, the following Welcome window opens, showing the Service Adapters, Event Adapters, and Integration Business Services tabs.
Page 38: Creating A New Target
To create a new target: 1. In the left pane, click the SAP node. Descriptive information (for example, title and product version) about the BEA WebLogic Adapter for SAP appears in the right pane. 2. In the right pane, move the pointer over Operations.
Page 39 3. Select Define a new target. The Add a new SAP target pane opens on the right as shown in the following image. a. In the Target Name field, type a name for the target, for example, SAPTarget. BEA WebLogic Adapter for SAP User’s Guide...
Page 40 In the Application Server field, type the host name or IP address for the computer that is hosting the SAP application. b. In the System Number field, type the system number defined to SAP for client communications. BEA Systems, Inc.
Page 41 Creating XML Schemas for SAP c. From the EDI Version drop-down list, select the Electronic Data Interchange (EDI) document version you are using with the BEA WebLogic Adapter for SAP. Version 3 is the default value. 5. Click the User tab.
Page 42 The “Commit With Wait” has a definite performance impact on your adapter performance, use it with deliberation. The commit behavior of BAPI’s is found in SAP documentation under “Bapi Programming Guide and Reference (CA-BFA)” . This option is disabled by default. BEA Systems, Inc.
Page 43 6. After you provide all the required information for your target, click Finish. The SAP target (SAPTarget) appears below the sap node in the left pane as shown in the following image. You are now ready to connect to your SAP target. BEA WebLogic Adapter for SAP User’s Guide...
Page 44: Connecting To A Target
3. Select Connect. The following graphic shows the Connect to SAPTarget pane that opens on the right, with fields to enter a client, a user, a password, a language, a code page, and an SAP trace. 3-10 BEA Systems, Inc.
Page 45: Disconnecting From A Target
• ALE (IDocs) Disconnecting From a Target Although you can maintain multiple open connections to different application systems, it is a good practice to close connections when you are not using them. BEA WebLogic Adapter for SAP User’s Guide 3-11...
Page 46: Modifying A Target
In the left pane, the SAPTarget node changes to reflect that a connection was closed (a red ‘x’ appears) as shown in the following image. Modifying a Target After you create a target for SAP using Servlet Application Explorer, you can edit the information that you provided previously. 3-12 BEA Systems, Inc.
Page 47: Deleting A Target
In addition to closing a target, you can delete a target that is no longer required. You can delete it whether or not it is closed. If open, the target automatically closes before it is deleted. BEA WebLogic Adapter for SAP User’s Guide 3-13...
Page 48: Viewing Application System Objects
RFC that exists within your SAP application environment. Procedure: How to View Application System Objects To view application system objects: 1. Click the icon to the left of the target name, for example, SAPTarget. 3-14 BEA Systems, Inc.
Page 49 BAPI method named BAPI_COMPANY_GETLIST appears as shown in the following image. a. Scroll down and click the icon next to the Company business object. Figure 0-1 Application Component Metadata b. Click the icon next to the BAPI method called BAPI_COMPANY_GETLIST. BEA WebLogic Adapter for SAP User’s Guide 3-15...
Page 50 Create Integration Business Services creates Web services for the SAP business object you selected. • Create Event Port creates a port to be used for SAP event handling. • Generate Schema generates XML request and response schemas for the SAP business object you selected. 3-16 BEA Systems, Inc.
Page 51: Creating An Xml Schema
BAPI method named BAPI_MATERIAL_GETLIST appears as shown in the following image. 2. In the right pane, move the pointer over Operations and select Generate Schema from the menu. Request, response, and event schemas are created for your business object. BEA WebLogic Adapter for SAP User’s Guide 3-17...
Page 52 The following image shows the Schemas pane that opens on the right with a table that lists and defines the root tag for each schema and provides hyperlinks to click to view each schema. 3. Click the hyperlink associated with the type of schema you want to view. 3-18 BEA Systems, Inc.
Page 53: Creating And Publishing
Integration Business Services. For more information, see Chapter 4, Creating and Publishing Integration Business Services. After the schemas are created, you also can create events. For more information, see Chapter 5, Configuring the Event Adapter for SAP. BEA WebLogic Adapter for SAP User’s Guide 3-19...
Page 54 Creating an XML Schema 3-20 BEA Systems, Inc.
Page 55: Creating And Publishing Integration Business Services
Java™ servlet implementation of Application Explorer to provide examples. For information on running Application Explorer in WebLogic Workshop, see Appendix A, Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services. BEA WebLogic Adapter for SAP User’s Guide...
Page 56: Understanding Integration Business Services
Understanding Integration Business Services Servlet Application Explorer provides Web developers with a simple, consistent mechanism for extending the capabilities of the BEA WebLogic Adapter for SAP. The Integration Business Services Engine (iBSE) exposes functionality as Web services. It serves as a gateway to heterogeneous back-end applications and databases.
Page 57 The following image shows the Operations menu in the right pane and a table listing properties and values for the BAPI method called BAPI_MATERIAL_GETLIST. 2. In the right pane, move the pointer over Operations. BEA WebLogic Adapter for SAP User’s Guide...
Page 58 Creating Integration Business Services The Operations menu expands as shown in the following image to display options. BEA Systems, Inc.
Page 59 4. Select Create a new service and click Next. A Create Web Service pane opens where you provide the specific information for the Integration Business Service you are defining as shown in the following image. BEA WebLogic Adapter for SAP User’s Guide...
Page 60 In the Method Name field, type a descriptive name for the method. b. In the Description field, type a brief description for the method (optional). 6. Click Finish. BEA Systems, Inc.
Page 61 The document queries the service in the input xml field. To use the identical sample input XML illustrated in this example, see Sample Integration Business Services Input XML on page 4-9. 8. Click Invoke. BEA WebLogic Adapter for SAP User’s Guide...
Page 62 Creating Integration Business Services The result appears in the right pane as shown in the following image. BEA Systems, Inc.
Page 63 - <item> <SIGN /> <OPTION /> <DESCR_LOW /> <DESCR_HIGH /> </item> </MATERIALSHORTDESCSEL> - <MATNRLIST> - <item> <MATERIAL /> <MATL_DESC /> <MATERIAL_EXTERNAL /> <MATERIAL_GUID /> <MATERIAL_VERSION /> </item> </MATNRLIST> - <MATNRSELECTION> - <item> <SIGN>E</SIGN> BEA WebLogic Adapter for SAP User’s Guide...
Page 64 <ROW>0</ROW> <FIELD /> <SYSTEM /> </item> </RETURN> - <SALESORGANISATIONSELECTION> - <item> <SIGN /> <OPTION /> <SALESORG_LOW /> <SALESORG_HIGH /> </item> </SALESORGANISATIONSELECTION> - <STORAGELOCATIONSELECT> - <item> <SIGN /> <OPTION /> <STLOC_LOW /> <STLOC_HIGH /> </item> </STORAGELOCATIONSELECT> </Material.GETLIST> 4-10 BEA Systems, Inc.
Page 65: Generating Wsdl From A Web Service
Generating WSDL From a Web Service Generating WSDL (Web Services Description Language) from a Web service enables you to make the Web service available to other services within a host server such as the BEA WebLogic Server. Procedure: How to Generate WSDL From a Web Service To generate WSDL from a Web service: 1.
Page 66 <xs:element type="xs:string" minOccurs="0" name="Username"/> <xs:element type="xs:string" minOccurs="0" name="Password"/> <xs:element type="xs:string" minOccurs="0" name="language"/> </xs:sequence> </xs:complexType> </xs:element> </xs:schema> <xs:schema targetNamespace="urn:schemas-iwaysoftware-com:iwse" elementFormDefault="qualified"> <xs:element name="adapterexception"> <xs:complexType> <xs:sequence> <xs:element type="xs:string" name="error"/> </xs:sequence> </xs:complexType> </xs:element> </xs:schema> <xs:schema xmlns:rfc="urn:iwaysoftware:ibse:jul2003:BAPI" targetNamespace="urn:iwaysoftware:ibse:jul2003:BAPI" xmlns:m1="urn:iwaysoftware:ibse:jul2003:BAPI" elementFormDefault="qualified"> <xs:element name="BAPI"> <xs:complexType> 4-12 BEA Systems, Inc.
Page 67 </xs:simpleType> </xs:element> <xs:element minOccurs="0" name="VALUATIONTYPE"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="10"/> </xs:restriction> </xs:simpleType> </xs:element> </xs:all> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema> <xs:schema xmlns:rfc="urn:iwaysoftware:ibse:jul2003:BAPI:response" targetNamespace="urn:iwaysoftware:ibse:jul2003:BAPI:response" xmlns:m11="urn:iwaysoftware:ibse:jul2003:BAPI:response" elementFormDefault="qualified"> <xs:element name="BAPIResponse"> <xs:complexType> <xs:sequence> <xs:element name="BAPI_MATERIAL_GET_DETAIL.Response"> <xs:complexType> BEA WebLogic Adapter for SAP User’s Guide 4-13...
Page 68 </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="ISSUE_UNIT"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="3"/> </xs:restriction> </xs:simpleType> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="BAPIMATDOBEW"> <xs:sequence> <xs:element name="PRICE_CTRL"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="1"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="MOVING_PR"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="23"/> </xs:restriction> 4-14 BEA Systems, Inc.
Page 69 <xs:restriction base="xs:string"> <xs:maxLength value="3"/> </xs:restriction> </xs:simpleType> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="BAPIMATDOA"> <xs:sequence> <xs:element name="MATL_DESC"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="40"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="OLD_MAT_NO"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="18"/> </xs:restriction> </xs:simpleType> </xs:element> BEA WebLogic Adapter for SAP User’s Guide 4-15...
Page 70 <xs:restriction base="xs:string"> <xs:maxLength value="9"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="PROD_HIER"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="18"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="BASIC_MATL"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="14"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="STD_DESCR"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="18"/> </xs:restriction> </xs:simpleType> 4-16 BEA Systems, Inc.
Page 71 <xs:maxLength value="2"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="STOR_CONDS"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="2"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="TEMP_CONDS"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="2"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="BASE_UOM"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="3"/> </xs:restriction> BEA WebLogic Adapter for SAP User’s Guide 4-17...
Page 72 <xs:element name="GROSS_WT"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="13"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="NET_WEIGHT"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="13"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="UNIT_OF_WT"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="3"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="VOLUME"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="13"/> 4-18 BEA Systems, Inc.
Page 73 <xs:restriction base="xs:string"> <xs:maxLength value="13"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="UNIT_DIM"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="3"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="MANU_MAT"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="40"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="MFR_NO"> <xs:simpleType> <xs:restriction base="xs:string"> BEA WebLogic Adapter for SAP User’s Guide 4-19...
Page 74 </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="UNIT_DIM_ISO"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="3"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="CREATED_ON"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="8"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="CREATED_BY"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="12"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="LAST_CHNGE"> <xs:simpleType> 4-20 BEA Systems, Inc.
Page 75 <xs:element name="BASIC_MATL_NEW"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="48"/> </xs:restriction> </xs:simpleType> </xs:element> </xs:sequence> </xs:complexType> <xs:complexType name="BAPIRETURN"> <xs:sequence> <xs:element name="TYPE"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="1"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="CODE"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="5"/> BEA WebLogic Adapter for SAP User’s Guide 4-21...
Page 76 </xs:element> <xs:element name="MESSAGE_V1"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="50"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="MESSAGE_V2"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="50"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="MESSAGE_V3"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:maxLength value="50"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="MESSAGE_V4"> <xs:simpleType> <xs:restriction base="xs:string"> 4-22 BEA Systems, Inc.
Page 77 <binding type="tns:BAPI_MATERIAL_GET_DETAILSoap" name="BAPI_MATERIAL_GET_DETAILSoap"> <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/> <operation name="BAPI"> <soap:operation style="document" soapAction="BAPI_MATERIAL_GET_DETAIL.BAPIRequest@test@@"/> <input> <soap:body use="literal"/> <soap:header part="header" message="tns:BAPI_MATERIAL_GET_DETAILHeader" use="literal"/> </input> <output> <soap:body use="literal"/> </output> <fault name="AdapterExceptionFault"> <soap:fault use="literal" name="AdapterExceptionFault"/> </fault> </operation> </binding> <service name="BAPI_MATERIAL_GET_DETAIL"> BEA WebLogic Adapter for SAP User’s Guide 4-23...
Page 78: Identity Propagation
The following is a sample SOAP header that is included in the WSDL file for a Web service: <SOAP-ENV:Header> <m:ibsinfo xmlns:m="urn:schemas-iwaysoftware-com:iwse"> <m:service>String</m:service> <m:method>String</m:method> <m:license>String</m:license> <m:disposition>String</m:disposition> <m:Username>String</m:Username> <m:Password>String</m:Password> <m:language>String</m:language> </m:ibsinfo> </SOAP-ENV:Header> Note: You can remove the following tags from the SOAP header, since they are not required: <m:disposition>String</m:disposition> <m:language>String</m:language> 4-24 BEA Systems, Inc.
Page 79: Configuring The Event Adapter For Sap
Java™ servlet implementation of Application Explorer to provide graphic examples. • Synchronous Event Processing For information on running Application Explorer in WebLogic Workshop, see Appendix B, Using Application Explorer in BEA WebLogic Workshop for Event Handling. BEA WebLogic Adapter for SAP User’s Guide...
Page 80: Understanding Event Functionality
Adapters tab or from the Event Adapters tab. When you use Application Explorer with an Integration Business Services Engine (iBSE) implementation, the following port dispositions are available: • File • iBSE • MSMQ • JMS queue • SOAP • HTTP BEA Systems, Inc.
Page 81 Procedure: How to Create a Port for the File Disposition To create a port for the File disposition using Application Explorer: 1. Click the Service Adapters tab. 2. From the Business Object Repository, select the BAPI_MATERIAL_GETLIST method. BEA WebLogic Adapter for SAP User’s Guide...
Page 82 The following image shows the Operations menu in the right pane and a table listing properties and values for the BAPI method named BAPI_MATERIAL_GETLIST. 3. In the right pane, move the pointer over Operations and select Create Event Port. BEA Systems, Inc.
Page 83 In the Event Port Name field, type a name. b. In the Event Port Description field, type a brief description (optional). c. From the Disposition Protocol drop-down list, select FILE. 4. Click Next. BEA WebLogic Adapter for SAP User’s Guide...
Page 84 Full directory path and file name to which the data is written. errorDest Location to which error logs are sent. Optional. Predefined port name or another disposition URL. The URL must be complete, including the protocol. For example: ifile://c:\temp\SAPEvent.txt;errorTo=ifile://c:\temp\error 6. Click Finish. BEA Systems, Inc.
Page 85 To create a port for an iBSE disposition using Application Explorer: 1. Click the Event Adapters tab. 2. In the left pane, expand the SAP node. 3. Select the ports node. 4. Move the pointer over Operations and select Add a new port. BEA WebLogic Adapter for SAP User’s Guide...
Page 86 2. In the left pane, expand the SAP node. 3. Select the ports node. 4. Move the pointer over Operations and select Add a new port. The Create New Port pane opens on the right. a. In the Name field, type a name. BEA Systems, Inc.
Page 87 4. Move the pointer over Operations and select Add a new port. The Create New Port window opens in the right pane. a. In the Name field, type a name. b. In the Description field, type a brief description (optional). BEA WebLogic Adapter for SAP User’s Guide...
Page 88 For BEA WebLogic Server this is: t3://host:port where: host Is the machine name where WebLogic Server is installed. port Is the port on which WebLogic server is listening. The default port if not changed at installation is 7001. 5-10 BEA Systems, Inc.
Page 89 Parameter Description jndifactory Is JNDI context.INITIAL_CONTEXT_FACTORY and is provided by the JNDI service provider. For WebLogic Server, the WebLogic factory is: weblogic.jndi.WLInitialContextFactory user Valid user name required to access a JMS server. password Valid password required to access a JMS server.
Page 90 Object Repository for any RFC or BAPI. 5. Click OK. The event port appears under the ports node in the left pane. In the right pane, a summary of the information associated with the port appears. 5-12 BEA Systems, Inc.
Page 91 Name of the host on which the Web server resides. port Port number on which the Web server is listening. Universal resource identifier that completes the URL specification. 5. Click OK. BEA WebLogic Adapter for SAP User’s Guide 5-13...
Page 92 Description qManager Name of the queue manager to which the server must connect. qName or Name of the queue where messages are placed. respqueue host Host on which the MQ Server is located (MQ Client only). 5-14 BEA Systems, Inc.
Page 93 You cannot change the port name. 3. Make the required changes to the event port configuration fields and click OK. BEA WebLogic Adapter for SAP User’s Guide 5-15...
Page 94: Creating, Editing, Or Deleting A Channel
All defined event ports must be associated with a channel. You can create a channel using Servlet Application Explorer. Procedure: How to Create a Channel To create a channel using Application Explorer: 1. Click the Event Adapters tab. 5-16 BEA Systems, Inc.
Page 95 2. Expand the Event Adapters node, for example, SAP. The ports and channels nodes appear in the left pane. 3. Click the channels node. 4. In the right pane, move the pointer over Operations and select Add a new channel. BEA WebLogic Adapter for SAP User’s Guide 5-17...
Page 96 The following graphic shows the Edit channels pane that opens on the right, with fields to enter a gateway host, a gateway service, the program ID of the server, an application server, and a system number for the channel. 5-18 BEA Systems, Inc.
Page 97 The following graphic shows the User tab that opens, with fields to enter a client, a user, a password, a language, and a code page. The following table lists and describes the user parameters. BEA WebLogic Adapter for SAP User’s Guide 5-19...
Page 98 IDoc format, any user defined function modules, check boxes to enable SAP traces or Unicode encoding of the event data, and a pull down menu with options for synchronous event processing. d. Specify additional information or criteria for the channel you are creating. 5-20 BEA Systems, Inc.
Page 99 6. Click the preemitter tab. The following graphic shows the preemitter tab that opens, with a checkbox that enables you to strip the SAP payload of an event document. 7. Click Next. BEA WebLogic Adapter for SAP User’s Guide 5-21...
Page 100 When only one port appears, it is as if you are transfering all ports. Therefore, only the double arrow button is active. The port appears in the list of available ports as shown in the following image. 5-22 BEA Systems, Inc.
Page 101 To activate your event configuration, you must start the channel using the Operations menu, as shown in the following image. 9. Move the pointer over Operations and select Start the channel. BEA WebLogic Adapter for SAP User’s Guide 5-23...
Page 102 1. In the left pane, select the channel you want to edit. The Operations menu opens in the right pane over the summary of the channel information, as shown in the following image. 2. Move the pointer over Operations and select Edit. 5-24 BEA Systems, Inc.
Page 103 The Operations menu opens in the right pane over the summary of the channel information, as shown in the following image. 2. Move the pointer over Operations and select Delete. A confirmation dialog box opens asking if you want to delete this item. BEA WebLogic Adapter for SAP User’s Guide 5-25...
Page 104: Synchronous Event Processing
From the Disposition Protocol drop-down list, select SOAP. d. In the Disposition field, enter a SOAP destination, using the following format: soap:[wsdl-url];soapaction=[myaction]; method=[web service method];namespace=[namespace]; responseTo=[pre-defined port name or another disposition URL]; errorTo=[pre-defined port name or another disposition url] 5-26 BEA Systems, Inc.
Page 105 Modules to generate the schema and WSDL file instead of using the Business Object Repository for any RFC or BAPI. The following is an example of a completed SOAP disposition: soap:http://localhost:7001/ibse/IBSEServlet/test/soapWS.ibs?wsdl; soapaction=soapWS.GETLISTRequest@test@@;method=GETLIST; namespace=urn:iwaysoftware:ibse:jul2005:GETLIST; responseTo=ifile://c:\output\sap\soapOut.xml BEA WebLogic Adapter for SAP User’s Guide 5-27...
Page 106 6. Start the channel. A Web service for an SAP Remote Function Module, for example, BAPI_MATERIAL_GETLIST, is triggered after an event occurs in the SAP system. The response document is returned and routed to a file location. 5-28 BEA Systems, Inc.
Page 107: Using Integration Business Services Policy-Based Security
Policy-Based Security you must enable security for your environment through the Integration Business Services Engine (iBSE) configuration page. For more information, see the BEA WebLogic ERP Adapter Installation and Configuration manual. Note: BEA recommends that you leave policy-based security disabled.
Page 108: Integration Business Services Policy-Based Security
Resource Execution policy is associated to the iBS. At that time, only users granted execution permission, or those who do not belong to a group that was denied execution permissions, have access to the iBS. BEA Systems, Inc.
Page 109: Configuring Integration Business Services Policy-Based Security
Security Policy option in Servlet Application Explorer. For more information, see How to Configure IP and Domain Restrictions on page 6-10. Note: BEA recommends that you leave policy-based security disabled. Procedure: How to Create a User to Associate With a Policy To create a user to associate with a policy: 1.
Page 110 The Add a new user pane opens as shown in the following image. a. In the Name field, type a user ID. b. In the Password field, type the password associated with the user ID. c. In the Description field, type a description of the user (optional). BEA Systems, Inc.
Page 111 To create a group to associate with a policy: 1. Open Servlet Application Explorer. a. Click the Integration Business Services tab. b. Expand the Configuration node. c. Expand the Security node. d. Expand the Users and Groups node. e. Select Groups. BEA WebLogic Adapter for SAP User’s Guide...
Page 112 4. Either highlight a single user in the list of available users and add it to the current list by clicking the left arrow, or click the double left arrow to add all users in the list of available users to the group. BEA Systems, Inc.
Page 113 Expand the Configuration node. c. Select Policies. The Policies pane opens on the right where you can apply a policy as shown in the following image. The Operations menu displays three options, Build/Rebuild, Add, and Refresh. BEA WebLogic Adapter for SAP User’s Guide...
Page 114 In the Description field, type a description for the policy (optional). 3. Click Next. The Modify policy targets pane opens where you can move targets between the Current and Available lists, as shown in the following image. BEA Systems, Inc.
Page 115 6. To assign whether users or groups may execute the Integration Business Services, select Grant to permit execution or Deny to restrict execution from a Permission drop-down list. BEA WebLogic Adapter for SAP User’s Guide...
Page 116 Procedure: How to Configure IP and Domain Restrictions To configure IP and domain restrictions: 1. Open Servlet Application Explorer. a. Select the Integration Business Services tab. b. Expand the Configuration node. c. Expand the Security node. d. Select IP and Domain. 6-10 BEA Systems, Inc.
Page 117 If you select Domain, you must provide the domain name, for example, yahoo.com. 3. From the Access Control drop-down list, select Grant to permit access or Deny to restrict access for the IP addresses and domain names you are adding. BEA WebLogic Adapter for SAP User’s Guide 6-11...
Page 118 Configuring Integration Business Services Policy-Based Security 4. Click OK. The IP and Domain pane opens and summarizes your configuration including the domain name, whether access is granted or denied, and a description (optional), as shown in the following image. 6-12 BEA Systems, Inc.
Page 119: Management And Monitoring
Setting Engine Log Levels • Configuring Connection Pool Sizes • Migrating Repositories • Exporting or Importing Targets • Retrieving or Updating Web Service Method Connection Information • Starting or Stopping a Channel Programmatically BEA WebLogic Adapter for SAP User’s Guide...
Page 120: Managing And Monitoring Services And Events Using Ibse
It also contains a field where you can enter a path to the adapter lib directory. To configure security settings, the Security pane contains fields for typing the Admin User name and the associated password and a check box for specifying policy. BEA Systems, Inc.
Page 121 In the upper and lower right of the window is a Save button. In the lower left of the window is an option to access more configuration settings. BEA WebLogic Adapter for SAP User’s Guide...
Page 122 In the Monitoring pane, from the Repository Type drop-down list, select the type of repository you are using. b. To connect to the database in the Repository Url field, type a JDBC URL. BEA Systems, Inc.
Page 123 4. Click Start Monitoring. iBSE begins to monitor all services and events currently in use. If you selected the option to store messages, iBSE stores messages. 5. To stop monitoring, click Stop Monitoring. BEA WebLogic Adapter for SAP User’s Guide...
Page 124 At the bottom of the window is a home button to click to return to the iBSE Monitoring Settings window. The system level summary provides services statistics at a system level. BEA Systems, Inc.
Page 125 Failed Invocations Failed services arranged by correlation ID. To retrieve more information for a service, select the service from the drop-down list. BEA WebLogic Adapter for SAP User’s Guide...
Page 126 To return to the iBSE Monitoring Settings window, you click the home button. a. To stop a service at any time, click Suspend Service. b. To restart the service, click Resume Service. BEA Systems, Inc.
Page 127 Successful Invocations or Failed Invocations drop-down list. To suspend or resume a service, you can click a button in the lower right. To return to the iBSE Monitoring Settings window, you click the home button. BEA WebLogic Adapter for SAP User’s Guide...
Page 128 7. To view the XML request document in your Web browser, click Request Message. You can also view the XML response document for the service. 8. To return to the iBSE Monitoring Settings window, click home. 7-10 BEA Systems, Inc.
Page 129 In the lower right of the window is a home button. The system level summary provides event statistics at a system level. BEA WebLogic Adapter for SAP User’s Guide 7-11...
Page 130 Successful events arranged by correlation ID. To retrieve more information for an event, select the event from the drop-down list. Failed Events Failed events arranged by correlation ID. To retrieve more information for an event, select the event from the drop-down list. 7-12 BEA Systems, Inc.
Page 131 Monitoring Settings window. a. To stop a channel at any time, click Suspend Channel. b. To start the channel, click Start Channel. BEA WebLogic Adapter for SAP User’s Guide 7-13...
Page 132 In the lower right of the window is a button to click to suspend or resume a channel and a home button to click to return to the iBSE Monitoring Settings window. 7-14 BEA Systems, Inc.
Page 133 The Messages pane contains a table that shows the size of the event and reply messages. a. To view the XML event document in your Web browser, click Event Message. b. To return to the iBSE Monitoring Settings window, click home. BEA WebLogic Adapter for SAP User’s Guide 7-15...
Page 134: Managing And Monitoring Services And Events Using The Jca Test Tool
It also provides options for viewing service or event adapters. The JCA Test Tool runs in managed mode by default. 7-16 BEA Systems, Inc.
Page 135 The following image shows the updated statistics that appear for your service if the request is successful. The statistics include the total number of requests, successes, and errors and the average and last execution time in milliseconds. BEA WebLogic Adapter for SAP User’s Guide 7-17...
Page 136 JCA configuration that is created using Application Explorer. a. Click Destroy Connection Factory for redeployment. b. Redeploy the JCA connector. c. In the JCA Test Tool, click Refresh Connection Factory after redeployment. 7-18 BEA Systems, Inc.
Page 137 The upper right of the pane contains options to start or refresh the channel. BEA WebLogic Adapter for SAP User’s Guide 7-19...
Page 138: Setting Engine Log Levels
Setting Engine Log Levels The following procedures describe how to set engine log levels. For more information, see the BEA WebLogic ERP Adapter Installation and Configuration manual. Procedure: How to Enable Tracing for Servlet iBSE To enable tracing for Servlet iBSE: 1.
Page 139 A directory in the configuration directory contains the logs. For example, on Windows the default location is the following: C:\Program Files\iway55\config\base\log The log files are named jca_*.log. You should also review the logs generated by your application server. BEA WebLogic Adapter for SAP User’s Guide 7-21...
Page 140: Configuring Connection Pool Sizes
The JCA Resource Connector has an initial capacity value of 0 by default and cannot be changed. The maximum capacity value is 10 by default and can be changed to a higher value. <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE weblogic-connection-factory-dd (View Source for full doctype...)> - <weblogic-connection-factory-dd> <connection-factory-name>IWAFJCA</connection-factory-name>...
Page 141: Migrating Repositories
JCA repositories to new destinations without affecting your existing configuration. For example, you can migrate a repository from a development environment to a production environment. The BEA WebLogic Server must be restarted to detect new repository changes.
Page 142: Ibse Repositories
In addition, verify that all required files and drivers for your database are in the class path. For more information on configuring repositories, see the BEA WebLogic ERP Adapter Installation and Configuration manual. Note: The following procedure allows you to migrate only Web services. If migrating event handling information is one of your requirements, you must migrate at the database level.
Page 143 4. In the Choose a file field, paste the iBSE configuration service URL. 5. Click OK. The following image shows the soap operation name dialog box that opens with a list of available control methods. BEA WebLogic Adapter for SAP User’s Guide 7-25...
Page 144 In the following image, the pointer points to the Text view icon. 8. To display the structure of the SOAP envelope as text, click the Text view icon. The <SOAP-ENV:Header> tag is not required and can be deleted from the SOAP envelope. 7-26 BEA Systems, Inc.
Page 145 If you want to migrate all Web services from the current iBSE repository, remove the <m:servicename> tag. 11. From the SOAP menu, select Send request to server. Your iBSE repository and the Web services you specified migrate to the new Oracle repository URL that you specified. BEA WebLogic Adapter for SAP User’s Guide 7-27...
Page 146: Jca Repositories
Migrating Repositories JCA Repositories The following procedure describes how to migrate a JCA repository. For more information on configuring JCA repositories, see the BEA WebLogic ERP Adapter Installation and Configuration manual. Procedure: How to Migrate a JCA Repository To migrate a JCA repository: 1.
Page 147 For more information on configuring the Microsoft SQL Server 2000 repository, see the BEA WebLogic ERP Adapter Installation and Configuration manual. 2. To migrate the tables that were created by the iwse.sql script for iBSE, use your Microsoft SQL Server 2000 database tool set.
Page 148 2. To create the Oracle database tables that are used by iBSE, use the SQL script as shown in the example in the following image that shows a list of tables. For more information on configuring the Oracle repository, see the BEA WebLogic ERP Adapter Installation and Configuration manual.
Page 149 2. To create the Sybase database tables that are used by iBSE, use the SQL script as shown in the example in the following image that shows a list of tables. For more information on configuring the Sybase repository, see the BEA WebLogic ERP Adapter Installation and Configuration manual.
Page 150 2. To create the DB2 database tables that are used by iBSE, use the SQL script as shown in the example in the following image that shows a list of tables. For more information on configuring the DB2 repository, see the BEA WebLogic ERP Adapter Installation and Configuration manual.
Page 151: Exporting Or Importing Targets
3. From the SOAP menu, select Create new SOAP request. The WSDL file location dialog box opens. 4. In the Choose a file field, paste the iBSE administrative services for Application Explorer URL. BEA WebLogic Adapter for SAP User’s Guide 7-33...
Page 152 10. From the SOAP menu, select Send request to server. A response is returned that contains the <m: exporttime> and <m: contents> elements. You must use these elements when importing your target. 7-34 BEA Systems, Inc.
Page 153 The soap operation name dialog box opens and lists the available control methods. 5. Select the IMPORTTARGET(IMPORTTARGET parameters) control method and click OK. A window opens, which shows the structure of the SOAP envelope. BEA WebLogic Adapter for SAP User’s Guide 7-35...
Page 154 For the <m: contents> tag, copy and paste the contents of the <m: contents> tag that was returned when you exported your target. 9. From the SOAP menu, select Send request to server. 7-36 BEA Systems, Inc.
Page 155: Retrieving Or Updating Web Service Method Connection Information
The WSDL file location dialog box opens. 4. In the Choose a file field, paste the iBSE configuration service URL, and click OK. The soap operation name dialog box opens and lists the available control methods. BEA WebLogic Adapter for SAP User’s Guide 7-37...
Page 156 For the <m:methodname> tag, replace the String placeholder with name of the Web service method. 9. From the SOAP menu, select Send request to server. A response is returned that contains the <m: descriptor> element. You must use this element when updating your Web service method. 7-38 BEA Systems, Inc.
Page 157 The soap operation name dialog box opens and lists the available control methods. 5. Select the SETMTHCONNECTION(SETMTHCONNECTION parameters) control method and click OK. A window opens that shows the structure of the SOAP envelope. BEA WebLogic Adapter for SAP User’s Guide 7-39...
Page 158 Web Service method connection information. 9. Modify the contents of the <m: descriptor> tag to change the existing Web Service method connection information. 10. From the SOAP menu, select Send request to server. 7-40 BEA Systems, Inc.
Page 159: Starting Or Stopping A Channel Programmatically
Info pane. The middle pane is blank. The right side is divided into three blank panes. 3. From the SOAP menu, select Create new SOAP request. The WSDL file location dialog box opens. BEA WebLogic Adapter for SAP User’s Guide 7-41...
Page 160 8. Locate the following section: <SOAP-ENV:Body> <m:STARTCHANNEL xmlns:m="urn:schemas-iwaysoftware-com:dec2002:iwse:event"> <m:channel>String</m:channel> </m:STARTCHANNEL> </SOAP-ENV:Body> 9. For the <m:channel> tag, replace the String placeholder with the name of the channel you want to start. 10. From the SOAP menu, select Send request to server. 7-42 BEA Systems, Inc.
Page 161 Info pane. The middle pane is blank. The right side is divided into three blank panes. 3. From the SOAP menu, select Create new SOAP request. The WSDL file location dialog box opens. BEA WebLogic Adapter for SAP User’s Guide 7-43...
Page 162 8. Locate the following section: <SOAP-ENV:Body> <m:STOPCHANNEL xmlns:m="urn:schemas-iwaysoftware-com:dec2002:iwse:event"> <m:channel>String</m:channel> </m:STOPCHANNEL> </SOAP-ENV:Body> 9. For the <m:channel> tag, replace the String placeholder with the name of the channel you want to stop. 10. From the SOAP menu, select Send request to Server. 7-44 BEA Systems, Inc.
Page 163 Management and Monitoring BEA WebLogic Adapter for SAP User’s Guide 7-45...
Page 164 7-46 BEA Systems, Inc.
Page 165: Understanding Sap Events
Related Concepts and Terminology processing. • Registering Your Program ID in SAPGUI • Testing the SAP Event Adapter • Application Link Enabling Configuration for the Event Adapter • Testing the SAP ALE Configuration BEA WebLogic Adapter for SAP User’s Guide...
Page 166: Overview
RFC API are called RFC calls. SAP Gateway The SAP Gateway is a secure BEA WebLogic Server. No connections are accepted unless they were pre-registered previously from the SAP presentation Client. A server connection presents itself to the Gateway and exposes a Program Identifier. If the Program Identifier is found in the list of registered Program IDs, the Gateway server then offers a connection to the server, which accepts a connection.
Page 167: Program Ids And Load Balancing
BEA WebLogic scenario where messages are validated by schema and application. When configuring multiple events in BEA WebLogic using a single SAP program ID, SAP load balances the event data. For example, if multiple remote function calls or BAPIs use the...
Page 168 3. Execute the SM59 transaction. The Display and maintain RFC destinations window opens and displays a list of connections and drivers you can manage as shown in the following image. 4. Select TCP/IP connections. 5. Click Create. BEA Systems, Inc.
Page 169 In the Connection type field, type T (for destination type, TCP/IP). c. In the Description field, type a brief description. 6. Click Save from the tool bar or select Save from the Destination menu. BEA WebLogic Adapter for SAP User’s Guide...
Page 170: Testing The Sap Event Adapter
7. Click Save from the tool bar or select Save from the Destination menu. 8. Ensure your event adapter is running. 9. To verify that the SAP system and the BEA WebLogic Adapter for SAP are communicating, click Test connection.
Page 171 To choose single test, press F8 and click the Single Test icon or select Function module, Test, and then Single Test. b. Enter an RFC target system, for example, IWAYDEST. c. Enter input data for the particular RFC module, for example, AB*. 2. To execute, press F8. BEA WebLogic Adapter for SAP User’s Guide...
Page 172: Application Link Enabling Configuration For The Event Adapter
3. Enter data into the SAP GUI and click the Execute button. The function name and input data are transferred by RFC to create an XML document on theBEA WebLogic Server with the parameters input in SAPGUI. Application Link Enabling Configuration for the Event Adapter The SAP event adapter receives IDocs (Intermediate Documents) from SAP.
Page 173 The Creating a tRFC port window opens as shown in the following image. On the left, the window is divided into a Ports pane and a Description pane. A pane for displaying information about the port is on the right. BEA WebLogic Adapter for SAP User’s Guide...
Page 174 4. Click the green check mark beside Define Logical System. The Change View “Logical Systems”: Overview window opens and displays a list of logical systems and their names as shown in the following image. 5. Click New entries. 8-10 BEA Systems, Inc.
Page 175 Procedure: How to Create a Partner Profile To create a partner profile: 1. In the SAP Workbench, choose Tools, Business Communication, IDoc Basis, IDoc, and then Partner profile or execute the WE20 transaction. BEA WebLogic Adapter for SAP User’s Guide 8-11...
Page 176 Depending on your performance requirements, click Transfer IDoc Immed or Collect IDocs. b. For the IDoc, type a message type, for example, DEBMAS. c. Type a receiver port, for example, A000000036. 7. Save the session and exit. 8-12 BEA Systems, Inc.
Page 177: Collected Idocs
2. Select Create model view. (If required, switch processing mode to edit within Distribution Model/Switch Processing Mode.) 3. Type a short text string and a technical name for your new model view. BEA WebLogic Adapter for SAP User’s Guide 8-13...
Page 178 In the Sender field, provide the sender that points to the SAP system that sends the IDoc, for example, I46_CLI800. 8-14 BEA Systems, Inc.
Page 179 DEBMAS, from the I46_CLI800 SAP system to the IWAYLOG logical system, as shown in the following image. You are now ready to test the connection to the logical system. BEA WebLogic Adapter for SAP User’s Guide 8-15...
Page 180: Testing The Sap Ale Configuration
2. In the Logical system field, type the logical system, for example, IWAYLOG. 3. To transfer data, click the Run button. The SAP event adapter receives the IDoc in XML format. No response is expected from the event adapter. 8-16 BEA Systems, Inc.
Page 181: Usage Considerations
If one of the event configuration parameters (for example, log level) is different for one of the events, BEA WebLogic creates a different schema for that event, and event data can be lost.
Page 182 This usage consideration applies to all supported platforms. Workaround If you wish to load balance SAP event data over multiple events in BEA WebLogic, ensure you configure each event in precisely the same way. If you do not wish to use load balancing, configure a separate event for each SAP program ID.
Page 183: Troubleshooting And Error Messages
Error Messages in Application Explorer can arise whether you are using the adapter with a JCA or with an iBSE configuration. • Error Messages in SAP • Error Messages in JCA • Error Messages in iBSE BEA WebLogic Adapter for SAP User’s Guide...
Page 184: Troubleshooting Overview
Troubleshooting Overview Troubleshooting Overview This topic provides troubleshooting information for the BEA WebLogic Adapter for SAP, separated into four categories: • Application Explorer • • • iBSE Note: The following locations include log file information that is relevant for troubleshooting.
Page 185 2004 RELEASE 620 COMPONENT NI (network interface) VERSION 36 RC -10 MODULE ninti.c LINE 979 DETAIL NiPConnect2 SYSTEM CALL SO_ERROR ERRNO 10061 ERRNO TEXT WSAECONNREFUSED: Connection refused COUNTER 1). Check logs for more information. BEA WebLogic Adapter for SAP User’s Guide...
Page 186 The following error message appears: com.ibi.sapr3.SapAdapterException: java.lang.ExceptionInInitializerEr ror: JCO.classInitialize(): Could not load middleware layer 'com.sap.mw.jco.rfc.MiddlewareRFC' JCO.nativeInit(): Could not initialize dynamic link library sapjcorfc [Native Library F:\iWay55.008.0628\lib\sapjcorfc.d ll already loaded in another classloader]. java.library.path BEA Systems, Inc.
Page 187: Error Messages In Sap
Make sure your user ID has the correct following error message appears: permissions configured in SAP. For more information, consult your SAP administrator. AdapterException: java.lang.Exception: BapiError/BapiAbort: You are not authorized to display customers. BEA WebLogic Adapter for SAP User’s Guide...
Page 188: Error Messages In Jca
SOAP fault. In general, when the SOAP agent inside iBSE receives an invalid SOAP request, a SOAP fault element is generated in the SOAP response. The SOAP fault element contains fault string and fault code elements. The fault code contains a description of the SOAP agent error. BEA Systems, Inc.
Page 189: Adapter-Specific Error Handling
Although it is almost impossible to anticipate every error condition that an adapter may encounter, the following examples show how adapters handle common error conditions and how error conditions are then exposed to the Web services consumer application. BEA WebLogic Adapter for SAP User’s Guide...
Page 190 Example: Empty Result From SOAP Request When the BEA WebLogic Adapter for SAP executes an SAP object as a Web service using input parameters passed in the SOAP request message that do not match records in SAP, the following SOAP response is generated: <?xml version="1.0"...
Page 191 Troubleshooting and Error Messages Example: Failure to Connect to SAP When the BEA WebLogic Adapter for SAP cannot connect to SAP when executing a Web service, the following SOAP response is generated: <?xml version="1.0" encoding="ISO-8859-1" ?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/ soap/envelope/"> <SOAP-ENV:Body>...
Page 192 Note: The condition for this adapter does not yield a SOAP fault. When the BEA WebLogic Adapter for SAP executes a SOAP request using input parameters passed that do not match records in the target system, the following SOAP response is generated: <SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"...
Page 193: Using Application Explorer In Bea Weblogic Workshop To Create Xml Schemas And Web Services
PPENDIX U sing Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services Topics: This section describes how to use the Java Swing Application Explorer in BEA WebLogic Workshop to create • Starting Application Explorer in BEA XML schemas for SAP BAPIs, RFCs, and IDocs.
Page 194: Starting Application Explorer In Bea Weblogic Workshop
3. From the BEA WebLogic Workshop View menu, select Windows and then, Application Explorer. Application Explorer opens in BEA WebLogic Workshop. You can resize and drag-and-drop the Application Explorer window within BEA WebLogic Workshop. For example, you can drag it to the upper part of BEA WebLogic Workshop. BEA Systems, Inc.
Page 195: Creating A New Configuration For Ibse Or Jca
Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services Creating a New Configuration for iBSE or JCA Before you can start using Application Explorer, you must define a new configuration for iBSE or JCA. How to Create a New Configuration for iBSE or JCA...
Page 196 4. Right-click the configuration to which you want to connect, for example, base, and select Connect. The Service Adapters and Event Adapters nodes appear. When you connect to iBSE, the Service Adapters, Event Adapters, and Integration Business Services nodes appear. BEA Systems, Inc.
Page 197: Connecting To Sap
Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services 5. To display the service and event adapters that are installed, expand each node. The Service Adapters list includes an SAP node that enables you to connect to SAP metadata and create XML request and response schemas to use to listen for events or create Web services.
Page 198 Connecting to SAP Descriptive information (for example, title and product version) for the BEA WebLogic Adapter for SAP appears in the right pane. 2. To view the options, right-click the SAP adapter node. 3. Select Add Target. The Add target dialog box opens.
Page 199 Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services c. From the Type drop-down list, select the type of server to which you are connecting. Application Server is the default value. 4. Click OK. The Application Server dialog box opens where you must specify connection information for SAP and the application server that is hosting SAP.
Page 200 To enable traces, select the SAP trace check box. After you provide information for the System and User tabs, you have completed the SAP target configuration. However, you can specify additional parameters in the Advanced and Security tabs. 7. Click OK. BEA Systems, Inc.
Page 201 Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services The new target (SAPTarget) appears in the left pane under the SAP node. In the right pane, you can review the connection information you specified. You are ready to connect to the application target you defined.
Page 202: Managing A Target
Managing a Target Although you can maintain multiple open connections to different application systems, BEA Systems, Inc. recommends that you close connections when they are not in use. After you disconnect, you can modify an existing target. You can modify the connection parameters when your system properties change. You also can delete a target.
Page 203 Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services How to Edit a Target Procedure To edit a target: 1. Ensure that the target you want to edit is disconnected. 2. In the left pane, right-click the target and select Edit.
Page 204: Viewing An Application System Object And Creating An Xml Schema
The available system objects appear. Figure 0-1 Expanded Connection Node 2. To expand the SAP repository node you want to explore, click the icon to the left of the repository name, for example, Business Object Repository. A-12 BEA Systems, Inc.
Page 205 Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services A list of business object groups appears. 3. Expand the Financial Accounting group. A list of business objects related to Financial Accounting appears. 4. Scroll down and click the Company business object.
Page 206 In the left pane, the following list of BAPI methods related to Company appears: 5. Click the BAPI method named BAPI_COMPANY_GETLIST. In the right pane, properties for the BAPI_COMPANY_GETLIST method appear in the Detail tab. Figure 0-2 Application Component Metadata A-14 BEA Systems, Inc.
Page 207 Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services To view the following XML schemas for the method, click the corresponding tab in the right pane. • Request • Response • Reply • Event How to View Additional Information for a Group or System Object in SAP...
Page 208 After you browse the application system business object repository and select a specific method, the relevant XML schemas automatically are created for that method and stored in the repository you created, for example: drive:\Program Files\iWay55\bea\ibse\wsdl\schemas\service\SAP \SAPTarget\S5710F9F where SAPTarget Is the name of the SAP target. A-16 BEA Systems, Inc.
Page 209: Creating An Integration Business Service
Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services S5710F9F Is a randomly generated folder name where the schemas are stored. Creating an Integration Business Service Java Swing Application Explorer provides Web developers with a simple, consistent mechanism for extending the capabilities of the adapter.
Page 210 Creating an Integration Business Service How to Create an Integration Business Service Procedure To create an Integration Business Service: 1. Select the BAPI_MATERIAL_GETLIST method from the Business Object Repository. A-18 BEA Systems, Inc.
Page 211 Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services 2. Right-click the method and select Create Integration Business Service. The Create Integration Business Service dialog box opens. a. From the Existing Service Names drop-down list, select whether you want to create a new service name or use an existing service name.
Page 212 SAPService node is expanded, and the BAPI_MATERIAL_GETLIST method automatically is selected. On the right, the test pane for the BAPI_MATERIAL_GETLIST method opens. 5. To invoke the service, enter a sample XML document in the input xml field. A-20 BEA Systems, Inc.
Page 213: Exporting Wsdl For Use In Bea Weblogic Workshop Workflows
Because Application Explorer runs within BEA WebLogic Workshop, you can easily incorporate Web services into BEA WebLogic Workflows. To enable BEA WebLogic Workshop to use Web services, you simply export the WSDL to a directory accessible to BEA WebLogic Workshop.
Page 214 1. After you create the Web service, right-click the Web service name and select Export WSDL. The Save dialog box appears. 2. Save the WSDL to a directory that is accessible to BEA WebLogic Workshop, for example, the \resources directory in your BEA WebLogic Workshop Web application directory structure.
Page 215: Identity Propagation
Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services Identity Propagation If you test or execute a Web service using a third party XML editor, for example XMLSPY, the Username and Password values that you specify in the SOAP header must be valid and are used to connect to SAP.
Page 216 </MANUFACTURERPARTNUMB> - <MATERIALSHORTDESCSEL> - <item> <SIGN /> <OPTION /> <DESCR_LOW /> <DESCR_HIGH /> </item> </MATERIALSHORTDESCSEL> - <MATNRLIST> - <item> <MATERIAL /> <MATL_DESC /> <MATERIAL_EXTERNAL /> <MATERIAL_GUID /> <MATERIAL_VERSION /> </item> </MATNRLIST> - <MATNRSELECTION> - <item> <SIGN>E</SIGN> A-24 BEA Systems, Inc.
Page 217 Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services <OPTION>BT</OPTION> <MATNR_LOW>1000</MATNR_LOW> <MATNR_HIGH>1010</MATNR_HIGH> </item> </MATNRSELECTION> - <PLANTSELECTION> - <item> <SIGN /> <OPTION /> <PLANT_LOW /> <PLANT_HIGH /> </item> </PLANTSELECTION> - <RETURN> - <item> <TYPE /> <ID />...
Page 218: Adding A Control For A Resource In Bea Weblogic Workshop
After you create a Web service using Application Explorer and export the WSDL file, you can create a control for the Web service. For more information on exporting a WSDL file, see How to Export WSDL for Use in BEA WebLogic Workshop Workflows on page A-22.
Page 219: Extensible Cci Control
Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services Extensible CCI Control The following section describes the enhanced CCI control, which is extensible and provides JCX with typed inputs and outputs for JCA in BEA WebLogic Workshop.
Page 220 Defining a Control Using the Extensible CCI Control Example The following sample JCX demonstrates how to define a control that uses the SAP BAPI_MATERIAL_GET_DATA method using the extensible CCI control in BEA WebLogic Workshop. 1. Start BEA WebLogic Workshop and create a new project.
Page 221 Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services A new JCX file is created. To edit an existing control, right click the control and select Edit. The Design view is displayed. 5. Click Source View.
Page 222 Extensible CCI Control You can add your own methods that call the adapter's services. A-30 BEA Systems, Inc.
Page 223: Using Application Explorer In Bea Weblogic Workshop For Event Handling
PPENDIX U sing Application Explorer in BEA WebLogic Workshop for Event Handling Topics: This section describes how to use Java Swing Application Explorer running in BEA WebLogic Workshop to create • Starting Application Explorer in BEA events for SAP. In addition, this section provides...
Page 224: Starting Application Explorer In Bea Weblogic Workshop
3. From the BEA WebLogic Workshop View menu, select Windows and then, Application Explorer. Application Explorer opens in BEA WebLogic Workshop. You can resize and drag-and-drop the Application Explorer window within BEA WebLogic Workshop. For example, you can drag it to the upper part of BEA WebLogic Workshop. BEA Systems, Inc.
Page 225: Understanding Event Functionality
Using Application Explorer in BEA WebLogic Workshop for Event Handling Understanding Event Functionality Events are generated as a result of activity in an application system. You can an use an event to trigger an action in your application. For example, SAP R/3 may generate an event when customer information is updated.
Page 226 MQ Series How to Create an Event Port for the File Disposition Procedure To create an event port for the File disposition: 1. In the Business Object Repository, right-click the BAPI_MATERIAL_GETLIST method and select Create Event Port. BEA Systems, Inc.
Page 227 Using Application Explorer in BEA WebLogic Workshop for Event Handling The Create Event Port dialog box opens. a. In the Name field, type a name for the event port, for example, GETLIST_EventPort. b. In the Description field, type a brief description.
Page 228 How to Create a Port for the iBSE Disposition Procedure The iBSE disposition allows an event to launch an Integration Business Service method. To create a port for iBSE: 1. From the Business Object Repository, right-click the BAPI_MATERIAL_GETLIST method and select Create Event Port. BEA Systems, Inc.
Page 229 Using Application Explorer in BEA WebLogic Workshop for Event Handling The Create Event Port dialog box opens. a. In the Name field, type a name for the event port, for example, GETLIST_EventPort. b. In the Description field, type a brief description.
Page 230 From the Protocol drop-down list, select MSMQ. d. In the URL field, enter an MSMQ destination using the following format: msmq:/host/queueType/queueName[;errorTo=errorDest] The following table defines the disposition parameters. Parameter Description host Name of the host on which the Microsoft Queuing system runs. BEA Systems, Inc.
Page 231 Using Application Explorer in BEA WebLogic Workshop for Event Handling Parameter Description queueType Type of queue. For private queues, enter Private$. Private queues are queues that are not published in Active Directory. They appear only on the local computer that contains them. Private queues are accessible only by Message Queuing applications that recognize the full path name or format name of the queue.
Page 232 The following table describes the disposition parameters. Parameter Description queue Name of a queue to which events are emitted. conn_factory The connection factory, a resource which contains information about the JMS Server. The BEA WebLogic connection factory is: javax.jms.QueueConnectionFactory B-10 BEA Systems, Inc.
Page 233 Is the machine name where BEA WebLogic Server resides. port Is the port on which BEA WebLogic Server is listening. The default port if not changed at installation is 7001. jndi_factory Is JNDI context.INITIAL_CONTEXT_FACTORY and is provided by the JNDI service provider.
Page 234 From the Protocol drop-down list, select SOAP. d. In the URL field, enter a SOAP destination using the following format: soap:[wsdl-url];soapaction=[myaction];method=[web service method];namespace=[namespace];responseTo=[pre-defined port name or another disposition URL];errorTo=[pre-defined port name or another disposition url] The following table describes the disposition parameters. B-12 BEA Systems, Inc.
Page 235 Using Application Explorer in BEA WebLogic Workshop for Event Handling Parameter Description wsdl-url The URL to the WSDL file that is required to create the SOAP message. For example: http://localhost:7001/ibse/IBSEServlet/test/webser vice.ibs?wsdl where: webservice Is the name of the Web service you created using Application Explorer.
Page 236 From the Protocol drop-down list, select HTTP. d. In the URL field, enter an HTTP destination using the following format: ihttp://url;responseTo=respDest The following table describes the disposition parameters. Parameter Description The URL target for the post operation. B-14 BEA Systems, Inc.
Page 237 Using Application Explorer in BEA WebLogic Workshop for Event Handling Parameter Description respDest The location to which responses are posted. Optional. This can be a predefined port name or another disposition URL. The URL must be complete, including the protocol.
Page 238: Modifying An Event Port
Explorer. To review the port settings, select the port name. In the right pane, a table appears that summarizes the information associated with the event port you created. How to Edit an Event Port Procedure To edit an existing event port: B-16 BEA Systems, Inc.
Page 239 Using Application Explorer in BEA WebLogic Workshop for Event Handling 1. To view the available ports, click the Ports node in the left pane. 2. Right-click the event port you want to edit and select Edit. The Edit Port dialog box opens.
Page 240: Creating A Channel
Event Adapters node. The list of adapters appears. 2. Click the SAP adapter node. The node expands, listing the Ports and Channels nodes. Figure 0-3 Expanded Connection Node 3. Right-click Channels and select Add Channel. B-18 BEA Systems, Inc.
Page 241 Using Application Explorer in BEA WebLogic Workshop for Event Handling The Add Channel dialog box opens. a. In the Name field, type a name for the channel, for example, SAPChannel. b. In the Description field, type a brief description. c. From the Protocol drop-down list, select SAP Channel - App Server.
Page 242 On the System tab, type the system information that is specific to your SAP system. b. Click the User tab. c. Enter the user information that is specific to your SAP system. d. Click the Advanced tab. B-20 BEA Systems, Inc.
Page 243 Using Application Explorer in BEA WebLogic Workshop for Event Handling e. Specify any additional information or criteria for the channel you are creating. Click the preemitter tab. g. Click Strip the Sap Payload to strip the SAP payload of an event document.
Page 244: Modifying A Channel
The following procedures describe how to edit and delete a channel using Application Explorer. To review the channel settings, you select the channel name. In the right pane, a table appears that summarizes the information associated with the channel you created. B-22 BEA Systems, Inc.
Page 245 Using Application Explorer in BEA WebLogic Workshop for Event Handling How to Edit a Channel Procedure To edit an existing channel: 1. To view the available channels, click the Channels node in the left pane. 2. Right-click the channel you want to edit, for example, SAPChannel, and select Edit.
Page 246 3. Make the required changes to the channel configuration. 4. Click Next. The Message Server dialog box opens. a. If changes are required, click the appropriate tab (System, User, or Advanced). b. Make the required changes. 5. Click OK. B-24 BEA Systems, Inc.
Page 247: Deploying Components In A Clustered Bea Weblogic Environment
The channel disappears from the Channels list. Deploying Components in a Clustered BEA WebLogic Environment Events can be configured in a clustered BEA WebLogic environment. You can deploy Integration Business Services Engine (iBSE) or JCA to this clustered environment. A cluster consists of multiple server instances running simultaneously, yet appears to clients to be a single server instance.
Page 248 Deploying Components in a Clustered BEA WebLogic Environment c. Add and configure an HTTP router. This does not have to be a part of WebLogic and can be an outside component. d. If you configure the HTTP router within WebLogic, start it by entering the following...
Page 249 Using Application Explorer in BEA WebLogic Workshop for Event Handling 4. To deploy iBSE, select the option button next to the ibse directory and then click Target Module. 5. To deploy servlet Application Explorer, select the option button next to the iwae directory and then click Target Module.
Page 250 Deploying Components in a Clustered BEA WebLogic Environment The following window opens. 6. Select the servers and/or clusters on which you want to deploy the application and click Continue. The following window opens. 7. Select the I will make the Web Application module accessible from the following location option button and provide the location from which all targets will access iBSE.
Page 251 How to Configure Ports and Channels in a Clustered Environment Procedure You can use Swing Application Explorer deployed in BEA WebLogic WorkShop or Servlet Application Explorer to configure ports and channels in a clustered environment. Note: Before using Servlet Application Explorer in a clustered environment, you must edit the web.xml file and specify the correct URL to your iBSE deployment.
Page 252 Deploying Components in a Clustered BEA WebLogic Environment 2. Create a new connection to the iBSE instance. For information on creating a new configuration, see Appendix A, Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services.
Page 253 Using Application Explorer in BEA WebLogic Workshop for Event Handling 4. Select an adapter from the adapter list (in this example, SAP) and add a new port. For more information, see Creating an Event Port on page B-3. 5. Create a channel and add the port you created. For more information, see Creating a Channel on page B-18.
Page 254 Deploying Components in a Clustered BEA WebLogic Environment The following graphic shows two configurations. The following operations performed on one managed server will be replicated on all other managed servers: • Create port and channel: Creates the channel and port under all available servers.
Page 255 Configure an administrative server to manage the managed servers. b. Add and configure as many managed servers as required. c. Add and configure an HTTP router. This does not have to be a part of WebLogic and can be an outside component.
Page 256 Deploying Components in a Clustered BEA WebLogic Environment 4. To deploy iBSE, select the option button next to the ibse directory and then click Target Module. 5. To deploy servlet Application Explorer, select the option button next to the iwae directory and then click Target Module.
Page 257 Using Application Explorer in BEA WebLogic Workshop for Event Handling The following window opens. 6. Select the servers and/or clusters on which you want to deploy the application and click Continue. The following window opens. 7. Select the I will make the Web Application module accessible from the following location option button and provide the location from which all targets will access iBSE.
Page 258 Deploying Components in a Clustered BEA WebLogic Environment Note: iBSE must use a database repository (SQL or Oracle). Do not use a file repository. You can select this in the Repository Type drop-down list in the iBSE monitoring page. After configuring a database repository, you must restart all of the managed servers.
Page 259: Using Weblogic Workshop To Access Web Services
PPENDIX U sing WebLogic Workshop to Access Web Services Topics: This section describes how to access Web services created for an SAP Business Application Programming Interface • Using WebLogic Workshop to (BAPI) and an SAP Remote Function Call (RFC) using Access an SAP BAPI or an SAP RFC WebLogic Workshop.
Page 260: Using Weblogic Workshop To Access An Sap Bapi Or An Sap Rfc
WebLogic Workshop are enterprise-class services, and WebLogic Workshop provides simple controls for connecting to your enterprise resources. At the same time, WebLogic Workshop simplifies the process of creating Web services by insulating developers from the low-level implementation details that have traditionally made Web service development the domain of sophisticated J2EE developers.
Page 261 Using WebLogic Workshop to Access Web Services BEA WebLogic Workshop opens. 2. Create a new application. a. From the File menu, select New and then, Application. b. In the upper-left pane, select all and then, select Empty Application. c. In the directory field, type C:\IWAYSRV.
Page 262: Calling A New Web Service For A Bapi
JAVA file in that it contains code for a Java class. However, because a file with a JWS extension contains the implementation code intended specifically for a Web service class, the extension gives it special meaning in the context of the WebLogic Server. After you access the Business Application Programming Interface (BAPI), the New Web Service dialog box opens, and you can continue and call a Web service.
Page 263 Using WebLogic Workshop to Access Web Services 3. In the upper-left pane, select all and then, select Web Service in the right pane. a. In the name field, type JWSNAME.jws. b. Click Create. The design view window opens. Web services expose their functionality through methods that clients invoke when they want to request something from the Web service.
Page 264 Using WebLogic Workshop to Access an SAP BAPI or an SAP RFC The following opens. 7. To generate a Java Control file, right-click the BAPI_MATERIAL_GET_DETAIL.wsdl file and select Generate Service Control. BEA Systems, Inc.
Page 265 Using WebLogic Workshop to Access Web Services 8. Drag the BAPI_MATERIAL_GET_DETAIL.jcx file onto the JWSNAME Web service as follows: 9. Click the Source View tab to modify the source code and call the BAPI_MATERIAL_GET_DETAIL Web service. 10. Add the following code to the source view: public void BAPI(BAPI_MATERIAL_GET_DETAILControl.BAPI_MATERIAL_GET_DETAIL input)
Page 266: Accessing An Sap Rfc
Web services, see Chapter 4, Creating and Publishing Integration Business Services. How to Access an SAP RFC Procedure To access an SAP Remote Function Call (RFC): 1. From the Start menu, choose Programs, WebLogic Platform 8.1, WebLogic Workshop, and then WebLogic Workshop. BEA Systems, Inc.
Page 267 Using WebLogic Workshop to Access Web Services BEA WebLogic Workshop opens. 2. Create a new application. a. From the File menu, select New and then, Application. b. In the upper-left pane, select all and then, select Empty Application. c. In the directory field, type C:\IWAYSRV.
Page 268: Calling A New Web Service For An Rfc
Web service class, the extension gives it special meaning in the context of the WebLogic Server. After you access the Remote Function Call (RFC), the New Web Service dialog box opens, and you can continue and call a Web service.
Page 269 Using WebLogic Workshop to Access Web Services 3. In the upper-left pane, select all and then, select Web Service in the right pane. a. In the name field, type RFC.jws. b. Click Create. The design view window opens. Web services expose their functionality through methods that clients invoke when they want to request something from the Web service.
Page 270 Using WebLogic Workshop to Access an SAP BAPI or an SAP RFC For more information on creating a WSDL file, see Chapter 4, Creating and Publishing Integration Business Services. The following opens. 6. To generate a Java Control file, right-click the RFC_CUSTOMER_GET.wsdl file and select Generate Service Control.
Page 271 Using WebLogic Workshop to Access Web Services 7. Drag the RFC.jcx file onto the JWSNAME Web service as follows: 8. Click the Source View tab to modify the source code and call the RFC Web service. 9. Add the following code to the source view: public void RFC_CUSTOMER_GET(RFCControl.RFC_CUSTOMER_GET input)
Page 272: Running The Jwsname Web Service From Weblogic Workshop
WebLogic Workshop. If WebLogic Server is running, a green ball appears. If WebLogic Server is not running, a red ball appears. If you see the red ball in the status bar, then start WebLogic Server, as described in the following procedure...
Page 273: Running The Jwsname Web Service For A Bapi
Using WebLogic Workshop to Access Web Services Running the JWSNAME Web Service for a BAPI The following procedure describes how to run the JWSNAME for a Business Application Programming Interface (BAPI). How to Run the JWSNAME Web Service for a BAPI...
Page 274 Running the JWSNAME Web Service From WebLogic Workshop After the SOAP request is sent to the Integration Business Services Engine (iBSE), the following response is returned: The previous sample is a very simple example of calling a Web service. You may want to perform more complex operations in your workflow.
Page 275: Calling Complex Operations In A Workflow For A Bapi
//used to store the execution time Calendar cal_start=Calendar.getInstance(TimeZone.getTimeZone("EST")); //creating a start calendar System.out.println("<<<< start: "+ cal_start.getTimeInMillis()); //Display the start time of execution to the WEBLOGIC CONSOLE BAPI_MATERIAL_GET_DETAILControl.BAPI(input); Calendar cal_end=Calendar.getInstance(TimeZone.getTimeZone("EST")); //create end calendar BEA WebLogic Adapter for SAP User’s Guide...
Page 276: Running The Jwsname Web Service For An Rfc
The following procedure describes how to run the JWSNAME for a Remote Function Call (RFC). You first must ensure that WebLogic Server is running. For more information on confirming that WebLogic Server is running, see Confirming WebLogic Server is Running and How to Start WebLogic Server.
Page 277 Using WebLogic Workshop to Access Web Services How to Run the JWSNAME Web Service for an RFC Procedure After you click the Start button on the tool bar to start the application, the following test window opens. 1. Click the Test XML tab to enter and test the XML stream to be passed to the Web service.
Page 278: Calling Complex Operations In A Workflow For An Rfc
Running the JWSNAME Web Service From WebLogic Workshop After the SOAP request is sent to the Integration Business Services Engine (iBSE), the following response is returned: The previous sample is a very simple example of calling a Web service. You may want to perform more complex operations in your workflow.
Page 279 //used to store the execution time Calendar cal_start=Calendar.getInstance(TimeZone.getTimeZone("EST")); //creating a start calendar System.out.println("<<<< start: "+ cal_start.getTimeInMillis()); //Display the start time of execution to the WEBLOGIC CONSOLE RFCControl.RFC_CUSTOMER_GET(input); Calendar cal_end=Calendar.getInstance(TimeZone.getTimeZone("EST")); //create end calendar System.out.println("<<<< end: "+ cal_end.getTimeInMillis());...
Page 280 Running the JWSNAME Web Service From WebLogic Workshop The results of the execution are saved in a file as follows: start time: 1073598362650 end time: 1073598362775 execution time : 125 C-22 BEA Systems, Inc.
Page 281: Sample Files And Coding Techniques
This section provides sample request and response documents sent between SAP and the • Sample RFC Request Document BEA WebLogic Adapter for SAP. It also includes a • Sample RFC Response Document sample RFC module and a sample wrapper module to call functions on remote destinations.
Page 282: Sample Rfc Request Document
Sample RFC Response Document The following sample code shows a sample RFC response document. <?xml version="1.0" ?> <doc:RFC_WALK_THRU_TEST.Response xmlns:doc="urn:sapcom:document:sap:business:rfc"> <TEST_OUT> <RFCFLOAT>0.0</RFCFLOAT> <RFCCHAR1></RFCCHAR1> <RFCINT2>0</RFCINT2> <RFCINT1>0</RFCINT1> <RFCCHAR4></RFCCHAR4> <RFCINT4>10</RFCINT4> <RFCHEX3>000000</RFCHEX3> <RFCCHAR2></RFCCHAR2> <RFCTIME>10:09:32</RFCTIME> <RFCDATE>2001-09-05</RFCDATE> <RFCDATA1>Hello World</RFCDATA1> <RFCDATA2></RFCDATA2> </TEST_OUT> <DESTINATIONS> </DESTINATIONS> <LOG> </LOG> </doc:RFC_WALK_THRU_TEST.Response> BEA Systems, Inc.
Page 283: Sample Idoc Xml For Message Type Debmas
<STATUS>30</STATUS> <DIRECT>1</DIRECT> <OUTMOD>2</OUTMOD> <EXPRSS></EXPRSS> <TEST></TEST> <IDOCTYP>DEBMAS01</IDOCTYP> <CIMTYP></CIMTYP> <MESTYP>DEBMAS</MESTYP> <MESCOD></MESCOD> <MESFCT></MESFCT> <STD></STD> <STDVRS></STDVRS> <STDMES></STDMES> <SNDPOR>SAPI46</SNDPOR> <SNDPRT>LS</SNDPRT> <SNDPFC></SNDPFC> <SNDPRN>I46_CLI800</SNDPRN> <SNDSAD></SNDSAD> <SNDLAD></SNDLAD> <RCVPOR>A000000018</RCVPOR> <RCVPRT>LS</RCVPRT> <RCVPFC></RCVPFC> <RCVPRN>SAMP</RCVPRN> <RCVSAD></RCVSAD> <RCVLAD></RCVLAD> <CREDAT>2001-09-04</CREDAT> <CRETIM>16:44:52</CRETIM> <REFINT></REFINT> <REFGRP></REFGRP> <REFMES></REFMES> <ARCKEY></ARCKEY> <SERIAL>20010904164452</SERIAL> </EDI_DC40> BEA WebLogic Adapter for SAP User’s Guide...
Page 284 <FAKSD></FAKSD> <FISKN></FISKN> <KNRZA></KNRZA> <KONZS></KONZS> <KTOKD>0001</KTOKD> <KUKLA></KUKLA> <LAND1>US</LAND1> <LIFNR></LIFNR> <LIFSD></LIFSD> <LOCCO></LOCCO> <LOEVM></LOEVM> <NAME1>Apple Corp</NAME1> <NAME2></NAME2> <NAME3></NAME3> <NAME4></NAME4> <NIELS></NIELS> <ORT01>Floral Park</ORT01> <ORT02></ORT02> <PFACH></PFACH> <PSTL2></PSTL2> <PSTLZ>10010</PSTLZ> <REGIO>NY</REGIO> <COUNC></COUNC> <CITYC></CITYC> <RPMKR></RPMKR> <SORTL>APPLE</SORTL> <SPERR></SPERR> <SPRAS>E</SPRAS> <STCD1></STCD1> <STCD2></STCD2> <STKZA></STKZA> <STKZU></STKZU> <STRAS>123 Main street</STRAS> BEA Systems, Inc.
Page 285 Sample Files and Coding Techniques <TELBX></TELBX> <TELF1></TELF1> <TELF2></TELF2> <TELFX></TELFX> <TELTX></TELTX> <TELX1></TELX1> <LZONE>0000000001</LZONE> <XZEMP></XZEMP> <VBUND></VBUND> <STCEG></STCEG> <GFORM></GFORM> <BRAN1></BRAN1> <BRAN2></BRAN2> <BRAN3></BRAN3> <BRAN4></BRAN4> <BRAN5></BRAN5> <UMJAH>0000</UMJAH> <UWAER></UWAER> <JMZAH>000000</JMZAH> <JMJAH>0000</JMJAH> <KATR1></KATR1> <KATR2></KATR2> <KATR3></KATR3> <KATR4></KATR4> <KATR5></KATR5> <KATR6></KATR6> <KATR7></KATR7> <KATR8></KATR8> <KATR9></KATR9> <KATR10></KATR10> <STKZN></STKZN> BEA WebLogic Adapter for SAP User’s Guide...
Page 286 Sample IDoc XML for Message Type DEBMAS <UMSA1>0</UMSA1> <TXJCD></TXJCD> <PERIV></PERIV> <KTOCD></KTOCD> <PFORT></PFORT> <DTAMS></DTAMS> <DTAWS></DTAWS> <HZUOR>00</HZUOR> <CIVVE>X</CIVVE> <MILVE></MILVE> <SPRAS_ISO>EN</SPRAS_ISO> <FITYP></FITYP>| <STCDT></STCDT> <STCD3></STCD3> <STCD4></STCD4> <XICMS></XICMS> <CFOPC></CFOPC> <TXLW1></TXLW1> <TXLW2></TXLW2> <CCC01></CCC01> <CCC02></CCC02> <CCC03></CCC03> <CCC04></CCC04> <CASSD></CASSD> <KDKG1></KDKG1> <KDKG2></KDKG2> <KDKG3></KDKG3> <KDKG4></KDKG4> <KDKG5></KDKG5> <NODEL></NODEL> <XSUB2></XSUB2> <WERKS></WERKS> BEA Systems, Inc.
Page 287 <KALKS>1</KALKS> <KDGRP></KDGRP> <BZIRK></BZIRK> <KONDA></KONDA> <PLTYP></PLTYP> <AWAHR>100</AWAHR> <INCO1></INCO1> <INCO2></INCO2> <LIFSD></LIFSD> <AUTLF></AUTLF> <ANTLF>9</ANTLF> <KZTLF></KZTLF> <KZAZU>X</KZAZU> <CHSPL></CHSPL> <LPRIO>00</LPRIO> <EIKTO></EIKTO> <VSBED>01</VSBED> <FAKSD></FAKSD> <MRNKZ></MRNKZ> <PERFK></PERFK> <PERRL></PERRL> <WAERS>EUR</WAERS> <KTGRD></KTGRD> <ZTERM></ZTERM> <VWERK></VWERK> <VKGRP></VKGRP> <VKBUR></VKBUR> <VSORT></VSORT> <KVGR1></KVGR1> <KVGR2></KVGR2> <KVGR3></KVGR3> <KVGR4></KVGR4> <KVGR5></KVGR5> BEA WebLogic Adapter for SAP User’s Guide...
Page 288 <RDOFF></RDOFF> <AGREL></AGREL> <MEGRU></MEGRU> <UEBTO>0.0</UEBTO> <UNTTO>0.0</UNTTO> <UEBTK></UEBTK> <PVKSM></PVKSM> <PODKZ></PODKZ> <PODTG> 0</PODTG> <E1KNVPM SEGMENT="1"> <MSGFN>005</MSGFN> <PARVW>AG</PARVW> <KUNN2>0000000001</KUNN2> <DEFPA></DEFPA> <KNREF></KNREF> <PARZA>000</PARZA> </E1KNVPM> <E1KNVPM SEGMENT="1"> <MSGFN>005</MSGFN> <PARVW>RE</PARVW> <KUNN2>0000000001</KUNN2> <DEFPA></DEFPA> <KNREF></KNREF> <PARZA>000</PARZA> </E1KNVPM> <E1KNVPM SEGMENT="1"> <MSGFN>005</MSGFN> <PARVW>RG</PARVW> <KUNN2>0000000001</KUNN2> <DEFPA></DEFPA> <KNREF></KNREF> <PARZA>000</PARZA> </E1KNVPM> BEA Systems, Inc.
Page 289: Collected Idocs
The following sample code uses a user-defined RFC module named Z_EVENT_DISPATCH. FUNCTION Z_01_EVENT_DISPATCH. CALL FUNCTION 'Z_EVENT_DISPATCH' DESTINATION 'IWAYDEST' EXPORTING EVENT = EVENT RECTYPE = RECTYPE OBJTYPE = OBJTYPE OBJKEY = OBJKEY TABLES EVENT_CONTAINER = EVENT_CONTAINER. ENDFUNCTION. BEA WebLogic Adapter for SAP User’s Guide...
Page 290: Sample Wrapper Module To Call Functions On Remote Destinations (Service
Programming manual, which is available at the following URL: http://service.sap.com The RFC Server program must return the data to SAP in a format that follows the exact structure of the Remote Function interface, or an abnormal ending occurs in SAP. D-10 BEA Systems, Inc.
Page 291 ERRORCODE = 4. EXIT. WHEN -5. ERRORCODE = 99999. EXIT. ENDCASE. * IF SY-SUBRC <> 0. *ERRORCODE = SY-SUBRC. * MESSAGE ID SY-MSGID TYPE SY-MSGTY NUMBER SY-MSGNO WITH SY-MSGV1 SY-MSGV2 SY-MSGV3 SY-MSGV4. *ENDIF. ENDFUNCTION. BEA WebLogic Adapter for SAP User’s Guide D-11...
Page 292: Using Staging Bapis To Retrieve Sap Bw Metadata
By using these BAPIs, you can connect metadata repositories and extraction engines to the SAP Business Information Warehouse. BEA WebLogic enables you to link these systems to the rest of the enterprise. For complete documentation on the individual data structures and individual BAPI calls, see Business Information Warehouse available at the following URL: http://service.sap.com...
Page 293 Sample Files and Coding Techniques 6. Start BEA WebLogic and configure a File event. When the XML document is placed into the specified file listener directory, BEA WebLogic automatically submits it to SAP for processing and returns the document with a list of all active InfoCubes from the SAP Business Warehouse.
Page 294 Using Staging BAPIs to Retrieve SAP BW Metadata D-14 BEA Systems, Inc.

BEA WebLogic User Manual

Quick Links

Troubleshooting

Need help?

Questions and answers

Related Manuals for BEA WebLogic

Summary of Contents for BEA WebLogic

Table of Contents