Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 4 Configuring an Adapter Service Engine Instance : Siebel Adapter Configuration

Siebel Adapter Configuration
For a newly created adapter project, create a Siebel Adapter Configuration and configure it to perform tasks.
To create and configure a Siebel Adapter Configuration, follow these steps:
1.
Click the newly created project, for example TIB_SBL_Adapter, in the Project Explorer Panel, and then select File > New > Adapter Resources... from the Menu. The Create New Adapters Resource dialog appears.
Figure 30 Create New Adapters Resource Dialog
2.
Expand the Configurations folder and select Siebel Adapter. Click the Next button to open the Siebel Adapter Configuration dialog.
3.
Enter or select the parent folder for the newly created configuration file and enter the configuration file name in the File name field. The default configuration file name is SiebelAdapterConfiguration.adsblmodel.
4.
Click the Finish button to close the dialog.
5.
Double-click the configuration file under the adapter project folder in the Project Explorer Panel. The Editor Panel appears on the right with the configuration tabs.
6.
Configuration
The Configuration tab provides options to modify basic configuration information.
Figure 31 Configuration Tab
The configuration parameters are listed in Table 3, Configuration Parameters.
The total number of reconnection attempts to make before the runtime adapter or adapter service is stopped. The default value of -1 means reconnection attempts will continue indefinitely.
Connection Configuration
Siebel Connection Shared Resource for how to define a connection configuration. The options for a connection configuration are listed in Table 2, Siebel Connection Configuration Parameters.
Guidelines for Choosing an Instance Name
An instance name must use alphanumeric characters. An underscore (_) character can be used. The entire instance name must be less than 80 characters. The space character cannot be used in an instance name.
An instance name must be unique with respect to other adapter instances for the same adapter in the project. The same instance name can be used to name an adapter instance for a different adapter in the same project. For example, a Siebel adapter instance named TEST and a Siebel adapter instance named TEST can coexist in the same project.
Each instance name must be unique per adapter within a project even if each instance is defined in a different folder. That is, configuring same-named adapter instances in different folders will not make their names unique.
When you create an Adapter Service Engine instance, several resources are automatically created for it. The names of these resources derive from the name of the instance they belong to. Changing the adapter instance name results in an automatic regeneration of the resources names. If you manually modify any resource name, that particular name will not be automatically regenerated next time you rename the adapter instance.
Adapter Options
The Adapter Options tab provides options to modify base configuration information and monitoring information.
Figure 32 Adapter Options Tab
The configuration parameters for Siebel Adapter Options are listed in Table 4, Adapter Options Parameters.
Language Encoding
The default setting is 5000, or once every five seconds.
Number of Threads
Standard MicroAgent Name
Standard MicroAgent Timeout (ms)
Enable Class MicroAgent
Check this check box to enable instance or class specific standard TIBCO Hawk Microagent.
Class MicroAgent Timeout (ms)
Default MicroAgent Session
Adapter Services
The Adapter Service tab provides options for adding and configuring the following adapter services, as shown in Figure 33.
Figure 33 Adapter Services Tab
To add a service, follow these steps:
1.
Click the Add Service Name button to add a desired service into the All Siebel Adapter Services pane. The parameter configuration panes appear in the tab.
2.
For more information on each service, refer to TIBCO ActiveMatrix Adapter for Siebel Concepts.
Publisher Service
The configuration parameters for Publisher Service are listed in Table 5.
A service name must use alphanumeric characters. An underscore (_) character can be used. The entire instance name must be less than 80 characters. The space character cannot be used in an instance name. A service name cannot use substitution variables.
Convert Siebel Business Objects into AESchemas. Click Browse in the drop-down list to select a business object child from any of the previously imported BOs.
Non-Siebel Business Components
Send Complete Integration Object
Subscriber Service
The configuration parameters for Subscriber Service are listed in Table 6.
A service name must use alphanumeric characters. An underscore (_) character can be used. The entire instance name must be less than 80 characters. The space character cannot be used in an instance name. A service name cannot use substitution variables.
Convert Siebel Business Objects into AESchemas. Click Browse in the drop-down list to select a business object child from any of the previously imported BOs.
Invoke Siebel Business Service
RPC Server Service
The configuration parameters for RPC Server service are listed in Table 7, RPC Server Service Configuration Parameters.
A service name must use alphanumeric characters. An underscore (_) character can be used. The entire instance name must be less than 80 characters. The space character cannot be used in an instance name. A service name cannot use substitution variables.
Convert Siebel Business Objects into AESchemas. Click Browse in the drop-down list to select a business object child from any of the previously imported BOs.
Query Siebel Business Components
Insert/Update Siebel Business Components
Query Siebel Integration Components
Insert/Update Siebel Integration Components
Invoke a Siebel Business Service
RPC Client Service
The configuration parameters for RPC Client service are listed in Table 8, RPC Client Service Configuration Parameters.
A service name must use alphanumeric characters. An underscore (_) character can be used. The entire instance name must be less than 80 characters. The space character cannot be used in an instance name. A service name cannot use substitution variables.
Convert Siebel Business Objects into AESchemas. Click Browse in the drop-down list to select a business object child from any of the previously imported BOs.
Query Non Siebel Business Component
The adapter generates the request to the external application with the data from the Siebel application that invokes the adapter, without querying Siebel.
Query Siebel Business Components
Query Siebel Integration Components
Query Siebel Complete Integration Object
Log Sinks
The Log Sinks tab specify the output destination (sinks) for the trace messages and set the tracing level for the roles selected, as shown in Figure 34.
The following operations are introduced in this section:
Figure 34 Log Sinks Tab
Adding a Sink
To add a sink, follow these steps:
1.
Click the Add Sink Type button to add a desired sink into the All Log Sinks pane. The parameter configuration panes appear in the tab.
2.
Log Info Messages
Log Debug Messages
This trace level is reserved and should not be enabled unless requested by the TIBCO Support. This trace level writes a lot of information to the log file and significantly reduces the speed of the Adapter Service Engine.
Log Warning Messages
Log Error Messages
If checked, traces are added to the existing file at startup. If unchecked, the existing file is overwritten at startup if one of the same name exists. Only true and false are legal values.
Choose between out and error.
The Hawk sink uses the Hawk session, created and used by the Adapter Service Engine for monitoring purposes, to send tracing messages to the TIBCO Hawk monitor or Display.
Click Browse from the drop-down list to select one of the previously defined sessions.
Removing a Sink
To remove a log sink, follow these steps:
1.
2.
Click the Remove Sink button to remove the sink.
Adding Roles to a Sink
To add roles to a sink, follow these steps:
1.
2.
Click the Add Log Sink Role button to add additional roles. You can add debug, error, warning, or informational roles to sinks by selecting the corresponding roles from the Role drop-down list.
Removing Roles from a Sink
To remove roles from a sink, follow these steps:
1.
2.
Click the Remove Log Sink Role button to remove the role.

Copyright © TIBCO Software Inc. All Rights Reserved