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


Chapter 5 Configuring Adapter Services : CI Subscription Service

CI Subscription Service
When running as a Subscription Service the adapter receives messages from the TIBCO Environment and inserts the message data into a PeopleSoft database through Component Interface APIs.
Configuration Options
Configure a Subscription Service under the following tabs in the Configuration Panel.
Configuration Tab
The Configuration tab contains the following fields:
The name of the Component Interface stored in the PeopleSoft database. It matches the Component Interface Name and is automatically filled in by TIBCO Designer.
TIBCO Designer automatically supplies this name when you click the Fetch Interface… button and select a Component Interface. When starting the adapter, it uses this name to find the Component Interface in PeopleSoft. You can enter a partial string in this field to filter the Component Interfaces that are presented in the drop-down list when you click the Fetch Interface… button.
For example, entering p would narrow the drop-down list to only Component Interface names beginning with p.
Available only for the JMS transport. It can be Durable or Non Durable. See Delivery Mode for details.
Available only for the Rendezvous transport. It can be Certified, Reliable or Distributed Queue. See Quality of Service for details.
Services must use the same wire format to exchange data. It can be XML Message or ActiveEnterprise Message. See Wire Format for details.
Get Schema
Click the Get Schema button to list the fields of the fetched schema in the Schema Tab.
If you have changed any configuration, either on the service level or on the instance level, click the Get Schema button to ensure that the modification is reflected in the service at runtime.
Schema Tab
In the Schema tab you can view all elements.
To view schema elements, click on the folders to expand them. It is not necessary to click the Apply button.
The Schema tab contains the following fields:
Note: The values are TIBCO field-types and not PeopleSoft field-types.
Note: The values are TIBCO field-types and not PeopleSoft field-types.
Note: The key fields are always included in the runtime input.
Advanced Tab
The Advanced tab contains the following fields:
By default, a dynamic destination is generated using the Domain and Deployment global variables, the adapter acronym, the adapter instance name, and the service name.
If you use this default dynamic destination, ensure that the values for Domain and Deployment are not empty. You can override the default dynamic destination by specifying the static destination in this field. The static destination must be defined on the EMS server before it can be used by the runtime adapter. See the TIBCO Enterprise Message Service User’s Guide for information about destinations.
Available only for the Rendezvous transport.
By default, a service uses a message subject that is generated using the Domain and Deployment global variables, the adapter acronym, the adapter instance name and the service name.
If you use this default subject, make sure the values for Domain and Deployment are not empty. You can type a TIBCO Rendezvous subject name different from the default in this field. See TIBCO Rendezvous Concepts for information about specifying subject names.
Operation Code
The input data received by the Subscription Service contains a field called operation code (OPRN_CODE) if the Component Interface associated with the service contains records that are level 1 and above. The value in the operation code field determines the mode of update carried out on child records in the target PeopleSoft database. The values that can be specified in the input data for OPRN_CODE are:
I - If the incoming row(s) is present insert it.
U - If the incoming row(s) is present, update it.
R - Replace existing row(s) with the incoming row(s). (Deprecated)
D - If the incoming row(s) is present delete it.
Null - If no operation code is specified an update is carried out.
See Implementation of Keys in the TIBCO Adapter for PeopleSoft for more information on the operation codes.
Configuration Task Sequence
To configure a Subscription Service, follow these steps:
1.
2.
Click Adapter Services in the project panel.
3.
Drag a Subscription Service icon to the Design Panel.
4.
5.
Click the Apply button. This generates a unique endpoint with a TIBCO Rendezvous subject name. The adapter automatically enters this information in the Advanced tab.
Rendezvous is selected as the default Transport Type. If you select JMS as the Transport Type, a unique endpoint with the destination name will be generated.
6.
Click the Get Schema button. This downloads the Component Interface schema from PeopleSoft to TIBCO Designer.
7.

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