A Guided Tour: Conversation Objects

Conversation objects are at the core of WorkGroup Telephony. Each Conversation object represents one half of a point-to-point connection. A pair of Conversations together represent a shared dictionary of arbitrary data indexed by string.

A Conversation's dictionary is modified using two mechanisms:

  1. SetData method

  2. Send method

Read more about the conversation object's properties and methods.

SetData Method

This method modifies a local conversation by either changing the data associated with a key or by adding a new key with its matching data. Any keys added or changed this way are considered to be dirty.

Send Method

The second mechanism for changing a Conversation's dictionary is through the use of the Send method. When the Send method is invoked, all of the dirty keys - the keys added or changed through SetData - are bundled together and sent off to the Client Conversation. The Client Conversation then assembles the data and modifies its internal dictionary such that both dictionaries in both Conversations are now the same. Any AgentX or Remote controls on the Client machine whose AppID values match the value associated with the key AppID in the receiving Conversation object will generate a Changed event.

Retrieving Data

The data stored in a Conversation object can be retrieved using the GetData method. Other methods are also available for manipulating Conversation objects