UserTrackPoint クラス

定義

public ref class UserTrackPoint sealed

public sealed class UserTrackPoint

[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public sealed class UserTrackPoint

type UserTrackPoint = class

[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type UserTrackPoint = class

Public NotInheritable Class UserTrackPoint

継承

Object

UserTrackPoint

属性

ObsoleteAttribute

注釈

アクティビティ デザイナーまたはワークフロー デザイナーは、オーバーロードされた Activity.TrackData メソッドと ActivityExecutionContext.TrackData メソッドを使用してワークフローをインストルメント化し、ユーザー イベントとしてランタイム追跡インフラストラクチャにデータを出力できます。 出力されるデータは、ユーザー データと呼ばれます。 アクティビティステータスイベントや、ステータス変更時にのみ発生するワークフローステータスイベントとは異なり、ユーザーイベントはワークフローにインストルメント化された任意の場所で発生できます。 ワークフローをインストルメント化してユーザー イベントを生成する理由は多数あります。 たとえば、ワークフロー デザイナーは、ワークフローの進行状況に関する論理状態情報を伝えたり、アクティビティ デザイナーがアクティビティの状態の変更以外の場合にアクティビティ メンバーに機会を提供したりする場合があります。

UserTrackPointは、ユーザー イベントに関連付けられたルート ワークフロー インスタンスの潜在的な実行パスに関心のあるポイントを定義します。 UserTrackPointには、照合に含まれる場所、一致から除外される場所、およびトラック ポイントが一致したときにワークフロー インスタンスから抽出される追加データが含まれます。 UserTrackPointにTrackingProfile.UserTrackPointsを追加して、追跡ポイントが一致したときにUserTrackingRecordを追跡サービスに送信するようにランタイム追跡インフラストラクチャに指示できます。 ユーザー データは UserTrackingRecord.UserDataで返されます。 1 つの UserTrackPoint は、ワークフロー インスタンス内の複数のポイントで照合できます。

UserTrackingLocationには、ワークフロー インスタンスの潜在的な実行パス内のユーザー イベントに関連付けられている場所の一致条件が含まれています。 UserTrackingLocationオブジェクトをMatchingLocationsに追加して、トラック ポイントの照合に含める場所を定義できます。 同様に、 UserTrackingLocation オブジェクトを ExcludedLocations に追加して、トラック ポイントの照合から除外する場所を定義できます。

ActivityDataTrackingExtractオブジェクトとWorkflowDataTrackingExtract オブジェクトをExtractsに追加して、トラック ポイントが一致したときにワークフロー インスタンスから抽出する必要があるデータを指定できます。 抽出されたデータは、 UserTrackingRecord.Bodyで返されます。

Annotationsに追加して、トラック ポイントに関連付けられている追加情報を指定できます。 これらの注釈は、 UserTrackPoint.Annotationsで返されます。

このクラスの使用方法の例については、 ユーザー 追跡ポイントを使用した追跡のサンプルを参照してください。