次の方法で共有


テスト ケースを一括インポートまたはエクスポートする

Azure DevOps Services

Azure Test Plansでは、CSV または Microsoft Excel (XLSX) ファイル形式を使用したテスト ケースの一括インポートとエクスポートがサポートされます。 インポート時にテスト ケース ID を指定することで、テスト スイートに新しいテスト ケースを作成したり、既存のテスト ケースを更新したりできます。 エクスポート操作により、テスト ケースが CSV または XLSX ファイルに保存され、外部編集や共有が可能になります。

大規模なテスト ケースを管理するには、次のオプションがあります。

  • 一括操作: 大規模な変更のために CSV または XLSX ファイルを使用してインポートおよびエクスポートします。
  • Web ポータル ツール: ブラウザーでテスト ケースを直接コピー、複製、更新し、小さな変更を行います。

Web ポータルの代替方法の詳細については、「 テスト計画、テスト スイート、テスト ケースのコピーまたは複製」を参照してください。

テスト オブジェクトと用語の概要については、「テスト オブジェクトと用語 を参照してください。

前提 条件

カテゴリ 必要条件
プロジェクトへのアクセス権 プロジェクト メンバー
アクセス レベル フィードバックを要求または提供するには、少なくとも 利害関係者 のアクセスが必要です。
アクセス許可 - バグやその他の作業項目の種類を追加または変更するには: 対応する [エリアパス] において [このノードの作業項目を編集] アクセス許可を [許可] に設定します。
- 新しいタグを追加するには、タグ定義を作成し、 アクセス許可を [許可]に設定します。
詳細については、「 テスト用のアクセス許可とアクセスを設定するを参照してください。

テスト ケースのエクスポート

  1. テスト 計画>テスト 計画に移動し、テスト 計画を選択し、テスト スイートを選択してそのテスト ケースを表示します。

  2. (省略可能) Column オプション を選択して、ダウンロード ファイルにフィールドを追加します。

  3. すべてのテスト ケースを選択するか、特定のテスト ケースを選択し、[ テスト ケースを CSV にエクスポート ] または [ テスト ケースを XLSX にエクスポート] を選択します。

    選択したテスト スイートからのテスト ケースのエクスポートのスクリーンショット。

    ファイルがローカル コンピューターにダウンロードされます。

テスト ケースのインポート

  1. [テスト プラン>テスト プランに移動し、テスト 計画を選択し、スイート ツリーからテスト スイートを選択します。

  2. [ CSV/XLSX からテスト ケースをインポートする] を選択します。

    選択したテスト スイートへのテスト ケースのインポートのスクリーンショット。

  3. ファイルをドラッグ アンド ドロップするか、[ 参照 ] を選択してファイルを選択します。 ウィザードは、検出された列をAzure DevOpsフィールドに自動的にマップします。

  4. フィールド マッピングを確認します。 次の 9 つのフィールドが必要です。

    • ID - 新しいテスト ケースの場合は空のままにするか、更新する既存の ID を指定します
    • 作業項目の種類 - Test Case する必要があります (正確なスペルと大文字と小文字の区別)
    • タイトル
    • テスト ステップ - 各ステップのシーケンシャル番号 (123)
    • ステップ アクション
    • ステップが期待されています
    • エリア パス - 既存のエリア パスと一致する必要があります (例: MyProject\MyArea)
    • 割り当て済み - 組織内の有効なユーザー (表示名または電子メール)
    • State - Design にする必要があります

    フィールド マッピング インターフェイスを示すインポート ウィザードのスクリーンショット。

  5. (省略可能)マッピングを変更するには、フィールドドロップダウンを選択し、適切なAzure DevOpsフィールドを選択します。

    オプションのフィールド マッピングの更新のドロップダウン メニューを示すスクリーンショット。

    フィールドをスキップするには、現在のマッピングの選択を解除して 、フィールドの選択...を表示します。

    マッピングをスキップするための空のフィールド選択を示すスクリーンショット。

  6. (省略可能)現在のマッピングを再利用可能なテンプレートとしてエクスポートし、チームと共有します。

  7. (省略可能)複数のシートを含む XLSX ファイルの場合は、インポートするシートを選択します。 一度にインポートできるシートは 1 つだけです。

    複数のシートを含む XLSX ファイルのワークシート選択ダイアログを示すスクリーンショット。

  8. インポート を選択します。 ID が一致する既存のテスト ケースは更新され、上書きされる可能性があります。

マッピング テンプレートを使用する

Azure Test Plansは、同じ列構造を持つ将来のインポートに対するフィールド マッピングを記憶します。 インポートを完了する前に、常にマッピングを確認してください。

現在のマッピングをチームの再利用可能なテンプレートとしてエクスポートできるため、各メンバーがマッピングを個別に構成する必要はありません。 また、定期的に使用するさまざまなファイル構造のテンプレートを保存することもできます。

スクリーンショットには、テンプレートが選択されておらず、現在のマッピングをテンプレートとしてダウンロードするためのリンクが示されています。

テンプレートのインポート後にマッピングを変更すると、確立されたチーム標準に誤って変更されないように警告が表示されます。

スクリーンショットは、変更が行われた場合、アップロードされたテンプレートに基づいてマッピングが行われなくなったことを示すメッセージを示しています。

既存のテスト ケースを更新する

  1. (省略可能) Column オプション を選択して、編集するフィールドをビューに追加します。

  2. テスト ケースを CSV または XLSX にエクスポートします。 詳細については、「 テスト ケースのエクスポート」を参照してください。

    選択したテスト スイートからのテスト ケースのエクスポートのスクリーンショット。

  3. ファイルを編集します。 [ID] フィールドまたは [作業項目の種類] フィールドは変更しないでください。

  4. ファイルを保存し、テスト スイートにインポートし直します。 詳細については、「 テスト ケースのインポート」を参照してください。

よく寄せられる質問

Q: 新しいテスト ケースを作成し、同じファイル内の既存のテスト ケースを更新することはできますか。

A: はい。 同じ CSV または XLSX ファイルでは、新しいテストケースの場合は ID フィールドを空のままにして、更新の場合は既存の ID を含めます。

Q: インポート エラーを特定して解決するにはどうすればよいですか?

A: インポート ウィザードは、ファイルのアップロード、フィールド マッピング、および最終インポートの前に、各段階でファイルを検証します。 エラーはインラインで表示され、インポートを続行する前に解決する必要があります。

テスト ケースのインポート エラー ダイアログのスクリーンショット。

一般的なエラーと解決策:

エラー ソリューション
必須ヘッダーがありません 正確なスペルで必要な列ヘッダーを追加します。
無効なフィールド値が見つかりました 作業項目の種類が正確にTest Case状態Designエリア パスが既存のパス (MyProject\MyAreaなど)、Assigned To が有効なユーザー、テスト ステップが数値であることを確認します。
無効なデータ形式 日付形式、数値、およびテキストの長さの制限を確認します。
フィールド マッピングが正しくありません 列が正しいAzure DevOps フィールドにマップされていることを確認します。
空の必須フィールド すべての必須フィールドに有効なデータが含まれていることを確認します。

エラーを修正するには、エラー メッセージをメモし、CSV または XLSX ファイルを修正し、ファイルを再アップロードして、インポートを完了します。

Q: インポートでサポートされている作業項目の種類は何ですか?

A: インポート プロセスでは、 テスト ケース の作業項目のみがサポートされます。 既存の共有ステップを参照するには、その ID をファイルに含めます。 インポートで新しい共有ステップを作成することはできません。最初に Web インターフェイスで作成してから、その ID を参照します。

CSV での共有ステップ参照のスクリーンショット。

共有ステップ参照とステップの詳細の両方を同じ行に含める場合、インポートによって共有ステップ作業項目が更新されます。 共有ステップを変更せずに参照するには、ステップの詳細を省略します。

その他の作業項目の種類 (ユーザー ストーリー、タスク、バグ) については、「 一括インポートまたは更新 (CSV)」を参照してください。

Q: インポート ファイルの必須ヘッダーは何ですか?

A: 正確なスペルを持つ次の 9 つのヘッダーを含めます。

Header 説明
ID 新しいテスト ケースの場合は空白のままにします。更新プログラムの既存の ID を指定します。
作業項目の種類 Test Case または Shared Steps である必要があります。
タイトル テスト ケース名。
テスト ステップ 各ステップの注文番号。
ステップ アクション テスターが実行するアクション。
ステップが期待されています アクションの後に予期される結果。
エリア パス 既存のエリア パス (たとえば、 MyProject\MyArea) と一致する必要があります。
に割り当てられた 組織内の有効なユーザー。
状態 Designである必要があります。

Q: インポートまたはエクスポートの制限事項は何ですか?

A: 次の制限が適用されます。

  • テスト ケースは、インポート時に デザイン 状態である必要があります。
  • テスト ケースのタイトルは 128 文字を超えることはできません。
  • ファイルのインポートとエクスポートには、20 MB のサイズ制限があります。 操作が失敗した場合は、より小さなサブセットをインポートします。
  • 対象のテスト計画とテスト スイートの領域と反復パスに対するアクセス許可が必要です。
  • テスト ケースに 1,000 を超える関連リンクがある場合、操作は失敗します。

次のステップ

手動テスト を実行する