Configuring integration between Interact and Opportunity Detection

The integration between IBM® Interact and IBM® Opportunity Detection provides enhanced pattern recognition capabilities for your Interact implementation.

Prerequisite

You must have fully functional installations of Interact and Opportunity Detection before you can configure integration. This includes configuring data sources in Opportunity Detection, as described in the IBM® Opportunity DetectionAdministrator's Guide.

Integration is supported only for Interactive Channels defined within partition1. This is important to remember if your environment has multiple partitions.

In Opportunity Detection, use the Server Group Manager to create or identify the server group you will use to process Interact event patterns.

Follow these guidelines to configure the server group.

For convenience, you can set the name for this server group to exactly match the Interact server group that you will use to process the interactive channels where you use advanced Event Patterns.

If you use a matching name, you do not have to set the opDetectionServerGroupName property mentioned in the next step.

On the Server Group > Database tab, select a run time database connection.

Two data sources, named Interact Input Data Source and Interact Output Data Source are automatically created when you deploy a Pattern from Interact to Opportunity Detection for the first time. They are automatically mapped to the Default TCP Connector.

For complete details on configuring server groups in Opportunity Detection, see the IBM® Opportunity Detection Administrator's Guide or online help for the Opportunity Detection Server Group Manager.

Set configuration properties on the Settings > Configuration page as follows.

Configuration properties for integration
Property	Value
Campaign \| Partitions \| Partition N \| Interact \| serverGroups \| opDetectionServerGroupName	Set this property to the name of the Opportunity Detection server group you will use for processing advanced event patterns. If you do not set this property, Interact looks for an Opportunity Detection server with the same name that is specified in the Campaign \| partitions \| partition[n] \| Interact \| serverGroups \| [serverGroup] \| serverGroupName property.
Campaign \| Partitions \| Partition N \| Interact \| eventPatterns \| enableAdvancedPatterns	Set this property to True.
Interact \| services \| eventPattern \| advancedPatterns \| connectionTimeoutInMilliseconds	Set this property to the maximum time it can take to make an HTTP connection from the Interact real time environment to Opportunity Detection.
Interact \| services \| eventPattern \| advancedPatterns \| readTimeoutInMilliseconds	Set this property to the maximum time it can take to receive data after an HTTP connection is established between the Interact real time environment and Opportunity Detection.
Interact \| services \| eventPattern \| advancedPatterns \| connectionPoolSize	Optionally, change the size of the HTTP connection pool for the communication between the Interact real time environment and Opportunity Detection. The default value is 10.
Interact \| services \| configurationMonitor \| enable	If you want to be able to enable or disable the integration without having to restart real time, set this property to True.
Interact \| services \| configurationMonitor \| refreshIntervalInMinutes	If you set Interact \| services \| configurationMonitor \| enable to True, set this property to the time interval for polling the value of the Interact \| services \| eventPattern \| advancedPatterns enableAdvancedPatterns property.

Advanced Pattern Events are now available for use in your Interact installation.

Decide whether you want to use the automatic reconnection feature, and set the following properties on the Settings > Configuration page accordingly. By default, this feature is turned on.

Configuration properties for automatic reconnection
Property	Value
Interact \| services \| eventPattern \| advancedPatterns \| autoReconnect \| enable	Retain the default value of True if you want the system to reconnect automatically if connection problems occur between the Interact real time environment and Opportunity Detection.
Interact \| services \| eventPattern \| advancedPatterns \| autoReconnect \| durationInMinutes	Set this property to the time interval during which you want the system to evaluate repeated connection problems occurring between the Interact real time environment and Opportunity Detection. The default interval is 10 minutes.
Interact \| services \| eventPattern \| advancedPatterns \| autoReconnect \| numberOfFailuresBeforeDisconnect	Set this property to the number of connection failures allowed during the specified time period before the system automatically disconnects from Opportunity Detection.
Interact \| services \| eventPattern \| advancedPatterns \| autoReconnect \| consecutiveFailuresBeforeDisconnect	Retain the default value of True if you want the automatic reconnection feature to evaluate only consecutive failures of the connection between the Interact real time environment with Opportunity Detection. If you set this value to False, all failures within the specified time interval are evaluated.
Interact \| services \| eventPattern \| advancedPatterns \| autoReconnect \| sleepBeforeReconnectDurationInMinutes	The system waits the number of minutes specified in this property before reconnecting after the system disconnects due to repeated failures as specified in the other properties in this category. The default value is 5 minutes.
Interact \| services \| eventPattern \| advancedPatterns \| autoReconnect \| sendNotificationAfterDisconnect	This property determines whether the system sends an email notification when a connection failure occurs. The notification message includes the Interact real time instance name for which failure occurred and the amount of time before reconnection occurs, as specified in sleepBeforeReconnectDurationInMinutes. The default value is True, which means that notifications are sent.

How data flows between Interact and Opportunity Detection

Property	Value
Campaign \| Partitions \| Partition N \| Interact \| serverGroups \| opDetectionServerGroupName	Set this property to the name of the Opportunity Detection server group you will use for processing advanced event patterns. If you do not set this property, Interact looks for an Opportunity Detection server with the same name that is specified in the Campaign \| partitions \| partition[n] \| Interact \| serverGroups \| [serverGroup] \| serverGroupName property.
Campaign \| Partitions \| Partition N \| Interact \| eventPatterns \| enableAdvancedPatterns	Set this property to True.
Interact \| services \| eventPattern \| advancedPatterns \| connectionTimeoutInMilliseconds	Set this property to the maximum time it can take to make an HTTP connection from the Interact real time environment to Opportunity Detection.
Interact \| services \| eventPattern \| advancedPatterns \| readTimeoutInMilliseconds	Set this property to the maximum time it can take to receive data after an HTTP connection is established between the Interact real time environment and Opportunity Detection.
Interact \| services \| eventPattern \| advancedPatterns \| connectionPoolSize	Optionally, change the size of the HTTP connection pool for the communication between the Interact real time environment and Opportunity Detection. The default value is 10.
Interact \| services \| configurationMonitor \| enable	If you want to be able to enable or disable the integration without having to restart real time, set this property to True.
Interact \| services \| configurationMonitor \| refreshIntervalInMinutes	If you set Interact \| services \| configurationMonitor \| enable to True, set this property to the time interval for polling the value of the Interact \| services \| eventPattern \| advancedPatterns enableAdvancedPatterns property.