Jump to: navigation, search

In the Column List:

  • P = Primary key
  • M = Mandatory field
  • F = Foreign key
  • In the Data Type column, varchar/nvarchar means that the data type is varchar except in multi-language databases that use Unicode, in which case the data type is nvarchar. (The Info Mart database in Cloud deployments is not multi-language.)


This table records the changes in the UserData attribute of TEvents associated with voice calls, the UserData attribute of Interaction Server events for all types of multimedia interactions, and the isOnline attribute of events associated with chat sessions. In addition, ICON may record the change history of the Reasons and Extensions attributes of voice interactions as well as any other attributes of an interaction that are not recorded in the G_CALL_HISTORY and the G_PARTY_HISTORY table, if configured to gather data from T-Server or Interaction Server.

One prerequisite is that ICON must be able to determine that such data is associated with a specific interaction and that this association is known at runtime. ICON's writing to this table is also determined by the setting of one or more configuration options in the [filter-data] section.

Column List


Column Data Type P M F Description


numeric(19) X X The unique, autonumbered ID of this record. This is the primary key.


varchar(50) X This field points to the record in the G_CALL table that represents the call to which the data is attached.


varchar(50) This field points to the record in the G_PARTY table that represents the last party, associated with the interaction or endpoint, who added, changed, or deleted the data. Any one of the following attributes can be the source of attached data:
  • AttributeUserData
  • AttributeExtensions
  • AttributeReason

With a change in the data in AttributeUserData and upon receipt of AttachedDataChangedEvent, then PartyID is defined by the ThirdPartyDN attribute, if any exists. Otherwise, this field is empty.


int This field contains the DBID of the endpoint where data was added, changed, or deleted. If the data was taken from the event that caused the creation of the respective call, then this is the first party that created in the call. If the data was taken from the AttachedDataChangedEvent, then the party is defined by the ThirdPartyDN attribute, if any exist. Otherwise, this is the party that is defined by the ThisDN attribute (if any). For the rest of changes, the party is defined by the ThisDN attribute.

In a SIP Cluster environment, if the endpoint is not configured in Configuration Layer, the value for this field is 0.


varchar(255) The device number that is associated with the data.


int This field contains the DBID of the agent who changed the data. This is the agent who logged into the endpoint that is associated with the data change (if this information is available in the run time).


int This field contains the DBID of the Switch object that owns the endpoint that is associated with the change. If the EndPointID field is NULL, then so is the field SwitchID, and vice versa.


varchar(64) X This is the KeyName field. It records the name of the user data key that changed its value. The user determines which keys should be recorded by specifying them in ICON's configuration of user data.


int X This field specifies the type of change that caused the record to appear in the table. One of the following values:
  • 1—Created–The value of the key has been attached to the call at the moment the call was created. If this is true, then both the OldCharValue and the OldIntValue fields have the value NULL.
  • 2—Added–The value of the key that has just been added. If this is true, then both the OldCharValue and the OldIntValue fields have the value: NULL
  • 3—Updated–The value of the key has changed. If this is true, then either the OldCharValue or the OldIntValue field (depending of the data type) contains the previous value of the key.
  • 4—Deleted–The key has been deleted from the user data. If this is true, then both the CharValue and the IntValue fields are equal to NULL, and the OldCharValue or the OldIntValue field (depending of data type) contains the last value of the key.
  • 5—Terminated–The value of the key at the call termination.



int X The sequential number of the change of the value of the specific key associated with the call. The changes of a key are numbered separately for every call that the key is associated with. Numbering starts with 1.


int X The actual CSEQ in the call scope at the moment ICON is processing this data record. It should be consistent with the CSeq value in the G_PARTY_HISTORY table. For additional information, refer to the description of the CSeq field in the G_PARTY_HISTORY table.


int X The type of the data source: extensions, reasons, or attached (user) data. One of the following values:
  • 1—userdata
  • 2—reasons
  • 3—extensions
  • 4—attributes (reserved for future use)
  • 5—mcr_workbin



int X The ID of the key name, as defined in the attached data specification file (adata_spec.xml). Valid values for the KeyID are bigger than 10000 but smaller than 100000. If the KeyID is not defined, the value of this field is zero (0). The KeyID is not unique: different KeyNames can have the same KeyID. You can use the KeyID to build indexes to improve data querying by downstream reporting applications.

ICON hardcodes KeyIDs for the following attributes from Interaction Server events:

  • 9995—attr_is_online
  • 9996—attr_itx_agent_id
  • 9997—attr_itx_group_id
  • 9998—attr_itx_place_id
  • 9999—attr_itx_place_group_id


varchar(1024) For voice interactions, this field contains the value of the key in character format.

For chat interactions, ICON writes the value of the isOnline attribute of the triggering event from Interaction Server. One of the following:

  • 0—Chat session has been stopped.
  • 1—Chat session is alive.

For all types of interactions, ICON stores in this field UserData values for certain keys.


datetime The GMT-equivalent date and time when the key was changed as inherited from T-Server (or other data provider).


int This UTC-equivalent value of the ADDED field.


int A reference, derived from the ADDED_TS field, to a record in the G_TIMECODE table.


int Contains the data source session ID (DSS_ID) for the session that was active when the data was processed by ICON. For more information, see the description in System Fields.


int A key that is used for partitioning.


int System ID. Reserved for future use.


bigint Insert Sequence. Not unique.


bigint Update Sequence. Not unique.


datetime Reserved


int Reserved


varchar(255) Reserved


varchar(255) Reserved


int A flag indicating the reliability of classification of userdata added to this table. When an interaction is no longer in memory, such as when memory optimization is turned on (om-memory-optimization = true), and Interaction Server sends events regarding new or changed userdata, ICON records the userdata as changed (ChangeType = 3) and notes the reliability of this classification in this field:
  • 0—ChangeType classification is reliable.
  • 1—ChangeType classification is unreliable.

If ICON records the ChangeType as unreliable, the true change type may be 2 (added).


int Reserved



Comment on this article:

blog comments powered by Disqus
This page was last modified on 31 October 2016, at 16:02.