7.9. 外部連携を設定する¶
IM-BIS で「外部連携」を利用するためには、アクション設定から登録済みのデータソース定義を利用して、データマッパーの設定を行う必要があります。
Contents
7.9.1. 外部連携とは¶
データマッパーを利用して、画面アイテムとデータソース定義との間で値のやり取りを行うことができる機能です。外部連携を利用すると、データソース定義から取得したデータを画面に表示する、画面に入力した値をデータソース定義（Webサービスなど）に受け渡すといったことができます。
7.9.2. 外部連携を実行できるタイミング¶
外部連携を実行できるタイミングは、以下の通りです。
タスク（ノード）の前処理
対象のタスク（ノード）の画面の表示前に、外部連携を実行します。入力項目の初期値を外部連携を利用して設定したい場合などに利用します。画面イベント（アクション設定）
画面を表示しているときに、特定のアイテムへの操作（イベント）などのタイミングで外部連携を実行します。アクション設定については、 アクション設定 を参照してください。タスク（ノード）の後処理
対象のタスク（ノード）の処理が終わった後に、外部連携を実行します。入力内容を使って、他のシステムに連携する場合などに利用します。画面に入力した値が登録／更新された場合に実行されます。画面に入力した値に登録／更新がなかったタスク（ノード）では実行されません。案件終了処理
案件の終了後に、外部連携を実行します。完了した案件の情報に基づいて、他のテーブルへのデータ登録を行う場合などに利用します。注意
外部連携で設定できる案件終了処理は、 IM-Workflow の案件終了処理（トランザクションなし）で処理されます。そのため、 IM-Workflow の案件終了処理でエラーが発生した場合、ロールバックされません。
7.9.3. 外部連携でマッピングできる画面アイテム¶
外部連携でマッピングできる画面アイテムは、以下の通りです。
- 入力系画面アイテム（ファイルアップロード、リッチテキストボックスを除く）
- 共通マスタ系アイテム
- 隠しパラメータ、採番
7.9.4. 外部連携でマッピング不要で暗黙的に連携するデータ¶
外部連携では、データソース定義に特定のパラメータが設定されている場合、マッピング不要で暗黙的に処理を実施するパラメータがあります。
リクエストパラメータ
リクエストパラメータでは、アプリケーションの内部処理で利用しているシステムパラメータを連携できます。システムパラメータの詳細は、「 IM-BIS 仕様書 」-「 暗黙的に連携するリクエストパラメータの仕様 」を参照してください。レスポンスパラメータ
レスポンスパラメータでは、処理結果メッセージとして、メッセージボックスや入力チェックエラーメッセージを連携できます。処理結果メッセージの詳細は、「 IM-BIS 仕様書 」-「 暗黙的に連携するレスポンスパラメータの仕様 」を参照してください。コラム
マッピング設定・関数ビルダの設定があった場合は、 それらの設定を優先し、暗黙的な連携は行われません。
7.9.5. 外部連携で利用できるデータソースの種類¶
外部連携で利用できるデータソースの種類は、以下の通りです。
- テナントDBクエリ
- シェアードDBクエリ
- REST（非推奨）
- SOAP（非推奨）
- JAVA（非推奨）
- LogicDesigner
- CSVインポート
- CSVエクスポート
- ルール
- テナントDB更新系クエリ
- シェアードDB更新系クエリ
コラム
IM-BIS 2015 Winterより、データソース種別「LogicDesigner」を追加しました。データソース種別「LogicDesigner」は、データソース種別「REST」「SOAP」「JAVA」の機能を補完したもので、今後新規機能の追加は「LogicDesigner」に対してのみ実施されます。そのため、「REST」「SOAP」「JAVA」の利用については非推奨とし、「LogicDesigner」の利用を推奨しています。
7.9.6. 外部連携で取得したデータを画面上のアイテムと関連付ける方法¶
外部連携により取得したデータを画面上のアイテムと連携するためには、システム管理者により対象のデータソース定義が登録されている必要があります。
登録されているデータソース定義と画面上のアイテムを連携する設定は、連携させるタイミングに応じて、以下のいずれかの手順で設定します。
タスク（ノード）の前処理/後処理で外部連携を設定する場合
案件終了処理で外部連携を設定する場合
コラム
案件終了処理は承認・承認終了の処理種別のみ外部連携が実行されます。その他の処理種別で処理を行いたい場合は、IM-Workflowのコンテンツ定義の案件終了処理の利用を検討してください。処理方法については、「 IM-Workflow 管理者操作ガイド 」-「 ユーザプログラム定義の設定を追加する 」を参照してください。画面イベント（アクション設定）で外部連携を設定する場合
- 7.9.6.1. タスク（ノード）の実行前（前処理）・実行後（後処理）のタイミングで外部連携を設定する
- 7.9.6.2. 案件の終了のタイミングで外部連携を設定する
- 7.9.6.3. 画面上の特定のアイテム（入力・選択系アイテム）への操作（イベント）のタイミングで外部連携を設定する
- 7.9.6.4. 画面上の特定のアイテム（明細テーブル・グリッドテーブル）への操作（イベント）のタイミングで外部連携を設定する
- 7.9.6.5. 外部連携の特殊イベントを設定する（一覧選択、CSVインポート・エクスポート）
- 7.9.6.6. データマッパーで複数の画面アイテムやデータソース定義のパラメータ・フィールド、固定値をマッピングする
- 7.9.6.7. 「セレクトボックス」などの画面アイテムに外部連携でマスタデータを設定する
- 7.9.6.8. 画面アイテムのリクエストパラメータに関数を設定する
コラム
各機能の詳細については、「 IM-BIS 仕様書 」も参照してください。