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

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

ビルドとテストの統合をサポートする作業項目フィールドは、次の操作をサポートします。

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

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

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

データ型

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

リッチテキスト (HTML)

単語が含まれておらず、単語を含まない、空の1、空ではない1
複数行のテキスト文字列 (プレーンテキスト) 単語が含まれておらず、単語を含まない、空の1、空ではない1
1つのテキスト (文字列) =、 < > 、 > 、 < 、 > =、 < =、= [Field]、 < > [field]、 > [field]、 < [field]、 > = [field]、 < = [field]、Contains、not Contains、in、Not in、group in group、は過去のものです。

マクロ: [任意]作業項目の種類 のフィールドで有効
@Project2チームプロジェクト フィールドで有効

メモ:

  1. が空あり、空ではない 演算子は Azure DevOps Server 2019 RC2 以降のバージョンでサポートされています
  2. @Projectマクロは、Azure Boards および TFS 2015.1 以降のバージョンでサポートされています。 システムは自動的に既定で現在のプロジェクトに基づいてフィルター処理を行います。 詳細については、「 プロジェクト間のクエリ」を参照してください。

便利なフィルター

フィルター条件 次のクエリ句を含める
自動テストケース         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

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

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

List bugs and the test cases that test them

注意

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

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

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

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

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

オートメーションの状態 1

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

  • 自動

  • 自動化なし

  • 対応予定

自動テストを実行するには、「 テスト計画からの自動テストの実行」を参照してください。

[参照名] = AutomationStatus, データ型 = 文字列

テスト ケース

2で見つかりました

リビジョンとも呼ばれる、バグが発見された製品ビルド番号。

参照名 = Microsoft. VSTS. ビルド。データ型 = 文字列

注: [ ビルドに含ま れる] リンクの種類を使用して、作業項目をビルドにリンクすることもできます。 このリンクの種類は Azure DevOps から入手でき、現在のビルドプロセスでのみ機能します (XAML ビルドではありません)。
Bug

統合ビルド 2

コードが組み込まれた、または、バグが修正された製品ビルド番号。

参照名 = Microsoft. VSTS. ビルド。ビルド、データ型 = 文字列

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

問題

共有ステップが予想結果に関連付けられていることを示します。 使用できる値は YesNoです。

参照名 = Microsoft. VSTS. 共通。問題、データ型 = 文字列

共有ステップ

パラメーター 3

手動テストを実行する際に使用するパラメーターを含みます。

Microsoft VSTS. TCM. Parameters, Data type = HTML

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

手順

テストの実行に必要な操作手順と検証手順。

Microsoft VSTS. TCM. 手順, データ型 = HTML

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

システム情報

テストに関連するソフトウェア構成とシステム構成に関する情報。

Microsoft.VSTS.TCM.SystemInfo、データ型 = HTML

バグ、フィードバック応答
再現手順 (または再現手順)

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

参照名 = Microsoft. VSTS. TCM. ReproSteps, データ型 = HTML

Bug

テストスイート の種類1、4

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

  • クエリベース: 優先度が1のすべてのテストなど、特定の特性を持つテストケースをグループ化するために使用します。 定義したクエリによって返されるすべてのテスト ケースがスイートに自動的に含まれるようになります。

  • 静的: バックログ項目のテストの状態を追跡するように設計されたテストケースをグループ化するために使用します。 要件ベースのテスト スイートに追加した各テスト ケースは、バックログ項目に自動的にリンクされます。

  • 要件ベース: 任意の特性またはテストスイートと共にテストケースをグループ化するために使用します。

詳細については、「 テスト計画を作成する」を参照してください。

参照名 = Microsoft. VSTS. Testスイート、データ型 = 文字列

テスト スイート

ノート

  1. これらのフィールドの候補リストはカスタマイズしないでください。 システムは一覧表示されている値のみを受け入れます。
  2. 定義に要素を追加することによって GLOBALLIST FIELD 、ユーザーが選択できるビルドのドロップダウンメニューを提供できます。 詳細については、この記事で後述する「 ビルドとグローバルリストの自動作成 」を参照してください。
  3. では、TFS 2013.2 以降のバージョンをアプリケーション層サーバーにインストールし、既存のプロジェクトを更新して共有パラメーターをサポートする必要があります。 詳細については、「 TFS のアップグレード後の機能の構成」を参照してください。
  4. では、TFS 2013.3 以降のバージョンをアプリケーション層サーバーにインストールし、既存のプロジェクトを更新してテスト計画とテストスイートをサポートする必要があります。 詳細については、「 TFS のアップグレード後の機能の構成」を参照してください。

追加フィールド

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

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

自動テスト ストレージ

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

[参照名] = Microsoft. VSTS. [データ型] = [文字列]

テスト ケース

自動テストの種類

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

Reference name = Microsoft. VSTS. [データ型] = 文字列

テスト ケース

AutomatedTestId

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

参照名 = Microsoft. VSTS. [データ型] = 文字列

テスト ケース

AutomatedTestName

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

[参照名] = 必ず automatedtestname, データ型 = 文字列

テスト ケース

LocalDataSource

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

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

テスト ケース

クエリ テキスト

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

参照名 = QueryText、データ型 = プレーンテキスト

テスト スイート

テストスイートの監査 1

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

参照名 = TestSuiteAudit、データ型 = プレーンテキスト

テスト スイート

テストスイートの種類 ID 1、2

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

  • 1 (静的)

  • 2 (クエリベース)

  • 3 (要件ベース)

[参照名] = TestSuiteTypeId, データ型 = 整数

テスト スイート

ノート

  1. では、TFS 2013.3 以降のバージョンをアプリケーション層サーバーにインストールし、既存のプロジェクトを更新してテスト計画とテストスイートをサポートする必要があります。
  2. これらのフィールドの候補リストはカスタマイズしないでください。 システムは一覧表示されている値のみを受け入れます。

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

Team Foundation ビルドは、Azure DevOps Server と TFS で使用できるオンプレミスのビルドシステムです。 Team Foundation ビルドを使用してビルドプロセスを構成できます。また、ビルドが失敗したときに Team Foundation ビルドで作業項目を生成できます。 また、特定のビルドで解決された作業項目にビルド情報を追加できます。 これを機能させるには、Team Foundation ビルドで、作業項目の種類の定義に次の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 ビルドは作業項目を作成し、[検出 された対象] フィールドを、失敗したビルドのビルド番号に設定します。 [検出 された場所] フィールドがない場合、Team Foundation ビルドは失敗したビルドの作業項目を作成せず、他のすべての操作は想定どおりに動作します。

WIT 定義に 統合ビルド フィールドが存在する場合、Team Foundation ビルドは各ビルドで解決された作業項目を識別し、それらの作業項目を更新して、 統合ビルド フィールドで解決されたビルド番号を設定します。 [ 統合ビルド ] フィールドがない場合、Team Foundation ビルドでは作業項目にビルド番号が格納されず、他のすべての要素は想定どおりに動作します。

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

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

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

<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>

Test Plans と統合するフィールド

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

この方法で作業項目が作成されると、システムに関する情報とバグの再現手順が システム情報 と再現 手順 のフィールドにキャプチャされます。

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

<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) で使用できる機能の1つでは、コードをチェックインするときに作業項目を関連付けたり、解決したりすることができます。 コードの変更時に特定の作業項目を操作していた場合、コードの作業が終了するときに、ソース管理のチェックイン ウィンドウから、その関連付けを設定できます。

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

注意

チェックイン アクションを使用する場合は、必要な状態遷移を反映するように、と の**状態を適切 に設定する必要があります。

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

テスト作業項目の種類の可用性

テスト マネージャーとテストの作業項目の種類 (WIT) は次のフィールドを使用して、テスト計画、進捗、および結果を追跡します。 WIT の使用可能性はアプリケーション層にインストールされている TFS のバージョンに基づきます。 これらの Wit の使用方法の詳細については、「 テスト計画を作成する」を参照してください。

TFS 2013.0 TFS 2013.2 TFS 2013.3 以降のバージョン
  • Bug
  • 共有ステップ
  • テスト ケース
  • Bug
  • 共有パラメーター
  • 共有ステップ
  • テスト ケース
  • Bug
  • 共有パラメーター
  • 共有ステップ
  • テスト ケース
  • テスト計画
  • テスト スイート

既存のプロジェクトをアップグレードして、現在プロジェクトに含まれていない Wit を取得する方法の詳細については、「 アップグレード後の機能の構成」を参照してください。