< Previous | Next >

Creating an import to access the EIS services on a PeopleSoft server

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:

  1. 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.
  2. Select the PeopleSoft resource adapter:
    1. 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:
      Picture of the Select an Enterprise Service Resource Adapter page
    2. Click Next. The Configuration Settings for Discovery Agent page opens.
  3. Specify the properties for connecting to the EIS system on the PeopleSoft server:
    1. In the Prefix field, type PSOFT. This is the prefix that will be added to the names of the business objects.
    2. In the Component Interface Jar field, type C:\resourceadapterci\psftci.jar.
    3. Select the Configure Additional BO Properties check box.
    4. 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.
    5. In the Hostname field, type in the IP address or hostname of the PeopleSoft server that is hosting the EIS system.
    6. In the Port Number field, type the port number as shown in the following figure:
      Picture of the Configure Settings for Discovery Agent page
    7. Click Next. The Find and Discover Enterprise Services page opens.
  4. Discover the EIS service business objects services that are available on the PeopleSoft server:
    1. 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.
    2. 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:
      Picture of the Find and Discover Enterprise Services page
    3. 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.
    4. 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:
      Picture of the Configuration Parameters window
    5. 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.
    6. 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.
    7. 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:
      Picture of the Find and Discover Enterprise Services page
    8. Click Next. The Configure Objects page opens. The properties displayed are determined by the resource adapter
  5. Specify properties for the business objects that will be imported:
    1. 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.)
    2. 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:
      Picture of the Configure Objects page
    3. 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.
    4. Click Next. The Generate Artifacts page opens.
  6. Specify properties for the artifacts that will be generated:
    1. In the Generate Artifacts page, click New beside the Module field. The New Integration Project wizard opens, as shown in the following figure:
      Picture of the New Integration Project wizard
    2. Ensure that Create a module project is selected and click Next. The New Module wizard opens.
    3. In the Module Name field, type PurchaseOrderInformation, as shown in the following figure:
      Picture of the New Module wizard
    4. Clear the Open module assembly diagram check box.
    5. Click Finish to close the New Module wizard. The new PurchaseOrderInformation module is created and the Module field is automatically set to PurchaseOrderInformation.
    6. In the Folder field, type service. This folder will contain your generated service files and it will appear in the Physical Resources view.
    7. In the Name field, replace the existing entry by typing PurchaseOrder.
    8. Accept the default selected state of the Deploy connector with module check box. The PeopleSoft resource adapter must be deployed with the module.
    9. 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.
    10. Ensure that the Use discovered connection properties radio button is selected, as shown in the following figure:
      Picture of the Generate Artifacts page
      Information about the advantages of using discovered connection properties is described in the information center topic "Best practices: Developing EIS imports and exports."
    11. In the Generate Artifacts page, scroll down to the Connection Properties section of the page, as shown in the following figure:
      Picture of the Generate Artifacts page
    12. 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.
    13. In the Hostname field, ensure that the hostname or IP address of your PeopleSoft server is specified.
    14. In the Port Number field, ensure that the correct port number is specified.
    15. In the Language field, type ENG.
  7. 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.

Feedback
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.
< Previous | Next >