mablトレーナーでは、ファイルアップロードのステップとアサーションを組み合わせて、Webアプリケーションがファイルアップロードの操作を期待どおりに処理しているかどうかを確認できます。アップロードされたファイルは、今後のテスト編集やクラウド実行のためにmablワークスペースに追加され、アプリのテスト環境設定 > ファイルアップロードからアクセスできます。
続きを読んで、ウェブアプリへのファイルのアップロードについて詳しく学びましょう。
データの安全を守る
ワークスペース内の他のデータと同様に、ファイルアップロードは、キー強度とキー管理に関する業界標準のベストプラクティスを用いて暗号化されます。ファイルアップロードは、削除しない限り、mablクラウド内に保持されます。
ファイルアップロードステップのトレーニング
ファイルアップロードのステップを使用するには、アプリケーションのページのHTMLにファイルタイプの入力要素が必要です。これはファイル選択に使用される標準的なHTML要素であり、mablはこの要素を通じてファイル入力を設定します。アプリケーションにこの要素がない場合、ファイルアップロードのステップは機能しません。
開始するには、mablトレーナーを開き、アプリケーション内のファイルアップロードステップが必要なページに移動します。録画ボタンがオンになっていることを確認してください。
- アプリケーションの「ファイルのアップロード」または「ファイルを選択」ボタンをクリックしてください。
- ファイル選択ダイアログで、コンピューターからアップロードするファイルを選択してください。
- Open をクリックします。Trainer が自動的にファイル入力を設定するステップを記録します: 「Set file input to {name-of-file}」。
- アプリケーションでファイルのアップロードを送信するアクションを記録します。たとえば、「送信」ボタンをクリックします。
- ファイルのアップロードが成功したことを確認するアサーションを作成します。このアサーションは、ファイルのアップロードが成功した後にアプリケーション内で何が起こるかによって異なります。
ファイル要件
デフォルトでは、ファイルのアップロードは100 MBまでサポートされています。
ファイル名の最大文字数は255文字（ASCII文字）です。ただし、ファイル名に非ASCII文字が含まれる場合、文字エンコーディングとファイル名に使用できる255バイトの制限により、最大文字数が84文字程度まで短くなる場合があります。
Trainer が「Set file input」ステップを記録しない場合
ファイルを選択したときに、Trainerが「set file input」ステップではなく「click」ステップを記録する場合、アプリケーションに非表示のファイル入力要素が含まれている可能性があります。一部のウェブアプリケーションでは、ファイルタイプの入力要素を、表示されているボタンやドロップゾーンの背後に隠しています。Trainerは表示されている要素へのクリックを記録しますが、そのインタラクションを非表示のファイル入力と関連付けることはありません。
この問題を回避するには、カスタムファイルアップロードステップの作成をお試しください。
- Trainerで、 要素の検索ステップを追加します：ステップを追加 > 要素を検索。
- XPath に切り替えて、
//input[@type='file']を入力してください。 - アクションとしてファイル入力を設定を選択します。
- アップロードするファイルをドロップダウンから選択してください。
ページに複数のファイル入力要素がある場合は、正しい要素をターゲットにするために、より具体的なXPath式が必要になることがあります。たとえば、//input[@type='file' and @name='document']のようになります。
ワークスペースへのファイルの追加
カスタムファイルアップロードステップでは、すでにmablワークスペースにアップロードされているファイルのみを選択できます。ローカルマシンから新しいファイルをアップロードするには、ファイルアップロードステップを記録する必要があります。
アプリケーションでファイルのアップロードを直接記録できない場合は、次の回避策をお試しください。
- mablトレーナーを開き、
https://sandbox.mabl.com/file-uploadに移動します。 - サンドボックスのアップロードフォームを使用して、ファイルアップロードのステップを記録します。これにより、ファイルがワークスペースに追加されます。
- テストからサンドボックスのファイルアップロードステップを削除してください。
ファイルは テスト環境設定 > ファイルアップロード で利用可能になり、ワークスペース内の任意の「Set file input」ステップで選択できます。
Trainer でのファイルアップロードステップの再生
ファイルアップロードのステップを記録したら、ファイル選択ダイアログを開くクリックステップを削除してください。削除しない場合、Trainer のリプレイ中に毎回手動でファイル選択ダイアログを閉じる必要があります。
mablトレーナーの再生中またはローカル/クラウド実行中、ファイル選択ダイアログはページのHTMLではなくオペレーティングシステムの一部であるため、mablはファイル選択ダイアログを操作できません。mablトレーナーが操作できるものとできないものについては、こちらをご覧ください。
ファイル入力の更新
ファイル入力を更新するには、記録されたファイルアップロードステップの横にある鉛筆アイコンをクリックしてください。ドロップダウンから新しいファイル入力を選択できます。
まだmablアプリケーションにアップロードされていない新しいファイルをアップロードするには、既存のファイルアップロードステップを削除し、新しいファイル入力で新しいアップロードステップを記録してください。
シナリオごとに異なるファイルをアップロード
状況に応じて異なるファイルをアップロードする必要がある場合は、条件分岐を使用してシナリオを評価し、適切なファイルへの入力を設定してください。次のスクリーンショットは、データテーブルのシナリオに応じて異なるファイルをアップロードするテストステップを示しています。
データテーブルのシナリオに応じて異なるファイルをアップロードする
制限事項
mablトレーナーでのファイルアップロードには、以下の制限事項があります。
- ドラッグ＆ドロップによるファイル選択は非対応
- 1つのファイルアップロードステップでの複数ファイルの選択はサポートされていません。