5.7. ロジックフローのエラーハンドリング¶
この章では、ロジックフローにおいてエラーハンドリングを行う方法を説明します。
5.7.1. ロジックフローのエラーハンドリングとは¶
- エレメントでエラーが発生した場合、以降の処理を継続するかを決定する（エラー発生時のハンドリング）。
- 自身より前に処理が行われたエレメントのエラー状況をもとに、自身の振る舞いを制御する（エラー発生後のハンドリング）。
- エラー発生時のハンドリング - エレメントに対するエラーハンドリングの設定方法。
- エラー発生後のハンドリング - 受け取ったエラー状況（IM-LogicDesignerではこれを処理結果情報と呼びます）をもとに振る舞いを変更する方法。
5.7.2. エラーハンドリングの設定、および、動作確認¶
- 処理を継続する
- フロー全体のエラーとして処理を中断する
コラム
エラー処理フローによるエラーハンドリング
5.7.2.1. フローの準備¶
- 「サイトマップ」→「LogicDesigner」→「フロー定義一覧」から、ロジックフロー定義一覧を開きます。ロジックフロー定義一覧画面左上の「ロジックフロー新規作成」をクリックします。
「ユーザプロファイルの取得」タスク（IM共通マスタ）をフロー編集画面に追加し、以下のエレメント間に線を引きます。
- 「開始」制御要素から「ユーザプロファイルの取得」タスク
- 「ユーザプロファイルの取得」タスクから「終了」制御要素
図：ロジックフロー配線例
ロジックフローを以下のとおりに保存します。
フロー定義ID「tutorial_error_handling」
- フロー定義名
- 標準 - 「チュートリアルエラーハンドリング」
- 日本語、英語、中国語（中華人民共和国） - 入力なし
- フローカテゴリ
- ID - 「tutorial_category」
- 名称 - 「チュートリアルカテゴリ」
図：ロジックフローの保存
コラム
今回準備したフローについて
5.7.2.2. デフォルトの動作を確認する¶
ロジックフロー定義編集画面上部、ヘッダ内の「デバッグ」をクリックし、デバッグ画面を表示します。
図：デバッグ画面
デバッグ画面上部、ヘッダ内の「実行」をクリックし、デバッグ実行を行います。
図：デバッグ実行
「ユーザプロファイルの取得」タスク実行時にエラーが発生し、ロジックフローが異常終了することを確認してください。
図：デバッグ実行結果（異常終了）
5.7.2.3. エラーハンドリングの設定を行う¶
デバッグ画面を開いている場合は、デバッグ画面を閉じます。
「ユーザプロファイルの取得」タスクをクリックし、プロパティ画面を表示します。
図：「ユーザプロファイルの取得」タスクのプロパティ画面
タスク固有設定の項目を以下のとおりに変更します。
- エラーでも処理を継続する - チェックボックス：オン
図：エラーハンドリングの設定
ロジックフローを保存します。
5.7.2.4. エラーハンドリング設定後の動作を確認する。¶
ロジックフロー定義編集画面上部、ヘッダ内の「デバッグ」をクリックし、デバッグ画面を表示します。
デバッグ画面上部、ヘッダ内の「実行」をクリックし、デバッグ実行を行います。
「ユーザプロファイルの取得」タスク実行時にエラーが発生しますが、ロジックフローが「正常に終了」したことを確認してください。
図：デバッグ実行結果（正常終了）
注意
エラー発生後の動作について
5.7.3. 処理結果情報の利用方法、および、動作確認¶
5.7.3.1. 処理結果情報の詳細¶
プロパティ名 詳細 error<boolean> errorMessage<string> errorReport<string>
executeId<string> stackTrace<string>
図：セッション情報は全エレメントで同じ振る舞いの値を参照する。
図：処理結果情報は各エレメントの一つ前のエレメント情報を、それぞれ参照する。
5.7.3.2. エラー発生後のハンドリングを行うフローの作成¶
新しくロジックフローの入力として、ユーザコードを受け取る。
「ユーザプロファイルの取得」タスクは、入力のユーザコードを利用してユーザプロファイルを取得する。
- 「ユーザプロファイルの取得」タスクの処理結果に応じて以下のように振る舞うフローを定義する。
- 正常に処理出来た場合は、取得結果からユーザ名を「ログ出力」タスクを利用して出力する。
- 処理がエラーとなった場合は、処理がエラーになった旨を「ログ出力」タスクを利用して出力する。
ロジックフロー定義編集画面上部、ヘッダ内の「入出力設定」をクリックし、入出力設定画面を開きます。
入力に以下のパラメータを定義します。
パラメータ名 型 userCd string 
図：新しい入力である「ユーザコード」の定義
「ユーザプロファイルの取得」タスクをクリックした上で、「マッピング設定」をクリックし、マッピング設定画面を開きます。
マッピング設定を以下のとおりに設定します。
入力（始点） 出力（終点） 入力<object> - userCd<string> <object>im_immGetProfile1 - <string>userCd 
図：「ユーザプロファイルの取得」タスクのマッピング設定
以下のエレメントをフロー編集画面上に追加します。
「基本」-「分岐」制御要素
- 「汎用タスク」-「ログ出力」タスク（エラー発生時用）
- タスクID、および、エイリアスは「im_logger1」とします。
- 「汎用タスク」-「ログ出力」タスク（正常処理用）
- タスクID、および、エイリアスは「im_logger2」とします。
図：新しいエレメントの追加
追加したエレメント、および、既存のフローについて 以下のエレメント間に線を引きます。
- 「ユーザプロファイルの取得」タスクから「分岐」制御要素
- 「分岐」制御要素（then）から「ログ出力」タスク（エラー発生時用）
- 「分岐」制御要素（else）から「ログ出力」タスク（正常処理用）
- 「ログ出力」タスク（正常処理/エラー発生時）から「終了」制御要素
図：ロジックフロー配線例
「分岐」制御要素をクリックし、プロパティのタスク固有設定の項目を以下のとおりに変更します。
- 条件式（EL式）- 「${$task_result.error}」
図：条件の定義
「ログ出力」タスク（エラー発生時用）をクリックした上で、「マッピング設定」をクリックし、マッピング設定画面を開きます。
マッピング設定を以下のとおりに設定します。
入力（始点） 出力（終点） 処理結果情報<object> - errorMessage<string> <string>im_logger1 
図：「ログ出力」タスク（エラー発生時用）のマッピング設定
「ログ出力」タスク（正常処理用）をクリックした上で、「マッピング設定」をクリックし、マッピング設定画面を開きます。
マッピング設定を以下のとおりに設定します。
入力（始点） 出力（終点） im_immGetProfile1<object> - localize<object> - userName<string> <string>im_logger2 
図：「ログ出力」タスク（正常処理用）のマッピング設定
ロジックフローを保存します。
5.7.3.3. エラー発生後のハンドリングを行うフローの動作確認¶
ロジックフロー定義編集画面上部、ヘッダ内の「デバッグ」をクリックし、デバッグ画面を表示します。
図：デバッグ画面
デバッグ画面上部、ヘッダ内の「実行」をクリックします。
デバッグ実行の入力値として以下を定義し、実行します。
- 入力<object> - userCd<string> - 「aoyagi」
図：デバッグ実行（正常）
実行結果として以下を確認してください。
- ロジックフローがエラーを発生せずに正常終了していること。
- 「ログ出力」タスクからサーバのコンソールに「青柳辰巳」が出力されていること。
デバッグ画面上部、ヘッダ内の「実行」をクリックします。
デバッグ実行の入力値として以下を定義し、実行します。
- 入力<object> - userCd<string> - 「null」
図：デバッグ実行（エラー発生）
実行結果として以下を確認してください。
- ロジックフローはエラーが発生しているが、正常に終了していること。
- 「ログ出力」タスクからサーバのコンソールに「[E.IWP.LOGIC.IMMASTER.00003] ユーザコードが指定されていません。」というエラーメッセージが出力されていること。