Work Item Attributes

The following table describes work item attributes that you can specify in values for parameters that support macro expansion. Communications events and commands can reference these attributes as subparameters of the parameter Param, or as elements within other parameter values where macro expansion is supported. The following macros, when used in parameter values, can process these attributes: @SelectedWorkItem, @DeselectedWorkItem, and $GetWorkItemAttr.

You can use the WorkTrackingObj parameter in event log or command data definitions to store or update custom work item attributes. You can use the AfterWork event log parameter to update database records that store work item attributes after work items are released. (You can also use the WorkObject event response parameter to update database records for tracking work items.)

For example, if an event log includes a parameter definition like the following, then ContactId becomes a custom work item attribute that is available for use wherever work item attributes can be accessed. For example, commands that update the customer dashboard can access such attribute values:

WorkTrackingObj.ContactId = "{Contact.Id}"

Alternatively, if an event log includes a parameter definition like the following, then text that you specify is displayed in the Work Items list in the communications toolbar:

WorkTrackingObj.Description="your descriptive text goes here"

Note: Of the predefined work item attributes described in the following table, only ParentWorkItemID and Description can be updated.

For more information about the WorkTrackingObj and AfterWork event log parameters, see Event Logs. For more information about the WorkTrackingObj command data parameter, see Command Data. For more information about the WorkObject event response parameter, see Event Responses. For additional attributes that you can specify in event handlers, see Driver Event Attributes.

Attribute Name	Description
ChannelType	The language-independent value representing the channel type of this work item.
ChannelTypeLocale	The locale-dependent value for the channel type of this work item.
Description	A description of this work item. The value for this attribute comes primarily from the client handle methods WorkItemStarted and IndicateNewWorkItem. For more information, see Developing a Communications Driver
DriverWorkTrackID	The ID number of this work item as tracked by the driver.
IsRevoked	Indicates whether the work item has been rejected by an agent (using the Accept or Reject dialog box). Possible values are True or False (the default is False). This attribute is True whenever the service handle method RevokeQueuedWorkItem has been invoked for the work item.
ParentWorkItemID	The ID number of the parent of this work item. Note the following behavior for parent and child work items: When a parent work item is released, all child work items are released. When a parent work item is suspended, all child work items are suspended. When a parent work item is resumed, all child work items are resumed. When a child work item is started or resumed, the parent work item gains the focus. Agent can use the Work Items list in the communications toolbar to select a child work item and operate on this child work item individually. Parent and child work items can be of different channels, such as when an outbound voice call is placed to a customer who initiated an email work item. For more examples, see the sample communications configurations provided with Siebel Business Applications.
ProfileName	The communications driver profile for which this work item is applicable.
ViewBookmark	The bookmark for the view which was current when this work item was suspended. The bookmark data is serialized and compressed into a string.
WorkDuration	The duration of this work item. The value is the same as the @WorkDuration macro.
WorkItemID	The ID number of this work item.
WorkObjectID	The work tracking object ID number. The value is the same as the @WorkObjectID macro.
WorkStartTime	The start time of this work item. The value is the same as the @WorkStartTime macro. The value for this attribute comes primarily from the client handle method WorkItemStarted. For more information, see Developing a Communications Driver.
WorkState	The state of this work item. Possible values are Created, Active, Suspended, and Released. The value for this attribute comes primarily from client handle methods. When IndicateNewWorkItem is invoked, the WorkState value is Created. When WorkItemStarted is invoked, the WorkState value is Active. When WorkItemSuspended is invoked, the WorkState value is Suspended. When WorkItemResumed is invoked, the WorkState value is Active. When WorkItemReleased is invoked, the WorkState value is Released. For more information, see Developing a Communications Driver.