クエリ履歴とディスカッション フィールド

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

作業項目の履歴を参照すると、その作業項目を開いたユーザー、変更内容、および変更理由を確認できます。 この情報は、作業項目の変遷をたどるうえで役立ちます。 履歴フィールドに情報を入力する場合は、作業項目に対してこれまでに行われた処理内容と、これから必要な処理内容を作業項目の次の所有者が把握できるよう、できるだけ多くの情報を入力します。

注意

ディスカッション作業項目フィールドはありません。 [ディスカッション] 領域にコメントを入力して作業項目に対してクエリを実行するには、[履歴] フィールドでフィルター処理します。 [ディスカッション] テキスト ボックスに入力されたテキストの完全な内容が [履歴] フィールドに追加されます。

サポートされている演算子とマクロ

履歴フィールドを指定する クエリ句では 、Contains Words 演算子と Not Contains Words 演算子を使用 できます。 正確な語句に対して検索するか、ワイルドカード文字 を使用します * 。 ワイルドカード文字は、単語や語句の一部である文字列の末尾でのみ使用できます。

フル テキスト 検索が使用可能な場合、履歴フィールドにはフルテキスト検索のインデックスが自動的に作成されます。 単語検索Full-Text部分検索に関するページを参照してください。

作業項目の履歴のクエリを実行する

Web ポータルまたは Web ポータルを使用チーム エクスプローラー、作業項目の履歴を表示したり、[履歴] フィールドの内容に基づいて作業項目を 検索 したりできます。 履歴フィールドの内容に対して検索を実行すると、そのフィールドに記録された変更を含む作業項目だけが返されます。 つまり、他のフィールドのテキストに加えた変更は登録されます。

Screenshot of Query Editor to Search for items based on words contained in the History field.
Screenshot of Query Editor to Search for items based on words contained in the History field, earlier versions.

[履歴] フィールドの内容に基づいて項目を一覧表示する

クエリ エディターを使用して、履歴フィールド をクエリ 句 に 追加します。 [ディスカッション] 領域に入力 されたコメントは クエリ可能です。 変更されたフィールドなどの変更履歴エントリはクエリできません。 [ディスカッション] 領域または [説明] などのリッチ テキストフィールドに入力された単語に基づいて項目をすばやく検索するには、作業項目検索 の使用を検討してください

クエリ エディターを使用して、履歴フィールド をクエリ 句 に 追加します。 [履歴] フィールドに入力 されたコメント はクエリ可能です。 変更されたフィールドなどの変更履歴エントリはクエリできません。

変更された日付、または具体的な時間によって、作業項目をフィルター処理することができます。 クエリの範囲を限定すると、指定した日付範囲に当てはまる結果だけが返されるので、パフォーマンスも良くなります。

のフィルター処理 次のクエリ句を含める
[履歴] フィールドに再現可能という単語が含 " まれている項目"
History Contains Words reproducible
[履歴] フィールドにベータ'含 " まれている項目" History Does Not Contain Words beta
フレーズ スタック トレースを含 " み、 " 閉じられましたが再アクティブ化された項目             History Contains Words stack traces
And State Was Ever Closed
And State <> Closed
指定した期間内に閉じた項目             State = Done
And Closed Date > 7/1/2015
And Closed Date <= 7/21/2015
関連'されている項目            History Contains Words MyName
Or Assigned To Was Ever _ @Me

ヒントエディターを使用する場合に使用する方法

  • 検索する作業項目の [履歴] フィールドに指定された完全な単語または語句を入力します。
  • 検索する単語としてフル テキストを入力します。 [ 履歴] フィールドには、フルテキスト検索のインデックスが作成されます。 語の一部だけを入力した場合、完全な単語を含む作業項目は返されません。 たとえば、[履歴] フィールドに再現可能な動作という語句が含まれている場合、再現コード を検索すると、作業項目は見つかりません。 ただし、完全な単語再現可能な を検索 すると、作業項目が見つかる可能性があります。 などのワイルドカードを使用して文字列を検索できます repro*
  • クエリ エディターは、「Search のストップワードとストップリストの構成と管理」で定義されている一般的な単語またはストップ ワードFull-Text無視します
  • クエリ エディターのツール バーで、 Run query または Run query, earlier version アイコンをクリックし、クエリが予想される結果を返すのを確認します。
  • 期待した結果'されない場合は、入力した単語または語句を調整し、クエリを再度実行します。

作業項目の履歴を表示する

作業項目が保存される たび、[履歴 ] フィールドにエントリが作成されます。 変更の履歴を表示するには、既存の作業項目を開き、履歴タブ アイコンまたは [履歴] タブを選択するか、一部の作業項目の種類で [詳細] タブ  を選択 します。

表示される履歴の詳細は、ユーザーのプラットフォーム、バージョン、およびクライアントによって異なります。

[作業項目] フォームの [Web ポータル] の [履歴の選択] タブのスクリーンショット。

状態変更履歴図が最初に表示されます。 状態の変更の履歴全体を表示するには、 [すべて表示] を選択します

作業項目フォーム、Web ポータル、状態変更履歴図のスクリーンショット (Web ポータルのみ)。

左側のウィンドウでエントリを選択すると、行われた変更の詳細が表示されます。

作業項目フォーム、履歴タブ、Web ポータル、詳細のスクリーンショット。

注意

TFS 2017 以降のバージョンでは、[ 履歴 ] フィールドはリッチ テキスト フィールドではなくなりました。 作業項目の履歴に注釈を付けるには、説明フィールドまたは ディスカッション フィールドに****を追加 します。

ログに追加されたコメントのみを表示するには、[ディスカッションのみ] タブ を選択 します。項目に加えたすべての変更を表示するには、[すべての変更] タブを選択し、特定の日付と時刻の [すべての変更の表示] リンクを選択します。

作業項目フォーム、履歴タブ、Web ポータル、以前のバージョンのスクリーンショット

履歴、監査、リビジョンの追跡をサポートするフィールド

次のフィールドを使用して、クエリをフィルター処理し、レポートを作成できます。 これらのフィールドのいくつかには、作業項目がある状態から別の状態に進むにつれて、情報が入力されます。 その他のフィールドは、作業項目が変更された場合に更新されます。 一部のフィールドは作業項目フォームには表示されませんが、一覧表示されている WIT に対して追跡されます。

フィールド名 説明 作業項目の種類

変更者

最近作業項目を変更したチーム メンバーの名前。

参照名=System.ChangedBy、データ型=文字列

すべて

変更日

作業項目が変更された日時。

参照名=System.ChangedDate、データ型=DateTime

すべて

クローズ日 1

作業項目が終了した日時。

参照名=Microsoft.VSTS.Common.ClosedDate、データ型=DateTime

すべて

作成日

作業項目が作成された日時。

参照名=System.CreatedDate、データ型=DateTime

すべて
履歴 作成後に作業項目に対して行われた変更のレコード。 作業項目が更新されるたびに、情報が履歴に追加されます。履歴には、変更日、変更したユーザー、および変更されたフィールドが示されます。
履歴フィールド クエリは、ディスカッション コメントまたは説明フィールドに入力されたキーワードと一致する単語を含む作業項目を返します。 履歴フィールドを使用して、他のフィールドに加えた変更に対してクエリを実行することはできません。

書式設定されたテキストを履歴フィールドに追加できない。 作業項目'した後は、履歴を変更できません。

フィールド History と 共に、 DescriptionSteps to ReproTitle フィールドには、「クエリ フィールド、演算子、マクロ」の説明に従って、フルテキスト検索の インデックスが自動的に作成されます

参照名=System.History、データ型=履歴

すべて

解決日 1

作業項目が解決済み状態に移動された日時。

参照名=Microsoft.VSTS.Common.ResolvedDate、データ型=DateTime

バグ (アジャイル、CMMI)

...

作業項目の履歴のリビジョンに割り当てられている番号。

参照名=System.Rev、データ型=整数

すべて

状態の変更日

[状態] フィールドの値が変更された日時。

参照名=Microsoft.VSTS.Common.StateChangeDate、データ型=DateTime

すべて
テスト スイートの監査

テスト スイートの変更時に実行される追加操作 (たとえば、テスト スイートへのテストの追加または構成の変更) を追跡します。 このフィールドは [履歴] タブまたは個別のクエリから表示できます。 作業項目フィールドに対して実行された変更と、テスト ポイントおよび構成などの関連成果物による変更とを含む、統合された履歴が表示されます。

参照名=Microsoft.VSTS.TCM.TestSuiteAudit、データ型=PlainText

テスト スイート
透かし

作業項目に加えた変更をインクリメントするシステム マネージド フィールド (編集不可)。

参照名=System.Watermark、データ型=整数

すべて

メモ:

  1. WIT に対してこれらのフィールドを定義するには、WIT 定義の セクションに含 WORKFLOW める必要があります。 たとえば、次の構文は、解決済み状態に移行 FIELDS するときに定義に含まれます。

    <FIELD refname="Microsoft.VSTS.Common.ResolvedDate">  
       <SERVERDEFAULT from="clock" />  
    </FIELD>  
    

SDK リソース

プログラムでクエリを操作するには、「バグ、タスク、その他の作業項目のクエリ 」を参照してください