Page 1 BEA WebLogic Adapter for PeopleSoft User’s Guide DN3501560.0406 April 20, 2006...
Page 2 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 © 2006 BEA Systems, Inc. All Rights Reserved.
Page 3 Preface 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.
Page 4: Documentation Conventions
Component Interfaces (CI) and Messages. Using Application Describes how to use Java Swing Application Explorer Explorer for Event running in BEA WebLogic Workshop to create events for Handling PeopleSoft. Using Component Describes how to create, secure, and test a Component...
Page 5 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.
Page 6 Adapter EIS (DBMS/APP) HOTFIX / Service Pack The following table lists the types of Application Explorer. Specify the version (and platform, if different than listed previously) in the columns provided. Application Explorer Version Platform Type Swing Servlet BEA Systems, Inc.
Page 7 Describe the problem. Specify the error message(s). The following table lists error/problem files that might be applicable. XML schema XML instances Other input documents (transformation) Error screen shots Error output files BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 8 Contact Us! XML schema Trace and log files Log transaction viii BEA Systems, Inc.
Page 9: Table Of Contents
Key Features of the BEA WebLogic Adapter for PeopleSoft ....... .
Page 10 Adapter-Specific Error Handling ............8-6 BEA WebLogic Adapter for PeopleSoft Invalid SOAP Request ......8-6 Empty Result From PeopleSoft Request .
Page 11 Adding a Control for a Resource in BEA WebLogic Workshop .......
Page 12 Contents BEA Systems, Inc.
Page 13: Introducing The Bea Weblogic Adapter For Peoplesoft
HAPTER Introducing the BEA WebLogic Adapter for PeopleSoft Topics: This section provides an overview of the BEA WebLogic Adapter for PeopleSoft and describes how to integrate • Key Features of the BEA WebLogic PeopleSoft systems with other applications. Adapter for PeopleSoft •...
Page 14: Key Features Of The Bea Weblogic Adapter For Peoplesoft
Key Features of the BEA WebLogic Adapter for PeopleSoft 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.
Page 15: How The Bea Weblogic Adapter For Peoplesoft Works
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.
Page 16: Peoplesoft Application Messaging Manager
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...
Page 17: Application Explorer
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.
Page 18 Deployment Information for the BEA WebLogic Adapter for PeopleSoft BEA Systems, Inc.
Page 19: Configuring The Bea Weblogic Adapter For Peoplesoft
HAPTER Configuring the BEA WebLogic Adapter for PeopleSoft Topics: This section describes how to configure the BEA WebLogic Adapter for PeopleSoft. You must: • Specifying the PeopleSoft Version • Specify which version of PeopleSoft you are using. • Installing the Adapter Component Interfaces •...
Page 20: Specifying The Peoplesoft Version
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.
Page 21 Configuring the BEA WebLogic Adapter for PeopleSoft Procedure: How to Import and Build the Component Interfaces To import the IWY_CI_81 or IWY_CI_84 project to PeopleSoft 8: 1. Unzip iwpsci81.zip or iwpsci84.zip to a directory of your choice. The unzip process creates its own subdirectory. For example, if you extract the file to c:\temp, it creates c:\temp\IWY_CI_81 or c:\temp\IWY_CI_84.
Page 22 Options pane and a Build Execute Options pane. It also contains Build, Cancel, and Settings buttons. The steps to build the options follow. a. From Build Options, select Create Views. b. Select your site’s customary option in Build Execute Options. (In the previous figure, Execute SQL is selected.) BEA Systems, Inc.
Page 23 Configuring the BEA WebLogic Adapter for PeopleSoft 8. Click Build. The following image shows the Application Designer Build Progress status window. It contains a summary of the process completed, a status bar, and Close and Cancel buttons. Note: There are zero errors and zero warnings.
Page 24 Tablespace name. For more information regarding this function, consult your PeopleSoft 8 database administrator. You have finished importing and building the Component Interfaces. To configure security for Component Interfaces, see Configuring Component Interface Security on page 2-7. BEA Systems, Inc.
Page 25: Configuring Component Interface Security
8.4 in 4-tier mode. Procedure: How to Configure Component Interface Security To configure security for each BEA WebLogic Adapter for PeopleSoft Component Interface: 1. Choose PeopleTools, Security, User Profiles, Permissions & Roles, and then Permission Lists. The following image shows the expanded Security menu displaying a list of choices under Permissions &...
Page 26 Existing Value tab (selected), Add a New Value tab, Search by list, begins with input field, Search button, Advanced Search hyperlink, and a Search Results section. 3. To display the Component Interfaces tab, click the arrow to the right of the Sign-on Times tab. BEA Systems, Inc.
Page 27 Configuring the BEA WebLogic Adapter for PeopleSoft The following image shows the Permission List opening on the General tab, the first of five tabs. The other tabs are Pages, PeopleTools, Process, and Sign-on Times. 4. To display the Component Interfaces tab, click the arrow to the right of the Sign-on Times tab.
Page 28 8. Scroll to the bottom of the Component Interfaces pane and click Save. You have finished configuring security for the Component Interfaces delivered with BEA WebLogic Adapter for PeopleSoft. To test these Component Interfaces, see Testing the Component Interfaces on page 2-11.
Page 29: Testing The Component Interfaces
Configuring the BEA WebLogic Adapter for PeopleSoft Testing the Component Interfaces You must test each of the BEA WebLogic Adapter for PeopleSoft Component Interfaces before using them. Procedure: How to Test the Component Interfaces To test the Component Interfaces: 1. In PeopleSoft Application Designer, open the IWY_CI_ATTRIBUTES Component Interface.
Page 30 The following image shows the Component Interface Tester - Find Results dialog box. It has a Find Results field, and Get Selected and Cancel buttons. 4. Highlight one of the lines with its corresponding key in the Find Results window and click the Get Selected button. 2-12 BEA Systems, Inc.
Page 31 Configuring the BEA WebLogic Adapter for PeopleSoft The relevant data for the selected key appears as shown in the following image of the Component Interface Tester. It shows the values for the keys, GetKeyInfoCollection and FindKeyInfoCollection, and the list of IWY_PSBCITEM_VW databases.
Page 32 Mode check box, a Get History check box (selected), an Edit History Items check bo, Get Existing button (selected), Create New button (unavailable), Find button, and a Cancel button. The exposed properties for the key that is entered are returned. 2-14 BEA Systems, Inc.
Page 33 Configuring the BEA WebLogic Adapter for PeopleSoft The following image shows the Component Interface Tester dialog box. It includes an Item Name pane and an Error Message Log pane. If the previous window opens, the Component Interface has been successfully tested for the Get method.
Page 34: Installing The Tcp/Ip Message Router For The Bea Weblogic Adapter For Peoplesoft
Installing the TCP/IP Message Router for the BEA WebLogic Adapter for PeopleSoft Installing the TCP/IP Message Router for the BEA WebLogic Adapter for PeopleSoft To enable PeopleSoft to send an XML event document to iWay components using TCP/IP, you must install the type of TCP/IP message router required for your PeopleSoft release: •...
Page 35: Installing The Tcp/Ip Handler For Peoplesoft Release 8.1
Configuring the BEA WebLogic Adapter for PeopleSoft Installing the TCP/IP Handler for PeopleSoft Release 8.1 The TCP/IP target connector for PeopleSoft release 8.1 is installed with iWay 5.5. The default location on Windows is: C:\Program Files\iWay55\etc\misc\peoplesoft\iwpsevent81.jar Use the corresponding location on non-Windows systems.
Page 36: Copying Peoplesoft Files Into The Lib Directory
PeopleSoft release 8.1 requires an additional file, pstools.properties found in the following directory: PS_HOME\web\jmac • psoftcrmci.jar file. This is a set of Java classes that were generated from PeopleSoft Component Interfaces. For more information, see Chapter 3, Generating Component Interface APIs. 2-18 BEA Systems, Inc.
Page 37: Generating Component Interface Apis
HAPTER Generating Component Interface APIs Topics: This section describes how to build and compile Component Interface APIs to use with the BEA WebLogic • Building the PeopleSoft API Java Adapter for PeopleSoft. Programs • Compiling the PeopleSoft API Java Programs...
Page 38: Building The Peoplesoft Api Java Programs
Procedure: How to Create a PeopleSoft API Java Program To create a PeopleSoft API Java program: 1. Open the PeopleSoft Application Designer. The following image shows the PeopleSoft Application Designer Component Interface. PeopleSoft APIs is selected from the Build menu. BEA Systems, Inc.
Page 39 5. To build all files, follow the steps in How to Build All of the API Files on page 3-4. To build APIs for specific Component Interfaces, follow the steps in How to Build APIs for a Specific Component Interface on page 3-5. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 40 PeopleSoft package field, Select APIs to Build pane, and All, None, OK, and Cancel buttons. You are now ready to compile the Java files. For more information, see Compiling the PeopleSoft API Java Programs on page 3-6. BEA Systems, Inc.
Page 41 Template field, COM Server DLL Location, C Header Files Build check box, Directory for Header file field, Java Classes Build check box, Directory containing PeopleSoft package field, Select APIs to Build pane, and All, None, OK, and Cancel buttons. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 42: Compiling The Peoplesoft Api Java Programs
Another Machine on page 3-7. Note: There are two Java programs for every API file that you selected when you built the Java programs. For more information, see Building the PeopleSoft API Java Programs on page 3-2. BEA Systems, Inc.
Page 43 PeopleSoft Application Server under the PS_HOME\Web\psjoa directory. This is the file that you placed in the adapter lib directory during installation. For more information, see theBEA WebLogic ERP Adapter Installation and Configuration manual. Procedure: How to Compile the PeopleSoft API Java Programs on Another Machine...
Page 44 5. Place the JAR file in the common lib directory. This enables the BEA WebLogic Adapter for PeopleSoft to communicate with the PeopleSoft Component Interface. For the current Windows NT version of the product, the default location is...
Page 45 Generating Component Interface APIs For more information, see the BEA WebLogic ERP Adapter Installation and Configuration manual. Note: If you are running on UNIX, do the compile and JAR steps on Windows NT and then move the file to your UNIX machine. The JAR file is binary. If you use an FTP-based tool to move your JAR file from Windows NT to UNIX, the file format must be set to binary.
Page 46 Compiling the PeopleSoft API Java Programs 3-10 BEA Systems, Inc.
Page 47: Configuring The Peoplesoft Message Router
Application Messaging (in release 8.1). If not, see Appendix D, Using PeopleSoft 8 Integration Broker, for basic information about configuring and testing. For a complete description before you work with the BEA WebLogic Adapter for PeopleSoft, see your PeopleSoft documentation.
Page 48: Configuring The Tcp/Ip Or Http Target Connector For Peoplesoft 8.4
Note: Starting with release 8.4, the Integration Broker is delivered with an HTTP Outbound Connector. This connector can be used in place of the iWAY TCP/IP84 Connector for sending messages to your BEA WebLogic Server. Procedure: How to Configure the Gateway for the TCP/IP Target Connector To configure the gateway for the TCP/IP Target Connector: 1.
Page 49 If TCPIPTARGET84 still does not appear, the connector class file was not installed in the Integration Gateway. For information about installing the TCPIPTAGER84 connector, see the BEA WebLogic ERP Adapter Installation and Configuration manual. a. Click the Properties URL for TCPIPTARGET84.
Page 50 Type values for the host and the port for the machine on which your PeopleSoft XML listener is listening for incoming messages. 5. Click OK. The Gateway window opens. 6. Scroll to the bottom of the window and click Save. You have finished configuring the gateway for the TCP/IP Target Connector. BEA Systems, Inc.
Page 51 From the Node Type drop-down list, select External. b. From the Routing Type drop-down list, select Implicit. 3. Select the Connectors tab. a. Select TCPIPTARGET84 as the Connector ID. Default values appear for the host and the port. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 52 Configuring the TCP/IP or HTTP Target Connector for PeopleSoft 8.4 b. Type values for the host and the port for the machine and port that route XML to your BEA WebLogic Server. You can accept or override the default values for individual nodes.
Page 53 Inactive status is for initial testing only. After you test your configuration, you can change the status to Active and have as many nodes and transactions as required to satisfy your business requirements. 6. Click Save. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 54 If you do not see the HTTPTARGET Connector ID, click Load. If it still does not appear, your Gateway was not installed properly. b. Check with your PeopleSoft system administrator. 4. Click the Properties URL for HTTPTARGET. BEA Systems, Inc.
Page 55 Note: For complex business situations, you can override this setting on the individual node. 6. Click OK. The Gateway window opens. 7. Scroll to the bottom of the window and click Save. You have finished configuring the gateway for the HTTP Target Connector. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 56 This procedure uses a node called EXTERNAL. For more information about creating and using nodes, see Appendix D, Using PeopleSoft 8 Integration Broker or your PeopleSoft documentation. a. From the Node Type drop-down list, select External. 4-10 BEA Systems, Inc.
Page 57 Property ID Property Name Value HEADER sendUncompressed HTTPPROPERTY Method POST PRIMARYURL URL and the port of the HTTP listener Note: For complex business situations you can configure multiple nodes and multiple listeners. BEA WebLogic Adapter for PeopleSoft User’s Guide 4-11...
Page 58 The following image shows the Transactions tab selected in PeopleSoft 8 Integration Broker. It contains Transaction information, and Add Transaction, Save, and Return to Search buttons. 5. If there are no transactions, click Add Transaction. In this procedure, the node is already configured with the LOCATION_SYNC message. 4-12 BEA Systems, Inc.
Page 59 Inactive status is for initial testing only. After you test your configuration, you can change the status to Active and have as many nodes and transactions as required to satisfy your business requirements. 7. Click Save on the Transaction List. BEA WebLogic Adapter for PeopleSoft User’s Guide 4-13...
Page 60: Configuring The Tcp/Ip Handler For Peoplesoft 8.1
For more information, see Appendix D, Using PeopleSoft 8 Integration Broker. Procedure: How to Configure the TCP/IP Handler for PeopleSoft 8.1 To configure the TCP/IP Handler for PeopleSoft 8.1to send messages to your BEA WebLogic Server: 1. In a Web browser, launch the PeopleSoft 8.1 Gateway Configuration servlet interface.
Page 61 5. Click Configure. The following image shows the Add TCPIP81 Handler Directory window. It contains an Add a TCPIP81 node button and a Back to Handler Directory hyperlink. 6. Click Add a TCPIP81 node. BEA WebLogic Adapter for PeopleSoft User’s Guide 4-15...
Page 62: Testing Your Peoplesoft Configuration
PeopleSoft 8.1 Handler Directory window. 10. Click Unload and re-Load TCPIPHandler81. You are now ready to send messages from PeopleSoft to your BEA WebLogic Server. Testing Your PeopleSoft Configuration PeopleSoft 8.1 and 8.4 provide a ping node mechanism for testing your configuration. The mechanism functions identically in both versions.
Page 63 From the Message Node Name drop-down list, select your node. b. Click Ping Node. BEA WebLogic Adapter for PeopleSoft User’s Guide 4-17...
Page 64 Testing Your PeopleSoft Configuration If you properly configured both PeopleSoft and your BEA WebLogic Server, you receive a Success message. An error indicates a configuration problem. For more information, see the Integration Broker error log. 4-18 BEA Systems, Inc.
Page 65: Creating Xml Schemas Or Web Services For Peoplesoft
Application Explorer. • Starting Servlet Application Explorer • Establishing a Target for PeopleSoft • Modifying a Target • Viewing Application System Objects • Creating an XML Schema • Generating a Web Service for PeopleSoft BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 66: Overview
Procedure: How to Start BEA WebLogic Server on Windows To start BEA WebLogic Server on Windows: 1. Click the Start menu. 2. Select Programs, BEA WebLogic Platform 8.1, User Projects, your domain for iWay, and then, click Start Server. Procedure: How to Start BEA WebLogic Server on UNIX...
Page 67 Is the name of the machine where your application server is running. port Is the port for the domain you are using for BEA. The port for the default domain is 7001. The Application Explorer opens. The following image shows on the left, the Service Adapters tab is active, and a list of the supported adapters appears.
Page 68: Establishing A Target For Peoplesoft
Establishing a Target for PeopleSoft For more information on adding instances, see the BEA WebLogic ERP Adapter Installation and Configuration manual. You are ready to create new targets for PeopleSoft. Establishing a Target for PeopleSoft To browse PeopleSoft business objects, you must create a target for the system you intend to use.
Page 69 In the Description field, type a brief description for the connection. c. From the Target Type drop-down list, select the type of target to which you are connecting. The default value is Application Server. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 70 In the Password field, type a valid password for the PeopleSoft application. 6. Click Finish. The following image shows the PeopleSoft target, PSConnect, that appears below the PeopleSoft node in the left pane. You are ready to connect to your PeopleSoft target. BEA Systems, Inc.
Page 71 To disconnect from a target using Application Explorer: 1. In the left pane, click the target to which you are connected, for example, PSConnect. 2. In the right pane, move the pointer over Operations and select Disconnect. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 72: Modifying A Target
In addition to closing a target, you can delete a target that is no longer required. You can delete it whether or not it is closed. If open, the target automatically closes before it is deleted. For more information, see How to Delete a Target on page 5-9. BEA Systems, Inc.
Page 73 Procedure: How to Delete a Target To delete a target using Application Explorer: 1. In the left pane, click the target, for example, PSConnect. 2. In the right pane, move the pointer over Operations and select Delete. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 74 Modifying a Target The confirmation dialog box opens, as shown in the following image. 3. To delete the target you selected, click OK. The PSConnect node disappears from the left pane. 5-10 BEA Systems, Inc.
Page 75: Viewing Application System Objects
Component Interfaces. The following image shows the list of PeopleSoft Component Interfaces that appears in the left pane. You can now generate schemas. For more information, see Creating an XML Schema. BEA WebLogic Adapter for PeopleSoft User’s Guide 5-11...
Page 76: Creating An Xml Schema
Is the name of the connection to the PeopleSoft system as defined in Application Explorer. Under this directory, Application Explorer creates subdirectories containing schemas. When the adapter is used with a JCA configuration, Application Explorer stores the schemas under a \schemas subdirectory of the BEA home directory, for example, C:\Program Files\iWay55\bea\config\base\schemas\peoplesoft\PsoftServer where: PsoftServer Is the name of the connection to the PeopleSoft system as defined in Application Explorer.
Page 77 2. In the right pane, move the pointer over Operations and select Generate Schema. The following image shows the Schemas pane on the right with a table that defines the root tag for each schema and provides associated hyperlinks. BEA WebLogic Adapter for PeopleSoft User’s Guide 5-13...
Page 78 4. Click the Back button on your Web browser to return to the previous window. After you create schemas, you can create Web services. After you create schemas, you can also create events. For more information, see Chapter 6, Listening for PeopleSoft Events. 5-14 BEA Systems, Inc.
Page 79: Generating A Web Service For Peoplesoft
The following image shows a list of PeopleSoft Component Interfaces in the left pane. In the right pane, the Operations menu appears expanded and shows the Create Integration Business Service and Generate Schema menu options. BEA WebLogic Adapter for PeopleSoft User’s Guide 5-15...
Page 80 4. Select the Create a new service or Use an existing service option button and click Next. The following pane opens. The following image shows the next pane containing three text fields for entry as described in the next steps. 5-16 BEA Systems, Inc.
Page 81: Testing A Web Service
1. If you are not on the Integration Business Services tab of Application Explorer, click the tab to access Web services. 2. If it is not expanded, expand the list of Web services under Integration Business Services. BEA WebLogic Adapter for PeopleSoft User’s Guide 5-17...
Page 82 XML input, an input xml field appears. 6. In the input XML field, either type a sample XML document that queries the service, or browse to the location of an XML instance and click Open. 5-18 BEA Systems, Inc.
Page 83 Retrieving a List of Locations The following sample run-time input XML file retrieves a list of locations using the LOCATION Component Interface. <?xml version="1.0" encoding="UTF-8" ?> <PS8> <component perform="browse">LOCATION</component> <key name="Setid">SHARE</key> <key name="Location">ALBERTA</key> </PS8> BEA WebLogic Adapter for PeopleSoft User’s Guide 5-19...
Page 84 Generating a Web Service for PeopleSoft 5-20 BEA Systems, Inc.
Page 85: Listening For Peoplesoft Events
Understanding Event Functionality Several port dispositions are available, and you can choose • Creating, Editing, or Deleting a Port the technique that best suits your requirements. • Creating, Editing, or Deleting a Channel BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 86: Understanding Event Functionality
How to Create a Port for the iBSE Disposition on page 6-7. • JMS. The JMS queue disposition allows an event to be enqueued to a JMS queue. For more information, see How to Create an Event Port for the JMS Queue Disposition on page 6-11. BEA Systems, Inc.
Page 87 To create a specific event port for the File disposition using Application Explorer: 1. Click the Event Adapters tab. 2. In the left pane, expand the PeopleSoft node. 3. Select the ports node. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 88 When pointing Application Explorer to an iBSE deployment, specify the destination file using the following format: ifile://[location];errorTo=[pre-defined port name or another disposition url] When pointing Application Explorer to a JCA deployment, provide the full path to the directory. BEA Systems, Inc.
Page 89 1. Follow the steps in How to Create a Port for the HTTP Disposition on page 6-5. 2. In the Port Name field, type a name for the event. 3. In the Description field, type a brief description. 4. From the Disposition Protocol drop-down list, select HTTP. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 90 Is the combination of the name of the host on which the Web server resides and the port on which the server is listening for the post operation. Is the universal resource identifier that completes the url specification. 7. Click OK. BEA Systems, Inc.
Page 91 URL. Optional. 5. Click OK. The port appears under the ports node in the left pane. In the right pane, a table appears that summarizes the information associated with the port you created. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 92 The port appears under the ports node in the left pane. In the right pane, a table appears that summarizes the information associated with the port you created. You are ready to associate the event port with a channel. For more information, see Creating, Editing, or Deleting a Channel on page 6-14. BEA Systems, Inc.
Page 93 The WSDL URL appears in the Address field. 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. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 94 5. Click OK. The event port appears under the ports node in the left pane. In the right pane, a table appears that summarizes the information associated with the event port you created. 6-10 BEA Systems, Inc.
Page 95 The URL to use to contact the JNDI provider. The syntax of this URL depends on which JNDI provider is being used. This value corresponds to the standard JNDI property: java.naming.provider.url BEA WebLogic Adapter for PeopleSoft User’s Guide 6-11...
Page 96 Creating, Editing, or Deleting a Port Parameter Description jndi_factory Is JNDI context.INITIAL_CONTEXT_FACTORY and is provided by the JNDI service provider. For WebLogic Server, the WebLogic factory is: weblogic.jndi.WLInitialContextFactory. user A user ID associated with this queue. password The password for this user ID.
Page 97 Procedure: How to Delete an Event Port To delete an event port: 1. Select the event port you want to delete. 2. In the right pane, move the pointer over Operations, and select Delete. BEA WebLogic Adapter for PeopleSoft User’s Guide 6-13...
Page 98: Creating, Editing, Or Deleting A Channel
In the left pane, expand the PeopleSoft node. The ports and channels nodes appear. b. Click the channels node. 2. In the right pane, move the pointer over Operations and select Add a new channel. 6-14 BEA Systems, Inc.
Page 99 3. Click Next. The Edit channels pane opens. The following image shows the Edit channels pane where you enter the listener port number and choose the synchronization type from the drop-down list. BEA WebLogic Adapter for PeopleSoft User’s Guide 6-15...
Page 100 A summary window opens in the right pane, showing the channel description, channel status, and available ports. All the information in the summary is associated with the channel you created. The following image shows the newly created channel with an X over its icon. 6-16 BEA Systems, Inc.
Page 101 Root directory where PeopleSoft event data is posted. Listener port Port on which to listen for PeopleSoft event data. Synchronization Choose from three synchronization options: Type • REQUEST • REQUEST_RESPONSE • REQUEST_ACK 5. Click Next. BEA WebLogic Adapter for PeopleSoft User’s Guide 6-17...
Page 102 From the drop-down list, select File Listener. 3. Click Next. The Edit Channels pane opens with three tabs in the right pane. a. In the Request tab, enter values for the parameters as described in the following table. 6-18 BEA Systems, Inc.
Page 103 If you selected threaded processing, indicates the maximum number of requests that can be processed simultaneously. 4. Click Next. The Select Ports pane opens. a. Select an event port from the list of current ports. BEA WebLogic Adapter for PeopleSoft User’s Guide 6-19...
Page 104 The Edit Channels window opens with three tabs in the right pane. a. In the Request tab, enter values for the parameters as described in the following table. Parameter Description Queue manager name Name of the queue manager to which the server must connect. 6-20 BEA Systems, Inc.
Page 105 Message Queuing applications that recognize the full path name or format name of the queue. For private queues, enter Private$. qName Is the name of the queue where messages are placed, for example, iwaykxc1\Private$\peoplesoft BEA WebLogic Adapter for PeopleSoft User’s Guide 6-21...
Page 106 You must start the channel to activate your event configuration. In the right pane, a summary provides the channel description, channel status, and available ports. All the information is associated with the channel you created. 6-22 BEA Systems, Inc.
Page 107 Procedure: How to Delete a Channel To delete a channel: 1. In the left pane, select the channel you want to delete. 2. In the right pane, move the pointer over Operations and select Delete. BEA WebLogic Adapter for PeopleSoft User’s Guide 6-23...
Page 108 Creating, Editing, or Deleting a Channel The confirmation dialog box opens, as shown in the following image. 3. To delete the channel you selected, click OK. The channel disappears from the list in the left pane. 6-24 BEA Systems, Inc.
Page 109 Listening for PeopleSoft Events BEA WebLogic Adapter for PeopleSoft User’s Guide 6-25...
Page 110 Creating, Editing, or Deleting a Channel 6-26 BEA Systems, Inc.
Page 111: Using Web Services Policy-Based Security
The following topics describe how this feature works and Policy-Based Security how to configure it. • Configuring Integration Business Note: For the iWay 5.5 RG2 Release, it is recommended that Services Policy-Based Security policy-based security not be enabled. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 112: Integration Business Services Policy-Based Security
Resource Execution policy is associated to the iBS. At that time, only users granted execution permission, or those who do not belong to a group that was denied execution permissions, have access to the iBS. BEA Systems, Inc.
Page 113: Configuring Integration Business Services Policy-Based Security
Integration Business Services node expanded on the left. a. Click the Integration Business Services tab. b. Expand the Configuration node. c. Expand the Security node. d. Expand the Users and Groups node. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 114 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). 3. Click OK. BEA Systems, Inc.
Page 115 Expand the Configuration node. c. Expand the Security node. d. Expand the Users and Groups node. e. Select Groups. 2. In the right pane, move the pointer over Operations and click Add. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 116 Cancel button to escape from the pane. a. In the Name field, type a a name for the group. b. In the Description field, type a description for the group (optional). 3. Click Next. BEA Systems, Inc.
Page 117 4. After you select a minimum of one user, click Finish. The new group is added. The following image shows a pane with a new group added to the configuration. It includes a definition of a group and the group name and description. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 118 Select Policies. The following image shows the Policies pane on the right where you apply a policy. The Operations menu displays three options, Build/Rebuild, Add, and Refresh. 2. Move the pointer over Operations and click Add. BEA Systems, Inc.
Page 119 In the Name field, type a 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. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 120 Select a minimum of one user or group from the Available pane. Note: This user ID is checked against the value in the user ID element of the SOAP header sent to iBSE in a SOAP request. 5. Click Next. 7-10 BEA Systems, Inc.
Page 121 The following image shows the pane that summarizes your configuration. It includes a definition of policies and the name, type, and description of the policies. Procedure: How to Configure IP and Domain Restrictions To configure IP and domain restrictions: 1. Open Servlet Application Explorer. BEA WebLogic Adapter for PeopleSoft User’s Guide 7-11...
Page 122 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 subnet mask for the computer group. If you select Domain, you must provide the domain name, for example, yahoo.com. 7-12 BEA Systems, Inc.
Page 123 IP addresses and domain names you are adding. 4. Click OK. The following image shows the pane that opens and summarizes your configuration including the domain name, whether access is granted or denied, and a description (optional). BEA WebLogic Adapter for PeopleSoft User’s Guide 7-13...
Page 124 Configuring Integration Business Services Policy-Based Security 7-14 BEA Systems, Inc.
Page 125: Troubleshooting
PeopleSoft. • Troubleshooting The adapter-specific errors listed in this appendix can arise • Integration Business Services whether using the adapter with a JCA or with an iBSE Engine Error Messages configuration. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 126: Troubleshooting
The log file for Application Explorer can be found under the C:\Program File\iWay55\tools\iwae\bin directory. Reference: Application Explorer The following table describes the errors and its corresponding solutions for Application Explorer. Error Solution Cannot connect to the BEA WebLogic Ensure that: Adapter for PeopleSoft from Application • PeopleSoft is running. Explorer. •...
Page 127 PeopleSoft 8.1, then they should add this file. This error message may appear, even if you are not using PeopleSoft 8.1, in this case ignore this error message. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 128 This appears to be because there is no available application server domain. [Fri Aug 27 13:06:27 EDT 2004] bea.jolt.ServiceException: Invalid Session Component Interfaces and Messages do The project is not installed properly on the not appear in the adapter tree.
Page 129: Integration Business Services Engine Error Messages
<SOAP-ENV:Fault> <faultcode>SOAP-ENV:Client</faultcode> <faultstring>Parameter node is missing</faultstring> </SOAP-ENV:Fault> </SOAP-ENV:Body> </SOAP-ENV:Envelope> In this example, iBSE did not receive an element in the SOAP request message that is mandatory for the WSDL for this business service. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 130: Adapter-Specific Error Handling
Integration Business Services consumer application. BEA WebLogic Adapter for PeopleSoft Invalid SOAP Request When the PeopleSoft agent receives a SOAP request message that does not conform to the WSDL for the business service being executed, the following SOAP response is generated.
Page 131: Empty Result From Peoplesoft Request
Troubleshooting Empty Result From PeopleSoft Request When the BEA WebLogic Adapter for PeopleSoft executes a Component Interface as a business service using input parameters passed in the SOAP request that do not match records in PeopleSoft, the following SOAP response is generated.
Page 132: Invalid Soap Request
SOAP response is generated. Note: The condition for this adapter does not yield a SOAP fault. <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"> <RunDBQueryResult run="1" /> </m:RunDBQueryResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope> BEA Systems, Inc.
Page 133: Management And Monitoring
Setting Engine Log Levels • Configuring Connection Pool Sizes • Migrating Repositories • Exporting or Importing Targets • Retrieving or Updating Web Service Method Connection Information • Starting or Stopping a Channel Programmatically BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 134: Managing And Monitoring Services And Events Using Ibse
Channel • Port Procedure: How to Configure Monitoring Settings To configure monitoring settings: 1. Ensure that your BEA WebLogic Server is started. 2. To access the monitoring console, enter the following URL in your Web browser: http://localhost:port/ibse/IBSEConfig where: localhost Is the machine where the application server is running.
Page 135: Management And
Save button. In the lower left of the window is an option to click to access more configuration settings. 3. Click More configuration. Tip: To access the monitoring console directly, enter the following URL in your Web browser: http://localhost:port/ibse/IBSEStatus BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 136 The Save History button is inactive. After you enter properties and choose whether to save or view, you can click the Start Monitoring button. BEA Systems, Inc.
Page 137 5. To stop monitoring, click Stop Monitoring. Procedure: How to Monitor Services To monitor services: 1. Ensure that your BEA WebLogic Server is started. 2. From the iBSE Monitoring Settings window, click Start Monitoring. 3. Click View Services. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 138 Total Time Total amount of time iBSE monitors services. The time starts after you click Start Monitoring in the iBSE Monitoring Settings window. Total Request Count Total number of services requests that were made during the monitoring session. BEA Systems, Inc.
Page 139 A list of failed services arranged by correlation ID. To retrieve more information for a service, you can select the service from the drop-down list. 4. Select a service from the drop-down list. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 140 Settings window, you click the home button (also located in the lower right). a. To stop a service at any time, click Suspend Service. b. To restart the service, click Resume Service. 5. Select a method for the service from the Method drop-down list. BEA Systems, Inc.
Page 141 Settings window, you click the home button (also located in the lower right). 6. For additional information about a successful service and its method, select a service based on its correlation ID from the Successful Invocation drop-down list. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 142 8. To return to the iBSE Monitoring Settings window, click home. Procedure: How to Monitor Events To monitor events: 1. Ensure that your BEA WebLogic Server is started. 2. In the iBSE Monitoring Settings window, click Start Monitoring. 3. Click View Events.
Page 143 Total number of events. Total Success Count Total number of successful event executions. Total Error Count Total number of errors that were encountered. Average Event Size Average size of an available event request. BEA WebLogic Adapter for PeopleSoft User’s Guide 9-11...
Page 144 Failed Events List of failed events arranged by correlation ID. To retrieve more information for an event, select the event from the drop-down list. 4. Select a channel from the drop-down list. 9-12 BEA Systems, Inc.
Page 145 Monitoring Settings window. a. To stop a channel at any time, click Suspend Channel. b. To start the channel, click Start Channel. 5. From the Ports drop-down list, select a port for the channel. BEA WebLogic Adapter for PeopleSoft User’s Guide 9-13...
Page 146 Monitoring Settings window. 6. For more information about a successful event and its port, select an event based on its correlation ID from the Successful Events drop-down list. 9-14 BEA Systems, Inc.
Page 147 Monitoring Settings window. a. To view the XML event document in your Web browser, click Event Message. b. To return to the iBSE Monitoring Settings window, click home. BEA WebLogic Adapter for PeopleSoft User’s Guide 9-15...
Page 148: Managing And Monitoring Services And Events Using The Jca Test Tool
Note: You must perform these steps for every new adapter target that is created using a JCA implementation of Application Explorer. In addition, you also must perform these steps for every new JCA configuration that is created using Application Explorer. 9-16 BEA Systems, Inc.
Page 149 Management and Monitoring a. Click Destroy Connection Factory for redeployment. b. Redeploy the JCA connector module using the BEA WebLogic Server console. c. In the JCA Test Tool, click Refresh Connection Factory after redeployment. 3. Click Service adapters. The following image shows the Service Adapters page that opens. The page provides a live list of available service adapters and a list of targets configured for a specific adapter.
Page 150 JCA configuration that is created using Application Explorer. a. Click Destroy Connection Factory for redeployment. b. Redeploy the JCA connector module using the BEA WebLogic Server console. c. In the JCA Test Tool, click Refresh Connection Factory after redeployment.
Page 151: Setting Engine Log Levels
Setting Engine Log Levels The following section describes how to set engine log levels for Servlet iBSE and JCA. For more information, see the iWay Installation and Configuration for BEA WebLogic documentation. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 152 <config-property-value>DEBUG</config-property-value> A directory in the configuration directory contains the logs. a. Review the logs generated by your application server. b. Leave the remainder of the previous file unchanged. 3. Save the file and exit the editor. 9-20 BEA Systems, Inc.
Page 153: Configuring Connection Pool Sizes
Explorer to configure adapter connections, browse EIS objects, configure services, and configure listeners to listen for EIS events. For more information on configuring repositories, see the iWay Installation and Configuration for BEA WebLogic documentation. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 154: File Repositories
JCA repositories to new destinations without affecting your existing configuration. For example, you may want to migrate a repository from a development environment to a production environment. The BEA WebLogic Server must be restarted to detect new repository changes.
Page 155 The following image shows the WSDL file location dialog box that opens, 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. BEA WebLogic Adapter for PeopleSoft User’s Guide 9-23...
Page 156 Cancel. 6. Select the MIGRATEREPO(MIGRATEREPO parameters) control method and click OK. The following image shows a portion of the window that opens with the structure of the SOAP envelope. It includes information about location and schemas. 9-24 BEA Systems, Inc.
Page 157 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. BEA WebLogic Adapter for PeopleSoft User’s Guide 9-25...
Page 158: Jca Repositories
URL that you specified. JCA Repositories The following procedure describes how to migrate a JCA repository. For more information on configuring JCA repositories, see the iWay Installation and Configuration for BEA WebLogic documentation. Procedure: How to Migrate a JCA Repository To migrate a JCA repository: 1.
Page 159 For more information on configuring the Microsoft SQL Server 2000 repository, see the iWay Installation and Configuration for BEA WebLogic documentation. 2. To migrate the tables that were created by the iwse.sql script for iBSE, use your Microsoft SQL Server 2000 database tool set.
Page 160 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 iWay Installation and Configuration for BEA WebLogic documentation. 9-28 BEA Systems, Inc.
Page 161 Configuration for BEA WebLogic documentation. 3. To migrate the tables that were created by the SQL script for iBSE, use your Sybase database tool set. For more information, consult your database administrator. BEA WebLogic Adapter for PeopleSoft User’s Guide 9-29...
Page 162 For more information on configuring the DB2 repository, see the iWay Installation and Configuration for BEA WebLogic documentation. You can migrate the tables that were created by the SQL script for iBSE using your DB2 database toolset.
Page 163: Exporting Or Importing Targets
3. From the SOAP menu, select Create new SOAP request. The WSDL file location dialog box opens. 4. In the Choose a file field, paste the iBSE administrative services for Application Explorer URL. 5. Click OK. BEA WebLogic Adapter for PeopleSoft User’s Guide 9-31...
Page 164 You must use these elements when importing your target. Procedure: How to Import a Target To import a target: 1. Copy the iBSE administrative services for Application Explorer URL, for example: http://localhost:7777/ibse/IBSEServlet/admin/iwae.ibs?wsdl 2. Open a third party XML editor, for example, XMLSPY. 9-32 BEA Systems, Inc.
Page 165 6. Locate the Text view icon in the toolbar. In the following image, the pointer points to the Text view icon. 7. To display the structure of the SOAP envelope as text, click the Text view icon. BEA WebLogic Adapter for PeopleSoft User’s Guide 9-33...
Page 166: Retrieving Or Updating Web Service Method Connection Information
Procedure: How to Retrieve Web Service Method Connection Information To retrieve Web service method connection information: 1. Copy the iBSE configuration service URL, for example: http://localhost:7777/ibse/IBSEServlet/admin/iwconfig.ibs?wsdl 2. Open a third party XML editor, for example, XMLSPY. 9-34 BEA Systems, Inc.
Page 167 6. Locate the Text view icon in the toolbar. In the following image, the pointer points to the Text view icon. 7. To display the structure of the SOAP envelope as text, click the Text view icon. BEA WebLogic Adapter for PeopleSoft User’s Guide 9-35...
Page 168 Procedure: How to Update Web Service Method Connection Information To update Web service method connection information: 1. Copy the iBSE configuration service URL, for example: http://localhost:7777/ibse/IBSEServlet/admin/iwconfig.ibs?wsdl 2. Open a third party XML editor, for example, XMLSPY. 9-36 BEA Systems, Inc.
Page 169 6. Locate the Text view icon in the toolbar. In the following image, the pointer points to the Text view icon. 7. To display the structure of the SOAP envelope as text, click the Text view icon. BEA WebLogic Adapter for PeopleSoft User’s Guide 9-37...
Page 170: Starting Or Stopping A Channel Programmatically
The following topic describes how to start or stop a channel programmatically. Procedure: How to Start a Channel Programmatically To start a channel programmatically: 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. 9-38 BEA Systems, Inc.
Page 171 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 control event URL, and click OK. BEA WebLogic Adapter for PeopleSoft User’s Guide 9-39...
Page 172 8. Locate the following section: <SOAP-ENV:Body> <m:STARTCHANNEL xmlns:m="urn:schemas-iwaysoftware-com:dec2002:iwse:event"> <m:channel>String</m:channel> </m:STARTCHANNEL> </SOAP-ENV:Body> 9. For the <m:channel> tag, replace the String placeholder with the name of the channel you want to start. 10. From the SOAP menu, select Send request to server. 9-40 BEA Systems, Inc.
Page 173 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 control event URL, and click OK. BEA WebLogic Adapter for PeopleSoft User’s Guide 9-41...
Page 174 8. Locate the following section: <SOAP-ENV:Body> <m:STOPCHANNEL xmlns:m="urn:schemas-iwaysoftware-com:dec2002:iwse:event"> <m:channel>String</m:channel> </m:STOPCHANNEL> </SOAP-ENV:Body> 9. For the <m:channel> tag, replace the String placeholder with the name of the channel you want to stop. 10. From the SOAP menu, select Send request to server. 9-42 BEA Systems, Inc.
Page 175: Using Application Explorer To Create Xml Schemas And Business Services
U sing Application Explorer to Create XML Schemas and Business Services Topics: This section describes how to use Java Swing Application Explorer running in BEA WebLogic Workshop to create XML • Starting Application Explorer in BEA schemas and business services for PeopleSoft Component WebLogic Workshop Interfaces (CI) and Messages.
Page 176: Starting Application Explorer In Bea Weblogic Workshop
3. From the BEA WebLogic Workshop View menu, select Windows and then, Application Explorer. Application Explorer opens in BEA WebLogic Workshop. You can resize and drag-and-drop the Application Explorer window within BEA WebLogic Workshop. For example, you can drag it to the upper part of BEA WebLogic Workshop. BEA Systems, Inc.
Page 177: Creating A New Configuration For Ibse Or Jca
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 iWay configuration. The following dialog box opens. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 178 4. Right-click the configuration to which you want to connect, and select Connect. When you connect to JCA, the Service Adapters and Event Adapters nodes appear. When you connect to iBSE, the Service Adapters, Event Adapters, and Integration Business Services nodes appear. BEA Systems, Inc.
Page 179: Connecting To Peoplesoft
The Event Adapters list includes a PeopleSoft node that enables you to create ports and channels for PeopleSoft event handling. For more information, see Adding a Control for a Resource in BEA WebLogic Workshop on page A-19. Connecting to PeopleSoft To browse PeopleSoft Component Interfaces (CI) and Messages, you must create a PeopleSoft target and connect to it.
Page 180 From the Type drop-down list, select the type of server to which you are connecting. Application Server is the default value. 4. Click OK. The Application Server dialog box opens where you must specify connection information for PeopleSoft and the application server that is hosting PeopleSoft. BEA Systems, Inc.
Page 181 2. In the right pane, enter a password for that target. 3. In the left pane, right-click the target and select Connect. The PSoftTarget node in the left pane changes to reflect that a connection was made. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 182: Managing A Target
1. Right-click the PeopleSoft target from which you want to disconnect. 2. Select Disconnect. Disconnecting from the application system drops the connection, but the node remains. The PSoftTarget node in the left pane changes to reflect that you disconnected from the target. BEA Systems, Inc.
Page 183 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. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 184: Viewing A Business Object And Creating An Xml Schema
For example, Application Explorer enables you to view Component Interfaces, Component Interfaces(RPC), and Message metadata stored in PeopleSoft. For Component Interfaces(RPC), the BEA WebLogic Adapter for PeopleSoft enables Delete, Insert, Query, Update, and Find. How to View Metadata in PeopleSoft...
Page 185 2. To expand the PeopleSoft repository node you want to explore, click the icon to the left of the repository name, for example, Component Interfaces. A list of business object groups appears. BEA WebLogic Adapter for PeopleSoft User’s Guide A-11...
Page 186 Viewing a Business Object and Creating an XML Schema 3. Click the LOCATION Component Interface. The following XML schemas appear for the LOCATION Component Interface: • Request • Response A-12 BEA Systems, Inc.
Page 187 Files\iWay55\bea\ibse\wsdl\schemas\service\PeopleSoft \PSoftConnect\S9AFF52F where: PSoftConnect Is the name of the PeopleSoft target. S9AFF52F Is a randomly generated folder name indicating where the schemas are stored. BEA WebLogic Adapter for PeopleSoft User’s Guide A-13...
Page 188: Creating A Business Service
Because Application Explorer runs within BEA WebLogic Workshop, you can easily incorporate business services into BEA WebLogic Workflows. To enable BEA WebLogic Workshop to use business services, you export the WSDL to a directory accessible to BEA WebLogic Workshop. Note: In a J2EE Connector Architecture (JCA) implementation of adapters, business services are not available.
Page 189 From the License Name drop-down list, select a license. b. In the Method Name field, type a name for the method. c. In the Method Description field, type a brief description for the method. BEA WebLogic Adapter for PeopleSoft User’s Guide A-15...
Page 190 PSoftService node is expanded, and the LOCATION method is automatically selected. On the right, the test pane opens. 5. To invoke the service, enter a sample XML document in the input xml field. For sample input XML, see Retrieving a List of Locations. A-16 BEA Systems, Inc.
Page 191: Exporting Wsdl For Use In Bea Weblogic Workshop Workflows
1. After you create a business service, right-click the business services name and select Export WSDL. The Save dialog box appears. 2. Save the WSDL to a directory accessible to BEA WebLogic Workshop, for example, the \resources directory in your BEA WebLogic Workshop Web application directory structure.
Page 192: Identity Propagation
The following is a sample SOAP header that is included in the WSDL file for a Web service: <SOAP-ENV:Header> <m:ibsinfo xmlns:m="urn:schemas-iwaysoftware-com:iwse"> <m:service>String</m:service> <m:method>String</m:method> <m:license>String</m:license> <m:disposition>String</m:disposition> <m:Username>String</m:Username> <m:Password>String</m:Password> <m:language>String</m:language> </m:ibsinfo> </SOAP-ENV:Header> Note: You can remove the following tags from the SOAP header, since they are not required: <m:disposition>String</m:disposition> <m:language>String</m:language> A-18 BEA Systems, Inc.
Page 193: Adding A Control For A Resource In Bea Weblogic Workshop
After you create a business service using Application Explorer and export the WSDL file, you can create a control for the business service. For more information on exporting a WSDL file, see How to Export WSDL for Use in BEA WebLogic Workshop Workflows on page A-17.
Page 194: Adding An Extensible Cci Control To A Bea Weblogic Workshop Application
JCA deployment. You must add an iWay control before using it in a BEA WebLogic Workshop application workflow. The following topic describes the enhanced CCI control, which is extensible and provides JCX with typed inputs and outputs for JCA in BEA WebLogic Workshop. Overview The extensible iWay CCI control provides: •...
Page 195 The following sample JCX demonstrates how to define a control for PeopleSoft using the extensible CCI control in BEA WebLogic Workshop. 1. Start BEA WebLogic Workshop and create a new project. 2. Click Add from the Controls section in the Data Palette tab, select Integration Controls, and click iWay 5.5 JCA.
Page 196 Adding an Extensible CCI Control to a BEA WebLogic Workshop Application 3. Click Yes. The Select dialog box opens. 4. Choose a subfolder for the CCI control and click Select. A-22 BEA Systems, Inc.
Page 197 Click Create a new iWay 5.5 JCA control to use and provide a new JCX name. c. Enter the adapter name, target name, and select a debug level from the drop-down list. 5. Click Create. BEA WebLogic Adapter for PeopleSoft User’s Guide A-23...
Page 198 Adding an Extensible CCI Control to a BEA WebLogic Workshop Application A new JCX file is created. 6. Right-click the control, for example, edix12CCI, and select Edit. The Design View for the control opens. 7. Click the Source View tab.
Page 199 Change the existing incoming data type to match your request data type according to the PeopleSoft schema, for example, iwaysoftwareAdapterPeoplesoftCi.PS8Document. The following syntax provides a sample PeopleSoft method call, which calls the adapter service: public iwaysoftwareAdapterPeoplesoftCiResponse.PS8Document callpSoft(iwaysoftwareAdapterPeoplesoftCi.PS8Document aRequest) throws Exception; BEA WebLogic Adapter for PeopleSoft User’s Guide A-25...
Page 200 Adding an Extensible CCI Control to a BEA WebLogic Workshop Application The following control is now available in BEA WebLogic Workshop and can be added to a workflow: Note: You can view available data types under the XML Bean Classes folder in the Application tab, which are added once you import your XML request or response schemas from Application Explorer.
Page 201: Using The Extensible Cci Control
Example The following example uses dynamic class casting to specify a schema-based input XmlObject to be casted into a pure XmlObject as a service method, which is expected by the CCI control. BEA WebLogic Adapter for PeopleSoft User’s Guide A-27...
Page 202 Adding an Extensible CCI Control to a BEA WebLogic Workshop Application The following example uses dynamic class casting where the CCI control returns a pure XmlObject, which is casted dynamically into a schema-based output XmlObject. A-28 BEA Systems, Inc.
Page 203: Using Application Explorer For Event Handling
PPENDIX U sing Application Explorer for Event Handling Topics: This section describes how to use Java Swing Application Explorer running in BEA WebLogic Workshop to create • Starting Application Explorer in BEA events in PeopleSoft. WebLogic Workshop • Understanding Event Functionality •...
Page 204: Starting Application Explorer In Bea Weblogic Workshop
3. From the BEA WebLogic Workshop View menu, select Windows and then, Application Explorer. Application Explorer opens in BEA WebLogic Workshop. You can resize and drag-and-drop the Application Explorer window within BEA WebLogic Workshop. For example, you can drag it to the upper part of BEA WebLogic Workshop. BEA Systems, Inc.
Page 205: Understanding Event Functionality
The following procedures describe how to create an event port using Application Explorer. The following port dispositions are available: • FILE • HTTP • iBSE • JMSQ • MQ Series • MSMQ • SOAP BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 206 When pointing Application Explorer to an iBSE deployment, specify the destination file using the following format: ifile://[location];errorTo=[pre-defined port name or another disposition url] When pointing Application Explorer to a JCA deployment, provide the full path to the directory. BEA Systems, Inc.
Page 207 In the right pane, a table appears that summarizes the information associated with the event port you created. You are ready to associate the event port with a channel. For more information, see Creating a Channel on page B-19. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 208 In the URL field, enter an HTTP destination. When pointing Application Explorer to an iBSE deployment, use the following format ihttp://[myurl];responseTo=[pre-defined port name or another disposition url]; When pointing Application Explorer to a JCA deployment, use the following format http://host:port/uri BEA Systems, Inc.
Page 209 In the right pane, a table appears that summarizes the information associated with the event port you created. You are ready to associate the event port with a channel. For more information, see Creating a Channel on page B-19. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 210 The following table describes the disposition parameters. Parameter Description svcName Name of the service created with iBSE. methName Name of the method created for the Integration Business Service. BEA Systems, Inc.
Page 211 In the right pane, a table appears that summarizes the information associated with the event port you created. You are ready to associate the event port with a channel. For more information, see Creating a Channel on page B-19. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 212 In the URL field, enter an MSMQ destination in the following format: msmq:/host/private$/qName;errorTo=[pre-defined port name or another disposition url] The following table defines the disposition parameters. Parameter Description host Name of the host on which the Microsoft Queuing system runs. B-10 BEA Systems, Inc.
Page 213 In the right pane, a table appears that summarizes the information associated with the port you created. You are ready to associate the event port with a channel. For more information, see Creating a Channel on page B-19. BEA WebLogic Adapter for PeopleSoft User’s Guide B-11...
Page 214 When pointing Application Explorer to an iBSE deployment, use the following format: jmsq:myQueueName@myQueueFac;jndiurl=[myurl];jndifactory=[myfactory];us er=[user];password=[xxx];errorTo=[pre-defined port name or another disposition url] When pointing Application Explorer to a JCA deployment, use the following format: jms:jmsqueue@jmsfactory;jndiurl=;jndifactory=; The following table describes the URL parameters. B-12 BEA Systems, Inc.
Page 215 The connection factory, a resource that contains information about the JMS Server. The WebLogic connection factory is: javax.jms.QueueConnectionFactory jndi_url The URL of the application server. For BEA WebLogic Server, the URL t3://host:port where: host Is the machine name where BEA WebLogic Server resides.
Page 216 From the Protocol drop-down list, select SOAP. d. In the URL field, enter an 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] B-14 BEA Systems, Inc.
Page 217 A predefined port name or another disposition URL. The URL must be complete, including the protocol. errorTo The location to which error logs are sent. Optional. A predefined port name or another disposition URL. The URL must be complete, including the protocol. BEA WebLogic Adapter for PeopleSoft User’s Guide B-15...
Page 218 In the Name field, type a name for the event port. b. In the Description field, type a brief description. c. From the Protocol drop-down list, select MQ Series. d. In the URL field, enter an MQ Series destination. B-16 BEA Systems, Inc.
Page 219: Modifying An Event Port
The following procedures describe how to edit 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. BEA WebLogic Adapter for PeopleSoft User’s Guide B-17...
Page 220 1. To view the available ports, click the Ports node in the left pane. 2. Right-click the port you want to edit, and select Edit. The Edit Port dialog box opens. 3. Make the required changes and click OK. B-18 BEA Systems, Inc.
Page 221: Creating A Channel
Event Adapters node. The list of adapters appears. 2. Click the adapter node, for example, PeopleSoft. The node expands and displays the Ports and Channels nodes. Figure 0-3 Expanded Connection Node BEA WebLogic Adapter for PeopleSoft User’s Guide B-19...
Page 222 PeopleSoft supports event handling using TCP and HTTP protocols. d. To associate one or more available ports with this channel, select the port in the Available box and click the double right arrow button to move it to the Selected box. B-20 BEA Systems, Inc.
Page 223 In the Port Number field, specify the port number for your TCP listener (required). From the Synchronization Type drop-down list, select the synchronization type for your TCP listener. 5. Click OK. The channel appears below the Channels node in the left pane. BEA WebLogic Adapter for PeopleSoft User’s Guide B-21...
Page 224: Modifying A Channel
The following procedures describe how to edit and delete a channel using Application Explorer. To review the channel settings, you select the channel name. In the right pane, a table appears that summarizes the information associated with the channel you created. B-22 BEA Systems, Inc.
Page 225 1. To view the available channels, click the Channels node in the left pane. Right-click the channel you want to edit, for example, PSoftChannel, and select Edit. The Edit Channel dialog box opens. 3. Make the required changes to the channel configuration. BEA WebLogic Adapter for PeopleSoft User’s Guide B-23...
Page 226: Deploying Components In A Clustered Bea Weblogic Environment
Deploying Components in a Clustered BEA WebLogic Environment Events can be configured in a clustered BEA WebLogic environment. You can deploy iBSE or JCA to this environment. This topic uses iBSE as an example, but you can follow the same procedures when deploying JCA.
Page 227 Configure an administrative server to manage the managed servers. b. Add and configure as many managed servers as required. c. Add and configure an HTTP router. This does not have to be a part of WebLogic and can be an outside component.
Page 228 Deploying Components in a Clustered BEA WebLogic Environment A page appears for you to specify where the Web application is located. 4. To deploy iBSE, select the option button next to the ibse directory and then click Target Module. 5. To deploy Servlet Application Explorer, select the option button next to the iwae directory and then click Target Module.
Page 229 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. BEA WebLogic Adapter for PeopleSoft User’s Guide B-27...
Page 230 How to Configure Ports and Channels in a Clustered Environment Procedure You can use Swing Application Explorer deployed in BEA WebLogic WorkShop or Servlet Application Explorer to configure ports and channels in a clustered environment. Note: Before using Servlet Application Explorer in a clustered environment, you must edit the web.xml file and specify the correct URL to your iBSE deployment.
Page 231 3. Connect to the new configuration and select the Events Adapters node in the left pane of Application Explorer. 4. Add a new port for the BEA WebLogic Adapter for PeopleSoft. For more information, see Creating an Event Port on page B-3.
Page 232 Deploying Components in a Clustered BEA WebLogic Environment 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. The following image shows two configurations.
Page 233 Using Application Explorer for Event Handling The following operations must be performed on each server: • Start channel. Starts the channel for the specific server. • Stop channel. Stops the channel for the specific server. BEA WebLogic Adapter for PeopleSoft User’s Guide B-31...
Page 234 Deploying Components in a Clustered BEA WebLogic Environment B-32 BEA Systems, Inc.
Page 235: Using Component Interfaces
This section describes how to create new Component Interfaces—and how to modify existing Component • Creating a Component Interface Interfaces—for use with the BEA WebLogic Adapter for • Viewing or Changing Available PeopleSoft. You also can use Component Interfaces Methods supplied by PeopleSoft with your application.
Page 236: Creating A Component Interface
For a complete list of property icons, see the PeopleBooks documentation. Procedure: How to Create a New Component Interface To create a Component Interface: 1. Open the PeopleSoft Application Designer. 2. From the File menu, select New. BEA Systems, Inc.
Page 237 Using Component Interfaces The following image shows the PeopleSoft Application Designer New dialog box. Component Interface is selected. It also contains OK and Cancel buttons. 3. Select Component Interface. 4. Click OK. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 238 It contains the following: Object Type list (unavailable), Selection Criteria pane containing a Project list, Name, Description, and Market fields, and an Objects marking selection criteria pane. It also contains Select, Cancel, and New Search buttons. BEA Systems, Inc.
Page 239 To select the functions to perform, right-click either the right or left pane, depending on which pane is active. For a complete list of functions, see the PeopleBooks documentation. To create the Component Interface and display the properties of the underlying Component Interface, click Yes. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 240: Viewing Or Changing Available Methods
The standard methods for the Component Interface are: • Create • Find • • Save Only those methods in the underlying component are available. For example, if the underlying component does not contain Add capabilities, Create is not available. BEA Systems, Inc.
Page 241: Securing A Component Interface
How to Configure Component Interface Security for PeopleSoft Version 8.1 on page C-8. For information on configuring security for PeopleSoft Version 8.4, see How to Configure Interface Security for PeopleSoft Version 8.4 on page C-12. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 242 Procedure: How to Configure Component Interface Security for PeopleSoft Version 8.1 The following image shows the Component Interface Properties dialog box. It contains a General and Standard Methods tab (selected), and Cancel, Create, Find, Get, and Save check boxes. BEA Systems, Inc.
Page 243 Query, and New Query buttons. Before Security can be set, you must identify the permission list(s). 2. Select the relevant permission list and click OK. For information on permission lists, see the PeopleBooks documentation. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 244 3. Insert the new Component Interface that you created. 4. Click Edit. When you select the Component Interface, all available methods appear, including user-defined methods. You can then specify whether this particular Permission List must have Full or Partial Access. C-10 BEA Systems, Inc.
Page 245 The following image shows the ALLPORTL Permission List with full access to all methods (Get, Create, Save, Cancel, and Find). It also contains OK, Cancel, Full Access All, and No Access All buttons. 5. Select the desired level of access. 6. Click OK. BEA WebLogic Adapter for PeopleSoft User’s Guide C-11...
Page 246 To configure interface security: 1. Expand PeopleTools, Security, User Profiles, and Permissions & Roles and then, click Permission Lists. The following image shows the configure component interface security window. Permissions and Roles is selected in the left pane. C-12 BEA Systems, Inc.
Page 247 The following image shows the Permission list pane and contains information for the ALLPAGES permission list. It contains Description and Navigator Homepage fields, Can Start Application Server and Allow Password to be Emailed check boxes, and Never Time-out and Specific Time-out option buttons. BEA WebLogic Adapter for PeopleSoft User’s Guide C-13...
Page 248 The following image shows the Permission list pane and contains information for the ALLPAGES permission list. It contains Description and Navigator Homepage fields, Can Start Application Server and Allow Password to be Emailed check boxes, and Never Time-out and Specific Time-out option buttons. C-14 BEA Systems, Inc.
Page 249 4. Click the right arrow next to the Sign-on Times tab. The following image shows the Component Interfaces tab and lists component interfaces for the ALLPAGES permission list. 5. Click the Component Interfaces tab. BEA WebLogic Adapter for PeopleSoft User’s Guide C-15...
Page 250 6. To add a new row to the Component Interfaces list, click the + button. The following image shows the Component Interfaces tab and lists component interfaces for the ALLPAGES permission list. It includes a component interface name field. C-16 BEA Systems, Inc.
Page 251: Testing A Component Interface
10. Scroll down in the right pane and click Save. Testing a Component Interface The BEA WebLogic Adapter for PeopleSoft uses PeopleSoft metadata and Component Interfaces, therefore, it can accommodate new or modified Component Interfaces. The adapter makes no assumptions about Component Interfaces except that they are logical and valid.
Page 252 2. To test the Component Interface, use one the following methods: To test the Component Interface using the Find method, click Find. The Component Interface Tester - Find Results dialog box opens, displaying all of the possible entries for the underlying component. C-18 BEA Systems, Inc.
Page 253 If there are more than 300 entries, a message appears as shown in the following image. a. In the left pane of the Find Results dialog box, select a field. b. To display the relevant data for that particular field, click Get Selected. BEA WebLogic Adapter for PeopleSoft User’s Guide C-19...
Page 254 You can change values if Update access was specified. Alternatively, you can test using the Create method. To test the Component Interface using the Create method: a. Enter all required key values. b. Click Create New. C-20 BEA Systems, Inc.
Page 255 After you finish making changes, right-click the top item in the pane. 3. To save your changes, click the Save icon. The keys used to create the record can be used with the Get method for viewing data. BEA WebLogic Adapter for PeopleSoft User’s Guide C-21...
Page 256 The Effective Date is one of the default values. You have finished testing the Component Interface. Before using the Component Interface, you must generate its API. For more information, see Chapter 3, Generating Component Interface APIs. C-22 BEA Systems, Inc.
Page 257: Using Peoplesoft 8 Integration Broker
Note: This section is intended as a helpful supplement; it is not a substitute for PeopleSoft documentation. For more complete and up-to-date information on PeopleSoft Messaging and Integration Broker, see the PeopleSoft Online Library for your PeopleSoft system. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 258: Peoplesoft Integration Broker
Integration Gateway and control the final output destination of the XML file. PeopleSoft release 8.4 comes with several connectors including HTTP, FTP, SMTP, JMS, POP3, and a Simple File connector that places the file in a directory on the Web Server. This section discusses the Simple File connector. BEA Systems, Inc.
Page 259: Configuring Integration Broker In Peoplesoft 8.4
To ensure that the message is active and is routed to the proper Message Channel: 1. Open Application Designer. 2. On the File menu, point to Open, click Message, and open the LOCATION_SYNC message. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 260 The following image shows the fields included in the message: Field Name, Alias, and Include. 3. To view the fields that are included in the Message, select LOCATION_TBL. 4. To view the Properties dialog box, right-click LOCATION_TBL and select Properties. BEA Systems, Inc.
Page 261 The message is routed to the Message Channel, ENTERPRISE_SETUP, and the default message version is VERSION_1 (messages can have multiple versions). 5. Click OK. 6. Save the message. You have ensured that the message is active and routed correctly. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 262 Configuring Integration Broker in PeopleSoft 8.4 Procedure: How to Configure the IntegrationGateway.properties File If your Web server is WebLogic, the IntegrationGateway.properties file resides in: c:\bea\wlserver6.1\config\peoplesoft\applications\PSIGW\Web-inf\ To configure the IntegrationGateway.properties file: 1. Using the editor of your choice, open the IntegrationGateway.properties file.
Page 263 The Properties window for the FILEOUTPUT Connector opens, as shown in the following image. a. Accept or overwrite the default values. In the previous image, the FilePath PROPERTY from the c:\temp default was changed to d:\ps\cache. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 264 In the Request Message field, specify LOCATION_SYNC. c. In the Request Message Version field, specify VERSION_1. 7. Click Add. The Transaction Detail pane opens. a. In the Routing Type drop-down list, verify that the value is Implicit. BEA Systems, Inc.
Page 265: Configuring Application Messaging In Peoplesoft Release 8.1
These tasks are described in detail in the following procedures. Procedure: How to Create and Configure a New Message Node To create and configure a new Message Node: 1. From the File menu, select New and click Message Node. BEA WebLogic Adapter for PeopleSoft User’s Guide...
Page 266 Configuring Application Messaging in PeopleSoft Release 8.1 This image shows the Message Node window and contains three options: Insert Location, Find Object References, and Delete. 2. Right-click anywhere inside the white space and select Insert Location. D-10 BEA Systems, Inc.
Page 267 3. Type the following URL for the PeopleSoft Application Gateway (handler directory): machine-name:port/servlets/psft.pt8.gateway.GatewayServlet where: machine-name Is the URL of your PeopleSoft Web server. port Is the socket on which the server is listening. The characters you type after machine-name must be case-sensitive. BEA WebLogic Adapter for PeopleSoft User’s Guide D-11...
Page 268 It contains a Local Node check box, PeopleTools Version field, Application Version field, Password field, Re-verify Password field, and Distinguished Name field. It also contains OK and Cancel buttons. a. Select the Use tab. b. In the text boxes, type the PeopleTools and Application Version numbers. D-12 BEA Systems, Inc.
Page 269 To ensure that the message is active and is routed to the proper message channel: 1. Open Application Designer. 2. On the File menu, point to Open, click Message, and open the LOCATION_SYNC message.To view the fields that are included in the message, highlight LOCATION_TBL. BEA WebLogic Adapter for PeopleSoft User’s Guide D-13...
Page 270 Configuring Application Messaging in PeopleSoft Release 8.1 3. To view the fields that are included in the message, highlight LOCATION_TBL. The following image shows the LOCATION_TBL field, selected in the left pane. It contains Field Name, Alias, and Include information. D-14 BEA Systems, Inc.
Page 271 Ensure the Status check box is selected, indicating that the message is active. c. From the Message Channel drop-down list, select ENTERPRISE_SETUP. d. From the Default Version drop-down list, select VERSION_1 (messages can have multiple versions). 5. Click OK. 6. Save the message. BEA WebLogic Adapter for PeopleSoft User’s Guide D-15...
Page 272 It contains Message Channel Status and Quality of Service option buttons, and Archive Messages and Unordered check boxes. a. Select the Use tab. b. Ensure that Message Channel status is set to Run. c. Click OK. D-16 BEA Systems, Inc.
Page 273 Create and Configure a New Message Node on page D-9. b. Click Insert. 5. Click Cancel. a. Right-click the message node and point to Routing Direction. b. From the Routing Direction menu, select Publish To. BEA WebLogic Adapter for PeopleSoft User’s Guide D-17...
Page 274 1. In a Web browser, launch the PeopleSoft 8.1 configuration servlet interface (also known as the server gateway) by typing the following URL: machine-name:port/servlets/gateway.administration where: machine-name Is the name of the application server where PeopleSoft is hosted. port Is the port number on which the application server is listening. D-18 BEA Systems, Inc.
Page 275 The Add Handler window opens, as shown in the following image. 3. Type the following full name of the Simple File Handler class. psft.pt8.filehandler.SimpleFileHandler Note: The name is case-sensitive. 4. Click Save. BEA WebLogic Adapter for PeopleSoft User’s Guide D-19...
Page 276 The Handler Directory window reopens, as shown in the following image. 5. To load the handler, click Load. After the handler loads, “Loaded successfully” appears in the Status column. 6. Click Configure. The Simple File Handler Directory window opens, as shown in the following image. D-20 BEA Systems, Inc.
Page 277 Windows NT is c:\\temp\\file. (The double slashes may not be required for your environment.) c. Select the desired output file properties. 8. Click Save. You have finished configuring the Simple File Handler. BEA WebLogic Adapter for PeopleSoft User’s Guide D-21...
Page 278: Viewing The Peoplecode For A Message
To view the PeopleCode for a message: 1. Open Application Designer. The following image shows an open Application Designer. 2. Select the Record Fields tab a. Select the LOCATION_TBL record. b. Select the PeopleCode display option. D-22 BEA Systems, Inc.
Page 279 For more information about PeopleCode, consult your PeopleSoft Online Library. You have viewed the PeopleCode for a message. You can now test Integration Broker (in PeopleSoft 8.4) or Application Messaging (in PeopleSoft 8.1). BEA WebLogic Adapter for PeopleSoft User’s Guide D-23...
Page 280: Testing The Integration Broker
Transaction window and add, update, or delete a location entry in your application. Depending on your application, the way you navigate varies. The following image displays a Financials 8.4 application where a new location with a SetID of SHARE and a Location Code of TEST001 was added. D-24 BEA Systems, Inc.
Page 281 For a complete description on how to isolate and resolve problems with your messaging environment, consult you PeopleSoft Online Library. If you still cannot send your XML file, the PeopleSoft Customer Connection can help solve your problem. BEA WebLogic Adapter for PeopleSoft User’s Guide D-25...
Page 282: Using Outbound Synchronous Messages
Create and Configure a New Gateway Node on page D-8. In either case, you must configure your outbound synchronous transaction. The BEA WebLogic Adapter for PeopleSoft can work with PeopleSoft outbound synchronous messages. Outbound synchronous messages involve additional configuration steps, both within PeopleSoft and in BEA WebLogic Server.
Page 283 Using PeopleSoft 8 Integration Broker The following image shows the Transactions pane that opens. One outbound synchronous message, IB_INST_VER_SYNC_MSG, appears in the Transaction Type list. 3. In the IB_INST_VER_SYNC_MSG row, click the Edit hyperlink. BEA WebLogic Adapter for PeopleSoft User’s Guide D-27...
Page 284 Request and response messages appear. The target system must ensure that the response message follows the format of the request message. As the target system is your BEA WebLogic Server, you must transform the XML that is sent and returned from your final destination.
Page 285 To view the PeopleCode: 1. From Application Explorer, open the PSINST_VER record. 2. Select the PeopleCode display option. 3. Select the Field Change (FCh) box for the IB_SEND_SOS_BTN field. The following image shows the code. BEA WebLogic Adapter for PeopleSoft User’s Guide D-29...
Page 286 Using Outbound Synchronous Messages D-30 BEA Systems, Inc.

BEA WebLogic User Manual

Quick Links

Troubleshooting

Need help?

Questions and answers

Related Manuals for BEA WebLogic

Summary of Contents for BEA WebLogic

Table of Contents