後処理（Webデータベース）

後処理は、Webデータベースのアプリケーションでデータの登録・更新・削除が行われた後に実行される業務ロジックです。

注記

登録処理を行った場合のみ実行したい（更新・削除等の処理では実行しない）などの制御は、ロジック内の分岐を利用して実装可能です。

利用例

登録・更新時にフォームの入力内容をメールで送信する
登録時にフォームの入力内容を別のWebデータベースに登録する

業務ロジックの概要

後処理の業務ロジックを新規作成すると、初期状態では以下の図のように設定されています。
タスクを追加し、実現したい業務ロジックを作成してください。

業務ロジックの初期状態

後処理の業務ロジックには、処理の種別ごとの分岐が初期設定されています。
設定されている分岐条件と条件式は以下の通りです。

分岐条件	条件式
登録	`${ $input.executeProcessType == "regist" }`
更新	`${ $input.executeProcessType == "update" }`
削除	`${ $input.executeProcessType == "remove" }`
一時保存	`${ $input.executeProcessType == "preserve" }`

特定の処理、例えば、登録処理を実行する際にのみ実行したい処理は、「分岐（登録）」タスクの then から線をつなげるようにします。
複数の、または、すべての処理種別で同じ処理を実行する場合は、それぞれの分岐の then から線をつなげてください。

図：登録時にのみ実行したい処理の場合

図：登録時と更新時に実行したい処理の場合

注意

後処理は、データベーストランザクション内で実行されます。
そのため、業務ロジックの中で独自にデータベーストランザクション制御を行うことはできません。
JavaScriptユーザ定義タスクで、データベーストランザクション制御を伴う処理は実施しないでください。

入力値

入力値	型	説明
executeProcessType	string	executeProcessType を参照
postProcessParameter	object	postProcessParameterオブジェクトを参照
sendParam	object	sendParamオブジェクトを参照

executeProcessType

アプリケーション実行種別を保持します。
業務ロジックを実行するタイミングに合わせて以下の値が取得可能です。

regist：データの登録時
update：データの更新時
remove：データの削除時
preserve：データの一時保存時

postProcessParameterオブジェクト

画面の基本情報を保持します。

項目	型	説明
loginUserCd	string	ログインユーザコード
applicationId	string	アプリケーションID
applicationNo	long	アプリケーションバージョンNO（アプリケーション履歴番号）
insertId	string	データ登録ID
applicationType	string	アプリケーション種別 std：Webデータベース bis_wkf：ワークフロー
appPageType	string	アプリケーションページ種別 REGISTRATION：登録 EDIT：更新 REFERENCE：参照
processKey	string	プロセスキー

sendParamオブジェクト

フォームの入力情報を保持する送信パラメータオブジェクトです。
画面アイテム「明細テーブル」、「グリッドテーブル」、「スプレッドシート」のテーブルのパラメータ名はテーブル識別IDです。
上記を除く入力アイテムのパラメータ名はフィールド識別IDです。
複数項目選択可能な画面アイテム（「チェックボックス」、「リストボックス」）は選択された値をカンマ区切りにして値が設定されます。

注記

画面アイテム「ファイルアップロード」のアップロードファイル情報は含まれません。
ファイル情報の取得には「ファイルアップロード情報取得」タスクをご利用ください。

出力値

出力値	型	説明
error	boolean	エラーフラグ `true` を設定した場合、当処理をエラー終了します。処理が正常に終了した場合は `false` を設定してください。
errorMessage	string	設定したメッセージを例外ログとして出力します。
userErrorMessage	string	設定したメッセージをエラーメッセージとして画面に表示します。ロケールごとにメッセージを用意する必要がなければこのプロパティを利用してください。このプロパティを省略した場合、画面にはデフォルトのエラーメッセージが表示されます。
localizedUserErrorMessages	object	指定したメッセージをエラーメッセージとして画面に表示します。アクション処理のコンテキストから解決されたロケールに一致するメッセージを使用します。 `userErrorMessage` が指定されている場合はこのプロパティは使用されません。
outputLog	boolean	ログ出力有無フラグ業務ロジック実行中にエラーが発生した際のログ出力有無を設定します。このプロパティを省略した場合はログが出力されます。

localizedUserErrorMessagesオブジェクト

出力値	型	説明
ja	string	日本語ロケールメッセージ
en	string	英語ロケールメッセージ
zh_CN	string	中国語ロケールメッセージ

定数

定数ID	説明
FALSE	出力値 `error` へのマッピングに利用する定数です。
imfrApplicationId	アプリケーションID 「ファイルアップロード情報取得」タスクの入力値等に使用します。

実装例

簡単な後処理の業務ロジック実装例をご紹介します。
この業務ロジックでは、データ登録時に登録内容を特定のユーザにメールで送信します。

概要

図：業務ロジックの実装例

以下のタスクを使用しています。

汎用タスク > システム通知テキストメール送信

以下のユーザ定義タスクを作成して使用しています。

テンプレート定義「メール本文作成」

処理の流れ・設定例

テンプレート定義を利用して、送信するメールの本文を作成します。「ユーザ定義追加」から「テンプレート定義新規作成」を選択して、テンプレート定義「メール本文作成」を作成します。
テンプレート定義「メール本文作成」の入力値、テンプレートを設定します。今回は、入力値でフォームの入力情報（ name 、 price 、 notes ）を受け取り、テンプレートの所定の位置に埋め込みます。テンプレートは以下のようにします。
```
<#setting url_escaping_charset="UTF-8">

商品マスタに以下の商品が登録されました。

商品名：${name}
価格：${price}
備考：${notes}
```
備考
テンプレート定義の詳細は以下を参照してください。
- 「IM-LogicDesigner仕様書」-「テンプレート」
作成した「メール本文作成」タスクを配置します。今回は、データ登録時にメールを送信するようにしたいため、「分岐（登録）」タスクの then から線を繋げます。
「メール本文作成」タスクのマッピング設定を行います。フォームの入力情報は業務ロジックの入力値（ sendParam オブジェクト配下のパラメータ）から、「メール本文作成」タスクの入力値にマッピングします。
「システム通知テキストメール送信」タスクを用いて、メールを送信します。「メール本文作成」タスクの返却値 output をメール本文（ body ）にマッピングします。
メール件名（ subject ）と宛先ユーザ（ toUserCds ）は定数に値を設定し、マッピングします。

後処理（Webデータベース）

利用例​

業務ロジックの概要​

入力値​

executeProcessType​

postProcessParameterオブジェクト​

sendParamオブジェクト​

出力値​

localizedUserErrorMessagesオブジェクト​

定数​

実装例​

概要​

処理の流れ・設定例​

利用例