ファイルダウンロードアサーション
  • 24 Dec 2024
  • 1 分で読めます
  • 投稿者
  • ダーク
    ライト

ファイルダウンロードアサーション

  • ダーク
    ライト

記事の要約

注意点
本機能はご契約プランによってご提供状況が異なります。 


概要

ファイルダウンロードアサーション機能では、以下の4点が確認可能です。

  1. ファイルがダウンロードされていることを確認する
  2. ファイル名を確認する
  3. ファイルサイズが期待するサイズであることを確認する
  4. ファイルの完全一致を確認する
注意点

現時点では、ファイルの内容についてアサーションすることはできません。
また、本機能は、モバイル実機環境以外で動作しています。モバイル実機環境で実行した場合、ダウンロードアサーションのステップはスキップされます。

それでは、ダウンロードアサーションステップの追加をしてみましょう!

ファイルダウンロードアサーション機能を利用するための準備

  1. 本機能は、「Autify Recorder (New)」バージョン1.0.19以上でご利用いただけます。インストールされている「Autify Recorder (New)」のバージョンをご確認ください。
  2. ファイルダウンロードアサーション機能を利用するためには、レコーディング前に設定が必要です。シナリオ一覧から任意のシナリオを開いていただきブラウザの上部にある「Autify Recorder (New)」の拡張機能アイコンをクリックし、設定を有効にしてください (チェックをつけた状態にしてください)。チェックをつけると許可を求めるダイアログが表示されますので、許可 (Allow) を選択します。一度許可する必要はありますが、その後変更しない限りずっと使えます。

document_file_download_assertion_setting_1_en.png

document_file_download_assertion_setting_2_en.png

これで事前設定は完了です!さっそくレコーディングをしてみましょう。

シナリオレコーディング中に追加する

ファイルをダウンロードする操作をレコーディングします。

レコーディング中、ファイルがダウンロードしたタイミングで、Autify Recorderがダウンロードファイルを検出し、以下のウィンドウが表示されます。
file_download_assertion_recording_0_jp.png

「ファイルを選択」ボタンをクリックすると、Finderアプリなどのフォルダーアプリが起動されるので、対象のファイルを選択し、「開く」ボタンを押します。

file_download_assertion_recording_1_en.png

対象のファイル情報が表示されるので、「追加」ボタンを押してステップを追加します。

file_download_assertion_recording_2_jp.png

シナリオの録画を完了し、保存してください。
これで以下 (下図ステップ10) のようにファイルダウンロードアサーションステップが追加されました。
filedownloadassertion_scenario_edit_jp.png

各アサーションの設定方法や変更方法は「各アサーションを設定する」項目を参照ください。

シナリオ詳細画面から、ファイルダウンロードアサーションステップを追加する (編集する)

  1. ステップを挿入 > ダウンロードアサーション の順にクリックし、ファイルダウンロードアサーションステップを追加します。
  2. 各アサーションの設定方法は「各アサーションを設定する 」項目を参照ください。

file_download_assertion_edit_jp_in_scenaio.png

各アサーションを設定する

ファイルダウンロードアサーション機能では、以下の4点すべてもしくはいずれか1つ以上をアサーションすることが可能です。

  1. ファイルがダウンロードされていることを確認する

    1. ファイルがダウンロードできたかどうかをアサーションします。
  2. ファイル名を確認する

    1. ワイルドカード「*」を使用して、0文字以上の文字列に一致させることも可能です。

    例:「hatty*.pdf」と指定した場合、「hatty_20241211.pdf」というファイル名であっても成功と判定されます。

    また、「*.pdf」と指定した場合は、pdfファイル形式であれば成功と判定されます。

    exeファイルおよびmsiファイル以外のファイルを登録できます。

    ファイル名を空白やスペースなどにすることはできません。

  3. ファイルサイズが期待するサイズであることを確認する

    1. ダウンロードしたファイルサイズの範囲を指定することが可能です。
    2. ファイルサイズの完全一致を指定したい場合は、「ファイルサイズの一致」にチェックをつけ、サイズを指定します。
    3. ダウンロードファイルのサイズは、0.000kB ~ 102400.000Kbyteまで (小数点第3位まで) 検証可能です。
  4. ファイルの完全一致を確認する

    1. データの整合性確認やファイルの一意性を判定するための関数 (MD5 hash値) を使って、ダウンロードしたファイルが改ざんされていないか、またシナリオ作成時に指定したファイルを一致するかどうかを判定します。
    2. 毎回、ダウンロードするファイルが変わる場合は、チェックを外してください。
  5. アサーション対象とするファイルを指定する。

    1. ファイルアップロードボタンからアサーション対象とするファイルを指定したり変更したりすることが可能です。ファイルを変更した場合、アップロードしたファイルの名称およびファイルサイズが上書きされます。

filedownloadassertion_scenario_edit_jp.png

制限事項

  • ファイルサイズの上限は1ファイルあたり100MBまでです。
  • ファイルサイズの上限は1シナリオあたり合計で1GBまでです。

ファイルダウンロードアサーションステップにおけるテスト結果の見方

ダウンロードされたファイルをテスト結果詳細画面にて見てみましょう!

テスト結果では、テスト実行時にダウンロードしたファイルを確認することができます (下図青色の文字部分)。
また、各アサーションに対応する形でアサーション結果が右側にそれぞれテスト実行時の結果が表示されます。
もし、ファイルが30秒以上経過してもダウンロードされなかった場合、「ファイルがダウンロードされていること」以外のアサーションは実施されません。

Screenshot 2024-12-11 at 19.02.42.png

ダウンロードしたファイルはどこかに残るか

ファイルダウンロード機能を有効にしていないお客様

どこにも残りません。

テスト実行の最中には一時的にダウンロードしたファイルはテスト環境に保存されますが、テスト環境はテストのたびに作成しテストが完了したら削除しておりますため、ファイルもそのときに削除されます。

ファイルダウンロード機能を有効にしているお客様

ダウンロードされたファイルは、ファイルはAmazon S3上に保管されます。ダウンロードされたファイルの保存期間は30日で、ご契約いただいているテスト結果保存期間に関わらず30日を過ぎるとテスト結果上でダウンロードされたファイルを見ることができなくなります。


この記事は役に立ちましたか?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.