ATF でクライアントエラー包含リストを使用する方法Issue 自動テストフレームワーク (ATF) の使用時によく発生する一般的な問題は、Javascript クライアントエラーです。ATF の新しいリリースには、特定の既知のクライアント側エラーを無視できる機能が含まれており、ATF テストは、そのようなエラーが発生したステップを超えて進むことができます。 この新機能は、ATF クライアントエラー包含リストと呼ばれ、特定のクライアントエラーを包含リストに手動または自動で追加し、ATF テストまたはテストスイートの実行中にこれらのエラーをスキップすることができます。 Factsクライアントエラー包含リストを使用する際に留意すべき非常に重要な注意事項がいくつかあります。 このリストに特定のエラーメッセージを追加すると、ATF システムは、実行対象の ATF テストまたはテストスイートでそのエラーが発生するたびに適切なアクションを実行します。これにより、発生したエラーを超えてテストを続行できます。ただし、同じテストまたはスイートで発生した他のエラーが原因でテストが失敗または停止しないことを保証するものではありません。ほとんどの場合、ATF テストでクライアント側のエラーが検出された場合、エラーを修正してテスト自体を正常に完了するだけでなく、インスタンスの機能の適切な動作を確認することが最善の方法です。ただし、場合によっては、さまざまな原因によりエラーを修正できないことがあります。その場合は、クライアント側のエラーをクライアントエラー包含リストに追加する必要があります。ホワイトリストに登録されたエラーによってテストの実行を再度失敗させる必要がある場合は、そのエラーに対応するクライアントエラー包含リストレコードをインスタンスから削除 (削除) するか、そのレコードの [アクティブ] チェックボックスを非アクティブに設定します。Resolutionこの包含リストに特定のクライアント側エラーを追加するには、2 つの方法があります。自動および手動。 注: クライアントエラーを ATF クライアントエラー包含リストに自動的に追加する方法は、ほとんどの場合使用されますが、場合によっては、そのようなレコードを手動で追加する必要が生じる場合があります。 方法 1: 包含リストにエラーを手動で追加する ATF 包含リストクライアントエラーレコードは、そのエラーに関するさまざまな情報を指定することによって、手動で ATF に追加できます。次の手順では、その方法を詳しく説明します。 インスタンスに対するアドミン、atf_admin、または atf_test_designer 権限を持つアカウントを使用してインスタンスにログインします。インスタンスの次の場所を参照します: Automated Test Framework -> Run> Whitelisted Client Errors。[ホワイトリストに追加されたエラー] テーブルに現在のレコードのリスト (存在する場合) が表示されます。新規ボタンをクリックして、このテーブルに新しいレコードを作成します。このフォームでは、次のフィールドに入力する必要があります。レポートレベル: このフィールドは、この特定のエラーが見つかったテストのテスト結果でこの特定のエラーを報告する方法を設定するプルダウン メニューです。現在、このフィールドで選択できるオプションは次のとおりです。 警告 - ステップおよびテストは成功 (警告あり) を報告します - このオプションでは、このエラーでテストは停止しませんが、エラーがテストステップ結果に警告として記録され、エラーが発生したテストステップには「成功 (警告あり)」の結果コードが表示されます。無視 - ステップとテストは成功を報告します - このオプションでは、エラー発生時にテストも停止しません。この許可リストに登録されたクライアントエラーが発生したテストステップは「成功」のステータスコードを報告しますが、このテストのテストログにはクライアントエラーを示すレコードが含まれ、エラーが無視されたことが示されます。注意: このエラーのテストを再度停止し、失敗したテストを報告する必要が生じた場合は、この許可リストに登録されたエラーレコードをインスタンスから削除するか、許可リストに登録されたエラーのステータスを非アクティブに設定する必要があります。 アクティブ: このチェックボックスをオンにすると、各テストステップの実行中にこのエラータイプが発生した場合に、このホワイトリストクライアントエラーが ATF によって参照されます。このステップがアクティブに設定されていない場合、このレコードは無視され、エラーは引き続き報告され、ATF テストは通常どおりに停止します。 エラーメッセージ: これは、クライアントエラー包含リストに追加する予定の特定のエラーメッセージです。これは通常、この特定のエラーが発生したときに生成されるエラーメッセージです。[エラーメッセージ] フィールドと生成された実際のエラーを比較するときに、実際には「包含」演算子が使用されます。したがって、テストの実行時にクライアント側のエラーメッセージが検出され、そのエラーメッセージのテキストにこのフィールドのテキストと一致するテキストのサブ文字列が含まれている場合、このクライアントエラー包含リストがそのレコードに適用されます。 説明: このフィールドには、包含リストに追加されるエラーの簡単な説明を含める必要があります。 5.要求されたすべてのフィールドに入力したら、[Submit] ボタンをクリックして、新しい包含リストクライアントエラーレコードを ATF システムに追加します。 方法 2: 包含リストにエラーを自動的に追加する 包含リストクライアントエラーレコードをインスタンスに追加するより一般的な方法は、テストレコード、テスト結果レコード、またはテストステップ結果レコードから直接追加することです。 この方法でステップを追加するには、テストが少なくとも 1 回実行され、そのテストでこのエラーが発生する必要があります。 テスト結果から包含リストエラーレコードを直接追加するには: クライアント側のエラーが原因で失敗したテストのテスト結果レコードを参照します。そのレコードに関連付けられた関連リンクまでスクロールしすべてのクライアントエラーを警告リストに追加 または すべてのクライアントエラーを無視リストに追加というタイトルのリンクを選択します。 3.しばらくすると、(テストが停止する前に) テストで発生したエラーは、選択されたオプションに基づいて [警告] または [無視] リストに追加され、クライアントエラーレコードが追加されたことを示すメッセージが表示されます。 テストステップ結果レコードから包含リストエラーレコードを直接追加するには: ブラウザエラーに失敗した特定のテストステップ結果を参照します。関連リストから、すべてのクライアントエラーを警告リストに追加 または すべてのクライアントエラーを無視リストに追加 のいずれかのタイトルのリンクを選択します。しばらくすると、このステップで発生したエラーレコードがクライアントエラー包含リストに追加され、レコードが追加されたことを示すメッセージが表示されます。 テスト結果アイテムレコードから包含リストエラーを追加するには: 特定のエラーが発生した特定のテスト結果アイテムを参照します。 このレコードに関連付けられた関連リンクを見つけてクライアントエラーを警告リストに追加 またはクライアントエラーを無視リストに追加のいずれかを選択します。このオプションを選択すると、このステップで発生した特定のエラーメッセージが適切なリストに追加され、レコードがリストに追加されたことを示すメッセージが表示されます。 注意:エラーを 警告 リストに追加すると、エラーが警告としてログに記録され、テストは続行されますが、このエラーが原因で完了時に警告ありの成功としてマークされます。エラーが [無視] リストに追加された場合、テストも引き続き [成功] と表示されますが、テスト結果にはエラーが発生したが無視されたことを示すレコードが表示されます。 たとえば、ATF テストのパフォーマンスで、テストの実行中に単純なクライアント側スクリプトエラーが発生しました。したがって、このエラーによりテストが停止し、テストの失敗が報告されます。また、テストステップ自体に Failure が生成されます。 ほとんどの場合、テスターは関連するオブジェクトで発生したこのようなクライアント側のエラーを修正する必要がありますが、エラーを修正できない、または修正すべきでない場合もあります。したがって、この例では、テスターは発生したエラーを警告リストのクライアントエラー包含リストに追加します。その場合、テストは「成功 (警告あり)」のステータスのレポートを完了します。 さらに、その特定のエラーが発生した個々のテストステップは [警告] としてマークされます。 クライアントスクリプトエラーを [警告] リストに追加する代わりに、クライアントスクリプトエラーを [無視] リストに追加すると、テストは [成功] ステータスで完了します。 失敗した個々のテストステップは、テストステップでは [無視] として表示され、そのエラーが原因でテストが停止することはありません。