TrackingTable Property

TrackingTable Property

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Contains records of all messages correlated with ProcessInstance in an e-mail-based workflow.

Applies To

IProcessInstance Interface

Type Library

Microsoft CDO Workflow Objects for Microsoft Exchange

DLL Implemented In

CDOWF.DLL

Syntax

[Visual Basic]Property TrackingTable As ADODB.Recordset

[C++]HRESULT get_TrackingTable(Recordset* pVal);
HRESULT putTrackingTable(_Recordset Val);

Parameters

• pVal
  Returns the value of the TrackingTable property as a reference to a _Recordset Interface.
• Val
  Sets the value of the TrackingTable property to the value of the _Recordset Interface.

Remarks

The workflow engine uses the TrackingTable to store information regarding emails correlated with ProcessInstance. If the engine matches a row in the ActionTable with an OnReceive event, it makes an entry in the TrackingTable for the ReceivedMessage.

The tracking table provides you with ten fields that you can use to store additional properties you want to track. These are the custom0 through custom9 fields.

Records in the TrackingTable have the following fields:

Field Name	Type	Maximum Size	May be NULL
email	WCHAR	512 characters	No
trackingid	WCHAR	512 characters	Yes
date	WCHAR	512 characters	No
state	WCHAR	512 characters	No
flags	WCHAR	512 characters	No
response	WCHAR	512 characters	Yes
custom0 - custom9	WCHAR	512 characters	Yes

The following table describes the semantics of each tracking table field.

Field Name	Description
email	This contains the address in the 'To' field of outgoing forms or messages.
trackingid	This is a globally unique identifier (GUID) created by the workflow engine when you use SendWorkflowMessage(). The engine uses this GUID to correlate all subsequent messages associated with the ProcessInstance.
date	For outgoing messages, this is the 'sent' time. For incoming messages, this is the 'received' time.
state	The workflow engine puts the state of ProcessInstance here when you use SendWorkflowMessage(). It puts the ProcessInstance state in this field for all correlated responses as well.
flags	This can be 'STRICT', 'ADD', or 'INCOMING'. When you use SendWorkflowMessage(2), the engine puts 'STRICT' in this field.
response	The workflow engine automatically copies the value of the form field "https://schemas.microsoft.com/cdo/workflow/response" into this column without you having to write any code.
custom0 - custom9	These are ten fields that you can use to store data from your form. You need to write the script code to copy the data to the TrackingTable.

This property corresponds directly to the Exchange store property https://schemas.microsoft.com/cdo/workflow/trackingtablexml. Applications can also use Microsoft ActiveX Data Objects (ADO), OLE DB, or WebDAV to update this property directly.

Send us your feedback about the Microsoft Exchange Server 2003 SDK.

Build: June 2007 (2007.618.1)

© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.