例外処理 - Amazon Quick
例外のタイプアクション例外の使用

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

例外処理

例外処理を使用すると、オートメーションのエラーと予期しない条件を管理できます。Amazon Quick Automate は、堅牢なエラー管理とプロセスの継続性を確保するために、例外を適切に作成、引き上げ、処理する機能を提供します。

例外のタイプ

Amazon Quick Automate は、次の 2 種類の例外をサポートしています。

  • ビジネス例外 - 次のようなビジネスルール違反による予想されるエラーに使用されます。

    • 必須データがない

    • 無効な入力値

    • ポリシー違反

  • システム例外 - 次のような技術的エラーまたはインフラストラクチャエラーに使用されます。

    • 接続の失敗

    • サービスタイムアウト

    • 認証エラー

アクション

例外を発生させる

例外が発生してプロセスフローを中断します。例外をトリガーまたはスローしてプロセスを終了するか、例外シナリオを処理する特定のアクションを実行するために使用されます。すぐにプロセスを終了しない場合は、プロセスステップに例外フローを追加して例外を処理します。プロパティ:

  • タイトル (オプション) - プロセスの視覚化に表示されるアクション名 (「レイズ検証エラー」など)

  • カスタム例外の作成 (必須) - 選択すると、カスタムの詳細を含む新しい例外を作成します。オフの場合、変数に保存されている既存の例外を引き上げまたは再引き上げする

  • 例外タイプ (必須) - 例外のカテゴリ (「ビジネス例外」、「システム例外」など)

  • 例外の理由 (必須) - レポート用の同様の例外を分類するために使用される短い識別子 (例：「REQUIRED_FIELD_MISSING」、「INVALID_FORMAT」)

  • 例外メッセージ (必須) - トラブルシューティングに役立つ詳細な説明 (「顧客の E メールは必須ですが、提供されていません」など)

  • 引き上げる例外 (カスタム例外の作成がオフの場合に必須) - 通常変数として保存される、引き上げまたは再引き上げする例外 (例: new_exception)

カスタム例外を作成する

例外を発生させずに作成します。後続のステップで追加できる例外変数を準備するために使用されます。プロパティ:

  • タイトル (オプション) - プロセスの視覚化に表示されるアクション名 (「検証例外の作成」など)

  • 例外タイプ (必須) - 例外のカテゴリ (「ビジネス例外」、「システム例外」など)

  • 例外の理由 (必須) - レポート用の同様の例外を分類するために使用される短い識別子 (例：「REQUIRED_FIELD_MISSING」)

  • 例外メッセージ (必須) - トラブルシューティングに役立つ詳細な説明 (「顧客の E メールは必須ですが、提供されていません」など)

  • エラーコード (オプション) - さまざまなタイプのエラーを区別するために使用される数値コード (例: 404 for not found、503 for service unavailable)

  • 原因 (オプション) - この例外をトリガーした別の例外への参照。通常は変数として保存されます (例: original_exception)

  • 新しい例外 (出力) - 新しく作成された例外を保存する変数 (例: new_exception)

例外フロー

プロセスステップ内で発生する例外を処理する方法を定義します。プロセスで例外が発生した場合に従う代替パスを作成するために使用されます。例外が処理された後、プロセスは次のステップに進みます。プロセスを終了する場合は、例外を再度提起します。プロセスステップにある例外フロープラスボタンをクリックして、例外フローを追加します。プロパティ:

  • タイトル (オプション) - プロセスの視覚化に表示されるアクション名 (「ハンドル検証エラー」など)

  • 例外リファレンス (必須) - 例外フロー内の例外を参照する変数名。変数 ["property"] を使用して例外の詳細にアクセスします。ここで、プロパティはタイプ、理由、メッセージ、コード、または caused_by (例: エラー) です。

注記

例外フローは、プロセスステップにのみ追加できます。これらは、アクションパネルでは見つかりません。

例外の使用

例外プロパティ

例外を処理するときは、次のプロパティにアクセスできます。

  • type - 例外のカテゴリ (「ビジネス例外」または「システム例外」)

  • 理由 - 例外の短い識別子

  • message - エラーの詳細な説明

  • code - 数値エラーコードが指定されている場合

  • caused_by - 該当する場合、これをトリガーした元の例外

ベストプラクティス

  • 分類とレポートを容易にするために、わかりやすい例外理由を使用する

  • トラブルシューティングのための詳細なメッセージを含める

  • 一時的なシステム例外の再試行ロジックを実装する

  • ビジネス例外に対する人的介入を検討する

  • 例外を処理するときにケースステータスへの影響を考慮する

  • ブラウザの再起動などの例外が発生した場合でも、重要なクリーンアップオペレーションが行われるようにする

  • 例外の頻度とパターンをモニタリングする

  • 例外ログを定期的に確認する

  • 残りのステップを続行しない場合は、一度処理された例外を再生成する