ビルドとテストの統合フィールドに基づいてクエリを作成する

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

ビルドとテストの統合をサポートする作業項目フィールドを使用して、トレーサビリティの向上、品質傾向の分析、テスト関連のワークフローの自動化を行います。 一般的なシナリオは次のとおりです。

• バグを、検出または解決された特定のビルドに関連付けます。
• バグをビルドで照会して傾向を特定し、修正に優先順位を付けます。
• テスト ケースを手動または自動としてマークし、自動化メタデータを追跡します。
• チームがテストを確実に実行して検証できるように、テスト ケースと共有ステップのアクションと検証の手順を定義します。

この記事では、これらのフィールドを使用する方法について説明し、サンプル クエリとヒントを提供します。

[前提条件]

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

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

便利なフィルター

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

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

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

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

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

その他のフィールド

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

Team Foundation Build および Azure Pipelines と統合されるフィールド

Team Foundation Build は、以前の Azure DevOps Server リリースで使用されるオンプレミスのビルド システムです。 Azure Pipelines には、Azure DevOps Services でクラウドでホストされるビルドとパイプラインの機能が用意されています。 どちらのシステムも、ビルドの実行時とビルドで作業項目が解決されるときに、ビルド メタデータを作業項目と統合します。

ビルド統合に一般的に使用される 2 つのフィールドは 、Found In と Integration Build です。 WIT 定義に存在する場合、ビルド システムは作業項目を関連するビルド番号に関連付けることができます。

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 定義に [Found In ] フィールドが存在する場合、互換性のあるビルド プロセスでは、ビルドが失敗したときに作業項目を作成し、 Found In をビルド番号に設定できます。 統合ビルドが存在する場合、互換性のあるビルド プロセスは、ビルドによって解決された作業項目を対応するビルド番号で更新できます。

ビルドとグローバルリストの自動入力機能

Team Foundation Build または Azure Pipelines を使用してプロジェクトのビルドを初めてキューに登録すると、 Build - <ProjectName>という名前のグローバル リストが作成されます。 ビルドの実行ごとに、そのビルドの LISTITEM エントリが追加されます。 グローバルリストはプロジェクトの表示名を用いており、FIELD定義の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>

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

テスト計画では、テストが失敗したときにバグまたは別の作業項目を作成できます。 この方法で作業項目を追加すると、テスト システムは、[ システム情報] フィールドと [再現ステップ] フィールドで環境の詳細と再現 手順を キャプチャします。

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

Team Foundation バージョン管理 (TFVC) と統合されるフィールド

TFVC では、チェックイン時の作業項目の関連付けまたは解決がサポートされます。 チェックイン ウィンドウから作業項目をリンクし、アクションがサポートされている場合、TFVC は構成済みの状態遷移を作業項目に適用します。

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

制限事項

テスト ケースでクエリを実行するときの主な制限事項:

• 階層ビュー: テスト プラン、テスト スイート、およびテスト ケースの階層ビューを示すクエリを作成することはできません。これらの成果物は親子リンクの種類によって接続されていないためです。
• クエリベースのテスト スイート: クエリベースのスイートには、クエリによって返されるすべてのテスト ケースが含まれます。意図しない包含を回避するために、クエリが正確であることを確認します。
• フィールドの制限事項: 一部の詳細な実行結果は標準フィールドとして使用できないため、カスタム レポートまたは API の使用が必要になる場合があります。
• パフォーマンスとレートの制限: Azure DevOps では要求とリソースの制限が適用されます。最適化されていないクエリや過剰な API 呼び出しは、遅延や調整を引き起こす可能性があります。
• テストケースのリンク: テストケースは、複雑な階層クエリをサポートする形で他の作業項目に自動的にリンクされることはありません。

関連コンテンツ

• 作業項目フィールドのインデックス
• 作業項目から Git 開発を推進する
• 作業項目を他のオブジェクトにリンクする
• リンククエリと添付ファイルクエリ