Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved


Chapter 1 Preparing PeopleSoft : Preparing PeopleSoft Component Interfaces

Preparing PeopleSoft Component Interfaces
TIBCO ActiveMatrix Adapter for PeopleSoft uses PeopleSoft component interfaces as schemas and as APIs for formatting and processing data between a PeopleSoft application and the TIBCO environment. You must prepare PeopleSoft component interfaces so the design-time adapter can download them to the adapter’s configuration tool, TIBCO Designer.
The preparation steps given under Procedure assume you know PeopleSoft procedures. For complete information about creating component interfaces and making them available, see Integration Tools: PeopleSoft Component Interfaces in PeopleSoft (Enterprise PeopleTools) Documentation Library.
Procedure lists the general setup tasks with PeopleTools for using Component Interface.
Configuration Procedure for Adapter Services lists the specific configuration details for each type of adapter service.
Procedure
Before configuring the adapter, complete the following tasks in your PeopleSoft system:
 
Task A Develop Component Interfaces
To develop the required component interfaces, you need to create or change the required component interfaces by using PeopleTools Application Designer. Make sure the component interfaces have all the records and fields you need for the type of data the adapter will be processing.
Task B Build PeopleSoft Component Interface Java APIs
To build PeopleSoft Java APIs:
1.
2.
From the menu, select Build > PeopleSoft APIs.
3.
a.
Uncheck the Build checkbox for COM Type Library.
b.
Uncheck the Build checkbox for C Header Files.
c.
Check the Build checkbox for Java Classes. Navigate to open your Target Directory and select the following from the PeopleSoft APIs to Build list:
- PeopleSoft.*
- CompIntfc.CompIntfc*
- APIs for required component interfaces: For example, for the     COUNTRY component interface, select CompIntfc.COUNTRY and     CompIntfc.COUNTRYCollection.
Figure 3 Build PeopleSoft API Bindings
4.
Task C Compile the Built PeopleSoft Component Interface Java APIs
To compile the APIs for TIBCO ActiveMatrix Adapter for PeopleSoft, you can use TIBCO Configuration Tool. You install this tool as a post-installation task. For configuration details, see Compile the Component Interface APIs Using TIBCO Configuration Tool.
TIBCO Configuration Tool does not support HPUX PA-RISC platforms. This is because the release of TIBCO Configuration Tool used with the adapter requires Eclipse 3.7 to run and Eclipse 3.7 does not support HPUX PA-RISC platforms. To compile the APIs on these platforms, see Compile the Component Interface APIs Using Other Command Utilities.
Compile the Component Interface APIs Using TIBCO Configuration Tool
TIBCO Configuration Tool is installed to TIBCO_HOME/tct when you complete the post-installation tasks.
Follow these steps to compile the PeopleSoft Component Interface Java APIs:
1.
Access to psjoa.jar: must be from a PeopleTools version compatible with your server. Contact your PeopleSoft administrator to locate this library.
2.
You can run TIBCO Configuration Tool in GUI mode, console mode, silent mode, or script mode. For detailed information on how to use the tool in each mode, see the TIBCO Configuration Tool documentation set.
Location of psjoa.jar.
CONFIG_HOME/tct/peoplesoft/date-time/scripts
Table 6, TIBCO Configuration Tool Properties in build.properties lists some of the properties that you might change in the properties file.
Location of psjoa.jar.
3.
TIB_ADPSFT8_HOME/lib/ext
Compile the Component Interface APIs Using Other Command Utilities
For the platforms which TTIBCO Configuration Tool does not support, you can compile the Component Interface APIs by using one of the following alternative approaches:
Recommended: Run BuildCI command utility under the TIB_ADPSFT8_HOME/bin directory.
Run an ANT task under the TIBCO_HOME/tct/tct_version_number/plugins/com.tibco.tct.peoplesoft_plugin_version_number/res directory.
Task D Grant Permissions for the Required Component Interfaces
To grant permissions for the component interfaces:
1.
Log in to PIA and navigate to PeopleTools > Security > Permissions & Roles > Permission Lists.
2.
3.
Click the Component Interfaces tab and find the desired component interfaces. For example, if you want to work with the Country component interface, make sure it is in the list.
4.
Edit each component interface and grant Full Access permissions to all its methods, as shown in Figure 4.
Figure 4 Set Permissions for a Component Interface
Configuration Procedure for Adapter Services
The general tasks listed in Procedure are the same for all adapter services that use Component Interface. This section introduces the specific configuration details for each adapter service as follows:
CI Publication Service
Every PeopleSoft component to be processed by a CI Publication Service of the adapter must have a shadow page (formerly “panel”) embedded in the component. Embedding is done in the PeopleTools Application Designer after you have configured the adapter in TIBCO Designer but before starting the adapter.
The shadow work page, TIB_CI_ADAPTER_WRK, is shipped with the adapter. It contains configuration-driven PeopleCode that extracts data from the component based on the adapter configuration settings.
To embed the shadow work page into a component, you need to finish:
 
Task A Insert the TIB_CI_ADAPTER_WRK Page into Components
To insert the page into the required components:
1.
2.
From the menu, select File > Open. Use the Open Definition dialog to open the required components. For example, open the components that satisfy the COUNTRY selection criteria as shown in Figure 5.
Figure 5 Open Definition Dialog
3.
From the menu, select Insert > Page Into Component. Use the Insert Page dialog to insert TIB_CI_ADAPTER_WRK page of the TIB_PS8_ADAPTER into the component.
4.
From the menu, select File > Save to save the component.
Task B Grant Component Permissions for the TIB_CI_ADAPTER_WRK page
To grant the permissions for the TIB_CI_ADAPTER_WRK page you just add to the required component.
1.
Log in to PIA and navigate to PeopleTools > Security > Permissions & Roles > Permission Lists.
2.
Navigate to PeopleTools > Security > Permissions & Roles > Permission Lists.
3.
4.
Click Edit Pages and then check the Authorized checkbox for the Tib Ci Adapter Wrk page. For example, grant permissions for the Country_Table.GBL as shown in Figure 6:
Figure 6 Grant Permission for the TIB_CI_ADAPTER_WRK Page
5.
6.
CI Subscription Service and Request-Response Service
If you are applying a PeopleSoft component interface to a Subscription Service or a Request-Response Service in the adapter, set up the fields in the CREATEKEYS, GETKEYS, and FINDKEYS folders in every component interface as shown in the following table. Remember, PeopleSoft component interfaces become schemas in the adapter.
To insert data into the PeopleSoft system, make sure that both the CREATEKEYS and GETKEYS fields are filled in, regardless of whether they are new or recently updated. For more information on the CREATEKEYS, GETKEYS, and FINDKEYS, see Implementation of Keys in the TIBCO Adapter for PeopleSoft.
The adapter provides the FINDKEYS functionality of PeopleSoft Component Interface technology as a feature which can be used with the adapter's Request-Response Service. The adapter fetches the schema for a particular component interface at design time. In addition to the CREATEKEYS and GETKEYS schemas, the adapter now fetches the FINDKEYS schema as well. Hence, at runtime, if the FINDKEYS values are specified in the incoming request, they take precedence over any GETKEYS or CREATEKEYS values specified. The adapter's Request-Response Service uses the same FINDKEYS values to query PeopleSoft and returns, as a reply, a sequence of FINDKEY values, which satisfy the query criterion.

Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved