background image

Overview

2-2

BEA Systems, Inc.

Overview

SAP Remote Function calls require no system setup other than the Connection Target 
Parameters. If you do not intend to send IDocs to the SAP system, you may skip this chapter.

In inbound IDoc processing, the adapter reads an XML document and creates an SAP 
Standard format IDoc. The adapter can optionally transform incoming data into the 
standard format through XML transformation or SAP ALE transformation. After assembled 
as an IDoc, the file is sent to SAP for inbound processing. Multiple IDocs can also be 
assembled into a larger document for efficient processing. For more information, see the 
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. 
To store the parameters for processing of the IDoc messages, SAP requires a “logical 
system” entry for each transmission system. The Logical System stores type information 
about the Partner and the kind of messages expected from the partner. 

The Partner Profile defines the kind of message and the type of SAP function called to 
process that particular IDoc in an application. SAP also requires a filtering model, whether 
or not it is used for a particular message, called a Distribution Model that defines a message 
type and applies optional segment filters. After these are established, Inbound ALE/IDoc 
processing can begin.

The Control Section or reference structure file EDI_DC40 (defined in SAP R/3), must be 
completed and contains all the identifying information about the IDoc. The assembled 
header and data records are sent to SAP by the adapter. SAP does not require an incoming 
port to be specified. It takes the incoming RFC stream and assigns a port designation. In the 
Partner Profile, a function module must be identified to process the IDoc in the R/3 system.

Usually, IDocs are written directly to the database and slowly read by the application (for 
example, Purchasing for Purchase Orders). This can take time depending on the type of 
data and the application. The adapter can “post to the database and return” or “post and 
wait.” This is defined in the Partner Profile on the host system. In either case, you may send 
a status IDoc message to obtain the status of your IDoc or use appropriate transaction 
codes in SAP to view the IDocs online. 

You must perform the following steps to configure SAP for inbound IDoc processing:

1.

Configure a logical system.

2.

Configure a distribution model.

3.

Define an inbound partner profile.

Summary of Contents for WebLogic Server

Page 1: ...BEA WebLogic Adapter for SAP User s Guide DN3501342 0406 April 19 2006 ...

Page 2: ...e and software products by their trademarks In most if not all cases these designations are claimed as trademarks or registered trademarks by their respective companies It is not this publisher s intent to use any of these names generically The reader is therefore cautioned to investigate all claimed trademark rights before using any of these names other than to refer to the product described Copy...

Page 3: ...ionality of the adapter 2 Configuring SAP Inbound Processing Describes how to configure your SAP system for inbound client processing 3 Creating XML Schemas for SAP Describes how to create XML schemas for SAP business objects using Servlet Application Explorer 4 Creating and Publishing Integration Business Services Describes how to create and publish Integration Business Services using Servlet App...

Page 4: ...e events for SAP In addition this section provides information on using events in a clustered BEA WebLogic environment C Using WebLogic Workshop to Access Web Services Describes how to access Web services created for an SAP Business Application Programming Interface BAPI and an SAP Remote Function Call RFC using BEA WebLogic Workshop D Sample Files and Coding Techniques Provides sample request and...

Page 5: ...a com You can also contact Customer Support by using the contact information provided on the Customer Support Card which is included in the product package When contacting Customer Support be prepared to provide the following information Your name e mail address phone number and fax number Your company name and company address Your machine type and authorization codes The name and version of the p...

Page 6: ...in the column provided The following table lists the types of Application Explorer Specify the version and platform if different than listed previously in the columns provided In the following table specify the JVM version and vendor in the columns provided Platform Operating System OS Version Product List Adapters Adapter Deployment For example JCA or Integration Business Services Engine Containe...

Page 7: ...ion that produces the problem Did this happen previously Can you reproduce this problem consistently Any change in the application environment software configuration EIS database configuration application and so forth Under what circumstance does the problem not occur Describe the steps to reproduce the problem Describe the problem Specify the error message s XML schema XML instances Other input d...

Page 8: ...viii BEA Systems Inc ...

Page 9: ... Connector Architecture JCA 1 9 2 Configuring SAP Inbound Processing 2 1 Overview 2 2 Configuring a Logical System 2 3 Configuring a Distribution Model 2 6 Defining a Partner Profile 2 9 3 Creating XML Schemas for SAP 3 1 Overview 3 2 Starting Servlet Application Explorer 3 2 Establishing a Target for SAP 3 3 Creating a New Target 3 4 Connecting to a Target 3 10 Disconnecting From a Target 3 11 Mo...

Page 10: ...epositories 7 23 iBSE Repositories 7 24 JCA Repositories 7 28 Migrating Event Handling Configurations 7 28 Exporting or Importing Targets 7 33 Retrieving or Updating Web Service Method Connection Information 7 37 Starting or Stopping a Channel Programmatically 7 41 7 45 8 Understanding SAP Events 8 1 Overview 8 2 Related Concepts and Terminology 8 2 Client and Server Programs 8 2 SAP Gateway 8 2 P...

Page 11: ...ble CCI Control A 27 Overview A 27 Using the Extensible CCI Control A 27 B Using Application Explorer in BEA WebLogic Workshop for Event Handling B 1 Starting Application Explorer in BEA WebLogic WorkShop B 2 Understanding Event Functionality B 3 Creating an Event Port B 3 Modifying an Event Port B 16 Creating a Channel B 18 Modifying a Channel B 22 Deploying Components in a Clustered BEA WebLogic...

Page 12: ...FC Request Document D 2 Sample RFC Response Document D 2 Sample IDoc XML for Message Type DEBMAS D 3 Collected IDocs D 9 Sample RFC Module D 9 Sample Wrapper Module to Call Functions on Remote Destinations Service D 10 Using Staging BAPIs to Retrieve SAP BW Metadata D 12 ...

Page 13: ...ures of the BEA WebLogic Adapter for SAP SAP Certification SAP Business Components Integrating With SAP Understanding Web Services and Java Connector Architecture Functionality Component Information for the BEA WebLogic Adapter for SAP The following section provides an overview of the BEA WebLogic Adapter for SAP ...

Page 14: ...pplication Explorer a GUI tool that uses SAP object repository metadata to build XML schemas and Web services to handle adapter requests or event data Support for Remote Function Calls RFC Business Application Programming Interfaces BAPI and Intermediate Documents IDoc interfaces to SAP SAP Certification The BEA WebLogic Adapter for SAP provides state of the art middleware solutions for SAP Basis ...

Page 15: ...ersion 47x100 is supported on the SAP Web Application Server Versions 6 20 and 6 40 SAP R 3 Enterprise 47x200 SAP R 3 Enterprise Version 47x200 is supported on the SAP Web Application Server Versions 6 20 and 6 40 SAP Java Connector SAP JCo 2 1 6 Note For the current release status of the SAP Java Connector refer to SAP Note 549268 in the SAP Service Marketplace In addition the BEA WebLogic Adapte...

Page 16: ... not exist in your particular SAP system Therefore the examples included in this documentation may not be relevant to your system If this is the case you should use the examples as a general reference for adapter functionality and choose an RFC that exists within your SAP application environment As described in SAP Release Note 109533 SAP Function Modules RFCs can be delivered with different relea...

Page 17: ...return data either technical error information or a well formed response document IDocs are processed asynchronously The adapter is bidirectional and can process an event in SAP by receiving RFCs and IDocs directly from SAP The SAP system can be configured to send an IDoc or RFC to a logical system when a certain event occurs in this case to the adapter The output sent by SAP can be in any of the ...

Page 18: ... you know the function interface Web Services Example A Web service exposes the cup interface which provides a teacup The Acme Company exposes the tea Web service which provides a brown liquid when the correct parameter money is provided A cup of tea can be received by invoking the tea Web service and passing the money parameter Additional components are not required to receieve tea via the tea We...

Page 19: ...apter for SAP A description of Application Explorer the Integration Business Services Engine iBSE and the Enterprise Connector for J2EE Connector Architecture JCA follows the table Application Explorer Application Explorer uses an explorer metaphor to browse the SAP system for metadata The explorer enables you to create XML schemas and Web services for the associated object In addition you can cre...

Page 20: ...d 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 For more information see the BEA WebLogic ERP Installation and Configuration documentation Integrat...

Page 21: ...nnector 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 applicatio...

Page 22: ...Component Information for the BEA WebLogic Adapter for SAP 1 10 BEA Systems Inc ...

Page 23: ...1 CHAPTER 2 Configuring SAP Inbound Processing Topics Overview Configuring a Logical System Configuring a Distribution Model Defining a Partner Profile The following section describes how to configure your SAP system for inbound client processing ...

Page 24: ...le defines the kind of message and the type of SAP function called to process that particular IDoc in an application SAP also requires a filtering model whether or not it is used for a particular message called a Distribution Model that defines a message type and applies optional segment filters After these are established Inbound ALE IDoc processing can begin The Control Section or reference stru...

Page 25: ... as the unique ID This name is assigned explicitly to one client in an SAP system Procedure How to Configure a Logical System The following image shows the nsale transaction in the field under the menu bar To configure a logical system 1 Execute the sale transaction The Display IMG window opens as shown in the following image a Expand Sending and Receiving Systems and then Logical Systems b Select...

Page 26: ...ars that informs you that the table is cross client as shown in the following image 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 ...

Page 27: ...rresponding name as shown in the following image a In the Log System column type the Logical System for example IWAY_IN b In the Name column type a corresponding description 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 ...

Page 28: ...n the Request field type a name b In the Short description field type a brief description of your request 7 Click Save The logical system you configured for example IWAY_IN appears in the list as shown in the following image 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...

Page 29: ...ransaction in the field under the menu bar To configure a distribution model 1 Execute the bd64 transaction 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 ...

Page 30: ...eate Model View window opens and includes fields for the name of your distribution model and for Start and End dates as shown in the following image a In the Short text field type a model view name for example iway ale inbound b 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 retur...

Page 31: ...nfigured for example IWAY_IN b In the Receiver field type the logical system you configured for example IWAY_OUT c In the Message type field type the message type to use for example MATMAS To browse from a list of available message types you can click the icon to the right of the field 7 To enter the information click the checkmark You are returned to the main Change Distribution Model window 8 Cl...

Page 32: ...d under the menu bar To define a partner profile for a specific IDoc 1 Execute the we20 transaction 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 ...

Page 33: ...s the details of the expanded folder including the logical system and type language and so forth as shown in the following image 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 ...

Page 34: ...the Process code field enter the process code you want to use for example MATM c In the Processing by function module area select one of the following options 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 proces...

Page 35: ...section describes how to create XML schemas for SAP business objects using Application Explorer The functionality of Application Explorer is standard for any deployment type This section uses the 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 Works...

Page 36: ...lient access Application Explorer need not reside on the same system as the application system being accessed but network access is required Starting Servlet Application Explorer Before you can use the Servlet Application Explorer to browse metadata and create XML schemas you must start the BEA WebLogic Server Procedure How to Start BEA WebLogic Server on Windows To start the BEA WebLogic Server o...

Page 37: ...ighlighted in the left pane The Available Hosts drop down menu in the upper right lists the Connector for JCA or Servlet iBSE instance you can access 2 For more information on adding instances see BEA WebLogic ERP Adapter Installation and Configuration You are now ready to create new targets for SAP Establishing a Target for SAP To browse SAP business objects you must create a target for the syste...

Page 38: ... New Target The following image shows a window with a navigation pane on the left that lists supported adapters The right pane displays information about a selected adapter 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 ov...

Page 39: ...n appears as well as title and product version information for the adapter in the right pane as shown in the following image 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 ...

Page 40: ...nection parameters are consistent with those found in your SAP system For more information on parameter values that are specific to your SAP configuration consult your SAP system administrator The following tabs are available System Required User Required Advanced Security The System required tab enables you to provide the application server name system number and EDI version for the SAP system to...

Page 41: ...In the Client field type the client number defined for the SAP application for client communications b In the User field type a valid user ID for the SAP application c In the Password field type a valid password for the SAP application d In the Language field type a language key EN English is the default e In the Codepage field type a character code page value f To enable traces select the SAP tra...

Page 42: ...ws Exception so that code components may catch the exception and react accordingly If your application is document based you can select Creates Document to have an XML document created that contains the Java exception It is up to your application to read the XML document and obtain the error Commit with Wait All SAP Business Objects that change data must commit work to the database Some BAPI s dev...

Page 43: ...X 509 configuration see your SAP system documentation SNC mode By default SNC is disabled To enable SNC select 1 from the drop down list SNC partner Enter the name of the RFC server or message server load balancing that provides the SNC services SNC level Select the version of the SNC library from the drop down list SNC name Enter the name of the SNC library you are using SNC library path Enter th...

Page 44: ...expand the sap node and select the target you defined for example SAPTarget 2 In the right pane move the pointer over Operations The following image shows the target with a red x selected in the left pane In the right pane the Operations menu appears in its expanded form 3 Select Connect The following graphic shows the Connect to SAPTarget pane that opens on the right with fields to enter a client...

Page 45: ...sappears to reflect that a connection was made as shown in the following image 5 Expand the SAPTarget node The following SAP business objects appear Business Object Repository Remote Function Modules 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 ...

Page 46: ...e target selected in the left pane In the right pane the Operations menu appears expanded to display options 3 Select Disconnect Disconnecting from the application system drops the connection but the node remains 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 us...

Page 47: ...he Edit pane opens on the right with the target name a description and a target type selected from the drop down list as shown in the following image 3 Modify the connection information 4 To continue modifying additional information click Next 5 When you are finished making all of your edits click Finish Deleting a Target In addition to closing a target you can delete a target that is no longer re...

Page 48: ...tion Explorer enables you to explore and browse business object metadata For example Application Explorer enables you to view SAP BAPI RFC and iDoc metadata stored in the SAP Business Object repository Note Depending on the release or service pack installed certain RFCs for example RFC_CUSTOMER_GET may not exist in your particular SAP system Therefore the examples included in this documentation ma...

Page 49: ...e list under Business Object Repository click the icon next to Financial Accounting A list of business objects related to Financial Accounting appears in the left pane In the right pane the collapsed Operations menu and a table listing properties and values for the BAPI method named BAPI_COMPANY_GETLIST appears as shown in the following image a Scroll down and click the icon next to the Company bu...

Page 50: ...e available from the context menu Help provides information about BAPI RFC and IDoc usage Test Run simulates running the selected RFC or BAPI with sample data you provide Use Biztalk Schemas sets the default for schema output that is used by Microsoft Biztalk Create Integration Business Services creates Web services for the SAP business object you selected Create Event Port creates a port to be us...

Page 51: ...te XML request and response schemas for the SAP BAPI method called BAPI_MATERIAL_GETLIST 1 In the Business Object Repository select the GetList method In the right pane the collapsed Operations menu and a table listing properties and values for the 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 Generat...

Page 52: ...llowing 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 ...

Page 53: ...e 4 To return to the previous window click the Back button on your Web browser After you browse the list of business objects on your SAP system you can create 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 ...

Page 54: ...Creating an XML Schema 3 20 BEA Systems Inc ...

Page 55: ...w to create and publish Integration Business Services using Application Explorer The functionality of Application Explorer is standard for any deployment type This section uses the 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 X...

Page 56: ... in any format After you browse the SAP business object repository and create an XML schema for the object you can generate an Integration Business Service for the object you wish to use with your adapter Creating Integration Business Services The following topics describe how to create Integration Business Services including how to generate WSDL Web Services Description Language from a Web servic...

Page 57: ... BEA WebLogic Adapter for SAP User s Guide 4 3 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 ...

Page 58: ...Creating Integration Business Services 4 4 BEA Systems Inc The Operations menu expands as shown in the following image to display options ...

Page 59: ...es The Create Web Service for BAPI_MATERIAL_GETLIST pane opens on the right with options to create a new service or use an existing service 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 ...

Page 60: ...optional c In the License field select the license definition you want to use 5 Click Next A second Create Web Service pane opens on the right that includes fields for the method name and a description as shown in the following image a 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 ...

Page 61: ...left pane The Material_List service node is expanded and the GETLIST method is automatically selected The test pane for the GETLIST method opens in the right pane 7 Enter an XML instance of the schema you generated previously for the SAP business component The document queries the service in the input xml field To use the identical sample input XML illustrated in this example see Sample Integratio...

Page 62: ...Creating Integration Business Services 4 8 BEA Systems Inc The result appears in the right pane as shown in the following image ...

Page 63: ...om document sap business xmlns xsi http www w3 org 2001 XMLSchema instance xsi schemaLocation urn sap com document sap business C temp service_BAPI_MATERIAL_GETLIST xsd MAXROWS 1000 MAXROWS DISTRIBUTIONCHANNELSELECTION item SIGN OPTION DISTR_CHAN_LOW DISTR_CHAN_HIGH item DISTRIBUTIONCHANNELSELECTION MANUFACTURERPARTNUMB item MANU_MAT MFR_NO item MANUFACTURERPARTNUMB MATERIALSHORTDESCSEL item SIGN ...

Page 64: ...NT_LOW PLANT_HIGH item PLANTSELECTION RETURN item TYPE ID NUMBER MESSAGE LOG_NO LOG_MSG_NO MESSAGE_V1 MESSAGE_V2 MESSAGE_V3 MESSAGE_V4 PARAMETER 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 ...

Page 65: ...1 Click the Integration Business Services tab 2 To view the service for which you want to generate WSDL in the left pane expand the list of services 3 Select the service for example Material_List The following image shows Material_List service selected in the left pane The link for the service appears in the right pane a Right click the Service Description link b Select Save Target As 4 Choose a l...

Page 66: ...s iwaysoftware com iwse elementFormDefault qualified xs element name ibsinfo xs complexType xs sequence xs element type xs string name service xs element type xs string name method xs element type xs string name license xs element type xs string minOccurs 0 name disposition xs element type xs string minOccurs 0 name Username xs element type xs string minOccurs 0 name Password xs element type xs st...

Page 67: ... name VALUATIONAREA xs simpleType xs restriction base xs string xs maxLength value 4 xs restriction 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 jul2...

Page 68: ...exType xs element xs complexType name BAPIMATDOC xs sequence xs element name PUR_GROUP xs simpleType xs restriction base xs string xs maxLength value 3 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 e...

Page 69: ...element name CURRENCY xs simpleType xs restriction base xs string xs maxLength value 5 xs restriction xs simpleType xs element xs element name CURRENCY_ISO xs simpleType 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...

Page 70: ... string xs maxLength value 2 xs restriction xs simpleType xs element xs element name MATL_GROUP xs simpleType 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 str...

Page 71: ...xs simpleType xs restriction base xs string xs maxLength value 4 xs restriction xs simpleType xs element xs element name CONTAINER xs simpleType xs restriction base xs string 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 si...

Page 72: ...ype xs restriction base xs string xs maxLength value 32 xs restriction xs simpleType xs element 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...

Page 73: ...s element xs element name WIDTH xs simpleType xs restriction base xs string xs maxLength value 13 xs restriction xs simpleType xs element xs element name HEIGHT xs simpleType 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 ...

Page 74: ... element xs element name VOLUMEUNIT_ISO xs simpleType xs restriction base xs string xs maxLength value 3 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 ...

Page 75: ...ngth value 2 xs restriction xs simpleType xs element xs element name EMPTIESBOM xs simpleType xs restriction base xs string xs maxLength value 1 xs restriction xs simpleType xs element 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 eleme...

Page 76: ...MSG_NO xs simpleType xs restriction base xs string xs maxLength value 6 xs restriction xs simpleType 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 MESSAG...

Page 77: ...ATERIAL_GET_DETAILSoap operation name BAPI documentation input message tns BAPIIn output message tns BAPIOut fault message tns AdapterException name AdapterExceptionFault operation portType 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 soapAct...

Page 78: ...to connect to SAP The user name and password values that you provided for SAP when you created a target using Application Explorer are overwritten for this Web service request 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 Stri...

Page 79: ...g This section describes how to use Application Explorer to connect to SAP and listen for events The functionality of the Application Explorer is standard despite the deployment type This section uses the Java servlet implementation of Application Explorer to provide graphic examples For information on running Application Explorer in WebLogic Workshop see Appendix B Using Application Explorer in B...

Page 80: ...k Port A port associates a particular business object exposed by an adapter with a particular disposition A disposition defines the protocol and location of the event data The port defines the end point of the event consumption For more information see Creating Editing or Deleting a Port on page 5 2 Channel A channel represents configured connections to particular instances of back end or other ty...

Page 81: ...wing dispositions are available when using Application Explorer in conjunction with a JCA connector implementation File HTTP JMS Queue MQ Series 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 ...

Page 82: ...ystems Inc 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 ...

Page 83: ... Guide 5 5 The Create Event Port pane opens on the right as shown in the following image a 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 ...

Page 84: ...following format ifile location errorTo errorDest When pointing Application Explorer to a JCA deployment specify the destination file using the following format location The following table lists and describes the disposition parameters for File For example ifile c temp SAPEvent txt errorTo ifile c temp error 6 Click Finish Parameter Description location Full directory path and file name to which ...

Page 85: ...click SchemaLink You are now ready to associate the event port for File with a channel For more information see Creating Editing or Deleting a Channel on page 5 16 Procedure How to Create a Port for the iBSE Disposition The iBSE disposition enables an event to launch an Integration Business Services method To create a port for an iBSE disposition using Application Explorer 1 Click the Event Adapte...

Page 86: ...e a Port for the MSMQ Disposition The MSMQ disposition supports public and private queues To create a port for an MSMQ 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 The Create New Port pane opens on the right a In the Name field type a name Parameter D...

Page 87: ... queue 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 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 Parameter Description host Name of the host on which th...

Page 88: ...y The following table lists and describes the parameters for the disposition Parameter Description queue JNDI name of a queue to which events are emitted Connection Factory A resource that contains information about the JMS Server The WebLogic connection factory is javax jms QueueConnectionFactory jndiurl The URL to use to contact the JNDI provider The syntax of this URL depends on which JNDI prov...

Page 89: ...Description field type a brief description optional c 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 jndifactory I...

Page 90: ...rvice Is the name of the Web service you created using Application Explorer To find this value you can navigate to the Integration Business Services tab and open the Service Description link in a new window The WSDL URL appears in the Address field Alternatively you can open the WSDL file in a third party XML editor for example XMLSPY and view the SOAP request settings soapaction Method that is ca...

Page 91: ...ocol drop down list select HTTP d In the Disposition field enter an HTTP destination When pointing Application Explorer to an iBSE deployment specify the destination file using the following format ihttp url responseTo respDest When pointing Application Explorer to a JCA deployment specify the destination file using the following format http host port uri The following table lists and describes th...

Page 92: ...ld type a name b In the Description field type a brief description optional c From the Disposition Protocol drop down list select MQSeries d In the Disposition field enter an MQSeries destination When pointing Application Explorer to an iBSE deployment specify the destination file using the following format mqseries qManager qName host hostname port port channel channnelname errorTo pre defined po...

Page 93: ...n the right with fields where you can modify the description disposition protocol and disposition of the port as shown in the following image You cannot change the port name 3 Make the required changes to the event port configuration fields and click OK port Number to connect to an MQ Server queue manager MQ client only channel Case sensitive name of the channel that connects with the remote MQ Se...

Page 94: ... To delete the event port you selected click OK The event port disappears from the list in the left pane Creating Editing or Deleting a Channel The following procedures describe how to create edit or delete a channel for your event adapter as well as how to start or stop a channel All defined event ports must be associated with a channel You can create a channel using Servlet Application Explorer ...

Page 95: ...f adapters that support events appears in the left pane as shown in the following image 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 ...

Page 96: ...for example TEST_CHANNEL b In the Description field type a brief description optional c From the Channel Type drop down list select SAP Channel App Server 5 Click Next 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 ...

Page 97: ...g 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 Parameter Description Gateway host Host name of the SAP gateway Gateway service Service of the SAP gateway Program ID of the server Program ID of the registered server program Note The program ID of the server is case sensiti...

Page 98: ...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 Parameter Description Client Client number defined for the SAP system for client communications User Valid user ID for the SAP system Password Valid password for the SAP system Languag...

Page 99: ...the SAP payload of an event document 7 Click Next Parameter Description IDOC Format The IDoc format to use for the channel you are creating Possible values include SAP IFR IDOC XML Default FLAT IDOC User Defined Function Modules Path on the file system that points to your user defined function module A user defined function module is used as a data source SAP trace Select this option to enable SAP...

Page 100: ...ct an event port from the list of current ports b To transfer the port to the list of available ports click the single left arrow button or to associate all event ports click the double left arrow button 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 imag...

Page 101: ...h the channel description channel status and available ports as shown in the following image All the information is associated with the channel you created The X over the icon indicates that the channel is currently disconnected 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 Sta...

Page 102: ... channel at any time move the pointer over Operations and select Stop the channel Procedure How to Edit a Channel To edit an existing channel 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 ...

Page 103: ...ue editing information on the other tabs click Next 5 When you complete your edits click Finish Procedure How to Delete a Channel To delete an existing channel 1 In the left pane select the channel you want to delete 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 confirma...

Page 104: ...sing Application Explorer To configure synchronous event processing 1 Create a Web service for an SAP Remote Function Module for example BAPI_MATERIAL_GETLIST 2 View the WSDL file 3 In the Create New Port pane create a port using the SOAP disposition a In the Name field type a name b In the Description field type a brief description optional c From the Disposition Protocol drop down list select SO...

Page 105: ...host 7001 ibse IBSEServlet test webservice ibs wsdl where webservice Is the name of the Web service you created using Application Explorer To find this value you can navigate to the Integration Business Services tab and open the Service Description link in a new window The WSDL URL appears in the Address field Alternatively you can open the WSDL file in a third party XML editor for example XMLSPY ...

Page 106: ...r tabs b In the Advanced tab from the Processing Mode drop down list select REQUEST_RESPONSE 5 Associate the port you created earlier with the new channel 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 ...

Page 107: ... describe how Integration Business Services policy based security works and how to configure it using the Servlet Application Explorer Before you can configure 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 BE...

Page 108: ...ces The goal is to secure requests at both the transport and the SOAP request level that are transmitted on the wire Some policies do not deal with security issues directly but affect the run time behavior of the business services to which they are applied The Integration Business Services Engine iBSE administrator creates an instance of a policy type names it associates individual users and or gr...

Page 109: ...type controls connection access to Integration Business Services Engine iBSE and therefore need not be applied to an individual business service You need not create a policy however you must enable the 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 disa...

Page 110: ... right pane move the pointer over Operations and select Add 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 ...

Page 111: ...escription identifying that a new user was added to the configuration as shown in the following image Procedure How to Create a Group to Associate With a Policy 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 ...

Page 112: ... for the group b In the Description field type a description for the group optional 3 Click Next The Modify Group Membership pane opens where you can move users between the Current and Available lists as shown in the following image 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 use...

Page 113: ...tion identifying that a new group was added to the configuration as shown in the following image Procedure How to Create an Execution Policy To create an execution policy 1 Open Servlet Application Explorer a Click the Integration Business Services tab b 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...

Page 114: ...pane opens as shown in the following image a In the Name field type a name for the policy b From the Type drop down list select Execution c 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 ...

Page 115: ...he user ID element of the SOAP header sent to iBSE in a SOAP request 5 Click Next The following image shows the Modify policy permissions pane that opens and includes drop down lists where you can select to grant or deny permission to members 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 Permi...

Page 116: ...es a definition of policies and the name type and description of the policies as shown in the following image 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 ...

Page 117: ...he type of restriction b In the IP Mask Domain field type the IP or domain name using the following guidelines If you select Single Computer from the Type drop down list you must provide the IP address for that computer If you only know the DNS name for the computer click DNS Lookup to obtain the IP Address based on the DNS name If you select Group of Computers you must provide the IP address and ...

Page 118: ...es Policy Based Security 6 12 BEA Systems Inc 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 ...

Page 119: ...evels Configuring Connection Pool Sizes Migrating Repositories Exporting or Importing Targets Retrieving or Updating Web Service Method Connection Information Starting or Stopping a Channel Programmatically After you create services and events using Application Explorer you can use management and monitoring tools to measure the performance in your run time environment This section describes how to...

Page 120: ...s To configure monitoring settings 1 Ensure that your Application Server is started 2 To access the monitoring console enter the following URL in your Web browser http hostname port ibse IBSEConfig where hostname Is the machine where the application server is running port Is the HTTP port for the application server The iBSE Settings window opens as shown in the following image It consists of three...

Page 121: ...tains a drop down list for selecting the repository type fields to type information for the repository URL driver user and password and a check box where you can enable repository pooling 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 ...

Page 122: ...ort Is the HTTP port for the application server The iBSE Monitoring Settings window which is divided into two panes opens as shown in the following image At the bottom of the window is a row of command buttons that enable you to save your configuration view events or view services The Save History button is inactive a In the Monitoring pane from the Repository Type drop down list select the type o...

Page 123: ...hen stop monitoring to enable this option g From the drop down list select the maximum number of messages to store By default 10 000 is selected Note Depending on your environment and the number of messages that are exchanged storing a large number of messages may affect system performance If you require more information about your system resources consult your system administrator h Click Save Co...

Page 124: ...owing image The Web Service Methods pane contains a drop down list where you select a service On the right space is reserved for a drop down list of methods that will appear The Statistics pane contains a table with a summary of service statistics and two drop down lists where you can select a successful or failed invocation to view more information about that service At the bottom of the window i...

Page 125: ...r of errors encountered Average Request Size Average size of an available service request Average Response Size Average size of an available service response Average Execution Time Average execution time for a service Last Execution Time Last execution time for a service Average Back End Time Average back end time for a service Last Back End Time Last back end time for a service Successful Invocat...

Page 126: ...on the right where you select a service method The Statistics pane contains a table with a summary of service statistics and two drop down lists To view more information about that service you can select it from the 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 yo...

Page 127: ...on the left where you select a service and a drop down list on the right where you select a service method The Statistics pane contains a table with a summary of service statistics and two drop down lists To view more information about that service you can select it from the Successful Invocations or Failed Invocations drop down list To suspend or resume a service you can click a button in the low...

Page 128: ...ens as shown in the following image The Message Information pane contains a table of information about the message The Client Information pane contains a table of information about the client The Detail pane contains a table that shows the size of the request and response messages 7 To view the XML request document in your Web browser click Request Message You can also view the XML response docume...

Page 129: ...w opens as shown in the following image The Channels pane contains a drop down list on the left where you select a channel On the right space is reserved for a drop down list of ports that will appear The Statistics pane contains a table with a summary of event statistics and two drop down lists where you can select a successful or failed event to view more information about that event In the lowe...

Page 130: ...erage Event Size Average size of an available event request Average Event Reply Size Average size of an available event response Average Delivery Time Average delivery time for an event Last Delivery Time Last delivery time for an event Successful Events Successful events arranged by correlation ID To retrieve more information for an event select the event from the drop down list Failed Events Fai...

Page 131: ... a drop down list on the right where you select a port The Statistics pane contains a table with a summary of event statistics and two drop down lists where you can select a successful or failed event to view more information about that event 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 win...

Page 132: ... drop down list on the left where you select a channel and a drop down list on the right where you select a port The Statistics pane contains a table with a summary of event statistics and two drop down lists where you can select a successful or failed event to view more information about that event In the lower right of the window is a button to click to suspend or resume a channel and a home but...

Page 133: ...wn list The Event Level Statistics Message Statistics window opens as shown in the following image The Message Information pane contains a table of information pertaining to the event message 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 wind...

Page 134: ...Manage and Monitor Services Using the JCA Test Tool To manage and monitor services using the JCA Test Tool 1 Open a Web browser to http hostname port iwjcaivp where hostname Is the name of the machine where your application server is running port Is the port for the domain you are using The port for the default domain is 7001 for example http localhost 7001 iwjcaivp The following image shows the J...

Page 135: ...ory for redeployment b Redeploy the JCA connector c In the JCA Test Tool click Refresh Connection Factory after redeployment 3 Click Service adapters 4 Select a service adapter to monitor a Click the desired target for your service adapter b In the Request area enter a user name and password c In the Input Doc area enter a request document created from the request schema for your service 5 Click S...

Page 136: ...pane contains a description of the function of the tool and configuration information including options to change your connection settings It also provides options for viewing service or event adapters The JCA Test Tool runs in managed mode by default 2 To monitor the latest event adapter configuration perform the following steps Note You must perform these steps for every new adapter target that ...

Page 137: ...monitor 5 Click the desired channel for your event adapter 6 Click start The following image shows the updated statistics for your channel and the port The statistics include the total number of requests successes and errors and the average and last execution time in milliseconds The upper right of the pane contains options to start or refresh the channel ...

Page 138: ... Servlet iBSE 1 Open the Servlet iBSE configuration window at http hostname port ibse IBSEConfig where hostname Is the name of the machine where your application server is running port Is the port for the domain you are using The port for the default domain is 7001 for example http localhost 7001 ibse IBSEConfig 2 In the System pane from the Debug drop down list select the level of tracing 3 Click...

Page 139: ...g property name config property type java lang String config property type config property value config property value config property For example config property value DEBUG config property value Leave the remainder of the file unchanged 4 Save the file and exit the editor 5 Add the file back to the iwafjca rar file 6 Redeploy the connector A directory in the configuration directory contains the ...

Page 140: ...t 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 jndi name eis IWAFConnectionFactory jndi name pool params initial capacity 0 initial capacity max capacity 10 max capaci...

Page 141: ...agement purposes you can migrate iBSE and 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 File Repositories To migrate a File repository to another destination you copy the ibserepo xml file...

Page 142: ...tallation 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 For more information see Migrating Event Handling Configurations on page 1 1 Procedure How to Migrate an iBSE Repository Configured for Oracle To migrate an iBSE repository that is configur...

Page 143: ...ocation dialog box opens as shown in the following image where you enter a local path or URL The dialog includes Browse Window OK and Cancel buttons 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 ...

Page 144: ...that opens with the structure of the SOAP envelope It includes information about location and schemas 7 Locate the Text view icon in the tool bar 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 ...

Page 145: ...e the default Oracle JDBC driver is used c For the m ruser tag replace the String placeholder with a valid user name to access the Oracle repository d For the m rpwd tag replace the String placeholder with a valid password to access the Oracle repository 10 Perform one of the following migration options If you want to migrate a single Web service from the current iBSE repository enter the Web serv...

Page 146: ... in a new JCA configuration directory to migrate the existing repository Your JCA repository migrates to the new JCA configuration directory Migrating Event Handling Configurations This topic describes how to migrate your iBSE repositories at a database level for Microsoft SQL Server 2000 Oracle Sybase or DB2 You can use this information to migrate event handling information for example port or ch...

Page 147: ...listed by name in one column with corresponding columns for information about owner type and the date the table was created 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 F...

Page 148: ...in the following files For Oracle 8 iwse ora For Oracle 9 iwse ora9 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 3 To migrate the tables that were created by the...

Page 149: ...create the repository tables in the following file sybase iwse sql 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 3 To migrate the tables that were created by the ...

Page 150: ...ository tables in the following file db2 iwse sql 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 You can migrate the tables that were created by the SQL script for iBSE ...

Page 151: ...n Explorer URL for example http localhost 7777 ibse IBSEServlet admin iwae ibs wsdl 2 Open a third party XML editor for example XMLSPY The following image shows the XMLSPY window The upper left has a Project pane that contains a tree of sample files and the lower left has a blank Info pane The middle pane is blank The right side is divided into three blank panes 3 From the SOAP menu select Create ...

Page 152: ...can be deleted from the SOAP envelope 9 Locate the following section m EXPORTTARGET xmlns m urn schemas iwaysoftware com dec2002 iwse af m target String m target m name String m name m EXPORTTARGET a For the m target tag replace the String placeholder with the EIS target system name as it appears in Application Explorer and verify whether this value is case sensitive b For the m name tag replace t...

Page 153: ...ject pane that contains a tree of sample files and the lower left has a blank 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 4 In the Choose a file field paste the iBSE administrative services for Application Explorer URL and click OK The soap operation name dialog box o...

Page 154: ...AQCAEMmCZtuMFQxDS8b m contents m targetinstance m IMPORTTARGET a For the m target tag replace the String placeholder with the EIS target system name b For the m name tag replace the String placeholder with the new name of the target you want to import c For the m description tag replace the String placeholder with a description of the target d For the m repositoryid tag copy and paste the contents...

Page 155: ...URL for example http localhost 7777 ibse IBSEServlet admin iwconfig ibs wsdl 2 Open a third party XML editor for example XMLSPY The following image shows the XMLSPY window The upper left has a Project pane that contains a tree of sample files and the lower left has a blank Info pane The middle pane is blank The right side is divided into three blank panes 3 From the SOAP menu select Create new SOA...

Page 156: ... and can be deleted from the SOAP envelope 8 Locate the following section m GETMTHCONNECTION xmlns m urn schemas iwaysoftware com jul2003 ibse config m servicename String m servicename m methodname String m methodname m GETMTHCONNECTION a For the m servicename tag replace the String placeholder with the name of the Web service b For the m methodname tag replace the String placeholder with name of ...

Page 157: ...window The upper left has a Project pane that contains a tree of sample files and the lower left has a blank 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 4 In the Choose a file field paste the iBSE configuration service URL and click OK The soap operation name dialog b...

Page 158: ...me String m methodname m descriptor format channel m option title m group title m param m group m option m descriptor m SETMTHCONNECTION a For the m servicename tag replace the String placeholder with the name of the Web service b For the m methodname tag replace the String placeholder with the name of the Web service method c For the m descriptor tag copy and paste the contents of the m descripto...

Page 159: ...lly 1 Copy the iBSE control event URL for example http localhost 7777 ibse IBSEServlet admin iwevent ibs wsdl 2 Open a third party XML editor for example XMLSPY The following image shows the XMLSPY window The upper left has a Project pane that contains a tree of sample files and the lower left has a blank Info pane The middle pane is blank The right side is divided into three blank panes 3 From th...

Page 160: ...e structure of the SOAP envelope 6 Locate the Text view icon in the tool bar 7 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 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 SO...

Page 161: ... 7777 ibse IBSEServlet admin iwevent ibs wsdl 2 Open a third party XML editor for example XMLSPY The following image shows the XMLSPY window The upper left has a Project pane that contains a tree of sample files and the lower left has a blank 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 locatio...

Page 162: ...he structure of the SOAP envelope 6 Locate the Text view icon in the tool bar 7 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 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 SOA...

Page 163: ...Management and Monitoring BEA WebLogic Adapter for SAP User s Guide 7 45 ...

Page 164: ...7 46 BEA Systems Inc ...

Page 165: ...erminology Registering Your Program ID in SAPGUI Testing the SAP Event Adapter Application Link Enabling Configuration for the Event Adapter Testing the SAP ALE Configuration The following topics provide an overview of event functionality in SAP and describe how to configure and test your SAP system for event processing ...

Page 166: ...es of RFC programs are RFC Client RFC Server The RFC client is the instance that calls the RFC to execute the function that is provided by an RFC server The functions that can be executed remotely are called RFC functions and the functions provided by the 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 regist...

Page 167: ...AP sends one request to one listener and the next to another listener and so on The SAP Gateway Server includes a load balancing algorithm This mechanism is proprietary to SAP application development and may work by comparing total throughput of the connection the number of times in wait state and so on This means connection 1 may receive nine messages and connection 2 may receive one message If f...

Page 168: ... 4 BEA Systems Inc 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 ...

Page 169: ...ut the RFC destination as shown in the following image a In the RFC destination field type a name for example IWAYDEST The value you type in this field is case sensitive b 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 ...

Page 170: ...he SAP Event Adapter In the SAP Server the SE37 transaction enables you to send RFCs Remote Function Calls or BAPIs Business Application Programming Interfaces to any RFC destination For more information on RFC destinations see Registering Your Program ID in SAPGUI on page 8 3 Note Depending on the release or service pack installed certain RFCs may not exist in your particular SAP system Therefore...

Page 171: ...ule for example RFC_CUSTOMER_GET The following image shows the Function Builder Initial Screen where you can select to display change or create a function module RFC_CUSTOMER_GET is selected a 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 m...

Page 172: ...ansferred 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 To configure an SAP system to send IDocs to the SAP event adapter you use the ALE Application Link Enabling configuration to 1 Register your program ID in SAPGUI Fo...

Page 173: ... 8 11 5 Create a distribution model for the partner and message type You create a distribution model for the partner and message type you designated For more information see How to Create a Distribution Model for the Partner and Message Type on page 8 13 6 Test the SAP event adapter For more information see Testing the SAP ALE Configuration on page 8 16 Procedure How to Define a Port To define a p...

Page 174: ...e of the system generated RFC port Procedure How to Create a Logical System To create a logical system called IWAYLOG 1 In the ALE Configuration enter the area menu selection SALE transaction 2 Select SAP Reference IMG 3 Expand the following nodes Basis Components Application Link Enabling ALE Sending and Receiving Systems Logical Systems and Define Logical System 4 Click the green check mark besi...

Page 175: ...g System and Name for adding new log systems a Type an entry for Log System for example IWAYLOG b In the Name column type a name description for the partner profile 6 Save the session 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 ...

Page 176: ...pe enter USER 3 For Agent enter the current user ID or you may select another agent type 4 Under the outbound parameter table control select Create outbound parameter Partn type is LS Message type is DEBMAS the IDoc document type 5 Leave Partn funct blank 6 Click the Outbound options tab a Depending on your performance requirements click Transfer IDoc Immed or Collect IDocs b For the IDoc type a m...

Page 177: ...n IDoc for each header record in the collected IDoc file and duplicates the data for each IDoc Make sure the DOCNUM field is included in the EDI_DC40 structure and that each IDoc has a unique sequence number within the collected IDoc file Procedure How to Create a Distribution Model for the Partner and Message Type To create a distribution model called IWAYMOD 1 In the SAP Workbench choose Tools A...

Page 178: ... pane as shown in the following image 5 In the Distribution Model tree select a new model view 6 At the right in the button bar select Add message type The Add Message Type pane opens and displays the name of the model view It includes fields for specifying the sender and receiver of the message as well as the message type as shown in the following image a In the Sender field provide the sender th...

Page 179: ... c In the Message type field provide the type of IDoc for example DEBMAS 7 Click the check mark icon 8 Click the Save button The Change Distribution Model window opens and displays the new model view to use to send message type 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 ...

Page 180: ...includes fields for Customer Class Output type and Logical system The Parallel processing pane includes a field for Server group and a field for the number of customers per process To test the SAP Application Link Enabling ALE configuration 1 In the Send Customers window type the IDoc message type DEBMAS in the Output type field 2 In the Logical system field type the logical system for example IWA...

Page 181: ...Multiple Events Using Identical Program IDs Configuring multiple events in BEA WebLogic that use the same SAP Program ID enables you to load balance SAP event data over multiple adapter event consumers However when configuring each event all the event parameters for each event must match precisely If one of the event configuration parameters for example log level is different for one of the events...

Page 182: ...tch the schema for that channel For example only Doc A events that appear on the first channel are received and Doc B events that appear on the second channel are received Doc B events that appear on the first channel are rejected because they do not pass schema type validation The same result occurs for Doc A events that appear on the second channel This usage consideration applies to all support...

Page 183: ...Error Messages in Application Explorer Error Messages in SAP Error Messages in JCA Error Messages in iBSE The following topics explain limitations and workarounds when connecting to SAP The adapter specific errors described in this section can arise whether you are using the adapter with a JCA or with an iBSE configuration ...

Page 184: ...ibselogs The log file for Application Explorer can be found under the following directory C Program File iWay55 tools iwae bin Error Messages in Application Explorer The following table lists errors and solutions when using Application Explorer with the adapter Error Solution Cannot connect to the adapter from Application Explorer Ensure that SAP is running The Server name System Number and Client...

Page 185: ...ibi sapr3 SapAdapterException com sap mw jco JCO Exception 102 RFC_ERROR_COMMUNICATION Connect to SAP gateway failed Connect_PM GWHOST isdsrv8 GWSERV sapgw00 ASHOST isdsrv8 SYSNR 00 LOCATION CPIC TCP IP on local host ERROR partner not reached host isdsrv8 service 3300 TIME Fri Aug 27 11 49 14 2004 RELEASE 620 COMPONENT NI network interface VERSION 36 RC 10 MODULE ninti c LINE 979 DETAIL NiPConnect...

Page 186: ...a library path Ensure that you added the sapjcorfc dll file to the lib directory and the librfc32 dll file to the Windows system32 folder The DLL is loaded in another class loader iBSE and JCA are installed on the same server The following error message appears com ibi sapr3 SapAdapterException java lang ExceptionInInitializerEr ror JCO classInitialize Could not load middleware layer com sap mw jc...

Page 187: ...ure the Object type is correct When executing a request the following error message appears AdapterException java lang Exception Unable to retrieve BAPI name for CUSTOMER DETAIL2 Check the syntax of your input XML document and ensure the name of the BAPI is correct and is available in SAP When executing a request the following error message appears java lang RuntimeException com sap mw jco JCO Aba...

Page 188: ...his topic explains what to expect when you encounter the more common error conditions on an adapter specific basis Usually the SOAP gateway agent inside iBSE passes a SOAP request message to the adapter required for the Web service If an error occurs the way it is exposed depends on the adapter and the API or interfaces that the adapter uses A few scenarios cause the SOAP gateway to generate a SOA...

Page 189: ...n iBSE produces a SOAP fault element in the generated SOAP response The SOAP fault element contains fault code and fault string elements The fault string contains the native error description from the adapter target system Because adapters use the target system interfaces and APIs whether an exception is raised depends on how the target systems interface or API treats the error condition If a SOAP...

Page 190: ...ption faultstring SOAP ENV Fault SOAP ENV Body SOAP ENV Envelope 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 encoding ISO 8859 1 SOAP ENV Envelope xmlns SOAP ENV http schemas xmls...

Page 191: ...reached host ESDSUN service 3300 TIME Mon Jun 30 16 01 02 2003 RELEASE 620 COMPONENT NI network interface VERSION 36 RC 10 MODULE ninti c LINE 976 DETAIL NiPConnect2 SYSTEM CALL SO_ERROR ERRNO 10061 ERRNO TEXT WSAECONNREFUSED Connection refused COUNTER 1 faultstring SOAP ENV Fault SOAP ENV Body SOAP ENV Envelope Example Invalid SOAP Request When the BEA WebLogic Adapter for SAP receives a SOAP req...

Page 192: ... 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 xmlns SOAP ENV http schemas xmlsoap org soap envelope xmlns xsd http www w3 org 1999 XMLSchema SOAP ENV Body m RunDBQueryResponse xmlns m urn schemas iwaysoftware com iwse xmlns urn schemas iwaysoftware com iwse cid 2A3CB42703EB20203F91951B89F3C5AF...

Page 193: ...kshop Extensible CCI Control This section describes how to use the Java Swing Application Explorer in BEA WebLogic Workshop to create XML schemas for SAP BAPIs RFCs and IDocs In addition it provides information on creating Web services that are published by the Integration Business Services Engine iBSE Although this section describes the Java Swing implementation of Application Explorer other impl...

Page 194: ... the servlet version of Application Explorer that runs outside of WebLogic Workshop For more information about the servlet version see Chapter 3 Creating XML Schemas for SAP Procedure How to Start Application Explorer To start Application Explorer running in BEA WebLogic Workshop 1 Ensure the server on which Application Explorer is deployed is started 2 Start BEA WebLogic Workshop 3 From the BEA W...

Page 195: ...eate a New Configuration for iBSE or JCA To create a new configuration 1 Right click Configurations and select New The New Configuration dialog box opens 2 Type the name of the new configuration and click OK Note If you are creating a new JCA configuration type base in the name field You must use this value if you are pointing to the default configuration The following dialog box opens 3 From the ...

Page 196: ...the full path to your iWay installation A node representing the new configuration appears under the Configurations node The right pane provides details of the configuration you created After you add your configuration you must connect to it 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 ...

Page 197: ...or more information see Appendix B Using Application Explorer in BEA WebLogic Workshop for Event Handling Connecting to SAP To browse BAPIs RFCs and IDocs in SAP you must create a target for SAP The target serves as your connection point and is automatically saved after it is created You must establish a connection to SAP every time you start Application Explorer or after you disconnect from SAP T...

Page 198: ...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 a In the Name field type a descriptive name for the target for example SAPTarget b In the Description field enter a brief description for the target ...

Page 199: ...pplication server that is hosting SAP 5 Enter the following SAP system information on the System tab a In the Application Server field type the host name or IP address for the machine that is hosting the SAP application required b In the System number field type the system number defined to SAP for client communications required c From the EDI version drop down list select the Electronic Data Inte...

Page 200: ...n the Password field type a valid password for the SAP application d In the Language field type a language key EN English is the default value e In the Codepage field type a character code page value f 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 paramete...

Page 201: ...to connect to the application target you defined Procedure How to Connect to a Target To connect to an Enterprise Information System EIS for example SAP 1 In the left pane expand the SAP node and select the target to which you want to connect for example SAPTarget 2 In the right pane click the User tab and type a valid password for the SAP application 3 In the left pane right click the target and ...

Page 202: ... target You can modify the connection parameters when your system properties change You also can delete a target The following procedures describe how to disconnect from a target edit a target and delete a target Procedure How to Disconnect From a Target To disconnect from a target 1 Right click the target from which you want to disconnect 2 Select Disconnect Disconnecting from the application sys...

Page 203: ... Adapter for SAP User s Guide A 11 Procedure How to Edit a Target 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 The Application Server dialog box opens 3 Change the properties in the dialog box as required and click OK ...

Page 204: ... to SAP Application Explorer enables you to explore and browse business object metadata For example Application Explorer enables you to view BAPI RFC and iDOC metadata stored in the SAP Business Object repository Procedure How to View an SAP System Object To view an application system object 1 Click the icon to the left of the target name for example SAPTarget The available system objects appear F...

Page 205: ...hemas and Web Services BEA WebLogic Adapter for SAP User s Guide A 13 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: ... Systems Inc 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 ...

Page 207: ... How to View Additional Information for a Group or System Object in SAP To view additional information for a particular group or object in SAP 1 Right click a component for example Company and select Help The Help window opens 2 After you finish viewing the information click OK Procedure How to Search for a System Object in SAP To narrow your search for a system object in SAP 1 Right click the sys...

Page 208: ...utomatically expand the group and view all the methods that are available in the left pane of Application Explorer click the group name in the list of results Reference Schema Location 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...

Page 209: ...within an enterprise as well as across enterprises on any communication technology stack whether asynchronous or synchronous in any format After you browse the application system business object repository and create an XML schema for the object you can generate a business service for the object you wish to use with your adapter You can generate a business service also known as a Web service for o...

Page 210: ...ation Business Service A 18 BEA Systems Inc Procedure How to Create an Integration Business Service To create an Integration Business Service 1 Select the BAPI_MATERIAL_GETLIST method from the Business Object Repository ...

Page 211: ...to create a new service name or use an existing service name b In the Service Name field type a name for the business service for example SAPService c In the Service Description field type a brief description for the business service 3 Click Next The Create Integration Business Service dialog box displays additional fields a From the License Name drop down list select a license b In the Method Nam...

Page 212: ...siness Services node In the left pane all the available business services that were created appear The 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 ...

Page 213: ...API_MATERIAL_GETLIST Method on page A 24 6 Click Invoke The result appears in the right pane 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 WebLog...

Page 214: ...ebLogic Workshop 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 The WSDL file appears under the resources folder of your Web application ...

Page 215: ...g target creation using Application Explorer are overwritten for this Web service request 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 Passwor...

Page 216: ...rn sap com document sap business xmlns xsi http www w3 org 2001 XMLSchema instance xsi schemaLocation urn sap com document sap business C PROGRA 1 BEASYS 1 BEAAPP 1 sessions default SAP beasap46 service_BAPI_ MATERIAL_GETLIST xsd MAXROWS 1000 MAXROWS DISTRIBUTIONCHANNELSELECTION item SIGN OPTION DISTR_CHAN_LOW DISTR_CHAN_HIGH item DISTRIBUTIONCHANNELSELECTION MANUFACTURERPARTNUMB item MANU_MAT MFR...

Page 217: ...ION PLANTSELECTION item SIGN OPTION PLANT_LOW PLANT_HIGH item PLANTSELECTION RETURN item TYPE ID NUMBER MESSAGE LOG_NO LOG_MSG_NO MESSAGE_V1 MESSAGE_V2 MESSAGE_V3 MESSAGE_V4 PARAMETER 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 STORAGELOCATI...

Page 218: ...sing 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 Procedure How to Add a Web Service Control To add a Web service control 1 After exporting the WSDL file from Application Explorer locate the file in the Application tab of your BE...

Page 219: ...getDetail sapComDocumentSapRfcFunctions BAPIMATERIALGETDETAILDocument aRequest throws java lang Exception In addition the extensible CCI control now generates a JCX file to which you can add your own methods Using the Extensible CCI Control The extensible CCI control functions much like a database control since it generates JCX files to which you can add your own methods Your own methods can use t...

Page 220: ...I control in BEA WebLogic Workshop 1 Start BEA WebLogic Workshop and create a new project 2 Click Integration Controls and select JCA for ERP The Insert Control JCA for ERP dialog box opens 3 Perform the following steps a Provide a variable name for this control b Click Create a new JCA for ERP control to use and provide a new JCX name c Enter the adapter name target name and select a debug level ...

Page 221: ...gic Workshop to Create XML Schemas and Web Services BEA WebLogic Adapter for SAP User s Guide A 29 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 A 30 BEA Systems Inc You can add your own methods that call the adapter s services ...

Page 223: ...tanding Event Functionality Creating an Event Port Modifying an Event Port Creating a Channel Modifying a Channel Deploying Components in a Clustered BEA WebLogic Environment This section describes how to use Java Swing Application Explorer running in BEA WebLogic Workshop to create events for SAP In addition this section provides information on using events in a clustered BEA WebLogic environment...

Page 224: ... the servlet version of Application Explorer that runs outside of WebLogic Workshop For more information about the servlet version see Chapter 3 Creating XML Schemas for SAP Procedure How to Start Application Explorer To start Application Explorer running in BEA WebLogic Workshop 1 Ensure the server on which Application Explorer is deployed is started 2 Start BEA WebLogic Workshop 3 From the BEA W...

Page 225: ...on A disposition defines the protocol and location of the event data The port defines the end point of the event consumption For more information see Creating an Event Port Channel A channel represents configured connections to particular instances of back end systems A channel binds one or more event ports to a particular listener managed by the adapter For more information see Creating a Channel...

Page 226: ...TTP JMS queue MQ Series Procedure How to Create an Event Port for the File Disposition 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 ...

Page 227: ... From the Protocol drop down list select FILE d In the URL field type a destination where the event data is written using the following format file location errorTo errorDest The following table describes the disposition parameters 2 Click OK Parameter Description location The full directory path and file name to which the data is written errorDest Location where error logs are sent Optional A pre...

Page 228: ...sociated with the event port you created You are ready to associate the event port for File with a channel Procedure How to Create a Port for the iBSE Disposition 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 ...

Page 229: ... the following format ibse svcName methName responseTo respDest errorTo errorDest The following table describes the disposition parameters 2 Click OK Parameter Description svcName Name of the service created with iBSE methName Name of the method created for the Web service respDest Location to post responses to the Web service Optional A predefined port name or another disposition URL The URL must...

Page 230: ... a port for MSMQ 1 In the Business Object Repository right click the BAPI_MATERIAL_GETLIST method and select Create Event Port 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 c From the Protocol drop down list select MSMQ d In the URL field enter an MSMQ destination using the...

Page 231: ... a JMS queue disposition 1 In the Business Object Repository right click the BAPI_MATERIAL_GETLIST method and select Create Event Port The Create Event Port dialog box opens 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 Mess...

Page 232: ...n JMSQ destination using the following format jmsq queue conn_factory jndiurl jndi_url jndifactory jndi_factory user userID password pass errorTo errorDest 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 con...

Page 233: ...t Create Event Port The Create Event Port dialog box opens jndi_url The URL of the application server For BEA WebLogic Server this is t3 host port where host 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 t...

Page 234: ...ption c 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 ...

Page 235: ...he Web service you created using Application Explorer You can also open the WSDL file in a third party XML editor for example XMLSPY and view the SOAP request settings to find this value soapaction The method that will be called by the SOAP disposition This value can be found in the WSDL file method The Web service method you are using This value can be found in the WSDL file namespace The XML nam...

Page 236: ...BAPI_MATERIAL_GETLIST method and select Create Event Port 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 c 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 d...

Page 237: ...t to be enqueued to an MQ Series queue Both queue manager and queue name may be specified To create a port for MQ Series 1 Select the BAPI_MATERIAL_GETLIST method from the Business Object Repository 2 Right click the method and select Create Event Port The Create Event Port dialog box opens a In the Name field type a name for the event port for example GETLIST_EventPort respDest The location to wh...

Page 238: ...dit and delete an event port using Application 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 Procedure How to Edit an Event Port To edit an existing event port Parameter Description qManager Name of the queue manager to which the server must connect qName Name of the queue where...

Page 239: ...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 3 Make the required changes and click OK Procedure How to Delete an Event Port To delete an existing event port 1 To view the available ports click the Ports node in the left pane ...

Page 240: ...el to listen for SAP events All defined event ports must be associated with a channel Procedure How to Create a Channel To create a channel 1 In the left pane below the configuration you created for example SampleConfig expand the 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...

Page 241: ...ype 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 d To transfer an event port from the list of Available event ports to the list of Selected ports click the double right arrow button Note You can assign multiple event ports to a single channel 4 Click Next ...

Page 242: ...Inc The Application Server dialog box opens a 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 ...

Page 243: ...for SAP User s Guide B 21 e Specify any additional information or criteria for the channel you are creating f Click the preemitter tab g Click Strip the Sap Payload to strip the SAP payload of an event document 5 Click OK The channel you created appears in the left pane below the Channels node ...

Page 244: ... channel to listen for events 6 In the left pane right click the channel for example SAPChannel and select Start The channel you created is now active a To stop the channel right click the channel b Select Stop 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 pan...

Page 245: ...ling BEA WebLogic Adapter for SAP User s Guide B 23 Procedure How to Edit a Channel 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: ...it Channel dialog box opens 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 ...

Page 247: ...f multiple server instances running simultaneously yet appears to clients to be a single server instance The server instances that contain a cluster can be run on one machine but are usually run on multiple machines Clustering provides the following benefits Load balancing High availability Service requests are processed through the HTTP router and routed to an available managed server Events are ...

Page 248: ...s the location of the admin console e Add the managed servers to your cluster clusters For more information on configuring WebLogic Integration for deployment in a clustered environment see Deploying WebLogic Integration Solutions 2 Start the WebLogic Server and open WebLogic Server Console 3 Deploy iBSE to the cluster by selecting Web Application Modules from the Domain Configurations section and...

Page 249: ...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 If you are using servlet Application Explorer deploy it only on the admin server or one of the managed servers ...

Page 250: ...ch 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 It is recommended that you use a single instance of iBSE rather than copying iBSE onto every target ...

Page 251: ...02 or any other port that is specified for each managed node 8 Click Deploy Procedure How to Configure Ports and Channels in a Clustered Environment 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...

Page 252: ... For information on creating a new configuration see Appendix A Using Application Explorer in BEA WebLogic Workshop to Create XML Schemas and Web Services Note Use the IP address or machine name in the URL do not use localhost 3 Connect to the new configuration and select the Events node in the left pane of Application Explorer ...

Page 253: ...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 6 Click Next and enter the application server parameters 7 Start the channel 8 Create a new configuration and connect to the second iBSE instance The connection to iBSE must be configured to each instance of the managed server ...

Page 254: ...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 Delete port and channel Deletes the port and channel under all available servers The following operations must be performed on each server Start channel Starts the channel for the specific server ...

Page 255: ...the following command StartManagedWebLogic HTTPROUTER http localhost 7001 where HTTPROUTER Is the name of the server on which the HTTP router is running http localhost 7001 Is the location of the admin console e Add the managed servers to your cluster clusters For more information on configuring WebLogic Integration for deployment in a clustered environment see Deploying WebLogic Integration Solut...

Page 256: ... 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 If you are using servlet Application Explorer deploy it only on the admin server or one of the managed servers ...

Page 257: ...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 It is recommended that you use a single instance of iBSE rather than copying iBSE onto every target ...

Page 258: ...onitoring page After configuring a database repository you must restart all of the managed servers http hostname port ibse IBSEConfig where hostname Is where your application server is running Use the IP address or machine name in the URL do not use localhost port Is the port specific to each server since you deploy iBSE to an entire cluster For example 8001 8002 or any other port that is specifie...

Page 259: ...ices Topics Using WebLogic Workshop to Access an SAP BAPI or an SAP RFC Running the JWSNAME Web Service From WebLogic Workshop This section describes how to access Web services created for an SAP Business Application Programming Interface BAPI and an SAP Remote Function Call RFC using WebLogic Workshop ...

Page 260: ...on details that have traditionally made Web service development the domain of sophisticated J2EE developers With WebLogic Workshop you can build powerful Web services whether you are an application developer or a J2EE expert Accessing an SAP BAPI The following procedures assumes you already created and tested a Web service using Application Explorer It also assumes you created the WSDL used to acc...

Page 261: ...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 d Click Create 3 In the Application tab right click the IWAYSRV folder and select New Project 4 In the upper left pane select all and then select Web Project 5 In the name field type BAPIProj and click Create ...

Page 262: ...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 Procedure How to Call a New Web Service To call a new Web service 1 In th...

Page 263: ...ant to request something from the Web service In this case clients invoke a method to call the BAPI_MATERIAL_GET_DETAIL Control that is exposed later in this procedure 4 If it is not selected already click the Design View tab a From the Insert menu select Method b In the space provided replace method1 with BAPI and press Enter 5 Right click the resources sub folder project and select Import 6 Impo...

Page 264: ...Logic Workshop to Access an SAP BAPI or an SAP RFC C 6 BEA Systems Inc The following opens 7 To generate a Java Control file right click the BAPI_MATERIAL_GET_DETAIL wsdl file and select Generate Service Control ...

Page 265: ... 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 BAPI_MATERIAL_GET_DETAILControl BAPI input 11 To save your current work press Control S ...

Page 266: ...TAILControl BAPI_MATERIAL_GET_DETAIL input BAPI_MATERIAL_GET_DETAILControl BAPI input Accessing an SAP RFC The following procedure describes how to access an SAP Remote Function Call RFC and assumes you already created and tested a Web service using Application Explorer It also assumes you created the WSDL used to access the service For more information on creating Web services see Chapter 4 Creat...

Page 267: ... 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 d Click Create 3 In the Application tab right click the IWAYSRV folder and select New Project 4 In the upper left pane select all and then select Web Project 5 In the name field type RFCProj and click Create ...

Page 268: ...ause 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 Remote Function Call RFC the New Web Service dialog box opens and you can continue and call a Web service Procedure How to Call a New Web Service To call a new Web service 1 In the Applicati...

Page 269: ... functionality through methods that clients invoke when they want to request something from the Web service In this case clients invoke a method to call the RFC_CUSTOMER_GET Control that is exposed later in this procedure 4 If it is not selected already click the Design View tab a From the Insert menu select Method b In the space provided replace method1 with RFC_CUSTOMER_GET 5 Press Enter a Right...

Page 270: ...12 BEA Systems Inc 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: ... 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 RFCControl RFC_CUSTOMER_GET input 10 To save your current work press Control S ...

Page 272: ...u must ensure that WebLogic Server is running while you build your Web service Confirming WebLogic Server is Running You can confirm whether WebLogic Server is running by looking at the status bar at the bottom of 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 Se...

Page 273: ...rocedure How to Run the JWSNAME Web Service for a BAPI 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 2 Replace the string XML input with the following xml version 1 0 encoding UTF 8 BAPI_MATERIAL_GET_DETAIL MATERIAL P 100 MATERIAL BAPI_MATERIAL_GET_D...

Page 274: ...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 For an example see the following topic Calling Complex Operations in a Workflow for a BAPI ...

Page 275: ... WebService common control private resources BAPI_MATERIAL_GET_DETAILControl BAPI_MATERIAL_GET_DETAILControl static final long serialVersionUID 1L common operation public void BAPI BAPI_MATERIAL_GET_DETAILControl BAPI_MATERIAL_GET_DETAIL input throws Exception File outFile new File RESULTS txt creating an output file FileWriter out new FileWriter outFile creating a fileWriter for the output file l...

Page 276: ... out write start time cal_start getTimeInMillis n out write end time cal_end getTimeInMillis n out write execution time diff n out close closing file The results of the execution are saved in a file as follows start time 1073598362655 end time 1073598362775 execution time 120 Running the JWSNAME Web Service for an RFC The following procedure describes how to run the JWSNAME for a Remote Function C...

Page 277: ...on 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 2 Replace the string XML input with the following RFC_CUSTOMER_GET xmlns http www openuri org input KUNNR 0000401026 KUNNR NAME1 NAME1 input RFC_CUSTOMER_GET 3 Click the RFC_CUSTOMER_GET button to submit the request ...

Page 278: ...vice You may want to perform more complex operations in your workflow Calling Complex Operations in a Workflow for an RFC You may want to perform more complex operations in your workflow for a Remote Function Call RFC The following code represents sample Java code used to calculate the execution time of the Web service You can do similar coding for benchmarking or other purposes import resources R...

Page 279: ...ce 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 Display the end time of execution to the WEBLOGIC CONSOLE diff cal_end ...

Page 280: ...Running the JWSNAME Web Service From WebLogic Workshop C 22 BEA Systems Inc The results of the execution are saved in a file as follows start time 1073598362650 end time 1073598362775 execution time 125 ...

Page 281: ... Message Type DEBMAS Sample RFC Module Sample Wrapper Module to Call Functions on Remote Destinations Service Using Staging BAPIs to Retrieve SAP BW Metadata This section provides sample request and response documents sent between SAP and the BEA WebLogic Adapter for SAP It also includes a sample RFC module and a sample wrapper module to call functions on remote destinations ...

Page 282: ... RFCDATA1 Hello World RFCDATA1 RFCDATA2 RFCDATA2 TEST_IN DESTINATIONS DESTINATIONS LOG LOG doc RFC_WALK_THRU_TEST 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 RFCCH...

Page 283: ...REL 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 RCVLA...

Page 284: ...KSD 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 ...

Page 285: ... 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 ...

Page 286: ...AMS 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 ...

Page 287: ...LKS 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 KVGR...

Page 288: ...O 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 PA...

Page 289: ... creates an IDoc for each header record in the collected IDoc file and duplicates the data for each IDoc Make sure the DOCNUM field is included in the EDI_DC40 structure and that each IDoc has a unique sequence number within the collected IDoc file Sample RFC Module After you have configured the SAP event adapter and the RFC destination you can write ABAP code to execute calls at your new destinat...

Page 290: ...ndividual BAPI Business Application Programming Interface or Remote Function Module RFM but a parameter of the SAP function mechanism you require a wrapper module to invoke it as a service In addition you must invoke the wrapper module in place of the original function The wrapper module is written using SAP s ABAP 4 programming language and contains the same input and output parameters as the ori...

Page 291: ...USTOMER_T STRUCTURE BRFCKNA1 ERRORCODE 0 CALL FUNCTION RFC_CUSTOMER_GET DESTINATION JRDEST EXPORTING KUNNR MYKUNNR NAME1 MYNAME1 TABLES CUSTOMER_T MYCUSTOMER_T EXCEPTIONS COMMUNICATION_FAILURE 1 SYSTEM_FAILURE 2 NOTHING_SPECIFIED 3 NO_RECORD_FOUND 4 OTHERS 5 CASE SY SUBRC WHEN 0 ERRORCODE 0 EXIT WHEN 1 ERRORCODE 1 EXIT WHEN 2 ERRORCODE 2 EXIT WHEN 3 ERRORCODE 3 EXIT WHEN 4 ERRORCODE 4 EXIT WHEN 5 ...

Page 292: ... 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 Procedure How to Deploy BAPIs Through BEA WebLogic To deploy BAPIs through BEA WebLogic 1 Start the Servlet Application Explorer and connect to SAP 2 Select an object to query In this pro...

Page 293: ... 1 iway Adapters 5 2 104 sessions default sap GAH service_BAPI_CUBE_GETLIST_response xsd xmlns xsi http www w3 org 2001 XMLSchema instance RETURN TYPE ID NUMBER 000 NUMBER MESSAGE LOG_NO LOG_MSG_NO 000000 LOG_MSG_NO MESSAGE_V1 MESSAGE_V2 MESSAGE_V3 MESSAGE_V4 PARAMETER ROW 0 ROW FIELD SYSTEM RETURN For example the following is the response INFOCUBELIST item INFOCUBE 0BWTCFC1 INFOCUBE OBJVERS A OBJ...

Page 294: ...Using Staging BAPIs to Retrieve SAP BW Metadata D 14 BEA Systems Inc ...

Reviews: