コンテンツにスキップ

テストデータマトリックス

ガイド付きマトリックスはWebクライアントで利用可能です。その結果は通常のテストケースバリアントであり、Windowsでも使用可能です。

テストデータマトリックスを使用して、ライブラリのテストケースに対して既存のバリアント値の選択された組み合わせを作成します。例えば、2つのブラウザ、2つの役割、2つのデータセットで8つの組み合わせが生成されます。

次元 選択された値
ブラウザ Chromium、Firefox
役割 顧客、管理者
データセット 標準、特殊文字

この組み合わせ表の「データセット」は名前付きバリアント値です。さらに、構造化されたテストデータセットは列と行を提供し、その値をテストテキストに明示的に適用できます。テスト環境は別に管理され、全体のテスト実行をグループ化します。

前提条件

プロジェクトはテストバリアントを使用する必要があります。必要な次元と値はすでにバリアント管理に存在していなければなりません。組み合わせの追加にはライブラリのテストケースへの書き込みアクセスが必要です。読み取りアクセスではプレビューの検査が可能ですが、バリアントの追加には引き続き書き込みアクセスが必要です。

組み合わせを選択して追加します。

  1. Webテストケースライブラリで必要なケースを開き、ケースヘッダーのテストデータマトリックスを選択してください。この項目はライブラリツリーの選択したケースのコンテキストメニューにもあります。
  2. 各次元で必要な値を選択します。次元は少なくとも1つの値を選択した場合にのみ参加します。
  3. 組み合わせのプレビューを選択してください。アプリケーションは参加するすべての次元から選択された値を組み合わせます。実際の値のみを使用し、追加の空のオプションは追加しません。
  4. 既に存在するテストケースバリアントの組み合わせを確認します。追加したい不足している組み合わせのみを選択してください。
  5. 選択した組み合わせを追加します。を選択し、追加を確認してください。その後、通常のテストケースバリアントを開き、テスト内容を確認または完了してください。

既存のバリアントは内容を保持します。既存の組み合わせは再作成されません。プレビューには最大 200 組み合わせが含まれます。設定されたプロジェクトバリアント制限が低い場合もプレビューが制限されます。既存および新規追加のバリアントの合計数は適用される制限内に収める必要があります。制限が報告された場合は選択を減らしてください。

プレビューと適用の間にケースまたはそのバリアントが変更された場合、古いプレビューは拒否されます。新しいプレビューを生成し、選択を再度確認してください。

内容と計画

新しい組み合わせは既存のバリアントモデルを使用します。これらのバリアントを計画する前に継承されたテストステップと期待結果を確認してください。クイックテストケースの場合、対応するプロジェクト設定が有効な場合にのみ、プライマリバリアントの行がコピーされます。マトリックスはクイックテストケースに追加のバージョン履歴を導入しません。

以前に計画されたケース、実行中のテスト実行および結果は自動的に更新されません。新しいバリアントは次の明示的な計画ステップに含めてください。マトリックスは実行を開始せず、テスト結果も作成しません。

MCPおよびREST

ztm_project_test_data_matrixはoperation: "context"およびtestCaseIdを使用して利用可能な選択肢を読み取ります。プレビュー取得にはoperation: "preview"、同じtestCaseIdおよびvalueIdsを使用します。コンテキストから返される既存値のIDを使用してください。

変更は機能project.test-data-matrix.applyを持つztm_project_action_prepareおよびztm_project_action_commitを使用します。引数はtestCaseId、selectedCombinations(値IDを含む配列の配列)および現在のプレビューからのexpectedFingerprintです。追加のために意図的に選択された不足している組み合わせのみを送信してください。準備だけでは保存されません。コミット前にプレビューをレビューして確認してください。

REST は /api/v1/operations/{operationId} で同じ操作を公開します。両方の API は Web クライアントと同じ権限、制限、競合チェックを適用します。プロジェクト API キーには対応する読み取りまたは書き込みスコープが必要であり、書き込みスコープはテストケースの権限を上書きしません。

構造化されたテストデータセット

テストデータセットをテストデータマトリックスから開きます。テストケースにデータを適用するには、まずそのテストバリアントとテストデータを選択します。を選択します。管理はWebクライアントで行い、適用されたテキストはWindowsでも使用可能です。

  1. 新規データセットのダイアログを開いて名前を付け、その所有テスト単位を割り当ててください。その単位の権限によって、誰がデータを閲覧または編集できるかが決まります。
  2. 1行につき1つのカラムキーを定義してください。キーは文字で始まり、ASCIIの文字、数字およびアンダースコアのみを含みます。例えばAccountまたはExpectedMessage。
  3. 行を追加し、値を入力してデータセットを保存します。を選択します。制限は30列、1,000行、セルごとに32,767文字、合計データ内容は2MiBです。空のセルも有効な値です。

グリッドはコンパクトな値を表示します。セルをクリックして編集してください;入力するは改行を挿入し、タブは次に進みます。データセットを保存します。はアクティブなセルエディターをコミットします。ソートやページングは行IDや保存順序を変更しません。行削除アクションは右側に表示され、確認を求めます。0007のような値はテキストのままです。

データセットは通常のプロジェクトコンテンツであり、秘密のストアではありません。実運用のパスワードや個人データの代わりに合成値を使用してください。

XLSX交換

XLSXにエクスポートは1つのワークシートを持つワークブックを作成します。最初の列_RowIdには安定した行IDが含まれ、残りの列には列キーが含まれます。既存行のIDは保持し、新規行は空欄のままにしてください。ヘッダーは空でなく一意でなければなりません。

XLSXインポートのプレビューは行をエディターに読み込みます。保存された内容を置き換えるのはデータセットを保存します。のみです。省略された既存行は削除されますが、バインドされた行は削除できません。プレビュー後にデータセットが変更されている場合、保存は拒否されます。

数式、マクロ、および外部リンクは拒否されます。代わりに値を貼り付けてください。エクスポートはリテラルテキストを書き込み、先頭のゼロ、複数行の値、および=で始まる値を保持します。アップロードは4 MiBに制限されており、展開後のサイズおよびデータ内容の制限もチェックされます。

テストテキストに値を適用します。

テストテキスト内で{{data:Account}}を使用してAccount列を参照してください。ターゲットバリアントにはデータセットと行を選択し、置換のプレビューを選択します。未知の列やHTMLアドレスなどの安全でないトークン位置は適用を妨げます。値はHTMLとして実行されたり、トークンとして再帰的に解釈されたりすることはありません。

これらの値を適用します。はレビュー済みのテキストと値をバリアントに保存し、後で明示的に再適用できるよう元のテンプレートを保持します。非プライマリバリアントは元のテキストを継承していても独自のデータを使用できます。再利用可能なステップセクションおよびクイックテストセルも含まれます。

後からのデータ変更はテストテキストを自動的に更新しません。新しいテスト計画では、最近明示的に適用されたバリアントコンテンツが使用されます。既存のテスト実行は保存された内容を保持します。バインディングを解除し、テキストは保持するは適用されたテキストを保持しつつ関連付けを解除します。

テストケースのバージョニングにはバインディングと適用された値が含まれます。以前の改訂を復元すると、その履歴内容が使用され、現在のデータは使用されません。ライブラリバリアントにまだバインドされているデータセットまたは行は削除できません。

Windowsから開きます。

Windowsのテストケースライブラリで、保存済みのテストケースを右クリックし、Webでテストデータマトリックスを開くを選択してください。ブラウザはそのテストケースを事前選択します。クイックテストもサポートされています。

認証済みのWindowsセッションにより自動的にサインインされます。ハンドオフが失敗した場合のみサインインページが表示され、遷移先は保持されます。