TrackingTable Property

[This is preliminary documentation and subject to change.]

Contains records of all messages correlated with a ProcessInstance in an email-based workflow.

[Visual Basic,VBScript]
Public Property TrackingTable as Recordset
[C++]
HRESULT get_TrackingTable (_Recordset* pVal);
HRESULT put_TrackingTable (_Recordset Val);
[IDL]
HRESULT [propget] TrackingTable ([out,retval] _Recordset* pVal);
HRESULT [propput] TrackingTable ([in] _Recordset Val);

Remarks

The workflow engine uses the TrackingTable to store information regarding emails correlated with a 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 may wish to track. These are the custom0 through custom9 fields.

Records in the TrackingTable have the following fields:

TrackingTable Field Semantics

email

This contains the address in the 'To' field of outgoing forms or messages.

trackingid

This is a 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 the 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(FALSE), the engine puts 'STRICT' in this field.

response

The workflow engine automatically copies the value of the form field "http://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.

Example

See Also

IProcessDefinition