多くのアプリケーションでは、PDF のテストはエンドツーエンドのユーザージャーニーを検証するうえで重要なステップです。mabl では、スクリーンショットの取得や自然言語プロンプトによるバリデーションを含め、PDF ファイルとその内容の検証を自動化できます。
この記事では、mablトレーナーでPDFをテストする方法を説明します。
PDF メタデータをアサーションする
PDF をダウンロードすると、Trainer は自動的に ダウンロードのアサーション を追加し、PDF ファイル名に対してアサートします。
ファイルの種類やファイルサイズなどの追加メタデータでアサートするには、アサーションを編集をクリックしてください。別の方法として、ダウンロードのアサーションのステップで編集用の鉛筆アイコンをクリックしてください。
動的なファイル名
アプリケーションがPDFをダウンロードするたびに動的に生成されたファイル名を作成する場合は、動的に生成されるファイル名を扱う際のアドバイスをご覧ください。
PDF コンテンツを検証する
現在、Trainer で PDF コンテンツを検証する方法は 2 つあります。
生成AIアサーションを追加する
早期アクセス
ファイルのダウンロード向けの生成AIアサーションは、現在すべてのmablの契約ユーザーおよびトライアルユーザーを対象に、早期アクセスとしてLabsページから利用できます。ワークスペース > Labs
一般提供前は、予告なく機能を変更する場合があります。
生成AIアサーションでPDFの内容を検証するには、TrainerでダウンロードしたPDFのアサーションのステップを編集します。検証したい内容を自然言語のプロンプトで入力してください。ファイルの内容を確認するには、ファイルを表示をクリックします。アサーションのテストを実行する準備ができたら、テストアサーションをクリックします。
アサーションをテストすると、mabl はアサーションの基準を生成します。これらの基準は、アサーションの説明とともに LLM に送られ、あなたのアサーションを評価するための一貫した基準のセットを提供します。アサーションの説明を反復して更新すると、mabl は説明の最新の状態を反映するようにアサーションの基準を更新します。
PDF のダウンロードに対してアサートする場合、生成AIアサーションには、ダウンロードしたファイルの内容およびそのファイルをダウンロードしたページのスクリーンショットの両方が含まれることがあります。アサーションでウェブページ上の要素を検証する場合は、アサーションのステップが実行されるときに、その要素がビューポート内に表示されていることを確認してください。必要に応じて、必要な情報を取得できるように、ビューポートを設定するステップでブラウザーウィンドウのサイズを変更できます。
実行制限
トレーニング中は生成AIアサーションを無制限に使えるため、必要なだけアサーションを繰り返し改善できます。ただし、実行中は次の制限に注意してください。
- テストごとの上限： 生成AIアサーションは、1テストあたり30件までです。
- パフォーマンステスト: パフォーマンステストのコンテキスト内で実行する場合、生成AIによるアサーションは失敗します。
mabl PDF 閲覧者を開く
mabl のサブスクリプションに高度なシナリオ対応のアドオンが含まれている場合、mabl PDF 閲覧者でも内容を検証できます。PDF をダウンロードするときは、ダウンロードのプロンプトで PDFを開く ボタンをクリックします。
トレーナーは、あなたが mabl のPDF閲覧者に切り替えたことを自動的に検出し、記録されたステップの前にコンテキスト切り替えのステップを追加します。必要に応じて、PDFの内容にアサーションを追加してください。
制限事項
PDF をテストする場合は、次の制限事項に注意してください。
- Trainer は、UI での操作によってダウンロードされた PDF のみ検証できます。API ステップまたは APIテスト 内での HTTP POST リクエストで返される PDF には対応していません。
- フォームへの入力など、PDFの編集には対応していません。
mabl の PDF 閲覧者（PDFを開く オプション）で PDF コンテンツをテストする場合は、次の追加の制約に注意してください。
- Safari（WebKit）ブラウザーで実行するテストには対応していません
- blob URL の PDF を開けません。
これらの制約は、生成AIアサーションを使用するPDF検証には適用されません。