Using the enterprise service discovery wizard, you can discover
EIS services running on a PeopleSoft server and then generate an import or
export to access the EIS services.
In this topic, you are walked through the steps in creating an import
named PurchaseOrder that accesses purchase order information on an EIS system
running on a PeopleSoft server.
For the purpose of demonstrating how to
create an import to access EIS services, it is assumed that your component
interface (CI) JAR file is named psftci.jar and that it resides in your file
system in the example path C:\resourceadapterci.
To create an import to access the EIS services on a
PeopleSoft server:
- From the File menu of the Business
Integration perspective, select New > Enterprise Service
Discovery. The Enterprise Service Discovery wizard opens to the
Select an Enterprise Service Resource Adapter page, which displays the resource
adapters that you have imported into the workbench.
- Select the PeopleSoft resource adapter:
- In the resource adapter list, select IBM WebSphere
Adapter for PeopleSoft Enterprise (version 6.0.0.1) from the 'PeopleSoft'
Connector Project, as shown in the following figure:

- Click Next. The Configuration Settings
for Discovery Agent page opens.
- Specify the properties for connecting to the EIS system on the
PeopleSoft server:
- In the Prefix field, type PSOFT.
This is the prefix that will be added to the names of the business objects.
- In the Component Interface Jar field,
type C:\resourceadapterci\psftci.jar.
- Select the Configure Additional BO Properties check
box.
- In the Username and Password fields,
type in the user name and password that you use to connect to the EIS system
on your PeopleSoft server.
- In the Hostname field, type in the IP
address or hostname of the PeopleSoft server that is hosting the EIS system.
- In the Port Number field, type the port
number as shown in the following figure:

- Click Next. The Find and Discover Enterprise
Services page opens.
- Discover the EIS service business objects services that are available
on the PeopleSoft server:
- In the Find and Discover Enterprise Services page, click Execute
Query. Based on the component interfaces that are contained in
the CI JAR file, the query runs and discovers the corresponding business objects
in the EIS system on the PeopleSoft server. These business objects are returned
and listed in the Objects discovered by query list.
- In the Objects discovered by query list,
select the business object that you want to import. The imported business
objects will represent the data structures in the EIS services on the PeopleSoft
server. In the following figure, the PO_COMP_INTERFACE business
object is selected:

- Click the Add to import list button to
add the selected business object to the Objects to be Imported list.
The Configuration Parameters window opens because the Configure
Additional BO Properties check box was selected on the Configure
Settings for Discovery Agent page.
- In the Logical Delete field, select one
attribute from the interface component to serve as a SoftDelete key. All attributes
of the interface component are available except child collection attributes.
In the following figure, the attribute Vendorid has
been selected:

- In the Logical Delete Value field, optionally
select a value for the attribute that you selected in the Logical
Delete field. This value is used to update records
in the component when a delete operation is performed. For example, if you
selected status in the Logical Delete field
and then you selected closed in the Logical
Delete Value field, records in the component would have their status value
updated to closed when the resource adapter performed
a delete operation.
- Beside the Find Keys list, click Add to
select attributes from the interface component that you want to add to the Find
Keys list, then select those attributes in the Find
Keys list that you want to add as FindKeys. You can select multiple
attributes and all attributes of the interface component are available except
child collection attributes.
- Click OK to close the Configuration Parameters
window. In the Objects to be imported list, your selected
objects are displayed as shown in the following figure:

- Click Next. The Configure Objects page
opens. The properties displayed are determined by the resource adapter
- Specify properties for the business objects that will be imported:
- In the Configure Objects page, accept the default value of Outbound in
the Service Type field. When the Outbound service
type is selected, the enterprise service discovery wizard generates an import.
(And when the Inbound service type is selected, the
wizard generates an export.)
- In the BO Location field, type the name
of a folder where you want to generate your business objects. This is recommended
to keep your business objects separated from the root folder. In the following
figure, data is specified as the BO location:

- Use the Add or Remove buttons
to add or remove service functions from the Service Functions list.
The import will invoke any service functions that appear in the list.
- Click Next. The Generate Artifacts page
opens.
- Specify properties for the artifacts that will be generated:
- In the Generate Artifacts page, click New beside
the Module field. The New Integration Project wizard
opens, as shown in the following figure:

- Ensure that Create a module project is
selected and click Next. The New Module wizard opens.
- In the Module Name field, type PurchaseOrderInformation,
as shown in the following figure:

- Clear the Open module assembly diagram check
box.
- Click Finish to close the New Module
wizard. The new PurchaseOrderInformation module is
created and the Module field is automatically set to PurchaseOrderInformation.
- In the Folder field, type service.
This folder will contain your generated service files and it will appear in
the Physical Resources view.
- In the Name field, replace the existing
entry by typing PurchaseOrder.
- Accept the default selected state of the Deploy connector
with module check box. The PeopleSoft resource adapter must be
deployed with the module.
- In the J2C Authentication Data Entry field,
type the JAAS J2C authentication alias psoftAlias (if
you chose to specify this alias in the topic "Creating an authentication alias".) Remember that any alias that you specified in the Alias field
of the administrative console is actually saved in the format nodeName/aliasName.
For example, if you specified the alias psoftAlias in
the Alias field of the administrative console, it would
probably be saved as widNode/psoftAlias and you would need to specify the
value widNode/psoftAlias in the J2C Authentication
Data Entry field.
- Ensure that the Use discovered connection properties radio
button is selected, as shown in the following figure:

Information about the advantages of using discovered connection properties
is described in the information center topic "Best practices: Developing EIS
imports and exports."
- In the Generate Artifacts page, scroll down to the Connection
Properties section of the page, as shown in the following figure:

- If you specified widNode/psoftAlias or
another valid alias in the J2C Authentication Data Entry field,
then ensure that the Username and Password fields
are empty.
- In the Hostname field, ensure that the
hostname or IP address of your PeopleSoft server is specified.
- In the Port Number field, ensure that
the correct port number is specified.
- In the Language field, type ENG.
- Click Finish. The EIS binding information
is automatically created and the import and related artifacts are generated
into the PurchaseOrderInformation module in the Business Integration view.
For information on connector properties and "best practices", refer
to the documentation for your specific adapter.