探索的テスト¶
セッションはWebクライアントで管理されます。Windowsはデータを保持しますが、専用のセッションインターフェースはまだ提供していません。
探索的セッションは焦点を絞った調査を記録します:何を学びたいか、何を観察したか、どの質問が残っているか。事前定義されたテストケースは必要ありません。各セッションはテスト計画に属し、空の場合もあります。通常のテスト実行を作成せず、合格率やリリース準備状況を変更しません。
一時的な調査を実行します。¶
「ショッピングカートはリフレッシュ後も内容を保持するか?」のような質問には短いセッションで十分です。既存のテスト計画を選択し、質問をチャーターとして入力してセッションを開始してください。初期状態を注意として記録します。カートが空になる場合は発見を追加し、そのエントリーにスクリーンショットを添付してください。簡潔な結論で終了します。ノート、画像および発見はセッションログに一緒に残ります。
チェックが既に知られており、テスターが同じリストを繰り返す場合はクイックテストケースを使用してください。調査中に繰り返す価値のあるチェックを発見した場合は、その所見に対して後でテストケース変換を使用してください。
セッションを準備する¶
- プロジェクト作業エリアで探索的テストを開きます。
- セッションを計画するを選択してください。ダイアログで書き込み権限のあるテストプランを選択します。
- 意味のあるタイトル、チャーター、および1分から480分のタイムボックスを入力してください。
- セッションを作成を選択してください。セッションは独自の詳細ページで開きます。開始前にタイトル、チャーターおよびタイムボックスを修正できます。
キャンセルまたは閉じるアイコンはダイアログを閉じます。Escapeキーやダイアログ外のクリックでは閉じません。フィールドを変更した場合、アプリケーションは確認を求めます。確認でのキャンセルはダイアログに戻ります。ページを離れるかリロードするまで、入力内容は再度開いた際に保持されます。検証エラー後は、エラーメッセージと入力内容を表示してダイアログが再度開きます。
有用なチャーターは目標と境界を示します。例えば:「接続が中断された場合のチェックアウトを探索します。重複注文や理解可能なフィードバックを探します。」これは必須のテスト手順の順序ではありません。
開始、一時停止、再開¶
開始 はセッションを開始します。一時停止 はアクティブなタイミングを停止し、再開 は別のアクティブな間隔を開始します。サーバーが期間を計算します。タイムボックスはガイダンスであり、セッションを自動的に終了しません。
重要: ブラウザを閉じても実行中のセッションは一時停止しません。長時間の中断前に明示的に一時停止してください。期間はセッション計画を支援し、請求記録ではありません。
観察と証拠を記録する¶
実行中または一時停止中のセッションで、エントリを追加します。
| タイプ | 目的 |
|---|---|
| 注意 | 実施されたアクション、観察、または中間要約 |
| 質問 | 未解決の仮定または追跡すべき質問 |
| 発見 | さらなる調査に値する観察事項 |
発見の場合、初期条件、操作および観察された動作を記述してください。発見は観察であり、確定されたソフトウェア欠陥ではありません。アプリケーションは外部の問題を自動的に作成しません。
エントリーにはスクリーンショットやファイルを含めることができます。プロジェクトのファイルタイプおよびサイズ制限は引き続き適用され、表示されるセッション制限も適用されます。ファイルはエントリーと共に保存され、許可された読者のみが利用可能です。実行可能またはアクティブなコンテンツはページに埋め込まれません。HTMLのようなジャーナルコンテンツはプレーンテキストのままです。
保存されたエントリは上書きできません。順序、作成者および時間が追跡可能なままにするため、前のエントリを修正するには別のメモを追加してください。別のウィンドウがセッションを変更している場合は、新しい状態を上書きせずに再読み込みしてください。
セッションを完了する¶
完了を選択し、概要を入力してください:調査した内容、支持される所見、未解決の事項は何か?明示的な確認後、完了したセッションは読み取り専用になります。調査を続けるには新しいセッションを作成してください。
完了は合格テスト結果やリリース承認を意味しません。その後、繰り返し可能なチェックのために通常のテストケースを自分で作成できます。これは自動的には行われません。
発見事項をテストケースに変換する¶
ファインディングは、停止または完了したセッションからのものを含め、テストライブラリ内の通常のテストケースになることがあります。ノートや質問は変換できません。
- ファインディングを開き、テストケース変換を選択してください。
- テストケースを作成できるテスト単位を選択します。
- タイトルと提案された説明を確認します。前提条件、テストステップ、期待結果はご自身で記述してください。観察された問題は自動的に期待結果として扱われません。
- 変換を確認するを選択してください。プレビューを確認し、テストケースを作成で確定してください。
既存の証拠は独立した添付ファイルにコピーされます。新しいテストケースとその最初のバージョンには承認済みのテキストとファイルが含まれます。元のセッション、発見、証拠は変更されません。その後、Web または Windows で通常のテストケースを編集できます。Web ビューでは、読み取りアクセスがある場合に起源と発見へのリンクが表示されます。そうでない場合は一般的な起源通知のみが表示されます。
各発見は最大1つのテストケースを作成します。操作を繰り返すと、まだ読める場合は既存のケースにリンクされます。後の編集や削除は自動的に置換を作成しません。変換に失敗した場合は同じリクエストで再試行でき、部分的なテストケースを残してはなりません。
ソース計画の読み取りアクセスと、宛先テスト単位でケースを作成する権限が必要です。セッションの所有は不要です。変換は完了したセッションを編集しません。後でソースを削除しても独立したターゲットケースやコピーされた添付ファイルは削除されません。
権限と保持¶
テスト計画の読み取り権限はセッション、ジャーナル、およびファイルをカバーします。現在の計画に書き込みアクセス権を持つ作成者または管理者が変更を行うことができます。プロジェクトマネージャーであるだけでは、他者のセッションを変更する権限はありません。無効化されたユーザーや計画権限が取り消されたユーザーも、以前に知られていたリンク経由でのアクセス権を失います。
親テスト計画を削除すると、その探索セッションおよび証拠も削除されます。プロジェクトのバックアップおよびVistaDBとSQL Server間の変換はセッションデータおよびファイルを保持します。意図的な削除前にプロジェクトをバックアップしてください。
MCPおよびREST¶
APIはWebインターフェースと同じドメインルールを使用します。読み取り操作はセッション、ジャーナル、および認可された証拠を提供します。書き込みは既存のプレビューと明示的な準備/コミット確認を使用します。作成者および著者は認証されたユーザーコンテキストから取得され、API呼び出しは他のテスターをなりすますことはできません。
読み取りツールは ztm_exploratory_sessions_list(オプションで testPlanId、limit は 1 から 100)、ztm_exploratory_session_read(sessionId)および ztm_exploratory_evidence_read(sessionId、entryId)です。書き込みは ztm_project_action_prepare と ztm_project_action_commit を project.exploratory-testing.create、.edit-planned、.transition または .add-entry と共に使用します。すべてのコマンドには requestId が必要で、更新にはさらに expectedRevision が必要です。遷移は Start、Pause、Resume、Complete で、エントリー種別は Note、Question、Finding です。オプションの evidence には fileName と contentBase64 が含まれ、MCP リクエスト制限のため API 書き込みは 512 KiB に制限されます。Web アップロードは最大 8 MiB を許可し、両方に厳しいプロジェクト制限が適用されます。既存の証拠は 8 MiB の保存制限まで完全に読み取れます。REST は /api/v1/operations/{operationId} でツールを公開します。変更は一致するセッションリビジョンを指定する必要があり、同一の繰り返しリクエストは二重に実行されません。
制限はファイルあたり8 MiB、セッションあたりの証拠は64 MiB、ジャーナルエントリーは1000件です。エントリー制限に達してもセッションの完了は可能です。
セッション準備のための例引数(テスト計画IDと一意のリクエストIDを置き換えてください):
{
"capabilityId": "project.exploratory-testing.create",
"idempotencyKey": "exploratory-create-unique-request",
"arguments": {
"requestId": "b0a6608b-f4bd-4c6a-8b8b-efec40adee83",
"testPlanId": 42,
"title": "Investigate checkout",
"charter": "Explore interrupted connections and retained input.",
"timeboxMinutes": 30
}
}
これらの引数をztm_project_action_prepareに送信します。プレビューを確認し、そのpreviewTokenを同じcapabilityIdでztm_project_action_commitに渡します。これには一致する書き込みスコープと現在の計画権限を持つプロジェクトAPIキーが必要です。準備のみではセッションは作成されません。
APIを通じた発見の変換¶
ztm_exploratory_finding_conversion_contextは読み取り可能なファインディング、その変換状態および許可された宛先テスト単位のページを返します。sessionIdおよびentryIdが必要で、query、skip、takeおよびselectedTargetTestUnitIdは任意です。後者は現在の結果ページに関係なく、以前に選択されたテスト単位の認可ラベルを返します。ztm_exploratory_finding_conversion_originはtestCaseIdを使用して読み取り可能なケースの起源を読み取ります。ソース識別子とセッションタイトルはソース読み取り権限が有効な間のみ返されます。
書き込み機能project.exploratory-testing.convert-findingはprepareとcommitも使用します。引数はsessionId、entryId、requestId、targetTestUnitId、title、description、prerequisites、stepsおよびexpectedResultsです。タイトルは500文字以内、4つのテキストフィールドはそれぞれ8000文字以内に制限されています。この操作はセッションリビジョンを受け付けません:プレビューは特定の発見と宛先コンテキストに結びつきます。レビュー済みドラフトの変更には新しいプレビューが必要です。
APIは既存の保存された証拠自体をコピーします。そのため、8 MiBのストレージ制限、またはより厳しいプロジェクト制限が適用されます。新しいAPIアップロードの512 KiB制限はここでは適用されません。同一の繰り返しリクエストは既に作成されたケースを変更しません。読み取り不能または削除された宛先は、隠されたIDやタイトルなしで報告されます。デモ保護、書き込み範囲、および現在のソース/宛先の権限は引き続き適用されます。
Windowsから開きます。¶
Windowsプロジェクトツリーで、テスト計画を右クリックし、Web上で探索的テストを開きます。を選択してください。そのテスト計画を使用してWebページが開きます。ページを開いてもセッションは作成されません。
認証済みのWindowsセッションにより自動的にサインインされます。ハンドオフが失敗した場合のみサインインページが表示され、遷移先は保持されます。