PeopleSoft Adapter 6.0 | webMethods PeopleSoft Adapter Documentation | webMethods PeopleSoft Adapter Installation and User’s Documentation | Adapter Services | Configuring Insert Services
 
Configuring Insert Services
Insert services enable the adapter to insert level 0 or higher CI records into a PeopleSoft database. For more information about Insert services, see Insert Services. You configure PeopleSoft Adapter services using Designer.
*To configure an Insert 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 Insert template.
7. Click Finish.
The adapter service editor for the Insert 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 component interface to use with the Insert service. Specify a value for the following fields:
Parameter
Description/Action
Component Interface
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 copied to 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.
9. On the Key Fields tab, you can view the list of key fields that the CI requires for input services. The tab contains the following information:
Parameter
Description/Action
CI Field Name
This column lists all Create key fields for the CI.
CI Field Type
This column lists the PeopleSoft data type for each Create key field.
Input Field Name
This column lists the webMethods field names for the input fields. When running this service, these fields must contain values for the service to be able to create and insert a CI record.
Input Field Type
This column lists the webMethods data type for each input field.
10. Select the Input Fields tab and specify the CI fields that the service will use as input fields.
The tab contains the following information:
Parameter
Description/Action
CI Field Name
This column lists all available input fields for the CI.
CI Field Type
This column lists the PeopleSoft data type for each CI input 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.
CI Record Key
This column indicates whether the field is a key field for the CI record. If this column contains a check mark, then the field is required for the record indicated in the CI Record Name column.
You must select the CI Record Key fields and provide values for these fields for each level 0 or higher record you are inserting into the PeopleSoft database or PeopleSoft will return an error. You do not have to provide values for level 1 or higher records that you are not inserting.
Use Field
Select this option for each field you want to use as an input field, or click the icon to select all of the fields. You must select the CI record keys for each record the service will insert.
Each field that you select on this tab will appear in the adapter service's input signature (see the Input/Output tab) within a document called ServiceNameInput.CreateKeyFields, 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.
The insert service can use any of the fields selected on this tab when inserting a record. However, the service must contain values for the CI record key fields for each record the service will insert.
Input Field Type
This column lists the webMethods data type for each input field.
11. Select the Output Fields tab and specify whether the service will return a status. The tab contains the following information:
Parameter
Description/Action
Status Field
This column shows the STATUS output field.
Use Field
Select this option if you want the service to return a status.
If you choose to use the STATUS field, the field will appear as an output field on the service's output signature (see the service's Input/Output tab).
Output Field Name
If you choose to use the STATUS field, this column lists the webMethods field name.
Output Field Type
This column lists the webMethods data type for the STATUS output field.
12. 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.
13. From the File menu, select Save.