Azure Boards での作業項目の履歴とディスカッション フィールドに対するクエリ

  • [アーティクル]

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

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

注意

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

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

[履歴] フィールドを指定するクエリ句では、[語を含む] 演算子と [語を含まない] 演算子を使用できます。 正確な語句で検索することも、ワイルドカード文字 (*) を使用することもできます。 ワイルドカード文字は、単語や語句の一部である文字列の末尾でのみ使用できます。

フルテキスト検索が利用可能な場合は、[履歴] フィールドに対してフルテキスト検索用のインデックスが自動的に作成されます。 「フルテキスト検索と単語の一部の検索」を参照してください

作業項目の履歴に対してクエリを実行する

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

クエリ エディターのスクリーンショット。[履歴] フィールド含まれている単語に基づいて項目を検索しています。

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

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

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

フィルターの対象

含めるクエリ句

履歴フィールドに「reproducible」という単語が含まれている項目

History Contains Words reproducible

履歴フィールドに「beta」という単語が含まれていない項目

History Does Not Contain Words beta

「stack traces」という語句を含み、終了したが再アクティブ化された項目

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

クエリ エディターの使用に関するヒント

  • 検索する作業項目の [履歴] フィールドに指定された、完全な単語または語句を入力してください。
  • 検索する単語としてフル テキストを入力します。 [履歴] フィールドはフルテキスト検索用にインデックス付けされます。 語の一部だけを入力した場合、完全な単語を含む作業項目は返されません。 たとえば、[履歴] フィールドに「reproducible behavior」という語句が含まれている場合、「repro」を検索しても作業項目は見つかりません。 ただし、「reproducible」という完全な単語を指定した場合は、作業項目が見つかります。 repro* のように、ワイルドカード文字 (*) を指定して文字列を検索することもできます。
  • クエリ エディターでは、一般的な単語やストップワードは無視されます (これについては、フルテキスト検索のストップ ワードとストップ リストの構成と管理に関するページで定義されています)。
  • クエリ エディターのツール バーで、[クエリの実行] または [クエリの実行](以前のバージョン) アイコンを選択して、クエリから期待どおりの結果が返されることを確認してください。
  • 期待どおりの結果が表示されない場合は、入力した検索用の単語や語句を修正してから、もう一度クエリを実行してください。

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

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

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

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

最初に状態の変更履歴ダイアグラムが表示されます。 状態の変更履歴全体を表示するには、[すべて表示] を選びます。

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

左ペインでエントリを選ぶと、加えられた変更の詳細が表示されます。

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

履歴ビューをフィルター処理する

[履歴] タブは、完全な追跡可能性をサポートするために、作業項目に加えられたすべての変更を追跡するように設計されています。 返される変更履歴が長いと、特定のフィールドへの変更がいつ行われたかを理解するのが難しくなる場合があります。 特定のフィールドへの変更や特定の人物による変更を迅速に見つけるためには、履歴ビューをフィルター処理してください。

注意

[フィルターの切り替え] 機能では、[新しいボード ハブ] プレビュー機能を有効にしておく必要があります。 この機能を有効にするには、「機能の管理または有効化」を参照してください。

フィルター機能を有効にするには、[フィルターの切り替え] を選択します。

作業項目フォーム、[履歴] タブ、Web ポータル、有効になった履歴フィルターのスクリーンショット。

特定のユーザーによる更新を確認するには、[更新者] メニューから名前を選択します。

作業項目フォーム、[履歴] タブ、更新者によるフィルターのスクリーンショット。

1 つ以上のフィールドに対して行われた更新を確認するには、[フィールド] メニューからフィールドを選択します。

[作業項目] フォーム、[履歴] タブ、[担当者] フィールドへの変更に対するフィルターのスクリーンショット。

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

クエリのフィルター処理とレポートの作成には、次のフィールドを使用できます。 これらのフィールドの一部では、作業項目がある状態から別の状態に進んだ際に情報が設定されます。 他のフィールドは、作業項目が変更されたときに更新されます。 一部のフィールドは作業項目フォームに表示されませんが、一覧表示される WIT 用に追跡されます。

フィールド名

説明

作業項目の種類

変更者

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

参照名=System.ChangedBy、データ型=String

すべて

変更日

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

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

すべて

終了日 1

作業項目が終了した日時。
参照名=Microsoft.VSTS.Common.ClosedDate、データ型=DateTime

すべて

作成日

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

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

すべて

履歴

作成後に作業項目に対して行われた変更のレコード。 作業項目が更新されるたびに、情報が履歴に追加されます。履歴には、変更日、変更したユーザー、および変更されたフィールドが示されます。

注意

履歴フィールドのクエリでは、[ディスカッション] のコメントや、[説明] フィールドに入力されたキーワードに一致する単語を含む作業項目が返されます。 履歴フィールドを使用して、他のフィールドに加えられた変更を照会することはできません。

書式設定されたテキストを [履歴] フィールドに追加することはできません。 作業項目を保存したら、履歴を変更することはできません。
「クエリ フィールド、演算子、マクロ」で説明されているように、History フィールド (および Description、Steps to Repro、Title フィールド) に対しては、フルテキスト検索用に自動的にインデックスが作成されます。

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

すべて

解決日 1

作業項目が解決済み状態に移行した日時。

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

バグ (アジャイル、CMMI)

...

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

注意

Azure DevOps Services 用 REST API を介して行われた更新については、作業項目のリビジョン制限 10,000 が適用されます。 この制限により、REST API からの更新は制限されますが、Web ポータルからの更新は影響を受けません。

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

すべて

更新日

作業項目が改訂または変更された日時。

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

共有パラメーター、共有ステップ、テスト ケース

状態の変更日

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

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

すべて

テスト スイートの監査

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

テスト スイート

ウォーターマーク

作業項目に加えられた変更と共にインクリメントされるシステム管理フィールド (編集不可)。
参照名=System.Watermark、データ型=Integer

すべて

注意

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

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

REST API

プログラムでクエリを操作するには、次の REST API リソースのいずれかを参照してください。