PeopleSoft Adapter 6.0 | webMethods PeopleSoft Adapter Documentation | webMethods PeopleSoft Adapter Installation and User’s Documentation | Adapter Services | Configuring Get Services
 
Configuring Get Services
Get services enable the adapter to retrieve a single CI record from a PeopleSoft database. For more information about Get services, see Get Services. You configure PeopleSoft Adapter services using Designer.
*To configure a Get service
1. Review the steps in Before Configuring or Managing Adapter Services.
2. Start Designer.
3. Perform the following:
a. Right-click the package in which the service should be contained and select New > Adapter Service.
b. Select the parent namespace and type a name for the adapter service.
c. Click Next.
4. Select PeopleSoft Adapter as the adapter type and click Next.
5. Select the appropriate Adapter Connection Name and click Next.
6. From the list of available templates, select the Get template.
7. Click Finish.
The adapter service editor for the Get service appears. You can select the Adapter Settings tab at any time to confirm adapter service properties such as the Adapter Name, Adapter Connection Name, and Adapter Service Template, as necessary.
8. Select the Component Interface tab, if it is not already selected, to specify the PeopleSoft CI to use with the Get service. Specify values for the following fields:
Parameter
Description/Action
Component Interface Name
Specify the name of the CI with which the adapter service will interface, as follows:
*If the Enable List Of All Available CIs parameter for this service's associated adapter connection is set to TRUE, you can select the CI from a list of all available CIs on the PeopleSoft system.
The list of CIs reflects all CIs on the PeopleSoft system. However, the adapter service will only work if the CI's .class files are present in the PeopleSoft.zip in the Integration Server directory. See Setting Up Your Adapter's Environment for details.
*If the Enable List Of All Available CIs parameter for this service's associated adapter connection is set to FALSE, you must type the name of the CI. This field is case sensitive.
For more information about the Enable List Of All Available CIsoption, see Configuring Adapter Connections.
If you want Designer to display an error if you select an invalid CI name, you can turn on automatic validation of adapter services as described in Validating Adapter Service Values.
Get History Items
Select this option if you want the service to get records that have effective dates that are set to a past date.
9. Select the Key Fields tab and specify the CI's Get key fields that the service will use as input fields to determine which record to return. Fields that you select on this tab will appear in the adapter service's input signature within a document called ServiceNameInput, where ServiceName is the name you specify for the service.
The tab contains the following information:
Parameter
Description/Action
CI Field Name
This column lists all Get key fields for the CI.
CI Field Type
This column lists the PeopleSoft data type for each Get key field.
Use Field
Select this option for each field you want to use as an input for the service, or click the icon to select all of the fields. The service will use the values of these fields to determine which record to return.
Each field you select on this tab will appear in the adapter service's input signature (see the Input/Output tab) within a document called ServiceNameInput, where ServiceName is the name you specify for the service.
Input Field Name
When you choose a field on this tab, this column lists the webMethods field name. Do not change the field name or the service will not work.
Input Field Type
This column lists the webMethods data type for each input field.
10. Select the Output Fields tab and specify the CI fields that the service will use as output fields.
The tab contains the following information:
Parameter
Description/Action
CI Field Name
This column lists all available output fields for the CI.
CI Field Type
This column lists the PeopleSoft data type for each CI output field.
CI Record Name
This column lists the record names for all available records in the CI. This column is provided as a convenience, enabling you to more easily identify record names.
Use Field
Select this option for each field you want to use as an output field, or click the icon to select all of the fields. The service will return CI records containing these fields.
Each field that you select on this tab will appear in the adapter service's output signature (see the Input/Output tab) within a document called ServiceNameOutput, where ServiceName is the name you specify for the service.
Output Field Name
When you choose a field on this tab, this column lists the webMethods field name. Do not change the field name or the service will not work.
Output Field Type
This column lists the webMethods data type for each output field.
11. When using Designer the, Designer contains only the Adapter Settings and Input/Output tabs. The information from the Audit and Permissions tabs appears in the Properties panel, and the information from the Results tab appears in the Service Results panel (in Designer). For more information see the webMethods Service Development Help for your release.
12. From the File menu, select Save.