5.4.13.2. 申請を行うユーザ定義(BIS申請/承認)の作成¶
注意
ユーザ定義(BIS申請/承認)のチュートリアルは、 IM-LogicDesigner 2017 Winter(8.0.18)以降のバージョンで実行できます。
5.4.13.2.1. 本チュートリアルで作成するユーザ定義の概要¶
「特定のワークフローに対する一括申請を実行する」
A入力した金額が10,000円未満の場合のルートです。分岐終了ノードに接続しています。 B入力した金額が10,000円以上、かつ50,000円以下の場合のルートです。動的承認ノードに接続しています。 C入力した金額が50,000円を超える場合のルートです。横配置ノードに接続しています。
ユーザ定義(JavaScript)
分岐開始ノードに対して、分岐先と動的承認ノード・横配置ノードの処理対象者を設定する処理を実装しています。インポートの手順は インポート方法 を参照してください。IM-BIS ワークフローの定義情報
IM-LogicDesigner の実行対象のワークフローに関する定義情報です。インポートの手順は「 IM-BIS システム管理者操作ガイド 」-「 一括インポート・エクスポートを行う 」を参照してください。注意
本チュートリアルに付属するサンプルでは、以下の事項については説明を割愛しています。実際の開発においては、必要に応じて適切な実装を行ってください。
- 例外処理
- バリデーションチェック
- 「ボタン(イベント)」の二度押し防止
- 処理結果の通知
- 画面遷移・タブ遷移
5.4.13.2.2. 処理種別とBIS定義¶
- アプリケーション種別 - 「BIS」
- 処理種別 - 「申請」
- 定義情報 - 「BISワークフロー(LD:申請)」
5.4.13.2.3. 入力値/出力値¶
5.4.13.2.3.1. 入力値¶
入力値 説明 applyUserPlugin<object> 処理対象者情報(プラグイン情報)です。処理種別「起票」時に指定します。draftInfo<object> 起票情報です。処理種別「起票」時に指定します。applyFromUnapplyInfo<object> 起票案件の申請情報です。処理種別「起票案件の申請」時に指定します。applyInfo<object> 申請情報です。処理種別「申請」時に指定します。reapplyInfo<object> 再申請情報です。処理種別「再申請」時に指定します。approveInfo<object> 承認情報です。処理種別「承認」時に指定します。asyncProcessingFlag<boolean> 非同期処理中実行フラグです。非同期処理中実行フラグに true を指定することで、到達処理ユーザプログラムで、当該案件に対する処理できます。詳細は「 IM-LogicDesigner仕様書 」-「タスク一覧」-「IM-BIS」の以下のIM-BISタスクを参照してください。
- 「起票案件の申請」
- 「再申請」
- 「承認」
workflowAdvancedSettingInfo<object> ワークフロー設定情報(高度な設定)です。対象のフローの処理時に以下の設定が必要な場合に指定します。
- 分岐先選択情報
- 確認ノード設定情報
- 動的承認ノード設定情報
- 横配置ノード設定情報
- 縦配置ノード設定情報
userParamInfo<object> ユーザパラメータ設定情報です。ユーザパラメータが存在する場合に指定します。formaItemInfo<object> 画面アイテム入力情報です。メインフォームに対象のアイテムが存在する場合に指定します。formaTableItemInfo<object> テーブル系画面アイテム入力情報です。メインフォームに対象のアイテムが存在する場合に指定します。
5.4.13.2.3.2. 出力値¶
返却値 説明 matterNumber<string> 入力値に定義したmatterNumberに設定した値が格納されます。入力値で値を設定しない場合、Nullが格納されます。systemMatterId<string> 案件の申請実行時にシステムで採番された案件を識別するためのIDが格納されます。 userDataId<string> 案件の申請実行時にシステムで採番された案件に紐づくユーザデータを識別するためのIDが格納されます。
5.4.13.2.4. BIS申請/承認¶
アプリケーション種別 説明 BIS 実行対象のフローがBISで作成したワークフローの場合に選択します。Forma(Workflow) 実行対象のフローがForma(WF連携)で作成したワークフローの場合に選択します。
処理種別 説明 起票 フローに対する処理として、起票を行う場合に選択します。詳細は「起票」を参照してください。起票案件の申請 フローに対する処理として、起票案件からの申請を行う場合に選択します。詳細は「起票案件からの申請」を参照してください。申請 フローに対する処理として、新規に申請を行う場合に選択します。再申請 フローに対する処理として、再申請を行う場合に選択します。詳細は「再申請」を参照してください。承認 フローに対する処理として、承認を行う場合に選択します。詳細は「承認」を参照してください。
定義情報 説明 BIS ID 「BIS定義検索」から選択したフローを識別するためのIDが表示されます。BIS 名 「BIS定義検索」から選択したフローの名称が表示されます。バージョン開始日 「BIS定義検索」時の検索基準日に合致するフローのバージョンの開始日が表示されます。バージョン終了日 「BIS定義検索」時の検索基準日に合致するフローのバージョンの終了日が表示されます。説明 「BIS定義検索」から選択したフローの説明が表示されます。アプリケーションID 「Forma定義検索」から選択したフローを識別するためのIDが表示されます。アプリケーション名 「Forma定義検索」から選択したフローの名称が表示されます。アプリケーション履歴番号 「Forma定義検索」から選択したフローのアプリケーション履歴番号が表示されます。説明 「Forma定義検索」から選択したフローの説明が表示されます。
5.4.13.2.5. ユーザ定義(BIS申請/承認)を作成する¶
「BIS申請/承認定義編集」画面を表示します。
ユーザ定義の基本情報となる各項目に以下の値を入力します。
- ユーザ定義「BIS申請/承認」を定義します。アプリケーション種別は「BIS」とします。処理種別は「申請」とします。
対象のフローを選択するには、「検索」をクリックします。
「BIS定義検索」で「BISワークフロー(LD:申請)」のチェックボックスをオンにし、「選択」をクリックします。
アプリケーション種別、処理種別、BIS定義の選択後、入力値・返却値が以下のように定義されます。
- 入力値については、選択したフローに基づいて取捨選択する必要があります。選択したフローでは、ユーザパラメータ、確認ノード、縦配置ノードの設定は不要なため、「userParamInfo」、「workflowAdvancedSettingInfo」の配下から「confirmNodeConfigInfo」、「verticalNodeConfigInfo」を削除します。
「登録」をクリックします。
5.4.13.2.6. ロジックフローを作成する¶
5.4.13.2.6.1. 入出力設定を定義する¶
入出力設定では、申請対象のワークフローの申請者に関する情報と処理結果メッセージに関する情報を定義します。入出力設定には、以下のとおりに設定してください。
入力値
概要
申請情報 applyInfo 、 画面アイテム入力情報 formaItemInfo を入力値として定義します。申請権限者のユーザコード・申請基準日は、IM-BISが暗黙的に連携するシステムパラメータの値を利用できるように、システムパラメータのキー名に基づいて定義します。暗黙的に連携するシステムパラメータの詳細は「 IM-BIS 仕様書 」-「 暗黙的に連携するリクエストパラメータの仕様 」を参照してください。パラメータ名・型
applyInfo <object> imwAuthUserCode <string> imwApplyBaseDate <string> authUserOrgzInfo <object> companyCode <string> orgzCode <string> orgzSetCode <string> formaItemInfo <object[]> textbox2 <string> number3 <double> calendar4 <date> textarea5 <string> 出力値
概要
処理結果メッセージ ImfrSoaResult を出力値として定義します。処理結果メッセージの詳細は「 IM-BIS 仕様書 」-「 暗黙的に連携するレスポンスパラメータの仕様 」を参照してください。パラメータ名・型
imfrSoaResult <object> imfrErrorFlag <boolean> imfrMessage <string[]> 上記の内容に基づく入出力設定の内容は以下のとおりです。
5.4.13.2.6.2. エレメントを配置する / シーケンスを定義する¶
フローに必要なエレメントを配置し、実際の処理を定義します。今回作成するロジックフローは、以下の図のように配置したエレメントで構成しています。
記号 説明 A 入力画面のテーブルの行数分の回数の処理を実行させるためのループを定義しています。 B 入力画面の金額に基づく分岐条件を定義しています。 C ワークフロー設定情報(高度な設定) workflowAdvancedSettingInfo のうち、以下の設定を定義しています。各設定内容の詳細は「 IM-LogicDesigner仕様書 」-「 IM-BISタスク・申請 」を参照してください。
- 分岐先選択情報 branchSelectInfo
- 動的承認ノード設定情報 branchSelectInfo - 処理対象設定(プラグイン情報) processTargetConfigs
- 横配置ノード設定情報 horizontalNodeConfigInfo - 案件ノード展開情報 matterNodeExpansions
D ユーザ定義(BIS申請/承認)を定義しています。 E 処理結果として出力するメッセージの内容を定義しています。 F 処理結果として呼び出し元に返却する返却値を定義しています。本チュートリアルでは、呼び出し元の画面にメッセージを表示するための imfrSoaResult を定義します。以降の手順でエレメントを配置していきます。エレメントの配置方法の詳細は エレメントを配置する を参照してください。
パレット内「基本」から以下のエレメントをそれぞれクリックして追加してください。名前の横に数字がある場合は、その数字の個数分追加してください。これらは、エレメントの構成で示した図のA、B、Eに該当します。図を参考に追加したエレメントを適切な位置に配置してください。上記の内容に基づいた現時点のエレメントの配置は以下のとおりです。 パレット内「チュートリアルユーザカテゴリ」から以下のエレメントをそれぞれクリックして追加してください。名前の横に数字がある場合は、その数字の個数分追加してください。これらは、エレメントの構成で示した図のC、Dに該当します。図を参考に追加したエレメントを適切な位置に配置してください。上記の内容に基づいた現時点のエレメントの配置は以下のとおりです。以上で、ロジックフローへのエレメントの配置が完了しました。配置したエレメントに対し、 線を引く(シーケンスを定義する) の手順に基づいて、最初に示した図のとおりにエレメントを接続してください。シーケンスの定義まで完了している状態は以下のとおりです。
5.4.13.2.6.3. プロパティを設定する¶
配置したエレメントのプロパティを設定します。はじめに、「繰り返し開始」タスクのプロパティを設定します。続いて、「分岐」制御要素のプロパティを設定します。2つの分岐のうち、ユーザ定義[BIS申請/承認-申請]ルール1に接続する分岐条件を「10,000円未満の場合に実行」とするように設定します。
フロー編集画面上の「分岐」タスクをクリックします。
タスク固有設定の「条件式(EL式)」の「編集」をクリックします。
im_startLoop1<object> (繰り返し開始タスクのタスクID) - item - number3 をダブルクリックします。式に ${ im_startLoop1.item.number3 } と表示されます。続けて、不等号の < をクリックします。
挿入した不等号の次に、比較する値の 10000 を入力します。
設定画面右下の 決定 をクリックし、「分岐」制御要素の条件式の定義を終了します。同様の手順で、もう一方の分岐の条件を「金額が10000円以上かつ50000円以下」と設定します。(先に設定した分岐の条件で「10000円以上であること」は設定されているため、「50000円以下であること」のみを条件に定義します。)以上で、プロパティ設定が全て完了しました。続いて、ロジックフロー内で利用する定数値・変数を定義します。
5.4.13.2.6.4. 定数値・変数を設定する¶
定数では、ユーザ定義(BIS申請/承認)の実行に必要な情報のうち、フローIDやノードIDなどの固定の値を定義します。チュートリアルでは、そのほかに処理結果メッセージの固定の文言なども定数に定義していきます。
ロジックフロー定義編集画面上部、ヘッダ内の「定数設定」をクリックします。
「定数を追加」をクリックします。
定数に「フローID」を登録するために、追加された行には以下のとおりに入力します。
同様の手順で、以下の定数についても定義します。
パラメータ名(定数ID) 定数値 説明 additionalMessage 件目の案件番号: 処理結果メッセージの固定メッセージ部分を指定します。 branchEndNodeId branch_end 1番目の分岐先のIDを指定します。 branchStartNodeId branch_start 分岐開始ノードのIDを指定します。 dynamicApprovalNodeId dynamic_approve 2番目の分岐先のIDを指定します。 horizontalNodeId horizontal 3番目の分岐先のIDを指定します。 matterName 一括申請案件 一括申請時の案件名を指定します。 originalDateFormat yyyy/MM/dd 申請基準日向け日付フォーマットです。 resultFalse false エラーフラグにfalse(正常)をセットします。 上記の内容に基づく定数設定の内容は以下のとおりです。変数では、出力値に設定している処理結果メッセージを格納する変数を定義します。以上で、変数の定義が完了しました。
5.4.13.2.6.5. マッピング設定を行う¶
マッピングは、各エレメントのプロパティ画面からマッピング設定画面を開いて行います。ここまで作成したロジックフローでマッピング設定が必要なエレメントは以下のとおりです。本チュートリアルでは、以下のエレメントへのマッピングの設定を例に説明します。はじめに、分岐のエレメントに接続しているユーザ定義(JavaScript)のマッピング設定を行います。このユーザ定義では、後続の処理に関するノード情報を入力値に渡すと、ユーザ定義(BIS申請/承認)の申請情報 applyInfo 、ワークフロー設定情報(高度な設定) workflowAdvancedSettingInfo を返却するように実装しています。
A. Branch Destination (分岐先ノード情報)
- Branch Destination Node ID (分岐先ノードID)
分岐開始ノードの次の遷移先を指定します。 B. Following Node Information (後続のノード情報)
- Dynamic Approval Node ID (動的承認ノードID)
- Arrange Horizontally Approval Node ID (横配置ノードID)
分岐開始ノードに接続している後続のノードに関する情報です。 分岐ルート別の設定内容は以下のとおりです。
ユーザ定義[BIS申請/承認-申請]ルール1 (ユーザ定義(JavaScript))
「分岐終了ノード」に遷移するルートです。
入力(始点) 出力(終点) 定数<object> - branchEndNodeId<string> tutorial_ud_bis_apply_rule_11<object> - branchEndId<string> 定数<object> - branchStartNodeId<string> tutorial_ud_bis_apply_rule_11<object> - branchStartId<string> 定数<object> - dynamicApprovalNodeId<string> tutorial_ud_bis_apply_rule_11<object> - dynamicApprovalNodeId<string> 定数<object> - horizontalNodeId<string> tutorial_ud_bis_apply_rule_11<object> - horizontalNodeId<string> ユーザ定義[BIS申請/承認-申請]ルール2 (ユーザ定義(JavaScript))
「動的承認ノード」に遷移するルートです。
入力(始点) 出力(終点) 定数<object> - branchStartNodeId<string> tutorial_ud_bis_apply_rule_21<object> - branchStartId<string> 定数<object> - dynamicApprovalNodeId<string> tutorial_ud_bis_apply_rule_21<object> - dynamicApprovalNodeId<string> 定数<object> - horizontalNodeId<string> tutorial_ud_bis_apply_rule_21<object> - horizontalNodeId<string> ユーザ定義[BIS申請/承認-申請]ルール3 (ユーザ定義(JavaScript))
「横配置ノード」に遷移するルートです。
入力(始点) 出力(終点) 定数<object> - branchStartNodeId<string> tutorial_ud_bis_apply_rule_31<object> - branchStartId<string> 定数<object> - dynamicApprovalNodeId<string> tutorial_ud_bis_apply_rule_31<object> - dynamicApprovalNodeId<string> 定数<object> - horizontalNodeId<string> tutorial_ud_bis_apply_rule_31<object> - horizontalNodeId<string> 設定内容をもとに、マッピング設定画面で実際に設定を行います。要素同士を直接接続する方法については、 マッピング設定を行う を参照してください。
2番目の「分岐」制御要素の then のルートに接続している「ユーザ定義[BIS申請/承認-申請]ルール2」タスクのマッピング設定画面を開きます。
設定画面左部、「定数<object>」要素の下にある「 branchStartNodeId<string> 」から出ている端子にカーソルをあわせます。
そのままドラッグし、設定画面右部、「tutorial_ud_bis_apply_rule_21<object>」要素の下にある「 branchStartId<string> 」から出ている端子にドロップします。
これにより、分岐開始ノードの情報がマッピングされました。
同様に、動的承認ノード・横配置ノードの情報をマッピングします。
動的承認ノードの情報のマッピング
横配置ノードの情報のマッピング
これで、「ユーザ定義[BIS申請/承認-申請]ルール2」に対するマッピングが設定できました。「ユーザ定義[BIS申請/承認-申請]ルール1」、「ユーザ定義[BIS申請/承認-申請]ルール3」についても、同様に「定数<object>」要素の下から対応する項目同士をマッピングします。続いて、「ユーザ定義[BIS申請/承認-申請]」タスクのマッピングを行います。設定内容は以下のとおりです。
ユーザ定義[BIS申請/承認-申請]
「ユーザ定義[BIS申請/承認-申請]」については、基本的に同じマッピングの設定を行います。金額によって分岐先や次の処理対象者が異なるため、該当の処理に関連する部分の接続が異なる点に注意してください。
- 金額が10000円未満に合致するルートの場合
入力(始点) 出力(終点) 入力<object> - applyInfo<object> - imwAuthUserCode<string> tutorial_ud_bis_apply1<object> - applyInfo<object> - applyAuthUserCode<string> 入力<object> - applyInfo<object> - imwApplyBaseDate<string>定数<object> - originalDateFormat<string>( parse 関数を利用)tutorial_ud_bis_apply1<object> - applyInfo<object> - applyBaseDate<date> 入力<object> - applyInfo<object> - authUserOrgzInfo<object> tutorial_ud_bis_apply1<object> - applyInfo<object> - authUserOrgzInfo<object> 定数<object> - flowId<string> tutorial_ud_bis_apply1<object> - applyInfo<object> - flowId<string> 定数<object> - matterName<string> tutorial_ud_bis_apply1<object> - applyInfo<object> - matterName<string> tutorial_ud_bis_apply_rule_11<object> tutorial_ud_bis_apply1<object> - workflowAdvancedSettingInfo<object> im_startLoop1<object> - item<object> tutorial_ud_bis_apply1<object> - formaItemInfo<object>
- 金額が10000円以上かつ50000円以下に合致するルートの場合
入力(始点) 出力(終点) 入力<object> - applyInfo<object> - imwAuthUserCode<string> tutorial_ud_bis_apply2<object> - applyInfo<object> - applyAuthUserCode<string> 入力<object> - applyInfo<object> - imwApplyBaseDate<string>定数<object> - originalDateFormat<string>( parse 関数を利用)tutorial_ud_bis_apply2<object> - applyInfo<object> - applyBaseDate<date> 入力<object> - applyInfo<object> - authUserOrgzInfo<object> tutorial_ud_bis_apply2<object> - applyInfo<object> - authUserOrgzInfo<object> 定数<object> - flowId<string> tutorial_ud_bis_apply2<object> - applyInfo<object> - flowId<string> 定数<object> - matterName<string> tutorial_ud_bis_apply2<object> - applyInfo<object> - matterName<string> tutorial_ud_bis_apply_rule_21<object> tutorial_ud_bis_apply2<object> - workflowAdvancedSettingInfo<object> im_startLoop1<object> - item<object> tutorial_ud_bis_apply2<object> - formaItemInfo<object>
- 金額が50000円超に合致するルートの場合
入力(始点) 出力(終点) 入力<object> - applyInfo<object> - imwAuthUserCode<string> tutorial_ud_bis_apply3<object> - applyInfo<object> - applyAuthUserCode<string> 入力<object> - applyInfo<object> - imwApplyBaseDate<string>定数<object> - originalDateFormat<string>( parse 関数を利用)tutorial_ud_bis_apply3<object> - applyInfo<object> - applyBaseDate<date> 入力<object> - applyInfo<object> - authUserOrgzInfo<object> tutorial_ud_bis_apply3<object> - applyInfo<object> - authUserOrgzInfo<object> 定数<object> - flowId<string> tutorial_ud_bis_apply3<object> - applyInfo<object> - flowId<string> 定数<object> - matterName<string> tutorial_ud_bis_apply3<object> - applyInfo<object> - matterName<string> tutorial_ud_bis_apply_rule_31<object> tutorial_ud_bis_apply3<object> - workflowAdvancedSettingInfo<object> im_startLoop1<object> - item<object> tutorial_ud_bis_apply3<object> - formaItemInfo<object> 実際に「ユーザ定義[BIS申請/承認-申請]」タスクのマッピングを設定します。
中央のルート上の「ユーザ定義[BIS申請/承認-申請]」タスクのマッピング設定画面を開きます。
設定画面左部、「入力<object>」-「applyInfo<object>」要素の下にある「 imwAuthUserCode<string> 」から出ている端子にカーソルをあわせます。
そのままドラッグし、設定画面右部、「tutorial_ud_bis_apply2<object>」-「applyInfo<object>」要素の下にある「 applyAuthUserCode<string> 」から出ている端子にドロップします。
これにより、フロー実行時の申請者情報と、 BIS申請/承認の申請権限者を表す情報がマッピングされました。
「入力<object>」-「applyInfo<object>」要素の下にある「 authUserOrgzInfo<object> 」と「tutorial_ud_bis_apply2<object>」-「applyInfo<object>」要素の下にある「 authUserOrgzInfo<object> 」(権限者所属組織情報)をマッピングします。
同様の手順で、設定情報に基づいた以下の要素をマッピングします。
定数<object> - flowId<string>- tutorial_ud_bis_apply2<object> - applyInfo<object> - flowId<string> 定数<object> - matterName<string>- tutorial_ud_bis_apply2<object> - applyInfo<object> - matterName<string>続いて、関数による日付フォーマットの変換を行いながら「ユーザ定義[BIS申請/承認-申請]」タスクの申請基準日の設定方法を説明します。
マッピング設定画面上部、ヘッダ内の中央右寄りに位置するセレクトボックスをクリックし、以下の項目を選択します。
セレクトボックスの中身が変更されたことを確認し、右側にある「関数を追加」をクリックします。
マッピング関数として、「parse」関数が追加されました。
設定画面左部、「入力<object>」-「applyInfo<object>」要素の下にある「 imwApplyBaseDate<string> 」から出ている端子をドラッグし、「parse」関数の左部から出ている端子のうち「 value 」へドロップします。
同様に、「定数<object>」要素の下にある「 originalDateFormat<string> 」から出ている端子をドラッグし、「parse」関数の左部から出ている端子のうち「 format 」へドロップします。
「parse」関数の右部から出ている端子「 out 」をドラッグし、設定画面右部、「applyBaseDate<date>」から出ている端子にドロップします。
これにより、マッピング関数を利用して、日付フォーマットを変換した値がマッピングされました。
続いて、「ユーザ定義[BIS申請/承認-申請]」タスクのワークフロー設定情報(高度な設定)の設定方法を説明します。
マッピング設定画面上部、ヘッダ内の左側に位置するセレクトボックスをクリックし、以下の項目を選択します。
セレクトボックスの中身が変更されたことを確認し、右側にある「入力を追加」をクリックします。
入力値として、「ユーザ定義[BIS申請/承認-申請]ルール2」タスク(tutorial_ud_bis_apply_rule_21<object>)の出力値が追加されました。
設定画面左部、追加した「tutorial_ud_bis_apply_rule_21<object>」から出ている端子をドラッグし、設定画面右部、「workflowAdvancedSettingInfo<object>」から出ている端子にドロップします。
これにより、ワークフロー実行情報のマッピングが設定できました。
続いて、「ユーザ定義[BIS申請/承認-申請]」タスクの画面アイテム入力情報の設定方法を説明します。
マッピング設定画面上部、ヘッダ内の左側に位置するセレクトボックスをクリックし、以下の項目を選択します。
セレクトボックスの中身が変更されたことを確認し、右側にある「入力を追加」をクリックします。
入力値として、「繰り返し開始」制御要素(im_startLoop1<object>)の出力値が追加されました。
設定画面左部、追加した「im_startLoop1<object>」要素の下にある「item<object>」から出ている端子をドラッグし、設定画面右部、「formaItemInfo<object>」から出ている端子にドロップします。
これにより、繰り返し対象のグリッドテーブルのレコード(行)を1つの申請情報に設定するためのマッピングが設定できました。
ここまでの手順で、「ユーザ定義[BIS申請/承認-申請]」タスクに必要なマッピングが設定できました。設定画面右下の決定をクリックし、「ユーザ定義[BIS申請/承認-申請]」タスクのマッピング設定を終了します。同様の手順で、残り2つの「ユーザ定義[BIS申請/承認-申請]」タスクのマッピングを設定します。マッピングはほぼ同じですが、ワークフロー設定情報(高度な設定)に接続するユーザ定義が異なる点のみ注意してください。ここまでのマッピングにより、ワークフローの申請を実行できますが、ユーザに正常に処理が行われたことを伝えるためのメッセージを以下のように表示するためのメッセージを「変数操作」制御要素で設定します。以下のようにメッセージを画面に表示するための設定を行います。
記号 説明 A 「繰り返し」制御要素の出力値を利用し、申請を実行した案件の順番を表示します。 B 「定数」を利用し、固定のメッセージを表示します。 C ユーザ定義「BIS申請/承認-申請」の出力値を利用し、申請を行った案件の案件番号を表示します。 分岐ルート別の設定内容は以下のとおりです。
変数操作 (左のルート)
入力(始点) 出力(終点) im_startLoop1<object> - index<integer>定数<object> - additionalMessage<string> concat (1) - aconcat (1) - b concat (1) - outtutorial_ud_bis_apply1<object> - matterNumber<string> concat (2) - aconcat (2) - b 変数<object> - msg<string[]>concat (2) - out push - arraypush - valuepush - out 変数<object> - msg<string[]> 変数操作 (中央のルート)
入力(始点) 出力(終点) im_startLoop1<object> - index<integer>定数<object> - additionalMessage<string> concat (1) - aconcat (1) - b concat (1) - outtutorial_ud_bis_apply2<object> - matterNumber<string> concat (2) - aconcat (2) - b 変数<object> - msg<string[]>concat (2) - out push - arraypush - valuepush - out 変数<object> - msg<string[]> 変数操作 (右のルート)
入力(始点) 出力(終点) im_startLoop1<object> - index<integer>定数<object> - additionalMessage<string> concat (1) - aconcat (1) - b concat (1) - outtutorial_ud_bis_apply3<object> - matterNumber<string> concat (2) - aconcat (2) - b 変数<object> - msg<string[]>concat (2) - out push - arraypush - valuepush - out 変数<object> - msg<string[]> 実際に「変数操作」制御要素のマッピングを設定します。
中央のルート上の「変数操作」制御要素をクリックします。
ラベルを「結果メッセージの編集(分岐2)」に変更します。
「マッピング設定」をクリックします。
マッピング設定画面上部、ヘッダ内の左側に位置するセレクトボックスをクリックし、以下の項目を選択します。
セレクトボックスの中身が変更されたことを確認し、右側にある「入力を追加」をクリックします。
入力値として、「繰り返し開始」制御要素(im_startLoop1<object>)の出力値が追加されました。
マッピング設定画面上部、ヘッダ内の中央右寄りに位置するセレクトボックスをクリックし、以下の項目を選択します。
セレクトボックスの中身が変更されたことを確認し、右側にある「関数を追加」をクリックします。
マッピング関数として、「concat」関数が追加されました。
設定画面左部、「im_startLoop1<object>」要素の下にある「 index<integer> 」から出ている端子をドラッグし、「concat」関数の左部から出ている端子のうち「 a 」へドロップします。
同様に、「定数<object>」要素の下にある「 additionalMessage<string> 」から出ている端子をドラッグし、「concat」関数の左部から出ている端子のうち「 b 」へドロップします。
マッピング設定画面上部、ヘッダ内の中央右寄りに位置するセレクトボックスをクリックし、以下の項目を選択します。
セレクトボックスの中身が変更されたことを確認し、右側にある「関数を追加」をクリックします。
マッピング関数として、「concat」関数が追加されました。
先に配置した関数「 concat 」から出ている端子をドラッグし、後に配置した関数「concat」の左部から出ている端子のうち「 a 」へドロップします。
マッピング設定画面上部、ヘッダ内の左側に位置するセレクトボックスをクリックし、以下の項目を選択します。
セレクトボックスの中身が変更されたことを確認し、右側にある「入力を追加」をクリックします。
入力値として、「ユーザ定義[BIS申請/承認-申請]」タスク(tutorial_ud_bis_apply2<object>)の出力値が追加されました。
設定画面左部、「tutorial_ud_bis_apply2<object>」要素の下にある「 matterNumber<string> 」から出ている端子をドラッグし、「concat」関数の左部から出ている端子のうち「 b 」へドロップします。
マッピング設定画面上部、ヘッダ内の中央右寄りに位置するセレクトボックスをクリックし、以下の項目を選択します。
セレクトボックスの中身が変更されたことを確認し、右側にある「関数を追加」をクリックします。
マッピング関数として、「push」関数が追加されました。
「変数<object>」要素の下にある「 msg<string[]> 」から出ている端子をドラッグし、「push」関数の左部から出ている端子のうち「 array 」へドロップします。
後に配置した関数「 concat 」から出ている端子をドラッグし、関数「push」の左部から出ている端子のうち「 value 」へドロップします。
関数「 push 」から出ている端子をドラッグし、設定画面右部、「変数<object>」要素の下にある「msg<string[]>」から出ている端子にドロップします。
ここまでの手順で、「変数操作」制御要素を利用したメッセージの編集に必要なマッピングが設定できました。設定画面右下の決定をクリックし、「変数操作」制御要素のマッピング設定を終了します。残りの左のルートと右のルート上の「変数操作」制御要素に対し、同様の手順でマッピングを設定します。このマッピングでは、案件番号の参照元のエイリアスがそれぞれ異なっている点に注意してください。最後に「終了」制御要素で、編集したメッセージを出力値にマッピングします。
「終了」制御要素のマッピング設定画面を開きます。
設定画面左部、「変数<object>」要素の下にある「 msg<string[]> 」から出ている端子をドラッグし、設定画面右部、「 imfrMessage<string[]> 」から出ている端子にドロップします。
設定画面左部、「定数<object>」要素の下にある「 resultFalse<string> 」から出ている端子をドラッグし、設定画面右部、「 imfrErrorFlag<boolean> 」から出ている端子にドロップします。
ここまでの手順で、「終了」制御要素を利用したメッセージの編集に必要なマッピングが設定できました。設定画面右下の 決定 をクリックし、「終了」制御要素のマッピング設定を終了します。
5.4.13.2.7. BISのアクションイベントを設定する¶
5.4.13.2.7.1. データソース定義を登録する¶
作成したロジックフローをデータソース定義(LogicDesigner)に登録します。データソース定義の登録手順の詳細は「 IM-BIS システム管理者操作ガイド 」-「 データソース定義を設定する 」を参照してください。
以下は設定例です。
5.4.13.2.7.2. アクションイベントに外部連携を設定する¶
登録したデータソース定義を利用して、BISの画面上のボタンがクリックされたタイミングでロジックフローによる申請が実行されるように設定します。
以下のBIS定義のフロー編集画面を開きます。
- BISフロー - LDチュートリアル:一括申請
「申請/処理開始」をダブルクリックして、フォーム編集画面を開きます。
画面右上の「アクション設定」をクリックします。
「アイテムイベント」タブに切り替えます。
「+追加」をクリックして、1行追加します。
以下のとおりに入力し、「設定」をクリックして「アクション設定」を開きます。
「+追加」をクリックして、1行追加します。
以下のとおりに入力し、「設定」をクリックして「データマッパー」画面を開きます。
右の「検索」をクリックして「データソース選択」画面を開きます。
データソース選択から登録したLogicDesignerのデータソース定義をクリックします。
左の欄から 所属組織|departmentCd4_c をクリックします。
右の欄の「LDチュートリアル-BIS申請」配下の companyCode をクリックします。
「追加」をクリックしてマッピングを追加します。
会社コードのマッピングが設定できました。
同様にして、以下のマッピングを追加してください。
左の欄(画面の項目) 右の欄(データソース定義の項目) 所属組織|departmentCd4_s authUserOrgzInfo - orgzSetCode 所属組織|departmentCd4 authUserOrgzInfo - orgzCode 品名|gt1_textbox1 formaItemInfo - OBJECT - textbox2 金額|gt1_number2 formaItemInfo - OBJECT - number3 購入予定日|gt1_calendar1 formaItemInfo - OBJECT - calendar4 備考|gt1_textbox4 formaItemInfo - OBJECT - textarea5 コラム
以下の項目については、暗黙的に連携されるため、明示的にマッピングする必要はありません。
データソース定義「LDチュートリアル-BIS申請」配下
「リクエスト」タブ
- imwAuthUserCode
- imwApplyBaseDate
「レスポンス」タブ
- imfrSoaResult 配下全て
暗黙的に連携するパラメータの詳細は、以下のドキュメントを参照してください
- 「 IM-BIS 仕様書 」-「 暗黙的に連携するリクエストパラメータの仕様 」、「 暗黙的に連携するレスポンスパラメータの仕様 」
必要なマッピングが設定できたら「保存」をクリック後、右上の×から「データマッパー」画面を閉じます。
「アクション設定」で「確定」をクリックします。
「イベント設定」で「確定」をクリックします。
「フォーム編集」画面の「更新」をクリックして保存します。保存後はフォーム編集の画面を閉じてください。 最後に「定義の反映」をクリックすると、作成したロジックフローの設定が完了します。ロジックフローを実行して確認するには、「IM-BIS」配下の「申請一覧」から「LDチュートリアル:一括申請」を表示してください。