TrackingProfile.UserTrackPoints Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets the collection of user track points used by the runtime tracking infrastructure to filter user events.
public:
property System::Workflow::Runtime::Tracking::UserTrackPointCollection ^ UserTrackPoints { System::Workflow::Runtime::Tracking::UserTrackPointCollection ^ get(); };public System.Workflow.Runtime.Tracking.UserTrackPointCollection UserTrackPoints { get; }member this.UserTrackPoints : System.Workflow.Runtime.Tracking.UserTrackPointCollectionPublic ReadOnly Property UserTrackPoints As UserTrackPointCollectionProperty Value
A UserTrackPointCollection that specifies the points in a workflow instance for which the runtime tracking infrastructure should send a UserTrackingRecord to the tracking service.
Remarks
A workflow designer or an activity designer can use Activity.TrackData, Activity.TrackData, ActivityExecutionContext.TrackData, or Activity.TrackData to instrument a workflow or an activity to emit data to the runtime tracking infrastructure at specific points during the execution of a workflow. Such an occurrence is called a user event and the data emitted is called user data. The runtime tracking infrastructure uses the UserTrackPoints property to filter user events to determine when to send a UserTrackingRecord to the tracking service. You can add a UserTrackPoint to the UserTrackPoints property to specify points of interest in the potential execution path of the workflow instance for which you want a UserTrackingRecord sent.
A UserTrackPoint does not actually define a physical point in a workflow instance, but instead defines a set of match parameters that can be used by the runtime tracking infrastructure to match user events. Therefore, the same UserTrackPoint can be matched many times during the lifespan of a workflow instance. The runtime tracking infrastructure always returns the user data associated with a matched UserTrackPoint in the UserTrackingRecord, but a UserTrackPoint can also specify data to be extracted from the workflow instance and returned in the tracking record.
