This section describes how to configure the Interaction Concentrator (ICON) Application object and other applications in the Genesys Configuration Layer in order to make various kinds of data available in the Interaction Database (IDB).
Click the tabs to view instructions for storing the various sorts of data you might require.
Storing Voice Data
In order to store voice interaction, agent state, and login session data in IDB, certain configuration settings are required in the Genesys Configuration Layer. This section describes the configuration settings that are required on the ICON Application object.
Connections:
To enable ICON to receive voice data and store it in IDB, you must configure ICON connections to appropriate T-Server instances.
Configuring for Voice Data
Any ICON Application object that has a configured connection to T-Server processes voice interaction data, regardless of the role that has been configured for the ICON application. However, to enable ICON to store interaction-related and party-related data for voice calls in IDB, you must configure the gcc role for the ICON application and associated Database Access Point (DAP).
To capture other types of data for voice objects and interactions, you must configure the appropriate values for the .
To enable ICON to identify the party that initiated release of a call, in deployments that support this functionality, set the value of the to 1.
Filtering Data
To improve Interaction Concentrator performance, consider excluding certain types of data from IDB storage. Review the filtering options in the filter-data section, and set appropriate values for your deployment.
If your deployment utilizes the feature to identify which party initiated release of a call, be aware that certain ICON filtering options can effectively disable this functionality.
For call-based reporting, the call-metrics option, in the filter-data configuration section, must be set to 0 (the default). Otherwise, ICON does not write any data to the G_CALL_STAT table.
The following options in the filter-data configuration section affect storage of information in the G_PARTY_STAT table:
- acd-party-history
- acd-party-metrics
- external-party
- observer-party
If you want to implement DN-based reporting on the parties that initiated release of calls, Genesys recommends that you retain the default values for these options, so that you do not filter party information.
For more information about using this feature, see the section about populating voice data in the
Interaction Concentrator 8.1 User’s Guide.
Storing Multimedia Data
In order to store multimedia interaction, agent state, and login session data in IDB, certain configuration settings are required in the Genesys Configuration Layer. This section describes the configuration settings that are required on the ICON Application object.
For more information about multimedia data in Interaction Concentrator, see the chapter about integrating with Genesys eServices/Multimedia and 3rd Party Media in the
Interaction Concentrator 8.1 User’s Guide.
[+] ICON Application
To enable ICON to receive eServices and 3rd Party Media data and store it in IDB, you must configure ICON connections to appropriate Interaction Server instances.
Connections
ICON cannot connect directly to an Application object of type Interaction Server. Instead, an Application object of type T-Server must represent Interaction Server.
You must perform the Interaction Server configuration differently depending on your environment, as follows:
- In a single-tenant environment or an environment with a single Interaction Server for each tenant, create a single application of type T-Server for each Interaction Server.
- In an environment with an Interaction Server that serves multiple tenants, you must create for each Interaction Server:
- One application of the Interaction Server type (which can accommodate multiple Tenants).
- As many applications of the T-Server type as there are tenants served by this Interaction Server, one for each tenant. Configure these applications using the actual Interaction Server host and port settings, following the instructions below.
To have ICON recognize connect to Interaction Server, execute the following steps:
- Create an application with application type T-Server in Configuration Server. This might be either in addition to or instead of an Interaction Server-type application, depending on your environment (see the explanation in the bullet-points above).
- On the Server Info tab of this application, specify the host and port parameters for your Interaction Server. If you are using both an Interaction Server-type application and a T-Server-type application, the host and port parameters must be identical.
- Designate the multimedia switch that Interaction Server uses as a switch for the T-Server-type application.
- Add the T-Server-type application to the Connections tab of the ICON application (instead of the Interaction Server application).
- If ICON is already running, restart it.
Important
Starting in release 8.1.2, if host or port information changes for any T-Server listed on the Connections tab, Interaction Concentrator dynamically reconnects using the new connection parameters.
While ICON disconnects from the prior host/port and connects to the new one, there might be a brief gap in data received from the T-Server.
In releases 8.1.0 and 8.1.1, you must restart ICON for updates to listed T-Servers to take effect.
[+] Other Configuration for Multimedia
There are no special requirements for other ICON Application object configuration options. The type of data that ICON captures for multimedia objects and interactions depends on the role configuration option that you configure for the ICON instance.
[+] Configuring for 3rd Party Media
To enable ICON to store information about 3rd Party Media interactions in IDB, you must configure the .
Storing Attached Data
Attached data refers to the interaction-related business data that is sent by T–Server or Interaction Server as key–value pairs (KVPs) in the UserData, Extensions, or Reasons attributes in TEvents.
Configuring Interaction Concentrator to store attached data in IDB is a two–part process:
- Specify the attached data key configuration file, which maps the key–value pairs (KVPs) in reporting event attributes to IDB tables and fields. For more information, see the Attached Data Specification File.
- Specify the attached data configuration settings in the Genesys Configuration Layer.
- For more information about attached data in Interaction Concentrator, see the chapter about processing attached data in the
Interaction Concentrator 8.1 User’s Guide.
- For information about configuring Interaction Concentrator to store user data from EventUserEvents that are distributed by T–Server or Interaction Server from other client applications (for example, from an agent desktop application), see the Storing Agent State and Login Session Data tab on this Special Configuration Requirements page.
[+] ICON Application
This section describes the configuration settings that are available on the ICON Application object.
ICON Role Configuration Option
For every ICON instance that must store attached data, make sure that the role option on the Options tab of the ICON Application object includes gud in the list of values. If you deploy a single ICON instance for the entire contact center, you can keep the default value (all). For more information, see the description of the role configuration option under ICON Role in the callconcentrator section of the Configuration Options page.
Attached Data Specification File
The adata–spec–name ICON configuration option enables you to point ICON to a different attached data specification file:
Attached Data Configuration Options
The following ICON configuration options enable you to specify what attached data ICON should store, and in what manner:
- adata–default–storage
- adata–extensions–history
- adata–reasons–history
- adata–userdata–history
Review the descriptions and values for the configuration options under Attached Data in the callconcentrator section of the Configuration Options page. Select the appropriate values for your environment, and make related configuration changes on the Options tab of the ICON Application object.
Custom Dispatcher Configuration Options
The following ICON configuration options enable you to specify how the custom dispatcher will process attached data:
- gud–cust–disp
- gud–cust–disp–groups
Review the descriptions and values for the configuration options under Custom Dispatcher in the callconcentrator section of the Configuration Options page. . Select the appropriate values for your environment, and make related configuration changes on the Options tab of the ICON Application object.
[+] Overview: Attached Data Specification File
If you require ICON to store attached data in IDB, create an attached data specification for ICON to use. The attached data specification is an XML file stored in the installation directory that you specify when you install the Interaction Concentrator application.
Important
If you change the XML file, you must restart ICON in order for the changes to take effect.
For sample attached data specifications, see:
- Sample Basic Attached Data Specification
- Sample Specification for Multimedia Attached Data
- Sample Specification for Customized Attached Data
In this section, unlike in the rest of this document, angle brackets indicate required syntax elements and do not indicate placeholders. Italics indicate placeholder text.
This section provides information about the following topics:
[+] Parser Limitations
The ICON XML parser imposes the following limitations:
- ICON ignores unknown attributes if they are present in the specification. When parsing the XML specification, ICON checks only for missing attributes.
- The ICON XML parser does not support namespaces.
- ICON ignores duplicate keys. Only the first occurrence of a key name is used to update the specified field in the database table.
[+] Attribute Values
This section describes the attributes that are used in the XML schema definition.
History Types
The following values can be used as history types:
none
|
No value for a given key is recorded in IDB.
|
first
|
Only the first value for a given key is recorded in IDB.
|
last
|
Only the last value for a given key is recorded in IDB.
|
all
|
Every change in value for a given key is recorded in IDB. This value applies only to keys that are configured to be stored in the history tables.
|
Storage Types
The table below shows the IDB table in which each attribute is stored.
Attribute Name
|
IDB Table Name
|
public
|
G_USERDATA_HISTORY
|
secure
|
G_SECURE_USERDATA_HISTORY
|
call
|
G_CALL_USERDATA
|
call-cust
|
G_CALL_USERDATA_CUST
|
call-cust1
|
G_CALL_USERDATA_CUST1
|
call-cust2
|
G_CALL_USERDATA_CUST2
|
mcr-f
|
GM_F_USERDATA
|
mcr-l
|
GM_L_USERDATA
|
user_supplied_name, such as cust-disp-group-n
|
Customer-defined name, as specified in the custom dispatcher.
|
Data Source Types
The following table shows the TEvent attribute from which each attribute is derived.
Attribute Name
|
TEvent Attribute Name
|
reasons
|
AttributeReasons
|
extensions
|
AttributeExtensions
|
userdata
|
AttributeUserData
|
[+] IDB Fields
The mapping between the field attribute (the logical key name) in the attached data specification and fields in the IDB tables is predefined. This section describes the predefined IDB fields for:
Predefined IDB Columns—Voice
For voice calls, the table below shows the predefined IDB field in which each attribute is stored in the G_CALL_USERDATA table.
Attribute Name
|
G_CALL_USERDATA Field
|
customer-segment
|
G_CUSTOMER_SEGMENT
|
service-type
|
G_SERVICE_TYPE
|
service-subtype
|
G_SERVICE_SUBTYPE
|
business-result
|
G_BUSINESS_RESULT
|
customer-id
|
CUSTOMER_ID
|
transaction-id
|
TRANSACTION_ID
|
cause-id
|
CAUSE_ID
|
account-id
|
ACCOUNT_ID
|
destination-id
|
DESTINATION_ID
|
target-id
|
TARGET_ID
|
Predefined IDB Columns—Multimedia
For eServices and 3rd Party Media interactions, the following table shows the predefined IDB fields in the GM_F_USERDATA and GM_L_USERDATA tables in which multimedia-specific attributes are stored. All the IDB fields listed in this table can be used for customer-defined keys.
Important
- In this table, the Key Name and Field columns refer to Attached Data Specification attributes.
- For any field attributes marked with an asterisk (*), if it is not mapped to a customer-defined key in the attached data specification file, the IDB field will be populated with the value of the predefined key.
Predefined Key Name
|
Key Name
|
Field
|
IDB Field
|
GM_F_USERDATA Table
|
|
|
|
FromPersonal
|
MyKeyName (customer-defined)
|
mcr-from-name
|
G_FROM_NAME
|
|
MyKeyName (customer-defined)
|
mcr-called-back
|
G_CALLED_BACK
|
Subject
|
MyKeyName (customer-defined)
|
*mcr-subject
|
G_SUBJECT
|
Origination_Source
|
MyKeyName (customer-defined)
|
*mcr-origin-source
|
G_ORIGIN_SOURCE
|
FromAddress
|
MyKeyName (customer-defined)
|
*mcr-from-address
|
G_FROM_ADDRESS
|
|
MyKeyName (customer-defined)
|
mcr-reserved-1 through mcr-reserved-4
|
G_RESERVED1 through G_RESERVED4
|
GM_L_USERDATA Table
|
|
|
|
|
MyKeyName (customer-defined)
|
mcr-suggested-response
|
G_S_RESPONSE
|
|
MyKeyName (customer-defined)
|
mcr-auto-response
|
G_A_RESPONSE
|
|
MyKeyName (customer-defined)
|
mcr-auto-ack
|
G_A_ACK
|
ContactId
|
MyKeyName (customer-defined)
|
mcr-ucs-contact-id
|
G_UCS_CONTACT_ID
|
Predefined IDB Columns—Custom Fields
ICON creates the IDB G_CALL_USERDATA_CUST* fields in the G_CALL_USERDATA_CUST* tables for the custom attributes that you might use in your attached data specification. You can use these fields for both voice and multimedia interactions.
- The G_CALL_USERDATA_CUST* fields are named CUST_DATA_1, CUST_DATA_2, CUST_DATA_3, and so on to CUST_DATA_19.
- As needed, you can use the following attribute names, which correspond to the similarly-numbered G_CALL_USERDATA_CUST* fields: cust-data-1, cust-data-2, cust-data-3, and so on to cust-data-19.
[+] Universal Routing Server Attached Data
Universal Routing Server (URS) distributes a standard set of attached data that usually exceeds reporting requirements for actual deployments.
To improve performance and conserve database resources, ICON does not store values for these keys in the IDB history tables by default, regardless of the value that you specify for the adata-userdata-history option (under Attached Data in the callconcentrator section of the Configuration Options page. If you require some or all of the following keys to be stored, explicitly define the respective keys in your attached data specification.
Depending on whether you specify the URS keys in the <public> or <secure> sections of the attached data specification, the KVP data will be stored in the KeyName, Value, and, if you also specify the id attribute, KEYID fields in the G_USERDATA_HISTORY or the G_SECURE_USERDATA_HISTORY table.
For an example of an attached data specification that includes URS attached data keys, see the Basic Sample tab on the Attached Data Specification File page.
Important
As a result of separate ICON processing, the value of any key that is marked with an asterisk (*) in the tables below is stored in the
G_ROUTE_RESULT table by default. You must nevertheless include this key in the attached data specification file if you want the key value to be stored in the user data history tables.
source=“userdata”
|
|
|
CBR-Interaction_cost
|
RTargetAgentGroup
|
RTargetUsed/RTargetType
|
CBR-IT-path_DBIDs
|
RTargetRuleSelected
|
RTargetAgSelDBID
|
CBR-actual_volume
|
*RTargetObjectSelected
|
CustomerSegment
|
CBR-contract_DBIDs
|
*RTargetTypeSelected
|
RTargetPlSelDBID
|
RStrategyDBID
|
*RTargetAgentSelected
|
RRequestedSkills
|
ServiceType
|
*RTargetPlaceSelected
|
RTargetPlaceGroup
|
ServiceObjective
|
*RStrategyName
|
RTargetCampaignGroup
|
RVQID
|
*RRequestedSkillCombination
|
RouterData70
|
RTargetObjSelDBID
|
*RTenant
|
|
RTargetRequested
|
RTargetUsed/RTargetName
|
|
source=“reasons”
|
|
|
RTR
|
RTargetObjSelDBID
|
RTargetUsed/RTargetName
|
CBR-Interaction_cost
|
*RTargetRuleSelected
|
RTargetUsed/RTargetType
|
CBR-IT-path_DBIDs
|
*RTargetObjectSelected
|
RTargetAgSelDBID
|
CBR-actual_volume
|
*RTargetTypeSelected
|
CustomerSegment
|
CBR-contract_DBIDs
|
*RTargetAgentSelected
|
RTargetPlSelDBID
|
RStrategyDBID
|
*RTargetPlaceSelected
|
RRequestedSkills
|
ServiceType
|
*RStrategyName
|
RTargetPlaceGroup
|
ServiceObjective
|
*RRequestedSkillCombination
|
RTargetCampaignGroup
|
RVQID
|
*RTenant
|
RouterData70
|
source=“extensions”
|
|
|
Reasons/RTR
|
*Reasons/RRequestedSkillCombination
|
RTargetUsed/RTargetName
|
Reasons/ServiceType
|
*Reasons/RTenant
|
RTargetUsed/RTargetType
|
Reasons/ServiceObjective
|
Reasons/RTargetAgSelDBID
|
Reasons/RTargetUsed
|
Reasons/RVQID
|
Reasons/CustomerSegment
|
Reasons/RTargetUsed/RTargetName
|
Reasons/RTargetObjSelDBID
|
Reasons/RTargetPlSelDBID
|
Reasons/RTargetUsed/RTargetType
|
Reasons/RStrategyDBID
|
Reasons/RRequestedSkills
|
Reasons/CBR-IT-path_DBIDs
|
*Reasons/RTargetRuleSelected
|
Reasons/RTargetPlaceGroup
|
Reasons/CBR-Interaction_cost
|
*Reasons/RTargetObjectSelected
|
Reasons/RTargetCampaignGroup
|
Reasons/CBR-actual_volume
|
*Reasons/RTargetTypeSelected
|
Reasons/RouterData70
|
Reasons/CBR-contract_DBIDs
|
*Reasons/RTargetAgentSelected
|
ReportingEventSequenceNumber
|
Reasons/RTR
|
*Reasons/RTargetPlaceSelected
|
Reasons
|
Reasons/RTargetAgentGroup
|
*Reasons/RStrategyName
|
RTargetUsed
|
Reasons/RTargetRequested
|
Storing Virtual Queue Data and Extended Route Results
This section provides information about the configuration settings in the Genesys Configuration Layer that are related to virtual queue functionality. The default configuration settings enable the storage of virtual queue data, provided that your releases of both Interaction Concentrator and URS support virtual queue functionality.
Configuration settings on the ICON Application object, the virtual queue DN object, and the Switch object enable you to manipulate virtual queue monitoring in the following ways:
- Change the storage mode of Interaction Concentrator.
- Disable monitoring and data storage for a particular virtual queue.
- Disable monitoring and data storage at the switch level—that is, for all virtual queues that belong to a particular switch.
For more information about virtual queue data in Interaction Concentrator, see the chapter about monitoring virtual queues and routing points in the
Interaction Concentrator 8.1 User’s Guide.
[+] Universal Routing Server
Although a URS release that supports virtual queue functionality is necessary in order to enable virtual queue monitoring in Interaction Concentrator, no special configuration is required on the URS side.
Beginning in release 7.6, URS provides additional information to ICON regarding the reason for routing an interaction using the AttributeReason of routing events. URS can also attach information to interactions about the targets for which it is waiting. (For more information, see the section about monitoring route results on routing points in the
Interaction Concentrator 8.1 User’s Guide.) To make this information available to Interaction Concentrator for downstream reporting purposes, set the following configuration options to true on the URS Application object:
- report_reasons
- report_targets
For more information about these URS configuration options, see the
Universal Routing Reference Manual.
[+] ICON Application
The default settings enable ICON to receive virtual queue data and store it in IDB.
Connections
Although a URS release that supports virtual queue functionality is necessary in order to enable virtual queue monitoring in Interaction Concentrator, ICON receives the data from T–Server or Interaction Server. Therefore, no connection to URS is required.
vq–write–mode
The vq–write–mode configuration option enables you to switch the storage mode for virtual queue data, if necessary. For descriptions of the storage modes, see the chapter about monitoring virtual queues and routing points in the
Interaction Concentrator 8.1 User’s Guide. You configure the vq–write–mode option in the callconcentrator section on the Options tab of the ICON Application object.
extended–route–result
The extended–route–result configuration option specifies whether ICON stores extended routing results (from URS) in IDB. You configure extended–route–result in the callconcentrator section on the Options tab of the ICON Application object.
Important
- To store extended route results in IDB, ICON requires URS release 7.6 and Interaction Server release 7.6.000.18 (or higher).
- Interaction Concentrator functionality related to storing Virtual Queues history in the G_ROUTE_RES_VQ_HIST table requires URS release 8.1 or higher.
For more information about these options, see the configuration options under Virtual Queue in the callconcentrator section on the Configuration Options page.
[+] Virtual Queue DN
Unless you need to disable monitoring and data storage for a particular virtual queue, no configuration is necessary for the DN object that represents this virtual queue in the Configuration Layer.
monitor
The monitor configuration option enables you to turn off ICON monitoring and data storage for a particular virtual queue, if necessary. If the option is set to 0, ICON does not register with T–Server to receive events that pertain to this virtual queue. You configure the monitor option in the gts section on the Annex tab of the DN object that is configured for this virtual queue. For more information about this option, see the DN tab on the Configuration Options page.
[+] Switch
Unless you need to disable virtual queue monitoring and data storage for a particular switch, no configuration is necessary for the corresponding Switch object in the Configuration Layer.
support–dn–type–5
The support–dn–type–5 configuration option enables you to turn off ICON monitoring and data storage for all virtual queues that belong to a particular switch, if necessary. If the option is set to 0, ICON does not register with T–Server to receive events that pertain to virtual queue DNs that belong to this switch. In this case, ICON does not process or store virtual queue–related TEvents, even if the monitor option is set to 1 for any of the virtual queues that belong to the switch. You configure the support–dn–type–5 option in the gts section on the Annex tab of the Switch object that is configured for this switch. For more information about this option, see the Switch tab on the Configuration Options page.
Storing Agent State and Login Session Data
In order to store agent state and login session data for voice and multimedia interactions in IDB, certain configuration settings are required in the Genesys Configuration Layer.
To enable ICON to receive agent data and store it in IDB, you must configure ICON connections to appropriate T–Server and Interaction Server instances.
Important
When ICON terminates a login session as ‘stuck’—that is, some issue has made it necessary to terminate the login session without receiving
EventLogout—all active reason codes related to the terminated session are removed from the
G_AGENT_STATE_RC_A table (stores active reason codes) and are not transferred to the
G_AGENT_STATE_RC table (stores reason code history).
[+] ICON Application Configuration
ICON Role
For every ICON instance that must store agent state or agent login session data, make sure that the role option on the Options tab of the ICON Application object includes gls in the list of values. If you deploy a single ICON instance for the entire contact center, you can keep the default value (all). For more information, see the description of the role configuration option under ICON Role in the callconcentrator section on the Configuration Options page.
Other Options
Interaction Concentrator provides a number of options to control reporting on agent login session metrics and agent login sessions—for example, gls–acw–first and gls–active–reason–codes (see the configuration options under Agent login session metrics and Agent login session in the callconcentrator section of the Configuration Options page). Review the relevant options and set appropriate values for your deployment.
[+] Configure ICON to Use Custom States
In order for ICON to store information to support reporting about custom states and common data, you must do the following:
- Set appropriate values for the following ICON Application configuration options (see the custom-states section on the Configuration Options page):
- AgentRecordUserTypes, which defines the custom agent states
- AgentUserFields
- EventData
- GlobalData
- store–event–data
- Configure the agent desktop application to send the applicable key–value pairs (KVPs) to T–Server, so that they can be included in the UserData of EventUserEvent, as explained below.
Agent Desktop Application Configuration
ICON records the beginning and end of a custom state, based on information that it receives in the UserData of an EventUserEvent from T–Server. You must configure your agent desktop application to send T–Server the appropriate KVP information for the EventUserEvent UserData.
[+] Start Recording a Custom State
In order for ICON to start recording a custom state, the desktop application must send the following KVP:
Key = "<StateKeyName>", Value = "+"
Example
"AfterCallWork", "+"
[+] Send Custom State Data
In order for ICON to store additional information about an active custom state, the desktop application must send the following KVP:
Key = "<CommentKey>", Value = "<StateCode>, <Comment>"
You can configure more than one comment key for the same custom state. However, for each comment key, ICON can store only one value. If multiple KVPs are sent for the same comment key, ICON stores only the last value.
Example
"Comment", "207, This is data about the state"
"Explanation", "207, This is more data about the state"
"Explanation", "207, This is more, changed data about the state"
In this example, ICON will store the following values:
- In the Comment field for state 207: This is data about the state
- In the Explanation field for state 207: This is more, changed data about the state
[+] Stop Recording a Custom State
In order for ICON to stop recording a custom state, the desktop application must send the following KVP:
Key = "<StateKeyName>", Value = "–"
Example
"AfterCallWork", "–"
[+] Use Multiple Custom States at Once
For each type of custom state, only one state can be active for a DN at any one time. However, ICON can simultaneously handle multiple different states independently. For example, two different states can be active on one DN, with different data corresponding to each. ICON does not support duplicate key names in attached data; KVPs with the same key name should not be sent in one EventUserEvent (as shown in the following Example).
Example
"AfterCallWork", "="
"Break", "="
"Comment", "207, This is data about the call"
"Comment", "208, This is data about the break"
"Break", "–”
"AfterCallWork", "–"
In the example above, ICON will store the key value only for the custom state "207, This is data about the call".
Storing Outbound Contact Data
In order to store Outbound Contact data in IDB for reporting purposes, certain configuration settings are required in the Genesys Configuration Layer, both for certain Outbound-related configuration objects and for the ICON Application object.
For more information about Outbound Contact Server (OCS) data in Interaction Concentrator, see the chapter about integrating with Outbound Contact in the
Interaction Concentrator 8.1 User’s Guide.
Outbound Contact Configuration
Special configuration of the items listed below is required in order to enable OCS to process and send data to ICON about the content of the fields in calling list records.
[+] Field Object
The two Field–level configuration options (described in detail below) control whether ICON will receive and store field values:
- icon_attribute
- send_attribute
Important
Interaction Concentrator reads
Field object configuration information only at startup. No real–time configuration changes to
Field objects are recognized. To accept changes to Field configuration, restart Interaction Concentrator.
icon_attribute
For every Field configuration object that describes a single field (for example, a phone number) within a record, you must configure the icon_attribute option if you want that data to be stored in IDB.
To configure this option:
- Open the Properties dialog box for the particular Field configuration object.
- Click the Annex tab.
- Create a new section named default, if it does not already exist.
- Within this section, create a new option named icon_attribute.
- Set the option to one of the following values:
- 1—To store OCS mandatory fields in the GO_RECORD table, custom defined fields in the GO_CUSTOM_FIELDS table, and history of field changes in GO_FIELDHIST table.
- 2—To store data as a secured field in the special GO_SECURE_FIELDS and GO_SEC_FIELDHIST IDB tables.
If you do not configure this option, or if you set its value to 0 (zero), OCS will not deliver those fields to ICON when sending reporting information, and ICON will not store the value of such fields.
send_attribute
For every user-defined or mandatory field that describes a single field (for example, a customer name) within a record, you must configure the send_attribute option if you want OCS to attach that data to outbound calls and in user events.
By default, OCS attaches the values of the mandatory fields listed in the table below. The table also shows the default key name for the attached data key–value pair.
Field
|
Key Name
|
contact_info
|
GSW_PHONE
|
chain_id
|
GSW_CHAIN_ID
|
attempt
|
GSW_ATTEMPTS
|
call_result
|
GSW_CALL_RESULT
|
If you do not configure the send_attribute option for other mandatory fields and for user–defined fields, OCS does not process data that is related to those Field objects, and accordingly ICON does not receive that data.
For more information, see the section about field–level options in the
Outbound Contact 8.1 Deployment Guide. See also the section in the
Outbound Contact 8.1 Reference Manual about attaching record information to desktop and OCS user events.
[+] Campaign Group Object
To enable reporting for all the activity associated with a Campaign Group, including chain activities, ensure that the Campaign Group object’s configuration properties specify a valid Voice Transfer Destination DN. The DN must be located on the switch served by the T–Server to which OCS is connected, and the T–Server must have a CTI link connected with the switch.
[+] Outbound Contact Server
If you require OCS to report snapshot metrics that are based on calculations related to call times (Outbound Call Dialing Time, Outbound Call Transfer Time, and CPD Time), ensure that audit logging is enabled for the OCS Application object.
- To enable audit logging, set the log_call_stats configuration option to true or yes.
No other special configuration is required on the OCS Application object.
ICON Application
To enable ICON to receive OCS data and store it in IDB, you must configure ICON connections to appropriate OCS instances, and you must set relevant configuration options.
[+] Connections
In an environment with a single OCS instance, add the OCS Application object to the Connections tab of the ICON Application object.
In an environment with multiple OCS instances, decide on your deployment topology—that is, decide whether a single ICON instance will handle the data from all or a subset of OCS instances, or whether each OCS will have a dedicated ICON instance. Based on your deployment decision, add one or more OCS Application objects to the Connections tab of the ICON Application object that must store data from those OCS instances.
[+] ICON Role Configuration Option
For every ICON instance that must store outbound data, make sure that the role option on the Options tab of the ICON Application object includes gos in the list of values. If you deploy a single ICON instance for the entire contact center, you can keep the default value (all). For more information, see the description of the role configuration option under ICON Role in the callconcentrator section of the Configuration Options page.
If you store different types of data to different IDBs, make sure that gos is also specified for the role option on the Options tab of the appropriate Database Access Point (DAP). Configure this option on the Options tab of the Application object for the DAP that your ICON instance uses to store outbound data to IDB.
[+] OCS–Specific ICON Options
The following ICON configuration options enable you to specify what outbound data ICON should store, and in what manner:
- gos-write-duplicate-metrics
- gos-write-metrics
- gos-write-metrics-only
Review the descriptions and values for the gos-write-* configuration options (under Outbound metrics in the callconcentrator section on the Configuration Options page). Select the appropriate values for your environment, and then make the appropriate configuration changes on the Options tab of the ICON Application object.
Multi-Tenant Considerations
In multi-tenant environments, the OCS-related objects that the ICON instance monitors may be configured under various tenants. Ensure that you assign all related tenants to the ICON application.
[+] Multi-Tenant Example
For example, you might create an Outbound Calling List object under a tenant called Outbound, and have the calling list use fields that you created as Field objects under the Environment tenant. To enable ICON to process OCS data related to the Outbound Calling List:
- Configure the required Field objects under the Environment tenant.
- Configure the icon_attribute option for all the fields that you want ICON to store.
- Configure the send_attribute option for all the fields that you want ICON to store.
- Add both the Environment tenant and the Outbound tenant on the Tenants tab of the ICON Application.
Storing License Reporting Data
If you are running Genesys License Reporting Manager (LRM), ICON enables you to store your LRM-specific data.
Configuring ICON to work with LRM requires that you set the appropriate value for the ICON .
[+] Configuring ICON to store LRM data
To configure ICON, perform the following steps:
- Designate the instance of ICON that will be used for LRM.
- Set the value of the role option to lrm.
- Ideally, the ICON you use for LRM data should not have any other role. If necessary, however, you can set the LRM instance of ICON for both the lrm and cfg (Configuration data) roles.
- Start (or if applicable, restart) ICON to have the role setting take effect.
[+] Configuration Notes
- If the role value is set to all, ICON stores LRM data. However, if you require only LRM data, setting the value to all results in the accumulation of large quantities of unusable data. Genesys recommends that you explicitly set the value to lrm to collect License Reporting data.
- Role assignments must be configured using only lower case (for example, lrm). ICON interprets uppercase (LRM) or mixed case (Lrm) settings as invalid and defaults to the all role.
- When role=lrm, ICON:
- Does not write data for gcc or gud providers.
- Disregards data filtering options.
- Enforces having the use–dss–monitor option set to true.
- You can switch ICON to or from the lrm role at any time by changing the setting for the role option. Restart ICON to have the change take effect.
Important
It is not advisable to change roles without careful planning. ICON stores the data associated with a role only when it is configured with that role. For example, if you set an instance of ICON to collect LRM data, then change the role so it is no longer set to
lrm, and then later change it back again, you will probably have a window of time during which there is no LRM data stored because the previous role may not have required ICON to collect the data necessary for LRM reporting.
- If you are using Genesys Info Mart, do not try to connect it to the ICON and the associated IDB that stores the LRM data. The LRM–specific ICON–IDB set stores data in a specific subset of tables. As a result, Genesys Info Mart will fail to start when it finds the tables from which it extracts data to be empty.
- HA is supported just as for any other ICON role.
Deploying a Partitioned Oracle IDB
In environments with large amounts of data to maintain, you can choose to create a partitioned Oracle IDB, which you can then purge efficiently by truncating entire partitions using the purgePartitions811 stored procedure. During this purge, all records in the purged partitions—both terminated and non-terminated—are truncated unconditionally.
Important
- If you need to purge only non-terminated records, use the GSYSPurge80/gsysPurge81 purge procedure instead.
- This partitioning and purge functionality is supported only for Oracle 11g and higher.
- Genesys strongly recommends that you do not use this purge mechanism for long–lived data types, such as multimedia. When used with long–lived data types, you might encounter situations in which some of the data for a still–active interaction is purged.
[+] Overview
The procedure for deploying the purge–by–truncating–partitions functionality is outlined below.
Warning
Do not try to change the number of partitions without consulting your Genesys representative for guidance.
- Start with a new Oracle database. There is no migration from a non-partitioned to a partitioned IDB.
- Determine the number of partitions necessary for your environment. When you run the SQL scripts to initialize your database, the number of partitions is set and cannot be changed afterwards.
- The default number of partitions is fourteen. In the majority of cases, fourteen partitions is expected to be satisfactory. In the rare case that you believe you require a different number of partitions, discuss your requirements with your Genesys representative.
- Run the SQL scripts to create your partitioned IDB, using the standard procedure given on the IDB tab on the Configuration and Installation page. However, the scripts used to create a partitioned IDB differ from those used for non–partitioned IDBs, so be sure to see “Creating Your Database” (below) for a list of the correct scripts.
- Have an instance of Interaction Concentrator write data to the existing (non–partitioned) IDB and a redundant instance that collects identical data write to the new (partitioned) IDB until you are certain that the partitioned IDB contains all the data you require. At that point, you can transition entirely to the partitioned IDB.
[+] Creating Your Database
To create a partitioned Oracle IDB, follow the standard instructions on the IDB tab on the Configuration and Installation page, but run the following scripts rather than the scripts used for a non–partitioned IDB. These two initialization scripts create a new partitioned IDB:
- CoreSchemaPart_ora.sql
- CoreProcedures_ora.sql
The following initialization script sets up the stored procedure used to purge the partitioned Oracle IDB:
As noted above, there is no migration path from a non–partitioned to a partitioned database. To migrate, Genesys recommends running your non–partitioned and partitioned databases in parallel until all required data appears in the partitioned database.
[+] About Partitioning
By default, the number of partitions is fourteen, with each partition equivalent to one day. Data is written into the partitions in sequence, starting with Partition 1 on Day 1, Partition 2 on Day 2, and so on, circling back to Partition 1 on Day 15.
As with all purge methods, only operational tables are purged. Special tables used for internal data storage and retrieval are neither partitioned nor purged.
The tables that are available for partitioning include the gsys_partition field, which must be configured to contain the UTC value taken from the created_ts field. This parameter is set using the partition-type configuration option (see it under Partitioning in the callconcentrator section of the Configuration Options page).
Each partitioned table also includes the virtual GSYS_SHORT_DAY column, based on value of the gsys_partition field.
[+] Purging
You perform the purge by executing the purgePartitions811 stored procedure, which truncates all partitions except for the number you specify in the days–to–keep parameter of the SQL statement.
Instructions for how to run the purgePartitions811 procedure, how to schedule it, and all other operational considerations are documented in the “Purging by Truncating Partitions” section the “Using Special Stored Procedures” chapter in the
Interaction Concentrator 8.1 User’s Guide.
[+] Partitioned Tables
The following tables are partitioned by the CoreSchemaPart_ora.sql script:
G_AGENT_STATE_HISTORY
|
G_IR_HISTORY
|
GO_CHAINREC_HIST
|
G_AGENT_STATE_RC
|
G_IS_LINK
|
GO_CUSTOM_FIELDS
|
G_CALL
|
G_IS_LINK_HISTORY
|
GO_FIELDHIST
|
G_CALL_HISTORY
|
G_LOGIN_SESSION
|
GO_METRICS
|
G_CALL_STAT
|
G_PARTY
|
GO_RECORD
|
G_CALL_USERDATA
|
G_PARTY_HISTORY
|
GO_SEC_FIELDHIST
|
G_CALL_USERDATA_CUST
|
G_PARTY_STAT
|
GO_SECURE_FIELDS
|
G_CALL_USERDATA_CUST1
|
G_ROUTE_RESULT
|
GOX_CHAIN_CALL
|
G_CALL_USERDATA_CUST2
|
G_USERDATA_HISTORY
|
GS_AGENT_STAT
|
G_CUSTOM_DATA_P
|
G_VIRTUAL_QUEUE
|
GS_AGENT_STAT_WM
|
G_CUSTOM_DATA_S
|
GM_F_USERDATA
|
GX_SESSION_ENDPOINT
|
G_CUSTOM_STATES
|
GM_L_USERDATA
|
G_ROUTE_RES_VQ_HIST
|
G_DND_HISTORY
|
GO_CAMPAIGNHISTORY
|
G_SECURE_USERDATA_HISTORY
|
G_IR
|
GO_CHAIN
|
|
Configuring for High Availability
The High Availability (HA) model used in Interaction Concentrator differs significantly from the Genesys standard HA model implemented in a majority of Genesys servers. Before you configure your ICON HA deployment, review the information in the
Interaction Concentrator 8.1 User’s Guide about implementing HA in Interaction Concentrator.
In an HA deployment, observe the following rules:
- You must set configuration options in both Interaction Concentrator Application objects exactly the same. Because this is not a typical redundant pair from the Genesys perspective, Configuration Server does not automatically synchronize the configuration options for two ICON applications.
- For example, to configure your redundant ICON applications to store voice interaction data in a pair of HA IDBs:
- In both ICON Application objects, set the role option so that it contains gcc and gud. This enables both ICON applications to store call–related and attached data.
- For any configuration options that affect the data populated by those roles, set the same option values in both ICON applications. For example, the two applications must use the same ICON configuration options for virtual queue monitoring, storage of attached data, and so on.
- For more information about setting configuration options, refer to the other pages in this section.
- You must configure a connection to the same T–Server or Interaction Server in both ICON Application objects.
- You must create two identical IDBs. Genesys recommends using two databases located on different hosts, but having the same RDBMS type and version number, to host the HA pair of IDBs.
- You must configure a DAP for each ICON to access its IDB.
For more information about configuring applications and connections in Configuration Manager, see the
Framework Deployment Guide.