翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# オートメーションのテスト
<a name="testing-automations"></a>

Amazon Quick Automate は、オートメーションをテストするための包括的な機能を提供します。このセクションでは、自動化動作の検証に使用できるツールと機能について説明します。

## テストモード
<a name="test-modes"></a>

オートメーションをテストするには、次の 2 つのモードから選択します。
+ 実行モード - オートメーションを最初から最後まで停止せずに実行します。オートメーションのブレークポイントは無視されます。このモードは、オートメーションの完全なフローをテストするのに最適です。
+ デバッグモード - オートメーションを実行し、設定したブレークポイント、または例外が発生した場合は一時停止します。これにより、自動化の状態を検査し、変数をモニタリングし、プロセスの特定の時点で動作を検証できます。

## テストペイン
<a name="test-pane"></a>

テストペインには、自動化テストのモニタリングと制御に役立つ 2 つのメインタブがあります。

### セットアップタブ
<a name="setup-tab"></a>

Setup タブには、テスト設定を管理するためのツールが用意されています。
+ ブレークポイントマネージャー - オートメーションで現在設定されているすべてのブレークポイントを一覧表示します。キャンバスに戻ることなく、このビューから直接ブレークポイントを削除します。
+ ナビゲーションのテスト - 表示するクイックアクセスリンク:
  + 実行の表示 - テストからのすべての自動化実行を表示する
  + ケースの表示 - テスト中に作成されたケースの表示
  + タスクの表示 - 生成されたヒューhuman-in-the-loopタスクを確認します

### モニタータブ
<a name="monitor-tab"></a>

Monitor タブには、実行中のオートメーションに関するリアルタイムの情報が表示されます。
+ UI ストリーミング - ブラウザ自動化アクションがリアルタイムで実行されるのを監視する
+ 変数監視 - 変数値をモニタリングおよび変更する
+ ログ - 詳細な自動化の進行状況を追跡する

## テストステータス
<a name="test-statuses"></a>

テスト中、オートメーションは次のいずれかのステータスになります。
+ 実行中 - オートメーションはアクションをアクティブに実行しています
+ 一時停止 (ブレークポイント) - ユーザー定義のブレークポイントで実行が停止しました
+ 一時停止 (例外) - エラー状態のため実行が停止しました
+ 完了 - オートメーションはすべてのステップを正常に完了しました
+ 失敗 - 自動化で回復不可能なエラーが発生し、停止しました

## の実行とデバッグ
<a name="running-and-debugging"></a>

### 入力と出力を使用してオートメーションをテストする
<a name="test-automations-inputs-outputs"></a>

入力フィールドと出力フィールドが定義されているオートメーションをテストすると、Amazon Quick Automate は入力値を検証し、入力と出力の両方を実行ログとともに **Monitor** ペインに拡張可能なカードとして表示します。

#### オーサリングスタジオからの入力によるオートメーションの実行
<a name="running-automation-with-inputs"></a>

Run ****または **Debug** を選択して入力と出力でオートメーションをテストすると、オーサリングスタジオ (Studio) には、入力**値の入力**というタイトルの動的入力フォームが表示されます。Amazon Quick Automate は、定義したスキーマに基づいてこのフォームを自動的に生成します。

フォームには以下が含まれます。
+ スキーマのフィールド名。
+ 各データ型に適した入力コントロール (文字列のテキストフィールド、整数の数値入力、ファイルのファイルアップロードボタン）。
+ 必須フィールドインジケータ (アスタリスクでマーク）。
+ デフォルト値は、定義した場所に事前入力されています。
+ データ型、必須フィールド、ファイルサイズ制限 (ファイルの場合最大 5 MB) に関するクライアント側の検証。

入力を使用してオートメーションを実行するには:
+ Studio でオートメーションを開き、**実行**または**デバッグ**を選択します。
+ **入力値を指定する**フォームで、各フィールドに値を入力します。
  + テキストフィールドと数値フィールドの場合は、値を直接入力します。
  + ファイルフィールドで、ブラ**ウズ**を選択してローカルマシンからファイルを選択します。
  + デフォルト値を上書きしない限り、オプションのフィールドは空白のままにできます。
+ **開始** を選択して、指定した入力で自動化を開始します。

Amazon Quick Automate は 2 つの検証レイヤーを実行します。
+ **クライアント側の検証** – 実行を開始する前に、空白の必須フィールド、正しいデータ型、ファイルサイズ制限をチェックします。
+ **ランタイム検証** – 実行中に JSON スキーマに対して完全な入力ペイロードを検証します

#### 入力と出力の表示
<a name="viewing-inputs-outputs-test"></a>

自動化が実行されると、入力値と出力値は、**Monitor** ペインに折りたたみ可能なカードとして表示されます。
+ **入力カード** – 実行ログの先頭に表示され、オートメーションの開始時に指定したすべての値が表示されます。
+ **出力カード** – 実行完了後に実行ログの最後に表示され、自動化によって生成されたすべての値が表示されます。

両方のカードはデフォルトで折りたたまれます。これらを展開すると、次のことができます。
+ 完全なスキーマ定義と実際の値を表示する
+ 入力または出力に含まれるファイルオブジェクトをダウンロードする
+ 構造化データを JSON としてコピーする
+ 完全なペイロードを JSON ファイルとしてダウンロードする

**注記**  
自動化がエラーで終了した場合、出力カードは使用できません。

### ブレークポイントの設定
<a name="setting-breakpoints"></a>

ブレークポイントを使用すると、特定の時点でオートメーションを一時停止できます。

ブレークポイントを追加するには:
+ キャンバス上のアクションまたはステップにカーソルを合わせます。
+ **ブレークポイントの追加**をクリックします。
+ ブレークポイントアイコンがアクションまたはステップに表示されます。

ブレークポイントを削除するには:
+ アクションの**ブレークポイントの削除**をクリックします。
+ または、セットアップタブのブレークポイントマネージャーを使用します。

**注記**  
デバッグモードを開始する前にブレークポイントをセットアップします。

### コントロールのデバッグ
<a name="debug-controls"></a>

オートメーションを一時停止すると、いくつかのコントロールオプションがあります。
+ 次へ - オートメーションで次のアクションを実行し、もう一度一時停止します。
+ 続行 - 次のブレークポイントに達するまで実行を再開する
+ 停止 - 現在のテストランを終了する
+ 無視 - 例外で一時停止すると、例外がクリアされ、そのアクションが成功したかのように続行されます。これは、例外が残りのテストをブロックしておらず、続行する場合に便利です。
+ 再試行 - 例外で一時停止すると、現在のアクションを再度実行しようとします。これは、問題が一時的な場合や、変数の値を変更して新しい値で再試行する場合に便利です。

### ステップを非アクティブ化する
<a name="deactivating-steps"></a>

アクションやステップを削除せずに一時的に無効にするには、テストを開始する前に無効にします。非アクティブ化されたアクションまたはステップは、テスト中にスキップされます。
+ 非アクティブ化するステップを選択する
+ **メニューオプション**をクリックします。
+ **非アクティブ化**を選択する
+ ステップがグレー表示されます

再アクティブ化するには:
+ 非アクティブ化されたステップを選択する
+ **メニューオプション**をクリックします。
+ [**Activate**] を選択してください。

### 可変ウォッチャー
<a name="variable-watcher"></a>

Monitor タブの Variable watcher は、テスト中にオートメーションで使用されているデータを検査するための可視性を提供します。変数を検査するには:
+ テストが一時停止されている間に Monitor タブで Variable watcher を開きます。
+ **追加**をクリックして検索し、検査する変数を選択します
+ 変数の現在の値を表示する
+ 値を変更してさまざまなシナリオをテストします。
  + 変数の横にある**鉛筆アイコンをクリックします**。
  + テストする新しい値を入力する
  + 実行を続行して新しい値に進みます。

この機能は、特に以下の場合に便利です。
+ さまざまなデータ条件のテスト
+ エラー処理の検証
+ エッジケースのシミュレーション

## トラブルシューティング
<a name="troubleshooting"></a>

### Assistant による修正
<a name="fix-with-assistant"></a>

オートメーションで例外が発生した場合、オートメーションアシスタントは問題の特定と解決に役立ちます。
+ エラーで一時停止したときに **Assistant で修正**をクリックします
+ Assistant は以下を行います。
  + エラーメッセージを分析する
  + 実行ログを確認する
  + トラブルシューティングナレッジベースを確認する
  + 問題を明確に説明する
  + 潜在的な解決策を提案する
+ Assistant とチャットして、次の操作を行います。
  + エラーについて質問する
  + 推奨される変更に基づいてオートメーションを更新する

## テストメトリクス
<a name="test-metrics"></a>

テストが完了すると、Amazon Quick Automate は、自動化のパフォーマンスを理解し、テストカバレッジを検証するのに役立つ包括的なテストメトリクスを提供します。テストランに関する主要なメトリクスを表示します。
+ 合計実行時間 - テストの開始から終了までの時間
+ 完了したケースの数 - 処理が終了したケースの数 (作成済みまたは保留中のケースを除く)
+ ケースあたりの平均時間 - 完了した各ケースの処理平均時間
+ ケースの成功率 - 例外なしで完了したケースの割合
+ 作成されたタスクの数 - テスト中に生成されたhuman-in-the-loopタスクの数
+ アクションカバレッジ - テスト中に実行されたオートメーション内のアクションの割合。テストされていないパスの特定に役立ちます。