iWay Application Adapter for PeopleSoft User's Guide Version 7.0.x and Higher August 16, 2018 Active Technologies, EDA, EDA/SQL, FIDEL, FOCUS, Information Builders, the Information Builders logo, iWay, iWay Software, Parlay, PC/FOCUS, RStat, Table Talk, Web390, WebFOCUS, WebFOCUS Active Technologies, and WebFOCUS Magnify are registered trademarks, and DataMigrator and Hyperstage are trademarks of Information Builders, Inc. Adobe, the Adobe logo, Acrobat, Adobe Reader, Flash, Adobe Flash Builder, Flex, and PostScript are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. 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 © 2018, by Information Builders, Inc. and iWay Software. All rights reserved. Patent Pending. This manual, or parts thereof, may not be reproduced in any form without the written permission of Information Builders, Inc. Contents Preface ......................................................................... 7 Documentation Conventions ............................................................8 Related Publications .................................................................. 9 Customer Support .................................................................... 9 Help Us to Serve You Better .......................................................... 10 User Feedback ......................................................................12 Information Builders Consulting and Training ............................................ 12 1. Introducing the iWay Application Adapter for PeopleSoft .......................13 Key Features of the iWay Application Adapter for PeopleSoft ...............................13 How the iWay Application Adapter for PeopleSoft Works ...................................14 PeopleSoft Enterprise Application Integration Architecture............................ 15 PeopleSoft Component Interface..................................................15 PeopleSoft Application Messaging Manager........................................ 15 iWay Application Adapter for PeopleSoft Component Information ........................... 15 Component Information Roadmap.................................................16 iWay Service Manager...........................................................16 iWay Explorer...................................................................16 iWay Business Services Provider..................................................17 2. iWay Application Adapter for PeopleSoft Supported Platforms Matrix ...........19 Application Adapter for PeopleSoft Supported Platforms Overview .......................... 19 PeopleTools ........................................................................ 20 Application Adapter for PeopleSoft Operating Systems ....................................20 Databases ......................................................................... 20 Java Development Kit (JDK) ...........................................................20 Application Adapter for PeopleSoft Communication Modes ................................ 20 PeopleSoft Object Types and Interfaces .................................................21 PeopleSoft Communication Types ......................................................21 PeopleSoft Operations ............................................................... 21 PeopleSoft Data Types ...............................................................21 Other PeopleSoft Functions ...........................................................22 Known Application Adapter for PeopleSoft Limitations .................................... 22 iWay Application Adapter for PeopleSoft User's Guide 3 Contents Related Information for the Application Adapter for PeopleSoft in Specific iWay Releases ......22 3. Application Adapter for PeopleSoft Quick Start Guide ..........................23 PeopleSoft Quick Start Overview .......................................................23 Installing the Application Adapter for PeopleSoft .........................................23 Configuring the Application Adapter for PeopleSoft ....................................... 24 Initial Configuration............................................................. 24 Using the Adapter for Inbound Processing (Inbound Services Into PeopleSoft)........... 26 Using the Adapter for Outbound Processing (Outbound Services From PeopleSoft)....... 26 Upgrading PeopleTools ...............................................................27 4. Configuring the iWay Application Adapter for PeopleSoft .......................29 Specifying the Version of PeopleSoft ................................................... 29 Installing the Application Adapter for PeopleSoft Component Interfaces ..................... 30 Importing and Building the Component Interfaces................................... 30 Configuring Component Interface Security..........................................35 Testing the Component Interfaces.................................................39 Installing the TCP/IP Message Router for the iWay Application Adapter for PeopleSoft .........43 Installing the TCP/IP Target Connector for PeopleSoft Release 8.4.....................44 Installing the TCP/IP Handler for PeopleSoft Release 8.1.............................44 Copying PeopleSoft Files Into the Lib Directory ...........................................45 5. Generating Component Interface APIs .........................................47 Building the PeopleSoft API Java Programs ..............................................47 Compiling the PeopleSoft API Java Programs ............................................ 53 6. Configuring the PeopleSoft Message Router ...................................57 Configuring the TCP/IP or HTTP Target Connector for PeopleSoft 8.4 ........................57 Configuring the TCP/IP Handler for PeopleSoft 8.1 .......................................70 Testing Your PeopleSoft Configuration ..................................................72 7. Creating XML Schemas or Web Services for PeopleSoft ........................75 XML Schema and Web Services for PeopleSoft Overview ..................................75 Starting iWay Explorer ................................................................75 Establishing a Target for PeopleSoft ....................................................76 Modifying a Target ...................................................................80 Viewing Application System Objects ....................................................81 4 Information Builders Contents Creating an XML Schema .............................................................82 Generating a Web Service for PeopleSoft ............................................... 84 Testing a Web Service...........................................................87 8. Listening for PeopleSoft Events ...............................................91 Understanding Event Functionality ..................................................... 91 Creating, Editing, or Deleting a Port ....................................................92 Using the Default Event Port.................................................... 103 Creating, Editing, or Deleting a Channel ............................................... 103 9. Configuring an HTTP Event Listener for PeopleSoft Using iWay Service Manager ....................................................................115 PeopleSoft HTTP Event Listener Overview ..............................................115 Configuring an HTTP Listener .........................................................115 10. PeopleSoft Troubleshooting and Error Messages ............................ 123 Error Messages in iWay Explorer ......................................................123 Error Messages in PeopleSoft ........................................................125 Error Messages in iBSP .............................................................127 General Error Handling in iBSP...................................................127 Adapter-Specific Error Handling..................................................128 A. Configuring the Application Adapter for PeopleSoft in an iWay Environment ....131 Configuring the Application Adapter for PeopleSoft in iWay Service Manager ................131 B. Using PeopleSoft Component Interfaces ..................................... 135 Creating a Component Interface ......................................................135 Viewing or Modifying Available Methods ............................................... 139 Securing a Component Interface ......................................................140 Testing a Component Interface .......................................................150 C. Using PeopleSoft 8 Integration Broker ....................................... 157 PeopleSoft Integration Broker ........................................................157 Configuring Integration Broker in PeopleSoft Release 8.4 (PeopleTools Releases 8.48 - 8.51) ................................................................................159 Configuring