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

概要

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ファイルダウンロードアサーション機能では、以下の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. ファイル名は確認対象に含まれません。
   3. 毎回、ダウンロードするファイルが変わる場合は、チェックを外してください。

5. アサーション対象とするファイルを指定する。

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

制限事項

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

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

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

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

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

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

どこにも残りません。

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

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

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

どのファイルが検証対象になるか

ファイルダウンロードアサーションで検証するファイルは「最新のファイル」ではなく、「ダウンロードされた順番」によって決まります。

たとえば、以下のように2つのファイルがダウンロードされ、その後に2つのアサーションステップが追加されたシナリオを考えてみます。

• ステップ10: ファイルAをダウンロード
• ステップ11: ファイルBをダウンロード
• ステップ12: アサーションステップ1
• ステップ13: アサーションステップ2

この場合、ステップ12のアサーションステップ1では1番目にダウンロードされたファイルAを、ステップ13のアサーションステップ2では2番目にダウンロードされたファイルBを、それぞれ検証対象とします。

アサーションステップの配置位置ではなく、シナリオ内でのアサーションステップの追加順序が検証対象のファイルを決定する点にご注意ください。
また、複数のファイルがダウンロードされるシナリオでは、次のような工夫で意図どおりに動作しやすくなります。

• アサーションは、対応するファイルのダウンロード操作直後に配置する
• 重複したダウンロード操作を削除する