再利用可能なテストステップ¶
再利用可能なステップブロックは、複数の通常のテストケースで使用するために共有手順を一度だけ記述します。ブロックにはフォーマットされたテストステップとオプションの期待される結果が含まれます。前提条件はテストケースの一部として残ります。各ブロックに対して追加の属性スキーマ、パラメーター、または別個のテスト実行結果はありません。
クイックテストケースおよびそのバリアントはこの初期スコープから除外されています。ブロックは別のテストケースを実行せず、テストケース依存関係を置き換えません。
ブラウザでブロックを保守する¶
プロジェクトで再利用可能なテストステップを開きます。各ブロックはテスト単位に属します。読み取りにはその単位への読み取りアクセスが必要で、維持には対応する完全アクセスが必要です。リストにはアクセス許可のあるコンテンツのみが含まれます。
- テストケースライブラリから再利用可能なテストステップを開き、ブロックを作成 を選択します。テスト単位を選択し、「顧客ポータルへのサインイン」などの意味のあるタイトルを入力します。
- フォーマットされたエディターに手順を入力し、必要に応じて期待される結果を追加してください。変更ノートは新しい状態を説明します。
- プレビューで内容を確認して保存します。ブロックのバージョン履歴に新しいバージョンが表示されます。
アーカイブされたブロックは既存の利用に対して引き続き利用可能です。新しいブロックバージョンは、それを使用するテストケースを自動的に変更しません。
通常のテストケースでブロックを使用します。¶
テストライブラリで通常のテストケースを開き、該当する場合はバリアントを選択し、再利用可能なステップ構成エディターを開きます。テストケースの編集アクセス権と、使用するブロックの読み取りアクセス権が必要です。
構成は順序付けられたローカルセクションとブロックセクションを含みます。ローカルセクションにはステップと任意の期待結果も含まれます。ブロックセクションは明示的に選択された固定バージョンを使用します。保存前に内容、順序、完全な出力を確認してください。管理された構成に初めて切り替える際、既存の有効なステップと期待結果がローカルセクションとして含まれます。
セクションで新しいブロックバージョンが提供されている場合は、比較を開いて前の内容と新しい内容を確認してください。明示的に採用して変更を保存した場合のみ、その内容が使用されます。他の使用箇所は以前の状態を保持します。
個別のブロックセクションをローカルテキストに変換すると、管理された構成内の内容が保持されます。変更を保存してください。代わりに全体の構成を変換すると、その管理状態が解除され、手順と期待結果がテストケースの自由テキストとして保存されます。この操作は最後に保存された状態を使用しますので、必要な編集は先に保存してください。確認前にプレビューをチェックしてください。どちらの操作も他のテストケースやブロックライブラリには影響しません。
バリアントはプライマリバリアントから内容を継承できます。別の構成を作成する際には、どの有効な内容が含まれているかを確認してください。別管理構成で明示的に保存された空の期待結果は、プライマリテキストを継承せず空のまま保持されます。
画像および添付ファイル¶
インライン画像はブロック改訂のコンテンツに属します。保存時に別の画像コピーが作成されるため、元の画像が変更または削除されても古い改訂や採用されたコンテンツは読み取り可能なままです。外部リンクされた画像はプロジェクト外にあり、永続的にキャプチャされたコンテンツではありません。
この最初のバージョンでは、ブロックには独自のファイル添付はありません。既存の添付ファイルはテストケースまたはバリアントに残ります。ステップブロックの改訂はそれらの添付ファイルのバージョン管理を行いません。
テストを計画し実行する¶
ステップと期待結果は、実行中、報告時、エクスポート時にも完全なテキストとして読みやすいままです。ブロックを使用しても追加の結果ステータスは作成されず、テスト統計は変更されません。
新しいライブラリ状態は意図的に計画テンプレートに同期されます。既存のテスト実行は受け取った内容と使用されたブロックバージョンを保持します。新しい内容は新規実行または該当する再テストワークフローでテストしてください。
Windowsと自動化¶
ブロックおよびその構成はブラウザーで管理されます。Windowsは完全な内容を表示し、実行時に使用します。管理されたステップおよび期待結果は読み取り専用です。ウェブリンクは対応するエディターまたは計画された内容スナップショットの読み取り専用ビューを開きます。他の許可されたテストケースフィールドは編集可能なままです。自動サインイン引き継ぎはWebで開きます。と同じメカニズムを使用します。
MCP統合はインターフェースと同じプロジェクトおよびオブジェクト権限を使用します。ブロックの保守、構成および変換のための読み取りツールおよび準備された書き込みアクションもMCPを通じて利用可能であり、追加の権限は付与しません。ツール契約については安全な操作およびMCPを参照してください。
プロジェクトのコピーと転送¶
別のプロジェクトから個別のコンテンツをインポートする場合、ブロックの使用は独立したローカルセクションになります。これらは元のプロジェクトのブロックライブラリとはリンクされず、後の元ソースの変更は影響しません。完全なプロジェクト転送ではブロック、バージョン、使用がまとめて保持されます。
既存の テキストモジュール は挿入補助として残ります:挿入されたテキストは継続するバージョンリンクなしのコピーです。既存テキストは自動的にブロックにマッチまたは移行されません。
関連トピック:ブラウザ内のテストケース、テストバリアント および テストの計画。
同じ操作はREST APIを通じて利用可能です:POST /api/v1/operations/ztm_project_reusable_test_stepsおよび{"operation":"list"}による読み取り、ztm_project_action_prepareおよびztm_project_action_commitによる書き込み。機能はproject.reusable-test-step.save、project.reusable-test-step.composition.saveおよびproject.reusable-test-step.composition.detachです。プロジェクトヘッダーとAPIキーが必要で、同じ権限およびプレビュー確認が適用されます。
Webエントリーは、最初の再利用可能ステップが追加される前でも、保存された通常ライブラリのテストケースのエディターで利用可能です。既存のテキストはローカルセクションとして保持されます。クイックテストは除外されます。計画されたコンテンツスナップショットは対応する読み取り専用ビューを開き続けます。
テストケースダイアログは、再利用可能なステップおよびバージョンアクションをWebで開きます。でグループ化します。編集可能なケースでは、再利用可能なステップアクションが現在の入力を最初に保存し、不正な入力はナビゲーションを妨げます。プロジェクトのこれらの追加エントリを非表示にします。できます。
変更影響を確認する¶
変更影響ビューには、テンプレートやオープンランにおける継承された使用と保存されたコピーも含まれています。ピン留めされたリビジョンやコンテンツ領域を区別し、それらを自動的に更新しません。