BEA WebLogic Server User manual

BEA WebLogic Adapter for PeopleSoft User’s Guide
DN3501560.0406
April 20, 2006

EDA, EDA/SQL, FIDEL, FOCCALC, FOCUS, FOCUS Fusion, FOCUS Vision, Hospital-Trac, Information Builders, the Information Builders logo,
Parlay, PC/FOCUS, SmartMart, SmartMode, SNAPpack, TableTalk, WALDO, Web390, WebFOCUS and WorldMART are registered trademarks,
and iWay and iWay Software are trademarks of Information Builders, Inc.
Due to the nature of this material, this document refers to numerous hardware 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.
Copyright © 2006BEA Systems, Inc. All Rights Reserved.

Preface
BEA WebLogic Adapter for PeopleSoft User’s Guide iii
Preface
This document explains how to use the BEA WebLogic Adapter for PeopleSoft, which is
used to develop client-server interfaces between PeopleSoft and other applications. It
describes how to use the BEA WebLogic Adapter for PeopleSoft with Application Explorer
to develop online connections to PeopleSoft applications.
How This Manual Is Organized
The following table lists the numbers and titles of the chapters and appendixes for this
manual with a brief description of the contents of each chapter and appendix.
Chapter/Appendix Contents
1Introducing the BEA
WebLogic Adapter
for PeopleSoft
Provides an overview of the BEA WebLogic Adapter for
PeopleSoft and summarizes how to use it to integrate
PeopleSoft systems with other applications.
2Configuring the BEA
WebLogic Adapter
for PeopleSoft
Describes how to configure the BEA WebLogic Adapter
for PeopleSoft.
3Generating
Component Interface
APIs
Describes how to generate Component Interface APIs for
use with the BEA WebLogic Adapter for PeopleSoft.
4Configuring the
PeopleSoft Message
Router
Describes how to configure the TCP/IP Target Connector
(in PeopleSoft release 8.4) and the TCP/IP Handler (in
PeopleSoft release 8.1).
5Creating XML
Schemas or Web
Services for
PeopleSoft
Describes how to create XML schemas and Web services
for PeopleSoft business objects using Servlet Application
Explorer.
6Listening for
PeopleSoft Events
Describes how to use Servlet Application Explorer to
connect to PeopleSoft and listen for events.
7Using Web Services
Policy-Based Security
Describes how to configure Integration Business Services
policy-based security.
8Management and
Monitoring
Describes the management and monitoring tools
provided by iBSE and JCA.

iv BEA Systems, Inc.
Documentation Conventions
The following table lists the conventions that apply in this manual and a description of
each.
9Troubleshooting Explains the limitations and workarounds when
connecting to PeopleSoft.
AUsing Application
Explorer to Create
XML Schemas and
Business Services
Describes how to use Java Swing Application Explorer
running in BEA WebLogic Workshop to create XML
schemas and Integration Business Services for PeopleSoft
Component Interfaces (CI) and Messages.
BUsing Application
Explorer for Event
Handling
Describes how to use Java Swing Application Explorer
running in BEA WebLogic Workshop to create events for
PeopleSoft.
CUsing Component
Interfaces
Describes how to create, secure, and test a Component
Interface for use with the BEA WebLogic Adapter for
PeopleSoft.
DUsing PeopleSoft 8
Integration Broker
Describes how to configure and test PeopleSoft
Integration Broker (release 8.4) and PeopleSoft
Application Messaging (release 8.1) using a PeopleSoft-
supplied File Output interface.
Chapter/Appendix Contents
Convention Description
THIS TYPEFACE or
this typeface Denotes syntax that you must enter exactly as shown.
this typeface Represents a placeholder (or variable) in syntax for a value that
you or the system must supply.
underscore Indicates a default setting.
this typeface Represents a placeholder (or variable), a cross-reference, or an
important term.
this typeface Highlights a file name or command.
Key + Key Indicates keys that you must press simultaneously.

Preface
BEA WebLogic Adapter for PeopleSoft User’s Guide v
Contact Us!
Your feedback on the BEA WebLogic Adapter for PeopleSoft documentation is important to
us.
Send us e-mail at docsuppor[email protected] 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 PeopleSoft documentation.
In your e-mail message, please indicate that you are using the documentation for BEA
WebLogic Adapter for PeopleSoft and the version of the documentation.
If you have any questions about this version of BEA WebLogic Adapter for PeopleSoft, or if
you have problems using the BEA WebLogic Adapter for PeopleSoft, 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 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 product you are using
• A description of the problem and the content of pertinent error messages
{ } Indicates two or three choices; type one of them, not the
braces.
|Separates mutually exclusive choices in syntax. Type one of
them, not the symbol.
... Indicates that you can enter a parameter multiple times. Type
only the parameter, not the ellipsis points (…).
.
.
.
Indicates that there are (or could be) intervening or additional
commands.
Convention Description

Contact Us!
vi BEA Systems, Inc.
Help Us to Serve You Better
To help our consultants answer your questions effectively, please be prepared to provide
specifications and sample files and to answer questions about errors and problems.
The following tables list the specifications our consultants require.
The following table lists components. Specify the version 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.
Platform
Operating System
OS Version
Product List
Adapters
Adapter
Deployment
For example, JCA, Integration Business Services Engine.
Container Version
Component Version
Adapter
EIS (DBMS/APP)
HOTFIX / Service Pack
Application Explorer
Type
Version Platform
Swing
Servlet
ASP

Preface
BEA WebLogic Adapter for PeopleSoft User’s Guide vii
In the following table, specify the JVM version and vendor in the columns provided.
The following table lists additional questions to help us serve you better.
The following table lists error/problem files that might be applicable.
Version Vendor
Request/Question Error/Problem Details or Information
Provide usage scenarios or
summarize the application
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 documents (transformation)
Error screen shots
Error output files

Contact Us!
viii BEA Systems, Inc.
Trace and log files
Log transaction
XML schema

BEA WebLogic Adapter for PeopleSoft User’s Guide ix
Contents
Contact Us! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-v
1. Introducing the BEA WebLogic Adapter for PeopleSoft . . . . . . . . . . . . . . . . . . . . . .1-1
Key Features of the BEA WebLogic Adapter for PeopleSoft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-2
How the BEA WebLogic Adapter for PeopleSoft Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3
PeopleSoft Enterprise Application Integration Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3
PeopleSoft Component Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3
PeopleSoft Application Messaging Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-4
Deployment Information for the BEA WebLogic Adapter for PeopleSoft . . . . . . . . . . . . . . . . . . . . . . . .1-4
Deployment Information Roadmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-4
Application Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-5
Integration Business Services Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-5
Enterprise Connector for J2EE Connector Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-5
2. Configuring the BEA WebLogic Adapter for PeopleSoft . . . . . . . . . . . . . . . . . . . . . .2-1
Specifying the PeopleSoft Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2
Installing the Adapter Component Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2
Importing and Building the Component Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2
Configuring Component Interface Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-7
Testing the Component Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
Installing the TCP/IP Message Router for the BEA WebLogic Adapter for PeopleSoft . . . . . . . . . . . 2-16
Installing the TCP/IP Target Connector for PeopleSoft Release 8.4 . . . . . . . . . . . . . . . . . . . . . . . 2-16
Installing the TCP/IP Handler for PeopleSoft Release 8.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
Copying PeopleSoft Files Into the Lib Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18
3. Generating Component Interface APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1
Building the PeopleSoft API Java Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2
Compiling the PeopleSoft API Java Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6
4. Configuring the PeopleSoft Message Router . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-1
Configuring the TCP/IP or HTTP Target Connector for PeopleSoft 8.4 . . . . . . . . . . . . . . . . . . . . . . . . . . .4-2
Configuring the TCP/IP Handler for PeopleSoft 8.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
Testing Your PeopleSoft Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16
5. Creating XML Schemas or Web Services for PeopleSoft . . . . . . . . . . . . . . . . . . . . . .5-1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-2
Starting Servlet Application Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-2
Establishing a Target for PeopleSoft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-4
Modifying a Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-8
Viewing Application System Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
Creating an XML Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12

Contents
xBEA Systems, Inc.
Generating a Web Service for PeopleSoft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15
Testing a Web Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
6. Listening for PeopleSoft Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-1
Understanding Event Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-2
Creating, Editing, or Deleting a Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-2
Creating, Editing, or Deleting a Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14
7. Using Web Services Policy-Based Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-1
Integration Business Services Policy-Based Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-2
Configuring Integration Business Services Policy-Based Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-3
8. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-1
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-2
Integration Business Services Engine Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-5
General Error Handling in iBSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-5
Adapter-Specific Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-6
BEA WebLogic Adapter for PeopleSoft Invalid SOAP Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-6
Empty Result From PeopleSoft Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-7
Failure to Connect to PeopleSoft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-7
Invalid SOAP Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-8
Empty Result From an Adapter Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-8
9. Management and Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-1
Managing and Monitoring Services and Events Using iBSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-2
Managing and Monitoring Services and Events Using the JCA Test Tool . . . . . . . . . . . . . . . . . . . . . . 9-16
Setting Engine Log Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-19
Configuring Connection Pool Sizes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-21
Migrating Repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-21
File Repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-22
iBSE Repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-22
JCA Repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-26
Migrating Event Handling Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-26
Exporting or Importing Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-31
Retrieving or Updating Web Service Method Connection Information . . . . . . . . . . . . . . . . . . . . . . . . 9-34
Starting or Stopping a Channel Programmatically . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-38
A. Using Application Explorer to Create XML Schemas and Business Services . . . A-1
Starting Application Explorer in BEA WebLogic Workshop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
Creating a New Configuration for iBSE or JCA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
Connecting to PeopleSoft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5
Creating and Connecting to a Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5
Managing a Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8
Viewing a Business Object and Creating an XML Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10

Contents
BEA WebLogic Adapter for PeopleSoft User’s Guide xi
Creating a Business Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-14
Exporting WSDL for Use in BEA WebLogic Workshop Workflows . . . . . . . . . . . . . . . . . . . . . . . . A-17
Identity Propagation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-18
Adding a Control for a Resource in BEA WebLogic Workshop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-19
Adding a Web Service Control to a BEA WebLogic Workshop Application . . . . . . . . . . . . . . . A-19
Adding an Extensible CCI Control to a BEA WebLogic Workshop Application . . . . . . . . . . . . . . . . . . A-20
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-20
Using the Extensible CCI Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-27
B. Using Application Explorer 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-17
Creating a Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-19
Modifying a Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-22
Deploying Components in a Clustered BEA WebLogic Environment . . . . . . . . . . . . . . . . . . . . . . . . . . B-24
C. Using Component Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .C-1
Creating a Component Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .C-2
Viewing or Changing Available Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .C-6
Securing a Component Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .C-7
Testing a Component Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-17
D. Using PeopleSoft 8 Integration Broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1
PeopleSoft Integration Broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-2
Configuring Integration Broker in PeopleSoft 8.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-3
Configuring Application Messaging in PeopleSoft Release 8.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-9
Viewing the PeopleCode for a Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-22
Testing the Integration Broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-24
Using Outbound Synchronous Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-26

Contents
xii BEA Systems, Inc.

BEA WebLogic Adapter for PeopleSoft User’s Guide 1-1
CHAPTER 1
Introducing the BEA WebLogic Adapter for PeopleSoft
Topics:
• Key Features of the BEA WebLogic
Adapter for PeopleSoft
• How the BEA WebLogic Adapter for
PeopleSoft Works
• Deployment Information for the
BEA WebLogic Adapter for
PeopleSoft
This section provides an overview of the BEA WebLogic
Adapter for PeopleSoft and describes how to integrate
PeopleSoft systems with other applications.

Key Features of the BEA WebLogic Adapter for PeopleSoft
1-2 BEA Systems, Inc.
Key Features of the BEA WebLogic Adapter for PeopleSoft
The BEA WebLogic Adapter for PeopleSoft provides a means to exchange real-time
business data between PeopleSoft systems and other application, database, or external
business partner systems. The adapter enables external applications for inbound and
outbound processing with PeopleSoft.
The adapter uses XML messages to enable non-PeopleSoft applications to communicate
and exchange transactions with PeopleSoft using services and events.
•Services: Applications use this capability to initiate a PeopleSoft business event.
Services also are referred to as component methods.
•Events: Applications use this capability to access PeopleSoft data only when a
PeopleSoft business event occurs. Events also are referred to as messages.
When you access a PeopleSoft component from another application, you work with:
•Component Interfaces. If a Component Interface does not exist, create, secure, and
test one. For more information, see Appendix C, Using Component Interfaces or your
PeopleSoft documentation.
If the Component Interface exists, but you modified it, secure and test it. For more
information, see Appendix C, Using Component Interfaces or your PeopleSoft
documentation.
Alternatively, you can secure and test the Component Interface and create the
Component Interface API after you generate schemas or Web services.
•Component Interface APIs. Create an API for the Component Interface. For more
information, see Chapter 3, Generating Component Interface APIs.
•Schemas and Web services. Create schemas or Web services for the component
methods. For more information, see Chapter 5, Creating XML Schemas or Web Services
for PeopleSoft.
To receive a message from PeopleSoft, you work with:
•The Integration environment. Configure and test your PeopleSoft Integration Broker
(release 8.4) or Application Messaging environment (release 8.1). To ensure that the
environment is properly configured, see Appendix D, Using PeopleSoft 8 Integration
Broker or your PeopleSoft documentation.
•Message routing. Configure TCP/IP Target Connector (release 8.4), HTTP Target
Connector (release 8.4), or TCP/IP Handler (release 8.1). For more information, see
Chapter 4, Configuring the PeopleSoft Message Router.

Introducing the BEA WebLogic Adapter for PeopleSoft
BEA WebLogic Adapter for PeopleSoft User’s Guide 1-3
How the BEA WebLogic Adapter for PeopleSoft Works
The adapter uses BEA WebLogic Server and XML messages to enable non-PeopleSoft
applications to communicate and exchange transactions using one of the following two
facilities:
• PeopleSoft Component Interface
• PeopleSoft Application Messaging Manager
The adapter connects to the PeopleSoft Application Server by accessing APIs for the
Component Interfaces that correspond to its supported business objects. Every
Component Interface contains data and business logic for the business component, thus
alleviating a requirement for the adapter to duplicate the processes defined within the
business component.
The adapter is bidirectional, enabling it to:
• Detect an event by receiving an XML document from PeopleSoft using Application
Messaging.
• Pass an XML request document to execute an instance of the PeopleSoft Component
Interface and its method.
PeopleSoft Enterprise Application Integration Architecture
PeopleSoft provides for integration with other applications and systems through its
Component Interface framework and its Integration Broker (in release 8.4) or Application
Messaging (in release 8.1) facility. The BEA WebLogic Adapter for PeopleSoft uses the
PeopleSoft framework and leverages various integration access methods to provide the
greatest amount of flexibility and functionality.
Integration access methods supported by the BEA WebLogic Adapter for PeopleSoft
include:
• PeopleSoft Java™ API using Component Interfaces.
• PeopleSoft XML using Application Messaging.
PeopleSoft Component Interface
In the PeopleSoft environment, a Component Interface is a container for distributing
PeopleSoft application data among PeopleSoft logical systems and for exchanging
PeopleSoft application data with non-PeopleSoft systems.
The Component Interface is based on an existing business process within PeopleSoft. An
example is a purchase order entry, which can be a PeopleSoft-delivered process or a
user-developed process. The Component Interface also inherits its methods (Add, Update,
and so on) and its business logic from the underlying business process.

Deployment Information for the BEA WebLogic Adapter for PeopleSoft
1-4 BEA Systems, Inc.
PeopleSoft delivers generic Component Interfaces with each of its applications. These are
called Enterprise Integration Points (EIP). Customers also can develop their own custom
Component Interfaces, or they can modify EIP as required.
PeopleSoft Application Messaging Manager
PeopleSoft Application Messaging facilitates the integration of PeopleSoft XML with
PeopleSoft. The BEA WebLogic Adapter for PeopleSoft provides a handler that must be
configured within the PeopleSoft application gateway using TCP/IP transport services.
Deployment Information for the BEA WebLogic Adapter for PeopleSoft
The BEA WebLogic Adapter for PeopleSoft works in conjunction with Servlet Application
Explorer with either of the following components:
• Integration Business Services Engine (iBSE)
• Enterprise Connector for J2EE™ Connector Architecture (JCA)
Both iBSE and the Connector for JCA are deployed to your application environment with
Application Explorer and the adapters.
Deployment Information Roadmap
The following table lists the location of deployment information for the iWay Adapter for
PeopleSoft 8. A description of Application Explorer, the Integration Business Services
Engine (iBSE), and the Enterprise Connector for J2EE Connector Architecture (JCA) follow
the table.
Deployed Component For more information, see
Application Explorer Chapters 6 and 7 of this guide
Appendix A and B of this guide when using
Application Explorer inside WebLogic Workshop
Application Explorer User’s Guide
Integration Business Services Engine
(iBSE)
BEA WebLogic ERP Adapter Installation and
Configuration
Enterprise Connector for J2EE
Connector Architecture (JCA)
BEA WebLogic ERP Adapter Installation and
Configuration
Connector for JCA for BEA WebLogic User’s Guide

Introducing the BEA WebLogic Adapter for PeopleSoft
BEA WebLogic Adapter for PeopleSoft User’s Guide 1-5
Application Explorer
Application Explorer uses an explorer metaphor to browse the PeopleSoft system for
metadata and create Web services and events.
Integration Business Services Engine
Integration Business Services Engine (iBSE) exposes—as Web services—enterprise assets
that are accessible from adapters regardless of the programming language or the particular
operating system.
iBSE simplifies the creation and execution of Web services when running:
• Custom and legacy applications
• Database queries and stored procedures
• Packaged applications
• Terminal emulation and screen-based systems
• Transactional systems
iBSE is a distributed programming architecture that solves Enterprise Application
Integration (EAI) hurdles that other programming models cannot. It enables programs to
communicate with one another using a text-based but platform and language
independent message format called XML.
Coupled with a platform and language independent messaging protocol called SOAP
(Simple Object Access Protocol), XML enables application development and integration by
assembling previously built components from multiple Web services.
Enterprise Connector for J2EE Connector Architecture
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 BEA WebLogic Server.
The Connector for JCA is distributed as a standard Resource Adapter Archive (RAR) for
deployment to the application server. Thus, the connector can be used in systems that are
non-compliant, although services such as pooled connections are not available.

Deployment Information for the BEA WebLogic Adapter for PeopleSoft
1-6 BEA Systems, Inc.

BEA WebLogic Adapter for PeopleSoft User’s Guide 2-1
CHAPTER 2
Configuring the BEA WebLogic Adapter for PeopleSoft
Topics:
• Specifying the PeopleSoft Version
• Installing the Adapter Component
Interfaces
• Installing the TCP/IP Message
Router for the BEA WebLogic
Adapter for PeopleSoft
• Copying PeopleSoft Files Into the
Lib Directory
This section describes how to configure the BEA WebLogic
Adapter for PeopleSoft. You must:
• Specify which version of PeopleSoft you are using.
• Install the adapter Component Interfaces.
• Install the adapter TCP/IP message router.
• Copy the psjoa.jar file (and, for PeopleSoft release 8.1,
the pstools.properties file) into the iWay55\lib
directory.

Specifying the PeopleSoft Version
2-2 BEA Systems, Inc.
Specifying the PeopleSoft Version
The BEA WebLogic Adapter for PeopleSoft supports multiple versions of PeopleSoft.
However, one version can be incompatible with another. The adapter must recognize the
version you use. After installation, files for both versions of PeopleSoft appear in the
iWay55\lib directory. The default location for this directory on Windows is:
C:\Program Files\iWay55\lib
Use the corresponding location on non-Windows systems.
To ensure the adapter functions properly, remove the file that does not correspond to your
release:
• For PeopleSoft 8.4, remove the following file:
iwpsci81.jar
• For PeopleSoft 8.1, remove the following file:
iwpsci84.jar
After changing the contents of the lib directory, restart all iWay components.
Installing the Adapter Component Interfaces
The BEA WebLogic Adapter for PeopleSoft includes two custom Component Interfaces.
Application Explorer uses these Component Interfaces to create schemas for events and
services.
To configure Component Interfaces for use by the BEA WebLogic Adapter for PeopleSoft:
1. Import and build the Component Interfaces.
2. Configure Component Interface security.
3. Test the Component Interfaces.
Importing and Building the Component Interfaces
The Component Interfaces supplied with the BEA WebLogic Adapter for PeopleSoft are
delivered through a PeopleSoft project:
• For PeopleSoft Release 8.4, it is the IWY_CI_84 project, packaged in iwpsci84.zip.
• For PeopleSoft Release 8.1, it is the IWY_CI_81 project, packaged in iwpsci81.zip.
These files are installed with iWay 5.5. On Windows, their default location is:
C:\Program Files\iWay55\etc\misc\peoplesoft
Use the corresponding location on non-Windows systems. If this location does not exist,
contact your distributor for copies of the relevant files.