アクションエラー評価

アクションを有効化してステップの失敗を検出し、実行を継続します。特定のエラー状態が発生するタイミングを特定して、独自のアクションステータスコード、ステータスメッセージ、エラー状態を返します。

メリット

アクションエラー評価を有効にすると、次のメリットが得られます。

• ステップの失敗をキャッチしてアクションの実行を継続できます。アクションに追加する各ステップの失敗動作を指定します。
• 独自のエラー条件を作成します。アクションがエラーステータスを返すタイミングと、返されるステータスコードとメッセージを指定します。
• フローデザイナーにより多くのエラー処理情報とオプションを提供します。独自のアクションステータスコードとメッセージを使用して問題を特定し、是正処置の詳細を提供します。

アクションエラー評価ステップコンポーネント

各ステップには、これらのエラー評価コンポーネントが用意されています。

図 : 1. エラー評価ステップコンポーネント

1. [このステップが失敗した場合] オプション

次のステップの実行を続行するか、エラー評価に進むオプション。このオプションはステップステータスに影響しません。

2. ステップステータス

ステップに関するランタイムの詳細を含むオブジェクトデータピル。アクションの各ステップはステップステータスを返します。

3. [ステップステータス] > [コード]

ステップでエラーが発生したかどうかを示す整数データピルです。何らかの理由でエラーが生成された場合、ステップは値 1 を返します。たとえば、必須の入力データが欠落しているか、間違ったデータタイプで出力を返す場合、ステップはエラーを生成する可能性があります。ステップは、正常に実行されると値 0 を返します。これらのコードはカスタマイズできません。

4. [ステップステータス] > [メッセージ]

ステップまたはシステム操作によって生成されたエラーメッセージを含む文字列データピル。このステップステータスメッセージはカスタマイズできません。

アクションエラー評価構成コンポーネント

アクションエラー評価はこれらの構成コンポーネントで構成されます。

図 : 2. エラー評価構成コンポーネント

5. [エラーの評価 (Error Evaluation)] セクション

考えられるエラー条件が含まれるセクション。 アクションが実行されると、すべての利用可能なエラー条件が評価されて、一致する可能性があるものが検索されます。アクションは、最初に一致したエラー条件で指定されたアクションステータスを返します。一致するエラー条件がない場合、アクションステータスは最後に実行されたステップのステップステータスに設定されます。

注:

データストリームアクションに [エラーの評価 (Error Evaluation)] セクションはありません。

6. [エラー条件を追加 (Add error condition)] オプション

エラー条件を追加するオプション。各エラー条件は else if フローロジックブロックと同等です。true にできるエラー条件は一度に 1 つのみです。

7. エラー条件の構成

エラー条件を設定するために使用できるオプションは次のとおりです。

• このエラー条件を識別するために使用するラベル
• このエラー条件と一致するために満たす必要がある条件
• アクションをフローに戻すエラーステータス
• アクションをフローに戻すアクションステータスコード
• アクションをフローに戻すアクションステータスメッセージ

8. アクションステータス

アクションに関するランタイムの詳細を含むオブジェクトデータピル。アクションは常にアクションステータスを返します。

9. [アクションステータス] > [コード]

最初に一致したエラー条件または最後のステップ実行によって返されたコードを含む整数データピル。カスタムエラー条件を作成するときに、独自のコードを返すことができます。

10. [アクションステータス] > [メッセージ]

一致したエラー条件または最後のステップ実行によって生成されたメッセージを含む文字列データピル。カスタムエラー条件を作成するときに、独自のメッセージを返すことができます。

一般的なガイドライン

アクションエラー評価によるメリットを得るには、次の一般的なガイドラインに従います。

独立したステップのみの実行継続を許可する

ステップが後続のステップで必要なデータを返さない場合は、ステップの実行継続を許可します。ステップが後続のステップで必要なデータを提供する場合、後続のステップを正常に実行できないことがわかります。

エラー条件が 10 を超えないようにする

作成できるエラー条件の数に制限はありませんが、各エラー条件は評価する必要があります。アクションで評価する必要があるエラー条件が多いほど、アクションの実行が低速になる可能性があります。

特定のステップの失敗を識別する

ステップステータスを使用して特定のステップがいつ失敗したかを識別できます。特定のステップを識別することは、アクションにタイプが同じステップの複数のインスタンスが含まれている場合に役立ちます。また、フローエラーハンドラーが失敗に対して具体的な是正処置を実行できるように、特定のステップを識別することもできます。

特定のエラー条件を一般的なエラー条件の前に配置する

アクションが一致するエラー条件を検出すると、エラーの評価は停止します。一般的なエラー条件を最初に配置すると、アクションが特定のエラー条件に一致しなくなる可能性があります。

わかりやすいエラー条件ラベルを使用する

エラー条件を編集する必要なく識別できるようになります。デフォルトでは、エラー条件は編集時にのみ表示できます。

• エラー条件を追加
  特定の条件が満たされた際にカスタム状況情報を返すアクションを有効化します。フローでカスタムアクションのステータスをエラーと見なすか成功した実行と見なすのかを指定します。