ファイルアップロードとは、ファイルアップロードのシナリオを検証する際に使用するために、mablワークスペースに保存されたファイルのことです。保存したファイルは、ブラウザテスト、モバイルテスト、APIテストのいずれでもアップロードに使用できます。ファイルアップロードページ(テスト環境設定 > ファイルアップロード)で、これらのファイルを管理します。このページでは、テストを作成する前にワークスペースにファイルを登録したり、テストが実際にアップロードした内容を確認するためにファイルをダウンロードしたり、不要になったファイルを削除したりできます。この記事では、次の内容について説明します。
データの安全性の確保
ワークスペース内の他のデータと同様に、ファイルアップロードは、鍵の強度と鍵管理に関する業界標準のベストプラクティスを用いて暗号化されます。ファイルアップロードは、削除するまでmablクラウドに保持されます。
ファイルアップロードが使用される場所
ファイルアップロードは、次の種類のテストで使用されます。
- ブラウザテスト: ファイルアップロードステップのソースとして Workspace upload を選択します。
- モバイルテスト: Push file ステップで Select files を使用します。
- APIテスト: formdataおよびbinaryリクエストボディで使用します。
- テスト生成: mablエージェントがファイルをアップロードするテストを生成する際に、途中で止まってファイルを求めることなく、すでにワークスペースにあるファイルを使用できます。
テストのトレーニング中にトレーナーやAPIテストエディターからアップロードしたファイルもこのページに表示されるため、ファイルアップロードページには、テストで使用できるファイルが常にすべて一覧表示されます。
ファイルアップロードは、ファイル変数とは異なります。ファイル変数はデータ駆動型のデータとして単一のテストにアップロードされ、そのテスト内にとどまります。ファイルアップロードはワークスペースに属し、どのテストからでも使用できます。
ファイルをアップロードする
- テスト環境設定 > ファイルアップロード に移動します。
- コンピューターからファイルをページにドラッグするか、Upload file をクリックしてファイルを選択します。一度に最大50個のファイルをアップロードできます。
- ページ上部の進行状況インジケーターを確認します。各ファイルの状態が一覧表示されるため、サイズの大きいファイルや時間のかかるアップロードの際に便利です。1つのファイルが失敗しても他のファイルはアップロードされるため、そのファイルを修正して個別に再試行できます。
空のファイルとフォルダーは受け付けられません。ファイルがワークスペースに登録されるとテーブルに表示され、チームの誰でもテスト内でそのファイルを選択できます。
ファイルをダウンロードする
ファイルの行にあるダウンロードアイコンをクリックすると、コンピューターにコピーを保存できます。ファイルのダウンロードは、次のような場合に役立ちます。
- テストを作成する前に、ファイルの内容がアプリケーションの期待どおりであることを確認する
- テストで使用したのとまったく同じファイルを使って、失敗したファイルアップロードステップを手動で再現する
- 自分のテストで再利用する前に、チームメンバーがアップロードした内容を確認する
ファイルを削除する
テスト環境設定 > ファイルアップロード のファイルアップロードテーブルには、各ファイルを使用しているテストとフローの数が表示されます。数値にカーソルを合わせると、どのテストやフローかを確認できます。ファイルが使用中の間は削除アイコンが無効になるため、テストが依存しているファイルを誤って削除することはありません。先にそのファイルを参照しているステップを更新または削除してから、削除アイコンをクリックして確認します。
mabl CLIまたはMCPからファイルアップロードを管理する
ファイルの準備をスクリプト化したい場合(たとえば、テスト生成を開始する前にCIジョブからワークスペースにファイルを登録する場合)は、mabl CLI の mabl files コマンドを使用して、1つ以上のファイルをワークスペースにアップロードしたり、ワークスペース内のファイルを一覧表示したり、ファイルをダウンロードしたり、ファイルを削除したりできます。ファイルアップロードページと同様に、mabl CLIは、テストやフローがまだ参照しているファイルの削除を、明示的にチェックを上書きしない限り拒否します。
mabl MCP には、ワークスペース内のファイルを一覧表示するツールが含まれています。これにより、AIクライアントはテストの計画や生成を行う前に、どのファイルがすでに利用可能かを確認できます。ファイルのアップロード、ダウンロード、削除を行うには、AIクライアントにmabl CLIコマンドへのアクセスを許可する必要があります。
制限事項
| 制限 | 値 |
|---|---|
| 最大ファイルサイズ | 1ファイルあたり300 MB |
| ファイルアップロードページから一度にアップロードできるファイル数 | 50 |
| ファイル名の長さ | ASCII文字で255文字。ファイル名にASCII文字以外の文字が含まれる場合は、文字エンコード方式とファイル名に使用可能な255バイトに基づき、上限は84文字までになることがあります。 |