「Try」アクティビティー

Try...」アクティビティーは、 メインの Try ブランチでアクティビティー (複数可) を実行しようとします。

このタスクについて

メインの「Try」ブランチでのアクティビティー (複数可) の実行時に例外が発生した場合は、「CatchAll」ブランチが実行されます。

バックグラウンドでマウスを右クリックすると、新しい「CatchAll」ブランチが作成されます。

例えば、 メインの Try ブランチは「データベース: 行の挿入 (Database Insert Rows)」アクティビティーを呼び出すことができます (次の図を参照)。

データベース: 行の挿入 (Database Insert Rows)」アクティビティーが失敗して例外をスローした場合は、CatchAll ブランチ内のアクティビティー (複数可) が実行されます。 このオーケストレーション例では、「データベース: 行の挿入 (Database Insert Rows)」アクティビティーによって例外がスローされると、「終了」アクティビティーが実行され、 現在のオーケストレーション・ジョブは終了します。

「Try...」アクティビティーを追加および構成するには、次のステップを実行します。

手順

  1. アクティビティー」タブおよび 「ロジック」フォルダーを開きます。
  2. Try...」アクティビティーをオーケストレーション上にドラッグします。 「Try...」アクティビティーが以下のブランチとともに表示されます。
    • Try... ブランチ
    • CatchAll ブランチ
    最初の CatchAll ブランチの作成時には、 以下の変数が自動的に作成されます。
    • faultName - 実行時、faultName 変数には、 Try ブランチのアクティビティーからスローされた例外の名前が含まれます。
    • faultData - 実行時、faultData 変数には、 例外に関連するエラー・メッセージが含まれます。 この追加情報が返されるのは、現時点では Web サービス・アクティビティーの場合に限られます。 Web サービス・アクティビティーでは、faultData 変数に障害が含まれます。
    • faultInfo - 実行時、faultInfo 変数は以下のノードを返します。
      • name - 実行時、faultInfo/name ノードには、 Try ブランチのアクティビティーからスローされた例外の名前が含まれます。 faultInfo/name ノードは、xsd:QName 型です。
      • message - 実行時、faultInfo/message ノードには、 例外に関連するエラー・メッセージが含まれます。 faultInfo/message ノードは、xsd:string 型です。
      • activityId - 実行時に、例外が発生したアクティビティーを一意的に識別するアクティビティー ID が faultInfo/activityId ノードに含まれます。 faultInfo/activityId ノードは、xsd:int 型です。
      • activityName - 実行時に、例外が発生したアクティビティーの名前が faultInfo/activityName ノードに含まれます。 faultInfo/activityName ノードは、xsd:string 型です。
      • faultTime - 実行時、faultInfo/faultTime ノードには、 エラーが発生した時刻が含まれます。 faultInfo/faultTime ノードは、xsd:dateTime 型です。
      注: アクティビティーから faultName 変数と faultInfo/name ノードに返される例外名は、今後のリリースで変更される可能性があります。
  3. Try... ブランチと CatchAll ブランチを構成するには、 「アクティビティー」タブのアクティビティーを「Try...」アクティビティーのブランチにドロップします (上および下の図を参照)。
    重要: faultNamefaultDatafaultInfo の各変数のスコープは、「Try...」アクティビティーの CatchAll ブランチに限定されています。 このスコープ制限からすると、これらの変数の値が有効であることが保証されているのは、CatchAll ブランチの中に限られます。 例えば、 faultName 変数の値をテストする「If...Then」アクティビティーを追加する場合は、次の図にあるように、その「If...Then」アクティビティーを、「Try...」アクティビティーの CatchAll ブランチ内部に配置する必要があります。



フィードバック | 特記事項


タイム・スタンプ・アイコン 最終更新: 2013年11月7日 (木曜日)


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/orch_try_activity.html