Studio ガイド

最終更新日時 2025年10月23日

テストデータのキュー

概要

テストデータのキューをデータソースとして設定したり、アクティビティ経由でインポートしたりすると、Studio でテストデータのキューを活用できます。インポートされたエンティティはすべて [プロジェクト] タブの [テストデータ] 下に保存されます。

Orchestrator のテストデータのキューについて詳しくは、「テストデータのキュー」をご覧ください。

注:

v2022.4 以降の Orchestrator をインストール、または Orchestrator を v2022.4 以降にアップグレードします。
JSON スキーマをアップロードし、Orchestrator にテストデータのキューを追加済みであることを確認します。

条件

新規作成したテストデータのキューは空ですが、Orchestrator で直接、または Studio 経由で定義した JSON スキーマに基づいて、キューアイテムをアップロードできます。
動的なテストデータを使用してテストケースを実行およびデバッグするには、テストエクスプローラーを使用します。データは実行時にテストデータのキューから取得され、実行時にテストエクスプローラーにより値が入力されます。

既知の制限事項

データドリブンなテストセットに対して Orchestrator UI から直接、入力引数の値を定義した場合、その値はテストバリエーションに渡されません。

回避策: 入力引数をテストデータのキューアイテムに直接追加します。

テストデータのキューアイテムを追加する

テストデータのキューアイテムをワークフローに追加するには、アクティビティを使用するかテストケースのデータソースとして設定します。

アクティビティを使用してアイテムを追加する

アクティビティを使用してテストデータのキューにアイテムを追加するには、カスタムワークフローを作成して、Orchestrator のテストデータのキューからデータをインポートするアクティビティを設定する必要があります。

Studio を開きます。
テストオートメーション プロジェクトを開くか、新規作成します。
[新規] > [テストケース] に移動します。
[デザイナー] パネルに [テストデータのキューアイテムを追加] アクティビティを追加し、[プロパティ] に移動して [キュー名] に Orchestrator のテストデータのキューと同じ名前を設定します。

注: Orchestrator インスタンスに接続されていることを確認します。
[テスト] > [データ] アクティビティのリストにある任意のアクティビティを複数個選択して、[テストデータのキューアイテムを追加] アクティビティに追加します。アクティビティについて詳しくは、「テストデータアクティビティ」をご覧ください。
自分の合成ユーザーデータのシナリオに合わせてアクティビティを設定します。

重要: 有効なキューアイテムの名前は、JSON スキーマに定義されている名前と正確に一致している必要があります。たとえば、JSON スキーマで givenName プロパティを定義している場合は、対応する[名前] アクティビティをこれに一致させる必要があります (例: DisplayName を givenName に設定するなど)。詳細は、「JSON スキーマの定義」をご覧ください。
[変数] パネルを開いて、変数を定義します。
テストケースを保存します。
[プロジェクト] パネルでテストケースを右クリックして、[「パブリッシュ可能」として設定] を選択します。
[パブリッシュ] をクリックして、パッケージのプロパティを設定します。
[ファイルを実行] をクリックします。

注: 代わりに、カスタム入力フォームを作成して、合成ユーザーデータを簡単に設定、生成する方法もあります。詳細は、「フォームを作成する」をご覧ください。

テストデータのキューをデータソースとしてテストケースに追加する

テストケースを作成する際、データドリブンなテストを活用するため、データソースがテストデータのキューをポイントするように設定できます。

テストデータを使用して新しいテストケースを作成するか、テストデータを使用して既存のテストケースを更新します。
[ソース] をクリックして、ドロップダウンリストから [テストデータのキュー] を選択します。
テストデータのキューを選択するか、検索機能を使用して検索します。
(任意) 組み込みのクエリビルダーを使用してテストデータのキューをフィルター処理し、特定のアイテムのみを取得します。
[範囲] オプションを使用して、目的の範囲の項目を設定します。最初のフィールドは範囲の開始インデックスを表し、2 つ目のフィールドは取得する項目の数を表します。
(任意) [アイテムのステータス] ドロップダウンリストから、処理するテストデータのキューアイテムの目的のステータスを選択します。以下から選択できます。
1. すべて – すべてのテストデータのキューアイテムを使用します。
2. 消費済みのアイテム - 消費済みとしてマークされたテストデータのキューアイテムのみを使用します。
3. 未消費のアイテム – 未消費としてマークされたテストデータのキューアイテムのみを使用します。
  図 1. [新しいテストケース] メニューのクエリビルダー
[作成] をクリックして、テストデータ (テストデータのキュー) をテストケースに追加します。
テストデータのキューの名前が付いた引数がプロジェクトの [引数] パネルに生成されます。上記の図では、引数の名前は workforce です。
重要: テストデータのキューの引数の名前を変更しないでください。変更すると、データにアクセスできなくなります。たとえば、引数の名前を workforce から Work_Force_Queueに変更すると、対応するデータにアクセスできなくなります。

テストデータのキューアイテムを更新する

テストデータのキューをソースとしてテストデータを更新できます。

Studio を開き、プロジェクトに移動します。
[プロジェクト] パネルで、データバリエーションがあるテストケースを右クリックし、[テストデータを更新] を選択します。
[ソース] をクリックして、ドロップダウンリストから [テストデータのキュー] を選択します。
テストデータのキューを選択するか、検索機能を使用して検索します。
(任意) [同じテストデータを使用してすべてのテストケースを更新] をクリックし、現在のプロジェクト内にある、更新するテストデータを使用しているすべてのテストケースを更新します。
(任意) 組み込みのクエリビルダーを使用してテストデータのキューをフィルター処理し、特定のアイテムのみを取得します。

注: この操作は、[テストエクスプローラー] でファイルを右クリックして [テストデータを更新] を選択することでも実行できます。

テストデータのキューアイテムを取得する

このチュートリアルでは、テストデータのキューアイテムを取得してデータドリブンなテストを実行する方法について説明します。データドリブンなテストでは、テストデータのキューアイテムを入力として使用して、さまざまなデータシナリオを効率的にテストできます。以下の手順に従って、テストケース内でテストデータのキューを取得および利用します。

テストオートメーション プロジェクトを作成します。
[デザイン] のリボンのファイル グループから、新しいテストケースを作成します。
1. [テストデータ] タブで、[ソース] として [テストデータのキュー] を選択します。
  この例では、テストデータのキュー「loan_quote_queue」を選択しました。
2. [作成] をクリックします。
  テストケースとともに、テストデータのキューの名前を持つ引数も [引数] パネル内に自動的に作成されます。
  重要: 引数名は変更せずにそのままにします。そうしないと、テストデータのキューからデータを取得できません。
テストデータのキューからアイテムを取得するには、生成された引数を入力し、取得する列にアクセスします。「<testDataQueueName>("<columnName>").toString」の形式を使用して、アイテムを取得できます。
この例では、[メッセージをログ] アクティビティを追加し、[メッセージ] フィールドに「loan_quote_queue("first_name").toString」を入力しました。