ビルドとテストの統合フィールドに基づくクエリの作成

[アーティクル]
04/05/2024

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

ビルドとテストの統合をサポートする作業項目フィールドでは、次のアクションがサポートされます。

バグを、そのバグが発見または修正されたビルドに関連付ける
ビルドに関連付けられているバグを照会する
テストケースに手動または自動としてマークを付け、自動テストケースをサポートする情報を格納する
テストケースと共有ステップに対して、操作手順と検証手順、およびテストの実行に使用するデータを定義する。

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

ほとんどのビルドおよびテスト統合フィールドには、String、PlainText、または HTML のデータ型があります。テキストフィールドまたはリッチテキストフィールドを指定するクエリ句では、次の表で示す演算子とマクロを使用できます。

データの種類

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

リッチテキスト (HTML) および
複数行テキスト文字列 (PlainText)

Is Empty と Is Not Empty 演算子は、Azure DevOps Server 2019 RC2 以降のバージョンでサポートされています。

単一テキスト (文字列)

マクロ: [Any] ([作業項目の種類] フィールドで有効)、@Project ([チームプロジェクト] フィールドで有効)。既定では、現在のプロジェクトに基づいて自動的にフィルター処理されます。詳細については、プロジェクト間でクエリを実行に関するページをご覧ください。

便利なフィルター

フィルターの対象

含めるクエリ句

自動テストケース

Work Item Type = Test Case And Automation Status = Automated

クエリベースのテストスイート

Work Item Type = Test Suite And Test Suite Type = Query Based

要件ベースのテストスイート

Work Item Type = Test Suite And Test Suite Type = Requirement Based

バグとそのテストケースを一覧表示する

新しいクエリを開き、クエリの種類を [作業項目とダイレクトリンク] に設定します。最上位レベルのバグをフィルター処理し、リンクされた作業項目フィルターにテストケースのフィルターを追加します。

バグとそのテストケースを一覧表示する

注意

Test Plans、テストスイート、テストケースの階層ビューを表示するクエリを構築することはできません。これらの項目は、親子リンクの種類を使って一緒にリンクされません。 [テスト] > [Test Plans] ページを使用して階層を表示することはできます。

ビルドとテストのデータフィールド

次の表では、1 つ以上のテスト WIT で定義されるフィールドを説明しています。データ型とフィールド属性の詳細については、作業項目フィールドと属性に関するページを参照してください。

フィールドまたは選択リストをカスタマイズするには、「クエリ、レポート、およびワークフローをサポートするためのフィールドの追加または変更」を参照してください。

フィールド名

説明

作業項目の種類

Automation の状態¹

テストケースの状態。次の値を指定できます。

自動
自動化なし
対応予定
自動テストを実行するには、「テスト計画から自動テストを実行する」を参照してください。
参照名=Microsoft.VSTS.TCM.AutomationStatus、データ型=String

テストケース

発見されたビルド²

リビジョンとも呼ばれる、バグが発見された製品ビルド番号。
参照名=Microsoft.VSTS.Build.FoundIn、データ型=String

注意

[発見されたビルド] リンクの種類を使用して、作業項目をビルドにリンクすることもできます。このリンクの種類は、Azure DevOps から利用でき、(XAML ビルドではなく) 現在のビルドプロセスでのみ機能します。

Bug

統合ビルド²

コードが組み込まれた、または、バグが修正された製品ビルド番号。
参照名=Microsoft.VSTS.Build.IntegrationBuild、データ型=String

注意

[ビルドに統合] リンクの種類を使用して、作業項目をビルドにリンクすることもできます。このリンクの種類は、Azure DevOps から利用でき、(XAML ビルドではなく) 現在のビルドプロセスでのみ機能します。

すべて

問題

共有ステップが予想結果に関連付けられていることを示します。許容値は Yes と No です。参照名=Microsoft.VSTS.Common.Issue、データ型=String

共有ステップ

パラメーター

手動テストを実行する際に使用するパラメーターを含みます。
Microsoft.VSTS.TCM.Parameters、データ型=HTML

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

手順

テストの実行に必要な操作手順と検証手順。 Microsoft.VSTS.TCM.Steps、データ型=HTML

共有ステップ、テストケース

システム情報

テストに関連するソフトウェア構成とシステム構成に関する情報。
Microsoft.VSTS.TCM.SystemInfo、データ型=HTML

バグ、フィードバック応答

再現ステップ (または再現手順)

予測できない動作の再現に必要な手順。他のチームメンバーが問題の影響を正確に理解し、バグが修正済みかどうかを判断するために十分な情報を提供します。これには、バグの検出や再現に必要な操作と、予想される動作が含まれます。参照名=Microsoft.VSTS.TCM.ReproSteps、データ型=HTML

Bug

テストスイートの種類¹

テストスイートのカテゴリ。使用できる値は、以下のとおりです。

[クエリベース]: 特定の特性を持つテストケース (たとえば、Priorty=1 のすべてのテストなど) をグループ化するために使用します。定義したクエリによって返されるすべてのテストケースがスイートに自動的に含まれるようになります。
[要件ベース]: バックログ項目のテスト状態を追跡するために設計されたテストケースをグループ化するために使用します。要件ベースのテストスイートに追加した各テストケースは、バックログ項目に自動的にリンクされます。
[静的]: 特性を持つテストケースまたはテストスイートをグループ化するために使用します。
詳細については、「テスト計画の作成」を参照してください。
参照名=Microsoft.VSTS.TCM.TestSuiteType、データ型=String

テストスイート

注意

これらのフィールドの選択リストをカスタマイズしないでください。システムは一覧表示されている値のみを受け入れます。
GLOBALLIST 要素を FIELD 定義に追加することによって、ユーザーが選択可能なビルドのドロップダウンメニューを提供できます。方法については、この記事で後述する「ビルドとグローバルリストの自動設定」を参照してください。

その他のフィールド

次のフィールドは、作業項目フォームには表示されませんが、テストケースまたはテストスイートごとに追跡されます。クエリのフィルター処理およびレポートの作成に、これらのフィールドのいくつかを使用できます。 (これらのフィールドはいずれも、データウェアハウスに追加されたり、インデックスが作成されたりすることはありません。)

フィールド名

説明

作業項目の種類

自動テストストレージ

テストケースを自動化するテストを含むアセンブリ。

参照名=Microsoft.VSTS.TCM.AutomatedTestStorage、データ型=String

テストケース

自動テストの種類

テストケースを自動化するテストの種類。

参照名=Microsoft.VSTS.TCM.AutomatedTestType、データ型=String

テストケース

AutomatedTestId

テストケースを自動化するテストの ID

参照名=Microsoft.VSTS.TCM.AutomatedTestId、データ型=String

テストケース

AutomatedTestName

テストケースの自動化に使用するテストの名前

参照名=Microsoft.VSTS.TCM.AutomatedTestName、データ型=String

テストケース

LocalDataSource

テストをサポートするローカルデータソース

参照名=Microsoft.VSTS.TCM.LocalDataSource、データ型=HTML

テストケース

クエリテキスト

クエリベースのスイートの種類に対して定義されるクエリをキャプチャするために使用されるフィールド。

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

テストスイート

テストスイートの監査

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

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

テストスイート

テストスイートの種類 ID ¹

テストスイートカテゴリに対応し、テストスイートのみに適用可能なシステム割り当て値。割り当て値は次のとおりです。

1 (静的)
2 (クエリベース)
3 (要件ベース)

参照名=Microsoft.VSTS.TCM.TestSuiteTypeId、データ型=Integer

テストスイート

注意

これらのフィールドの選択リストをカスタマイズしないでください。システムは一覧表示されている値のみを受け入れます。

Team Foundation ビルドと統合するフィールド

Team Foundation Build は、Azure DevOps Server および TFS で使用できるオンプレミスのビルドシステムです。ユーザーは Team Foundation Build を使用してビルドプロセスを構成でき、ビルドが失敗した際には Team Foundation Build で作業項目を生成できます。また、特定のビルドで解決された作業項目にビルド情報を追加できます。 Team Foundation Build でこの処理を実行するには、[発見されたビルド] と [統合ビルド] の 2 つのフィールドを作業項目の種類の定義に追加する必要があります。

[発見されたビルド] フィールドと [ビルドに統合] フィールドは、既定のプロセスではバグに対して定義されています。これらのフィールドは、バグをそのバグが発見されたビルドや修正されたビルドと関連付けます。

WIT 定義にこれらのフィールドを追加するには、次のコードスニペットを使用できます。

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="&lt;None&gt;" />
        </SUGGESTEDVALUES>
</FIELD>
<FIELD name="Integration Build" refname="Microsoft.VSTS.Build.IntegrationBuild" type="String" reportable="dimension">
    <HELPTEXT>Product build number this bug was fixed in</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="&lt;None&gt;" />
        </SUGGESTEDVALUES>
</FIELD>

[発見されたビルド] フィールドが WIT 定義内に存在する場合、Team Foundation Build はビルドに失敗すると作業項目を作成し、[発見されたビルド] フィールドを失敗したビルドのビルド番号に設定します。 [発見されたビルド] フィールドが存在しない場合、Team Foundation Build はビルドが失敗したときに作業項目を作成しません。その他の処理は予定どおりに実行されます。

[統合ビルド] フィールドが WIT 定義内に存在する場合、Team Foundation Build は各ビルドで解決された作業項目を識別し、それらの作業項目を更新して、[統合ビルド] フィールドに作業項目が解決されたビルド番号を設定します。 [統合ビルド] フィールドが存在しない場合、Team Foundation Build は作業項目にビルド番号を格納しません。その他の処理は予定どおりに実行されます。

ビルドとグローバルリストの自動設定

初めて Team Foundation ビルドを使用してプロジェクトのビルドをキューに入れた場合は、TFS が自動的に "Build - ProjectName" というラベルのグローバルリストを追加します。ビルドを実行するたびに、LISTITEM がビルドの名前でこのグローバルリストに追加されます。

GLOBALLIST 要素を FIELD 定義に追加することによって、ユーザーが選択可能なビルドのドロップダウンメニューを提供できます。次に例を示します。

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="&lt;None&gt;" />
        </SUGGESTEDVALUES>
        <SUGGESTEDVALUES expanditems="true" filteritems="excludegroups">
          <GLOBALLIST name="Builds - TeamProjectName" />
        </SUGGESTEDVALUES>
</FIELD>

テスト計画と統合するフィールド

テスト計画を使用すると、テストが失敗した場合にバグまたはその他の種類の作業項目の作成を自動化できます。詳細については、探索的テストを使用して既存のバグに結果を追加する方法に関する記事を参照してください。

この方法で作業項目が作成された場合、システムに関する情報およびバグを再現する手順は[システム情報] フィールドと[再現ステップ] フィールドに取り込まれます。

次のコードスニペットを使用して、障害を追跡するために作成する作業項目の種類にこれらのフィールドを追加できます。

<FIELD name="System Info" refname="Microsoft.VSTS.TCM.SystemInfo" type="HTML" />
<FIELD name="Repro Steps" refname="Microsoft.VSTS.TCM.ReproSteps" type="HTML" />

Team Foundation バージョン管理と統合するフィールド

Team Foundation バージョン管理 (TFVC) で使用できるいずれかの機能によって、コードのチェックイン時に作業項目の関連付けまたは解決ができます。コードの変更時に特定の作業項目を操作していた場合、コードの作業が終了するときに、ソース管理のチェックインウィンドウから、その関連付けを設定できます。

Team Foundation バージョン管理が作業項目を解決するには、その作業項目に特定のアクションが含まれている必要があります。ソース管理システムは、作業項目トラッキングに問い合わせて、作業項目がそのアクションをサポートするかどうかを判断し、そのアクションがサポートされる場合は、遷移の最初と最後の状態についても問い合わせます。アクションが見つかった場合、ソース管理システムは、コードにチェックインするときに設定されている遷移に従って作業項目を遷移します。

注意

[チェックイン] アクションを使用する場合は、適切な "from" 状態と "to" 状態を設定して、目的の状態遷移を反映させる必要があります。

アクションの詳細については、「状態、遷移、または理由に基づいたフィールド割り当ての自動化」を参照してください。

次の方法で共有

ビルドとテストの統合フィールドに基づくクエリの作成

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

便利なフィルター

バグとそのテストケースを一覧表示する

ビルドとテストのデータフィールド

その他のフィールド

Team Foundation ビルドと統合するフィールド

ビルドとグローバルリストの自動設定

テスト計画と統合するフィールド

Team Foundation バージョン管理と統合するフィールド

フィードバック

その他のリソース

次の方法で共有

ビルドとテストの統合フィールドに基づくクエリの作成

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

便利なフィルター

バグとそのテスト ケースを一覧表示する

ビルドとテストのデータ フィールド

その他のフィールド

Team Foundation ビルドと統合するフィールド

ビルドとグローバル リストの自動設定

テスト計画と統合するフィールド

Team Foundation バージョン管理と統合するフィールド

関連記事

フィードバック

その他のリソース

バグとそのテストケースを一覧表示する

ビルドとテストのデータフィールド

ビルドとグローバルリストの自動設定