BEA WebLogic Server User manual

BEA WebLogic
Adapter for
SAP®
UserGuide
Release 7.0
Document Date: October 2002

Copyright
Copyright © 2002 BEA Systems, Inc. All Rights Reserved.
Copyright © 2002 iWay Software. All Rights Reserved.
Restricted Rights Legend
This software and documentation is subject to and made available only pursuant to the terms of the BEA Systems
License Agreement and may be used or copied only in accordance with the terms of that agreement. It is against the
law to copy the software except as specifically allowed in the agreement. This document may not, in whole or in part,
be copied photocopied, reproduced, translated, or reduced to any electronic medium or machine readable form
without prior consent, in writing, from BEA Systems, Inc.
Use, duplication or disclosure by the U.S. Government is subject to restrictions set forth in the BEA Systems License
Agreement and in subparagraph (c)(1) of the Commercial Computer Software-Restricted Rights Clause at FAR
52.227-19; subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS
252.227-7013, subparagraph (d) of the Commercial Computer Software--Licensing clause at NASA FAR
supplement 16-52.227-86; or their equivalent.
Information in this document is subject to change without notice and does not represent a commitment on the part
of BEA Systems. THE SOFTWARE AND DOCUMENTATION ARE PROVIDED “AS IS” WITHOUT
WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, BEA Systems DOES NOT
WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE
RESULTS OF THE USE, OF THE SOFTWARE OR WRITTEN MATERIAL IN TERMS OF CORRECTNESS,
ACCURACY, RELIABILITY, OR OTHERWISE.
Trademarks or Service Marks
BEA, Jolt, Tuxedo, and WebLogic are registered trademarks of BEA Systems, Inc. BEA Builder, BEA Campaign
Manager for WebLogic, BEA eLink, BEA Manager, BEA WebLogic Commerce Server, BEA WebLogic
Enterprise, BEA WebLogic Enterprise Platform, BEA WebLogic Express, BEA WebLogic Integration, BEA
WebLogic Personalization Server, BEA WebLogic Platform, BEA WebLogic Portal, BEA WebLogic Server, BEA
WebLogic Workshop and How Business Becomes E-Business are trademarks of BEA Systems, Inc.
All other trademarks are the property of their respective companies.
BEA WebLogic Adapter for SAP User Guide
Part Number Date
N/A October 2002

BEA WebLogic Adapter for SAP User Guide iii
Table of Contents
About This Document
What You Need to Know .................................................................................... vi
Related Information............................................................................................. vi
Contact Us!......................................................................................................... vii
Documentation Conventions ............................................................................. viii
1. Introducing the BEA WebLogic Adapter for SAP
WebLogic Integration........................................................................................ 1-3
How the BEA WebLogic Adapter for SAP Works........................................... 1-4
2. Creating Schemas for SAP Business Objects
Overview ........................................................................................................... 2-1
Generating Schemas Using the BEA Application Explorer.............................. 2-3
3. Configuring the BEA WebLogic Adapter for SAP
Creating an Application View Folder................................................................ 3-1
Event Adapter Application Views..................................................................... 3-3
Creating the Event Adapter Application View .......................................... 3-4
Creating an SAP Remote Destination ........................................................ 3-8
Configuring the Event Adapter Application View................................... 3-14
Testing the Event Adapter in the Application View Console .................. 3-21
Testing the Event Adapter in Studio ........................................................ 3-26
Service Adapter Application Views ................................................................ 3-29
Creating a Service Adapter Application View......................................... 3-29
Configuring the Service Adapter Application View ................................ 3-32
Testing the Service Adapter ..................................................................... 3-36

iv BEA WebLogic Adapter for SAP User Guide
4. The BEA WebLogic Adapter for SAP and IDocs
Defining a Logical Port ..................................................................................... 4-2
Creating a Logical System................................................................................. 4-4
Creating a Partner Profile .................................................................................. 4-7
Creating a Distribution Model for the Partner and Message Type.................. 4-10
Manually Sending an IDoc .............................................................................. 4-14
5. Sending SAP Events Using ABAP Programs
Writing an RFC Module .................................................................................... 5-2
A. Sample Files
Sample RFC Request Document ...................................................................... A-1
Sample RFC Response Document.................................................................... A-2
Sample IDoc XML for Message Type DEBMAS............................................ A-3

BEA WebLogic Adapter for SAP User Guide v
About This Document
The BEA WebLogic Adapter for SAP is organized as follows:
Chapter 1, “Introducing the BEA WebLogic Adapter for SAP,” introduces the
BEA WebLogic Adapter for SAP and describes SAP business objects and
WebLogic Integration.
Chapter 2, “Creating Schemas for SAP Business Objects,” describes how to use
the BEA Application Explorer to generate schemas for your SAP business
objects.
Chapter 3, “Configuring the BEA WebLogic Adapter for SAP,” describes how to
configure the event adapter and service adapter.
Chapter 4, “The BEA WebLogic Adapter for SAP and IDocs,” describes how to
configure and test SAP to send IDocs to the event adapter.
Chapter 5, “Sending SAP Events Using ABAP Programs,” describes how to
send events programmatically using the BEA WebLogic Adapter for SAP.
Appendix A, “Sample Files,” provides sample request and response documents
sent between SAP and the BEA WebLogic Adapter for SAP.

vi BEA WebLogic Adapter for SAP User Guide
What You Need to Know
This document is written for system integrators who develop client interfaces between
SAP and other applications. It describes how to use the BEA WebLogic Adapter for
SAP in order to integrate SAP IDocs, RFCs, and BAPIs with WebLogic Integration. It
is assumed that readers know Web technologies and have a general understanding of
Microsoft Windows and UNIX systems as well as the WebLogic Integration and
WebLogic Server infrastructure.
Related Information
The following documents provide additional information for the associated software
components:
BEA WebLogic Adapter for SAP Installation and Configuration Guide
BEA WebLogic Adapter for SAP Release Notes
BEA Application Explorer Installation and Configuration Guide
BEA WebLogic Server installation and user documentation, which is available at
the following URL:
http://edocs.bea.com/more_wls.html
BEA WebLogic Integration installation and user documentation, which is
available at the following URL:
http://edocs.bea.com/more_wli.html

BEA WebLogic Adapter for SAP User Guide vii
Contact Us!
Your feedback on the BEA WebLogic Adapter for SAP documentation is important to
us. Send us e-mail at [e-mail] if you have questions or comments. Your
comments will be reviewed directly by the BEA professionals who create and update
the BEA WebLogic Adapter for SAP documentation.
In your e-mail message, please indicate which version of the BEA WebLogic Adapter
for SAP documentation you are using.
If you have any questions about this version of BEA WebLogic Adapter for SAP, or if
you have problems using the BEA WebLogic Adapter for SAP, contact BEA Customer
Support through BEA WebSupport at www.bea.com. You can also contact Customer
Support by using the contact information provided on the Customer Support Card that
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 product you are using
A description of the problem and the content of pertinent error messages

viii BEA WebLogic Adapter for SAP User Guide
Documentation Conventions
The following documentation conventions are used throughout this document.
Convention Item
boldface text Indicates terms defined in the glossary.
Ctrl+Tab Indicates that you must press two or more keys simultaneously.
italics Indicates emphasis or book titles.
monospace
text
Indicates code samples, commands and their options, data structures and
their members, data types, directories, and file names and their extensions.
Monospace text also indicates text that you must enter from the keyboard.
Examples:
#include <iostream.h> void main ( ) the pointer psz
chmod u+w *
\tux\data\ap
.doc
tux.doc
BITMAP
float
monospace
boldface
text
Identifies significant words in code.
Example:
void commit ( )
monospace
italic
text
Identifies variables in code.
Example:
String expr
UPPERCASE
TEXT
Indicates device names, environment variables, and logical operators.
Examples:
LPT1
SIGNON
OR

BEA WebLogic Adapter for SAP User Guide ix
{ } Indicates a set of choices in a syntax line. The braces themselves should
never be typed.
[ ] Indicates optional items in a syntax line. The brackets themselves should
never be typed.
Example:
buildobjclient [-v] [-o name ] [-f file-list]...
[-l file-list]...
|Separates mutually exclusive choices in a syntax line. The symbol itself
should never be typed.
... Indicates one of the following in a command line:
That an argument can be repeated several times in a command line
That the statement omits additional optional arguments
That you can enter additional parameters, values, or other information
The ellipsis itself should never be typed.
Example:
buildobjclient [-v] [-o name ] [-f file-list]...
[-l file-list]...
.
.
.
Indicates the omission of items from a code example or from a syntax line.
The vertical ellipsis itself should never be typed.
Convention Item

xBEA WebLogic Adapter for SAP User Guide