3
Supported PeopleSoft 8 Component Interfaces

This chapter provides PeopleSoft-specific information for accessing PeopleSoft Component Interfaces using OracleAS InterConnect. This chapter discusses the following topics:

• Working with OracleAS InterConnect and PeopleSoft Component Interfaces

• Working with Component Interface

• Exception Fields

• Custom Component Interface

• Creating a Subscribed Event

Working with OracleAS InterConnect and PeopleSoft Component Interfaces

OracleAS InterConnect provides a complete framework for e-Business application integration. PeopleSoft users often configure PeopleSoft to employ OracleAS InterConnect connectivity.

Working with Component Interface

When invoking a method on a Component Interface, the following warning message may display:

java.lang.NullPointerException: PSProperties not loaded from file

This message indicates the pstools.properties file cannot be found in the CLASSPATH. For PeopleSoft 8 adapter to include this file, update the service_classpath parameter in adapter.ini file.

See Also: You can find more information on this error in your PeopleSoft Customer Support Web site. The resolution ID for this issue is 703269.

Exception Fields

If an error occurs during a call, the exception field contains a detailed description of the error. You can then propagate this error string to the calling application.

For example, if a client application tries to add a record to the PeopleSoft server and the record with the same primary key already exists, a non-retryable error occurs. The exception field contains the exception data, which can then be propagated back to the client application.

Custom Component Interface

A Component Interface declares the set of methods and properties that a Component Interface supports, but it does not implement the behavior or properties. The OracleAS InterConnect PeopleSoft 8 adapter provides five standard methods for Component Interfaces:

• Bind

• Create

• Find

• Get

• Update

Before using Component Interfaces you must upload a custom Component Interface.

See Also: "Importing the Custom Component Interface"

Creating an Implemented Procedure

1. Start iStudio.

2. Right-click Implemented Procedures and select New under the Applications folder.

   Figure 3-1 Creating an Implemented Procedure

   

   Text description of the illustration psoai0001.gif

   The Implement Wizard--Select a Procedure dialog box is displayed.

   Figure 3-2 Implement Wizard - Select a Procedure

   

   Text description of the illustration selectaprocedure.gif

3. Select a procedure and click Next.

   The Define Application View dialog box is displayed. Use this dialog to import attributes from PeopleSoft. To import attributes, you must log in to PeopleSoft.

   See Also: "Importing Attributes"

   After logging in to PeopleSoft and importing attributes, the Define Application View dialog box is populated with the selected components.

4. Click Next in the Define Application View screen.

   Figure 3-3 Implement Wizard - Define Application View

   

   Text description of the illustration implwzard.gif

5. Click Next.

   The Define Mappings Arguments dialog box is displayed.

   Figure 3-4 Implement Wizard - Define Mapping:IN Arguments

   

   Text description of the illustration queagent3.gif

6. Click New.

7. Define the mappings and click Finish.

Importing Attributes

To import attributes from PeopleSoft:

1. Click Import and select PeopleSoft on the Define Application View dialog.

   The PeopleSoft Login dialog box is displayed.

   Figure 3-5 PeopleSoft Login

   

   Text description of the illustration login.gif

2. Enter information in the following fields:
   • Application Server Name--Enter a valid application server name.

   • Operator ID--Enter a valid operator ID.

   • Password--Enter a valid password.

     Note: If you do not have a valid ID and password, contact your PeopleSoft administrator.

   • PeopleSoft Version--Select 8.1x from the dropdown list.

     This disables the Data Source Dialog and enables the Component Interface Host.

   • Component Interface Host--Enter the host name and port number of the machine hosting the Component Interfaces, for example, //PEOPLE8:9000.

3. Click OK.

   The Component Selector is displayed.

4. Expand the Component Interfaces folder.

   Figure 3-6 Component Selector

   

   Text description of the illustration componentselector.gif

5. Double-click a method to expand the tree and select a method.

6. Click OK.

   The selected method and its attributes display on the Define Applications View dialog.

Creating a Subscribed Event

To create a subscribed event in iStudio:

1. Start iStudio.

2. Right-click Subscribed Event and select New under the Applications folder.

   Figure 3-7 Creating a Subscribed Event

   

   Text description of the illustration subevent1.gif

   The Subscribe Wizard--Select an Event dialog box is displayed.

   Figure 3-8 Subscribe Wizard - Select an Event

   

   Text description of the illustration subevent2.gif

3. Select the Application and Message Type from the dropdown menus.

4. Select an Event and click Next.

   The Define Application View dialog box is displayed.

   Figure 3-9 Subscribe Wizard - Define Application View

   

   Text description of the illustration subevent3.gif

5. Click Import and select PeopleSoft.

   The Define Application View dialog box is displayed. Use this dialog to import attributes from PeopleSoft. To import attributes, you must log in to PeopleSoft.

   See Also: "Importing Attributes"

   After logging in to PeopleSoft and importing attributes, the Define Application View dialog box is populated with the selected components.

   Figure 3-10 Subscribe Wizard - Define Application View

   

   Text description of the illustration subevent4.gif

6. Click Next.

   The Define Mapping dialog box is displayed.

   Figure 3-11 Subscribe Wizard - Define Mapping

   

   Text description of the illustration mesagent3.gif

7. Click New to define mappings and click Finish.