C Using Component Interfaces

This appendix describes how to create new and modify existing component interfaces for use with Oracle Application Adapter for PeopleSoft. It also describes how to apply security to those component interfaces and how to test them.

You can:

• Use component interfaces supplied by PeopleSoft with your application.

• Component interfaces also are known as Enterprise Integration Points (EIP).

• Modify an existing component interface.

• Create a new component interface.

Before using your component interface you must apply security to it and test it.

After securing and testing a component interface, you must generate its API. For more information, see Appendix A, "Generating Component Interface APIs".

Note:

This section is intended as a helpful supplement; it is not a substitute for PeopleSoft documentation. For complete and up-to-date information about PeopleSoft component interfaces, see the PeopleSoft Online Library for your PeopleSoft system.

This appendix contains the following topics:

• Working With Properties

• Securing a Component Interface

• Testing a Component Interface

Working With Properties

You create component interfaces using the PeopleSoft Application Designer. For more information about Application Designer, see your PeopleSoft documentation.

You can add properties from the records in the component view. You can delete a property in the component interface that you do not want to expose. You can rename properties by clicking the property and then clicking again until you can enter a new name. If you rename a property, it can be referenced in the component interface only by the new name, not by the underlying component name.

Properties may have various icons adjacent to them. For example, EMPLID has an icon indicating that it is a key field from the underlying record. NAME has an icon indicating that it is an alternate key field from the underlying record. For a complete list of property icons, see the PeopleBooks documentation.

Creating a New Component Interface

To create a component interface:

1. Open the PeopleSoft Application Designer.

2. Select New from the File menu.

   The New dialog is displayed, as shown in Figure C-1.

   Figure C-1 New Dialog

   
   Description of "Figure C-1 New Dialog"
   
   

   Perform the following steps:

   1. Select Component Interface.

   2. Click OK.

      The Select Source Component for Component Interface dialog is displayed, as shown in Figure C-2.

   Figure C-2 Select Source Component for Component Interface Dialog

   
   Description of "Figure C-2 Select Source Component for Component Interface Dialog"
   
   

3. Highlight the component to use as a basis for the component interface and click Select.

   The Application Designer dialog is displayed, as shown in Figure C-3.

   Figure C-3 Application Designer Dialog

   
   Description of "Figure C-3 Application Designer Dialog"
   
   

   Note:

   If the component interface is large, expose the component properties manually.

4. To create the component interface without displaying properties and to expose component properties manually, click No.

   Perform the following steps:

   1. Drag the relevant fields from the left pane to the right pane.

   2. To select various functions to perform, right-click either the right or left pane, depending on which pane is active, as shown in Figure C-4.

      For a complete list of functions, see the PeopleBooks documentation.

5. To create the component interface and display the properties of the underlying component interface, click Yes.

   Figure C-4 Application Designer Component Interface

   
   Description of "Figure C-4 Application Designer Component Interface"
   
   

Standard Methods

The standard methods for the component interface are:

• Create

• Find

• Get

• 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.

Viewing or Changing Available Methods

To view or change available methods:

1. Display the Component Interface Properties dialog, as shown in Figure C-5.

   Figure C-5 Component Interface Properties Dialog

   
   Description of "Figure C-5 Component Interface Properties Dialog"
   
   

2. Click the Standard Methods tab.

3. Select the desired methods.

Securing a Component Interface

You must set up security for the component interface before you can begin testing.

Configuring Component Interface Security for PeopleSoft Version 8.1x

The following procedure describes how to configure component interface security for PeopleSoft Version 8.1 in 2- and 3-tier mode.

To configure component interface security:

Figure C-6 Component Interface Security Options

Description of "Figure C-6 Component Interface Security Options"

1. From the Use menu, select Permission Lists, Component Interface, and then click Update/Display, as shown in Figure C-6.

   The Permission Lists dialog is displayed, as shown in Figure C-7.

   Figure C-7 Permission Lists Dialog

   
   Description of "Figure C-7 Permission Lists Dialog"
   
   

   Before Security can be set, you must identify the permission lists.

2. Select the relevant permission list and click OK.

   For more information on permission lists, see the PeopleBooks documentation.

   The Permissions Lists pane is displayed, as shown in Figure C-8.

   Figure C-8 Peremission Lists Pane

   
   Description of "Figure C-8 Peremission Lists Pane"
   
   

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 specify whether this particular Permission List must have full or partial access.

   The ALLPORTL Permission List has full access to all methods, as shown in Figure C-9.

   Figure C-9 ALLPORTL Permission List

   
   Description of "Figure C-9 ALLPORTL Permission List"
   
   

5. Select the desired level of access.

6. Click OK.

Configuring Component Interface Security for PeopleSoft Version 8.4 or Higher

The following procedure describes how to configure component interface security for PeopleSoft Version 8.4 or higher.

To configure interface security:

Figure C-10 Configure Component Interface Security

Description of "Figure C-10 Configure Component Interface Security"

1. Expand PeopleTools, Security, User Profiles, and Permissions & Roles and then click Permission Lists, as shown in Figure C-10.

2. Click Search.

   The Permission Lists Search pane is displayed.

3. Select the relevant permission list, as shown in Figure C-11.

   Figure C-11 Permission List Pane

   
   Description of "Figure C-11 Permission List Pane"
   
   

4. Click the right arrow next to the Sign-on Times tab.

   The Component Interfaces tab appears, as shown in Figure C-12.

   Figure C-12 Component Interfaces Tab

   
   Description of "Figure C-12 Component Interfaces Tab"
   
   

5. Click the Component Interfaces tab.

6. Click + to add a new row to the Component Interfaces list.

   A field appears where you can enter the component interface name, as shown in Figure C-13.

   Figure C-13 Component Interface Name Field

   
   Description of "Figure C-13 Component Interface Name Field"
   
   

7. Enter the component interface name and click Edit.

   This example uses the component interface AR_ITEM_AGENT, as shown in Figure C-14.

   Figure C-14 Component Interface Permissions Window

   
   Description of "Figure C-14 Component Interface Permissions Window"
   
   

8. From the lists, select the desired access level for each method.

9. Click OK.

   The Permissions list window is displayed, as shown in Figure C-15.

   Figure C-15 Permissions List Window

   
   Description of "Figure C-15 Permissions List Window"
   
   

10. Scroll down in the right pane and click Save.

Testing a Component Interface

Oracle Application 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. Each component interface must be tested before being used as a source for the adapter.

If changes are made to the underlying application by the user or by a PeopleSoft upgrade and the changes invalidate a component interface, the user must repair the invalid component interface before the adapter uses it.

To test a component interface:

1. In Application Designer, select Test Component Interface from the Tools menu.

   The Component Interface Tester dialog is displayed, as shown in Figure C-16.

   Figure C-16 Component Interface Tester Dialog

   
   Description of "Figure C-16 Component Interface Tester Dialog"
   
   

2. If required, click the Component Interface Tester dialog to bring it to the foreground.

3. 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 displays all of the possible entries for the underlying component, as shown in Figure C-17. If there are more than 300 entries, a message appears.

     Figure C-17 Component Interface Tester - Find Results Dialog

     
     Description of "Figure C-17 Component Interface Tester - Find Results Dialog"
     
     

   • In the left pane of the Find Results dialog, select a field.

   • To display the relevant data for that particular field, click Get Selected.

     The Find Results dialog is displayed, as shown in Figure C-18.

     Figure C-18 Find Results Dialog

     
     Description of "Figure C-18 Find Results Dialog"
     
     

   • If the security settings permit, you can change the values in the individual fields.

4. To test the component interface using the Get method, perform the following steps:

   1. Enter the existing key(s).

   2. Click Get Existing.

      This returns the exposed properties for the key that you entered. You can change values if Update access was specified.

   Alternatively, you can test using the Create method, as shown in Figure C-19.

   Figure C-19 Component Interface Tester Dialog

   
   Description of "Figure C-19 Component Interface Tester Dialog"
   
   

   Perform the following steps:

   1. Enter all required key values.

   2. Click Create New.

      When you enter valid values in Create keys, a pane showing the JOBCODE data is displayed after the Table name is expanded with default data in place, as shown in Figure C-20.

      Figure C-20 JOBCODE Data

      
      Description of "Figure C-20 JOBCODE Data"
      
      

      You can change fields at this point. Changes are validated against the component's underlying business logic.

   3. After you finish making changes, right-click the top item in the pane.

5. To save your changes, click Save.

   The keys used to create the record can be used with the Get method for viewing data. The data that was added can be viewed in the PeopleSoft Component as shown in the following example. 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 Appendix A, "Generating Component Interface APIs".