IM-BIS for Accel Platform / 業務管理者 操作ガイド

第5版 2014-04-01

«  ルール定義で分岐条件を設定する   ::   コンテンツ   ::   関数ビルダを利用する  »

IM-BIS で作成したフォームに配置した画面アイテムとデータソース定義を連携する

画面アイテム「一覧選択」や「セレクトボックス」では、データマッパーを利用して設定することでDBクエリ以外の外部連携のデータソースを参照できるようになりました。
ここでは、「一覧選択」の基本的な設定方法と、「セレクトボックス」などの画面アイテムでデータソース定義を参照するための設定方法を手順に沿って説明します。

「一覧選択」にデータソース定義を設定する

一覧選択への外部連携の設定手順は以下の通りです。

一覧画面と選択した値の反映先のマッピングを行う

  1. 「フォーム・デザイナ」画面で「ツールキット」から一覧選択を含む複数の画面アイテムを配置します。

    ../../_images/proc_1_11.png
  2. 画面アイテムのプロパティで「外部連携」をクリックします。

    ../../_images/proc_1_21.png
  3. plus をクリックして列を追加します。

    ../../_images/proc_1_31.png
  4. 追加した列について、「列名」、「列ID」、「タイプ」を設定します。

    ../../_images/proc_1_41.png
  5. 「取得値設定」をクリックします。

    ../../_images/proc_1_51.png
  6. マッピング情報の search をクリックします。

    ../../_images/proc_1_61.png
  7. 左の一覧選択画面の一覧項目から反映したい項目をクリックします。

    ../../_images/proc_1_71.png
  8. 右のフォームの項目一覧から一覧選択の画面アイテムをクリックします。

    ../../_images/proc_1_8.png
  9. 「追加」をクリックしてマッピングします。

    ../../_images/proc_1_9.png
  10. 「保存」をクリックしてマッピングの情報を保存します。

    ../../_images/proc_1_10.png
  11. 保存したら右上の「×」で「データマッパー」画面を閉じます。

    ../../_images/proc_1_111.png

データソース定義と一覧画面のマッピングを行う

  1. 「フォーム・デザイナ」画面で「外部連携」をクリックします。

    ../../_images/proc_2_11.png
  2. 「アイテムイベント」をクリックします。

    ../../_images/proc_2_21.png
  3. 「設定」をクリックします。

    ../../_images/proc_2_51.png
  4. 「追加」をクリックします。

    ../../_images/proc_2_61.png
  5. 「データマッパー」画面の右側の search をクリックします。

    ../../_images/proc_2_71.png
  6. 一覧選択の検索で利用する外部連携のデータソース定義をクリックします。

    ../../_images/proc_2_8.png
  7. データソース定義に受け渡す値がある場合、画面の項目、もしくは固定値をマッピングします。

    ../../_images/proc_2_9.png
  8. 「レスポンス」をクリックします。

    ../../_images/proc_2_10.png
  9. データソース定義からの返却値をクリックします。

    ../../_images/proc_2_111.png
  10. 返却値にマッピングする一覧選択の項目をクリックします。

    ../../_images/proc_2_12.png
  11. 「追加」をクリックします。

    ../../_images/proc_2_13.png
  12. 同様の手順で一覧選択の各項目のマッピングを設定します。

    ../../_images/proc_2_14.png
  13. 「保存」をクリックしてマッピングの情報を保存します。

    ../../_images/proc_2_15.png
  14. 保存したら右上の「×」で「データマッパー」画面を閉じます。

    ../../_images/proc_2_16.png
  15. 「確定」をクリックして外部連携設定を保存します。

    ../../_images/proc_2_17.png
  16. 「確定」をクリックしてイベント設定を保存します。

    ../../_images/proc_2_18.png
  17. これで、「更新」をクリックしてフォームを保存すると、一覧選択を設定した画面アイテムの設定が完了しました。

    ../../_images/proc_2_19.png

    注意

    一覧選択の取得値設定は、原則としてフォーム作成の最後に実施してください。
    フィールド識別IDとデータ型が決定した後でないと、実行処理における整合性が保持できず、動作を保証できません。
    その場合、再度取得値を設定すれば解消することができます。

「セレクトボックス」などの画面アイテムにデータソース定義を設定する

画面アイテム「セレクトボックス」や「リストボックス」などへの外部連携の設定手順は以下の通りです。
  1. 「フォーム・デザイナ」画面で「ツールキット」からセレクトボックスを配置します。

    ../../_images/proc_3_11.png
  2. 「フォーム・デザイナ」画面で「外部連携」をクリックします。

    ../../_images/proc_3_21.png
  3. 「初期表示イベント」で「追加」をクリックします。

    ../../_images/proc_3_31.png
  4. 「データマッパー」画面右側の search をクリックします。

    ../../_images/proc_3_41.png
  5. セレクトボックスに表示する値に利用する外部連携のデータソース定義をクリックします。

    ../../_images/proc_3_5.png
  6. 「レスポンス」をクリックします。

    ../../_images/proc_3_6.png
  7. セレクトボックスの表示値にしたいデータソース定義の項目をクリックします。

    ../../_images/proc_3_7.png
  8. 右側のセレクトボックスのツリーの「key_<セレクトボックスのフィールド識別ID>」をクリックします。

    ../../_images/proc_3_8.png
  9. 「追加」をクリックします。

    ../../_images/proc_3_9.png
  10. セレクトボックスの送信値にしたいデータソース定義の項目をクリックします。

    ../../_images/proc_3_10.png
  11. 右側のセレクトボックスのツリーの「value_<セレクトボックスのフィールド識別ID>」をクリックします。

    ../../_images/proc_3_111.png
  12. 「追加」をクリックします。

    ../../_images/proc_3_12.png
  13. 「保存」をクリックしてマッピングの情報を保存します。

    ../../_images/proc_3_13.png
  14. 保存したら右上の「×」で「データマッパー」画面を閉じます。

    ../../_images/proc_3_14.png
  15. 「確定」をクリックしてイベント設定を保存します。

    ../../_images/proc_3_15.png
  16. 「更新」をクリックしてフォームを保存すると、外部連携のデータソース定義と連携したセレクトボックスの設定が完了します。

    ../../_images/proc_3_16.png

画面アイテムのリクエストパラメータに関数を設定する

外部連携のパラメータやリクエストパラメータに対し、関数を設定する手順は以下の通りです。

コラム

外部連携のパラメータに関数を設定したいときは、以下の2ステップで外部連携を設定する必要があります。
  1. 関数の取得値と取得値を格納するための画面アイテムとのマッピング
  2. 1.の手順で設定した画面アイテムと関数を利用したい外部連携のパラメータとのマッピング

関数で取得した値を画面アイテムに受け渡す

  1. 「フォーム・デザイナ」画面で「ツールキット」から画面アイテム「隠しパラメータ」を配置します。

    ../../_images/proc_4_11.png
  2. 「フォーム・デザイナ」画面で「外部連携」をクリックします。

    ../../_images/proc_4_21.png
  3. 「初期表示イベント」で「追加」をクリックします。

    ../../_images/proc_4_31.png
  4. 「データマッパー」画面の右側の search をクリックします。

    ../../_images/proc_4_4.png
  5. 利用する関数に合致したデータソースをクリックします。

    ../../_images/proc_4_5.png
  6. 「レスポンス」をクリックします。

    ../../_images/proc_4_6.png
  7. 利用する関数に該当する項目をクリックします。

    ../../_images/proc_4_7.png
  8. 右のフォームの項目一覧から隠しパラメータをクリックします。

    ../../_images/proc_4_8.png
  9. 「追加」をクリックします。

    ../../_images/proc_4_9.png
  10. 「保存」をクリックしてマッピングの情報を保存します。

    ../../_images/proc_4_10.png
  11. 保存したら右上の「×」で「データマッパー」画面を閉じます。

    ../../_images/proc_4_111.png
  12. 「確定」をクリックしてイベント設定を保存します。

    ../../_images/proc_4_12.png

関数とマッピングした画面アイテムの値を外部連携で設定した画面アイテムに受け渡す

  1. 「フォーム・デザイナ」画面で「ツールキット」から外部連携で値を設定する画面アイテムを配置します。

    ../../_images/proc_5_11.png
  2. 「フォーム・デザイナ」画面で「外部連携」をクリックします。

    ../../_images/proc_5_21.png
  3. 「初期表示イベント」で「追加」をクリックします。

    ../../_images/proc_5_31.png
  4. 「データマッパー」画面右側の search をクリックします。

    ../../_images/proc_5_4.png
  5. 対象の画面アイテムに表示値・送信値に利用する外部連携のデータソース定義をクリックします。

    ../../_images/proc_5_5.png
  6. 関数の値を保持した画面アイテムをクリックします。

    ../../_images/proc_5_6.png
  7. データソース定義のパラメータ(リクエストパラメータ)をクリックします。

    ../../_images/proc_5_7.png
  8. 「追加」をクリックします。

    ../../_images/proc_5_8.png
  9. 「レスポンス」をクリックします。

    ../../_images/proc_5_9.png
  10. 対象の画面アイテムの表示値にしたいデータソース定義の項目をクリックします。

    ../../_images/proc_5_10.png
  11. 右側の対象の画面アイテムのツリーの「key_<対象の画面アイテムのフィールド識別ID>」をクリックします。

    ../../_images/proc_5_111.png
  12. 「追加」をクリックします。

    ../../_images/proc_5_12.png
  13. 対象の画面アイテムの送信値にしたいデータソース定義の項目をクリックします。

    ../../_images/proc_5_13.png
  14. 右側の対象の画面アイテムのツリーの「value_<対象の画面アイテムのフィールド識別ID>」をクリックします。

    ../../_images/proc_5_14.png
  15. 「追加」をクリックします。

    ../../_images/proc_5_15.png
  16. 「保存」をクリックしてマッピングの情報を保存します。

    ../../_images/proc_5_16.png
  17. 保存したら右上の「×」で「データマッパー」画面を閉じます。

    ../../_images/proc_5_17.png
  18. 最初に設定した関数の外部連携がエラーとなる場合には、後続の外部連携処理が正しく行えないため、画面アイテムに値を設定する連携処理の「前処理エラー時」を「全体中止」に変更します。

    ../../_images/proc_5_18.png
  19. 「確定」をクリックしてイベント設定を保存します。

    ../../_images/proc_5_19.png
  20. これで、「更新」をクリックしてフォームを保存すると、外部連携のデータソース定義と連携した画面アイテムの設定が完了しました。

    ../../_images/proc_5_20.png

«  ルール定義で分岐条件を設定する   ::   コンテンツ   ::   関数ビルダを利用する  »