Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
作業項目の履歴には、アイテムを作成したユーザー、変更内容、および変更が発生した理由が記録されます。 この情報は、追跡可能性と監査をサポートします。 [履歴] フィールドにエントリを追加するときは、次の所有者がコンテキストと次の手順を理解するのに役立つ十分な詳細を含めます。
Note
個別の [ディスカッション] フィールドはありません。 [ディスカッション] 領域に追加されたコメントを検索するには、[ 履歴 ] フィールドでフィルター処理します。[ディスカッション] ボックスに入力されたすべてのテキストが履歴に追加されます。
Prerequisites
| Category | Requirements |
|---|---|
| アクセス レベル | - 共有クエリを表示して実行するには: Project メンバー。 - 共有クエリを追加して保存するには:少なくとも Basic アクセス。 |
| Permissions | クエリを追加するフォルダーの貢献権限が許可に設定されていること。 既定では、 共同作成者 グループにはこのアクセス許可がありません。 |
Note
パブリック プロジェクトの 利害関係者 アクセス権を持つユーザーは、 Basic アクセス権を持つユーザーと同様に、クエリ機能にフル アクセスできます。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。
| Category | Requirements |
|---|---|
| アクセス レベル | - 共有クエリを表示して実行するには: Project メンバー。 - 共有クエリを追加して保存するには:少なくとも Basic アクセス。 |
| Permissions | クエリを追加するフォルダーの貢献権限が許可に設定されていること。 既定では、 共同作成者 グループにはこのアクセス許可がありません。 |
サポートされている演算子とマクロ
サポートされる演算子:
- 単語を含む
- 単語を含まない
検索方法:
- 正確な語句: 単語の正確なシーケンスを見つけます。
- ワイルドカード文字 (
*): 部分的な単語または語句の末尾にのみ使用します。
フルテキスト検索: [履歴] フィールドには、サービスでサポートされているフルテキスト検索用のインデックスが作成されます。 (Azure DevOps Services では、既定で作業項目の検索が公開されます。オンプレミスの Azure DevOps Server では、検索/レポート機能をインストールして構成する必要があります)。
作業項目の履歴を照会する
Web ポータルまたはチーム エクスプローラーを使用すると、作業項目の履歴を表示したり、[履歴] フィールドに基づいて作業項目を検索したりできます。 履歴フィールドを検索すると、そのフィールドに記録されたコンテンツを含むアイテムのみが返され、他のフィールドに加えられた構造化された変更は含まれません。
![[履歴] フィールドを検索するクエリ エディターを示すスクリーンショット。](media/hist-audit-query-ts-bt.png?view=azure-devops)
![[履歴] フィールドを検索するチーム エクスプローラーのクエリ エディターを示すスクリーンショット。](media/hist-audit-query-team-explorer.png?view=azure-devops)
[履歴] フィールドの内容に基づいて項目を一覧表示する
クエリ 句に履歴フィールドを含めるには、クエリ エディターを使用します。
- クエリ可能なコンテンツ: ディスカッション領域 (履歴) に入力されたコメント。
- クエリ不可能なコンテンツ: "フィールド X が A から B に変更されました" などのリビジョン メタデータは、履歴フィールドを使用してクエリを実行できません。
- 代替検索方法: リッチ テキスト フィールド (説明、ステップ、ディスカッション) で単語を検索するには、作業項目検索を使用します (リンクされたガイダンスを参照)。
- 変更日でフィルター処理: 作業項目を変更日時または特定の日付範囲でフィルター処理します。
フィルターの条件
含めるクエリ句
履歴に "再現可能" が含まれている項目
History Contains Words reproducible
履歴に "beta" が含まれていないアイテム
History Does Not Contain Words beta
"スタック トレース" を含み、閉じられたが、後で再アクティブ化された項目
History Contains Words "stack traces"
And State Was Ever Closed
And State <> Closed
日付範囲内で閉じたアイテム (例)
State = Done
And Closed Date > @Today - 30
And Closed Date <= @Today
関連付けがある項目
History Contains Words MyName
Or Assigned To Was Ever _ @Me
クエリエディタの使用に関するヒント
- パフォーマンスを向上させ、関連する結果を返すように、日付範囲でスコープを制限します。
- 完全な単語または正確な語句を使用します。
- 部分的な単語は一致を返さない場合があります。 たとえば、"再現可能な動作" は一致しますが、"再現" は一致しない可能性があります。
- 単語や語句の末尾にワイルドカードを使用します (
repro*など)。
- ストップ ワードに注意してください。フルテキスト インデックス作成では、一般的な単語が無視される可能性があります。 ストップワードの構成については、リンクされたガイダンスを参照してください。
- クエリを実行して検証します。
- クエリ エディターのツール バーで実行アイコンを選択して、クエリをテストします。
- 結果が見つからない場合は、使用条件を調整して再実行します。
作業項目の履歴を表示する
作業項目を保存するたびに、項目が履歴フィールドに追加されます。 履歴を表示するには、作業項目を開き、[履歴] タブ (または一部の作業項目の種類の詳細) を選択します。
正確な履歴の詳細は、クライアントとバージョンによって異なります。
![Web ポータルの [作業項目] フォームの [履歴] タブを示すスクリーンショット。](media/hist-audit-wi-form-vsts-tab.png?view=azure-devops)
状態変更履歴図が最初に表示されます。[すべて表示] を選択すると、完全な状態変更タイムラインが表示されます。
エントリを選択すると、加えられた変更の詳細が表示されます。
![すべての変更を含むチーム エクスプローラーの [履歴] タブを示すスクリーンショット。](media/alm_ha_allchanges.png?view=azure-devops)
履歴ビューをフィルター処理する
[履歴] タブには、作業項目に対するすべての変更が記録され、完全な追跡可能性が提供されます。 フィルター処理を使用して、アイテムを更新したユーザーまたは変更されたフィールドによって変更履歴を検索します。
Note
トグル フィルター機能には、新しいボード ハブ機能 (既定で有効) が必要です。 プレビュー機能を管理するには、リンクされたガイダンスを参照してください。
特定のユーザーによる更新を確認するには、[更新者] メニューから名前を選択します。
特定のフィールドの更新を確認するには、[フィールド] メニューからフィールドを選択します。
![[割り当て済み] フィールドによるフィルター処理履歴ビューを示すスクリーンショット。](media/history-audit/filter-history-field-assigned-to.png?view=azure-devops)
履歴、監査、リビジョンの追跡をサポートするフィールド
これらのフィールドを使用して、クエリをフィルター処理し、レポートを作成します。 一部のフィールドはアイテムが状態間を移動するときに更新され、他のフィールドはアイテムが変更されたときに更新されます。 いくつかのフィールドは作業項目フォームには表示されませんが、表示される WIT について追跡されます。
フィールド名
Description
作業項目タイプ
変更者
作業項目を最後に変更したチーム メンバーの名前。
Reference name=System.ChangedBy, Data type=String
All
変更日
作業項目が変更された日時。
Reference name=System.ChangedDate, Data type=DateTime
All
クローズ日 1
作業項目が閉じられた日時。
Reference name=Microsoft.VSTS.Common.ClosedDate, Data type=DateTime
All
作成日
作業項目が作成された日時。
Reference name=System.CreatedDate, Data type=DateTime
All
History
作成後に追加された変更のレコード。 各リビジョンは、変更を行ったユーザー、変更された日時、および変更されたフィールドを示します。
Note
履歴クエリは、[ディスカッション] フィールドまたは [説明] フィールドに検索語句が含まれるアイテムを返します。 履歴フィールドを使用して、他のフィールドに対して行われた構造化された変更を照会することはできません。
History フィールドと Description、Steps to Repro、および Title フィールドは、サービスがインデックス作成をサポートするフルテキスト検索用にインデックスが作成されます。
Reference name=System.History, Data type=History
All
解決日 1
作業項目が解決済み状態に移行した日時。
Reference name=Microsoft.VSTS.Common.ResolvedDate, Data type=DateTime
バグ (アジャイル、CMMI)
Rev
作業項目の履歴リビジョンに割り当てられたリビジョン番号。
Note
作業項目のリビジョン制限 10,000 は、Azure DevOps Services の REST API を通じて行われた更新に適用されます。ポータルの更新プログラムは影響を受けません。 (Azure DevOps REST API のドキュメントで現在の制限を確認します)。 Reference name=System.Rev, Data type=Integer
All
改訂日
作業項目が変更された日時。
Reference name=System.RevisedDate, Data type=DateTime
All
状態の変更日
[状態] フィールドの値が変更された日時。
Reference name=Microsoft.VSTS.Common.StateChangeDate, Data type=DateTime
All
テスト スイートを変更するときに実行された操作を追跡します (たとえば、テストの追加や構成の変更)。 [履歴] タブまたはクエリを使用して表示できます。
Reference name=Microsoft.VSTS.TCM.TestSuiteAudit, Data type=PlainText
テスト スイート
作業項目の変更に伴ってインクリメントされる、システム管理の編集不可能なフィールド。
Reference name=System.Watermark, Data type=Integer
All
表の注釈
1 これらのフィールドは、WIT 定義のワークフロー (WORKFLOW) セクションに含まれている必要があります。 たとえば、解決日を自動的に設定するには、次のようにします。
<FIELD refname="Microsoft.VSTS.Common.ResolvedDate">
<SERVERDEFAULT from="clock" />
</FIELD>