IM-BIS for Accel Platform IM-BIS 仕様書 第4版 2016-08-01

14. クライアントサイドスクリプトAPI

クライアントサイドスクリプトAPIを利用した画面アイテムの値操作について説明します。

14.1. 画面アイテムから値を取得するAPI

14.1.1. PC版

  • API一覧
アイテム名 API
文字列 formaItems.product_72_textbox.getItemData.%フィールド識別ID%
複数行文字列 formaItems.product_72_textarea.getItemData.%フィールド識別ID%
数値 formaItems.product_72_number.getItemData.%フィールド識別ID%
日付 formaItems.product_72_calendar.getItemData.%フィールド識別ID%
期間 formaItems.product_72_terms.getItemData.%フィールド識別ID%
一覧選択 formaItems.product_80_itemSelect.getItemData.%フィールド識別ID%
明細テーブル formaItems.product_80_table.getItemData.%フィールド識別ID%
チェックボックス formaItems.product_80_checkbox.getItemData.%フィールド識別ID%
ラジオボタン formaItems.product_80_radio.getItemData.%フィールド識別ID%
セレクトボックス formaItems.product_80_selectbox.getItemData.%フィールド識別ID%
リストボックス formaItems.product_80_listbox.getItemData.%フィールド識別ID%
グリッドテーブル formaItems.product_80_gridtable.getItemData.%フィールド識別ID%
ユーザ選択 formaItems.product_72_userSelect.getItemData.%フィールド識別ID%
組織選択(組織コード)
    (会社コード)
    (組織セットコード)
formaItems.product_72_departmentSelect.getItemData.%フィールド識別ID%
formaItems.product_72_departmentSelect.getItemData.%フィールド識別ID%_c
formaItems.product_72_departmentSelect.getItemData.%フィールド識別ID%_s
組織・役職選択(役職コード)
       (会社コード)
       (組織セットコード)
       (組織コード)
formaItems.product_72_departmentPostSelect.getItemData.%フィールド識別ID%
formaItems.product_72_departmentPostSelect.getItemData.%フィールド識別ID%_c
formaItems.product_72_departmentPostSelect.getItemData.%フィールド識別ID%_s
formaItems.product_72_departmentPostSelect.getItemData.%フィールド識別ID%_d
所属組織選択(組織コード)
      (会社コード)
      (組織セットコード)
formaItems.product_72_affiliationSelect.getItemData.%フィールド識別ID%
formaItems.product_72_affiliationSelect.getItemData.%フィールド識別ID%_c
formaItems.product_72_affiliationSelect.getItemData.%フィールド識別ID%_s
隠しパラメータ formaItems.product_72_hidden.getItemData.%フィールド識別ID%
一覧選択(互換用) formaItems.product_72_itemSelect.getItemData.%フィールド識別ID%
明細テーブル(互換用) formaItems.product_72_table.getItemData.%フィールド識別ID%
チェックボックス(互換用) formaItems.product_72_checkbox.getItemData.%フィールド識別ID%
ラジオボタン(互換用) formaItems.product_72_radio.getItemData.%フィールド識別ID%
セレクトボックス(互換用) formaItems.product_72_selectbox.getItemData.%フィールド識別ID%
リストボックス(互換用) formaItems.product_72_listbox.getItemData.%フィールド識別ID%
  • サンプルコード

    • 文字列 入力値の取得
    1
    2
    3
    4
    (function($){
        var result = formaItems.product_72_textbox.getItemData.%フィールド識別ID%();
        alert(result);
    })(jQuery);
    
    • リストボックス・チェックボックス 入力値の取得
    1
    2
    3
    4
    5
    6
    7
    (function($){
        var result = formaItems.product_80_listbox.getItemData.%フィールド識別ID%();
        var valueArray = result.split( ',' );
        for(var i=0; i<valueArray.length; i++){
            alert(valueArray[i]);
        }
    })(jQuery);
    
    • グリッドテーブル・明細テーブル 全行取得
    1
    2
    3
    4
    5
    6
    7
    8
    (function($){
        var rowId = "";
        var inputIdList = [];
        var result = formaItems.product_80_gridtable.getItemData.%テーブル識別ID%(rowId, inputIdList);
        for(var i=0; i<result.length; i++){
            alert(result[i].%フィールド識別ID%);
        }
    })(jQuery);
    
    • グリッドテーブル・明細テーブル 特定行取得
    1
    2
    3
    4
    5
    6
    7
    8
    (function($){
        var rowId = 行数;
        var inputIdList = [];
        inputIdList[0] = "%フィールド識別ID";
        var result = formaItems.product_80_gridtable.getItemData.%テーブル識別ID%(rowId, inputIdList);
        alert(result[0].%フィールド識別ID%);
        }
    })(jQuery);
    

14.1.2. スマートフォン版

  • API一覧
アイテム名 API
文字列 formaItems.product_72_textbox.getItemDataSp(Object arg)
複数行文字列 formaItems.product_72_textarea.getItemDataSp(Object arg)
数値 formaItems.product_72_number.getItemDataSp(Object arg)
日付 formaItems.product_72_calendar.getItemDataSp(Object arg)
期間 formaItems.product_72_terms.getItemDataSp(Object arg)
明細テーブル formaItems.product_80_table.getItemDataSp(Object arg)
チェックボックス formaItems.product_80_checkbox.getItemDataSp(Object arg)
ラジオボタン formaItems.product_80_radio.getItemDataSp(Object arg)
セレクトボックス formaItems.product_80_selectbox.getItemDataSp(Object arg)
リストボックス formaItems.product_80_listbox.getItemDataSp(Object arg)
グリッドテーブル formaItems.product_80_gridtable.getItemDataSp(Object arg)
ユーザ選択 formaItems.product_72_userSelect.getItemDataSp(Object arg)
組織選択
formaItems.product_72_departmentSelect.getItemDataSp(Object arg)
組織・役職選択
formaItems.product_72_departmentPostSelect.getItemDataSp(Object arg)
所属組織選択
formaItems.product_72_affiliationSelect.getItemDataSp(Object arg)
隠しパラメータ formaItems.product_72_hidden.getItemDataSp(Object arg)
一覧選択(互換用) formaItems.product_72_itemSelect.getItemDataSp(Object arg)
チェックボックス(互換用) formaItems.product_72_checkbox.getItemDataSp(Object arg)
ラジオボタン(互換用) formaItems.product_72_radio.getItemDataSp(Object arg)
セレクトボックス(互換用) formaItems.product_72_selectbox.getItemDataSp(Object arg)
リストボックス(互換用) formaItems.product_72_listbox.getItemDataSp(Object arg)
  • サンプルコード

    引数のargは、下記の構造のオブジェクトで指定します。
    • 文字列 入力値の取得

      1
      2
      3
      4
      5
      6
      (function($){
          var args = {};
          args.input_id = "%フィールド識別ID%";
          var result = formaItems.product_72_textbox.getItemDataSp(args);
          alert(result);
      })(jQuery);
      
    • リストボックス・チェックボックス 入力値の取得

      1
      2
      3
      4
      5
      6
      7
      8
      9
      (function($){
          var args = {};
          args.input_id = "%フィールド識別ID%";
          var result = formaItems.product_80_listbox.getItemDataSp(args);
          var valueArray = result.split( ',' );
          for(var i=0; i<valueArray.length; i++){
              alert(valueArray[i]);
          }
      })(jQuery);
      
    • グリッドテーブル・明細テーブル 全行の取得

       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      11
      (function($){
          var args = {};
          args.tableId = "%テーブル識別ID%";
          args.rowId = "";
          args.inputIdList = [];
          args.inputIdList[0] = "%フィールド識別ID%";
          var result = formaItems.product_80_gridtable.getItemDataSp(args);
          for(var i=0; i<result.length; i++){
              alert(result[i].%フィールド識別ID%);
          }
      })(jQuery);
      
    • グリッドテーブル・明細テーブル 特定行の取得

      1
      2
      3
      4
      5
      6
      7
      8
      9
      (function($){
          var args = {};
          args.tableId = "%テーブル識別ID%";
          args.rowId = 行数;
          args.inputIdList = [];
          args.inputIdList[0] = "%フィールド識別ID%";
          var result = formaItems.product_80_gridtable.getItemDataSp(args);
          alert(result[0].%フィールド識別ID%);
      })(jQuery);
      

14.2. 画面アイテムに値を反映するAPI

14.2.1. PC版

  • API一覧
アイテム名 API
文字列 formaItems.product_72_textbox.setItemData.%フィールド識別ID%(Object arg)
複数行文字列 formaItems.product_72_textarea.setItemData.%フィールド識別ID%(Object arg)
数値 formaItems.product_72_number.setItemData.%フィールド識別ID%(Object arg)
日付 formaItems.product_72_calendar.setItemData.%フィールド識別ID%(Object arg)
期間 formaItems.product_72_terms.setItemData.%フィールド識別ID%(Object arg)
一覧選択 formaItems.product_80_itemSelect.setItemData.%フィールド識別ID%(Object arg)
明細テーブル formaItems.product_80_table.setItemData.%フィールド識別ID%(Object arg)
チェックボックス formaItems.product_80_checkbox.setItemData.%フィールド識別ID%(Object arg)
ラジオボタン formaItems.product_80_radio.setItemData.%フィールド識別ID%(Object arg)
セレクトボックス formaItems.product_80_selectbox.setItemData.%フィールド識別ID%(Object arg)
リストボックス formaItems.product_80_listbox.setItemData.%フィールド識別ID%(Object arg)
グリッドテーブル formaItems.product_80_gridtable.setItemData.%フィールド識別ID%(Object arg)
ユーザ選択 formaItems.product_72_userSelect.setItemData.%フィールド識別ID%(Object arg)
組織選択(組織コード)
    (会社コード)
    (組織セットコード)
formaItems.product_72_departmentSelect.setItemData.%フィールド識別ID%(Object arg)
formaItems.product_72_departmentSelect.setItemData.%フィールド識別ID%_c(Object arg)
formaItems.product_72_departmentSelect.setItemData.%フィールド識別ID%_s(Object arg)
組織・役職選択(役職コード)
       (会社コード)
       (組織セットコード)
       (組織コード)
formaItems.product_72_departmentPostSelect.setItemData.%フィールド識別ID%(Object arg)
formaItems.product_72_departmentPostSelect.setItemData.%フィールド識別ID%_c(Object arg)
formaItems.product_72_departmentPostSelect.setItemData.%フィールド識別ID%_s(Object arg)
formaItems.product_72_departmentPostSelect.setItemData.%フィールド識別ID%_d(Object arg)
所属組織選択(組織コード)
      (会社コード)
      (組織セットコード)
formaItems.product_72_affiliationSelect.setItemData.%フィールド識別ID%(Object arg)
formaItems.product_72_affiliationSelect.setItemData.%フィールド識別ID%_c(Object arg)
formaItems.product_72_affiliationSelect.setItemData.%フィールド識別ID%_s(Object arg)
隠しパラメータ formaItems.product_72_hidden.setItemData.%フィールド識別ID%(Object arg)
一覧選択(互換用) formaItems.product_72_itemSelect.setItemData.%フィールド識別ID%(Object arg)
明細テーブル(互換用) formaItems.product_72_table.setItemData.%フィールド識別ID%(Object arg)
チェックボックス(互換用) formaItems.product_72_checkbox.setItemData.%フィールド識別ID%(Object arg)
ラジオボタン(互換用) formaItems.product_72_radio.setItemData.%フィールド識別ID%(Object arg)
セレクトボックス(互換用) formaItems.product_72_selectbox.setItemData.%フィールド識別ID%(Object arg)
リストボックス(互換用) formaItems.product_72_listbox.setItemData.%フィールド識別ID%(Object arg)
  • サンプルコード

    引数のargは、下記の構造のオブジェクトで指定します。
    入力値は、アイテムのデータ型に合わせて指定します。
    • 文字列 入力値の反映

      1
      2
      3
      4
      5
      6
      (function($){
          var args = {};
          args.data = {};
          args.data.%フィールド識別ID% = "入力値";
          formaItems.product_72_textbox.setItemData.%フィールド識別ID%(args);
      })(jQuery);
      
    • リストボックス・チェックボックス 入力値の反映

      複数要素の場合、カンマ区切りの文字列で指定します。画面では、送信値に一致する行が選択されます。
      1
      2
      3
      4
      5
      6
      (function($){
          var args = {};
          args.data = {};
          args.data.%フィールド識別ID% = "入力値1,入力値2,入力値3";
          formaItems.product_80_listbox.setItemData.%フィールド識別ID%(args);
      })(jQuery);
      
    • グリッドテーブル・明細テーブル 全行の反映

       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      (function($){
          var args = {};
          args.data = {};
          args.data.%テーブル識別ID% = [];
          for(var i=0; i<valueArray.length; i++){
              args.data.%テーブル識別ID%.%フィールド識別ID% = valueArray[i];
          }
          var option = {};
          formaItems.product_80_gridtable.setItemData.%テーブル識別ID%(args, option);
      })(jQuery);
      
    • グリッドテーブル・明細テーブル 特定行の反映

      グリッドテーブルの場合は、削除された行数についても行数の計算にて考慮する必要があります。
       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      (function($){
          var args = {};
          args.data = {};
          args.data.%テーブル識別ID% = [];
          args.data.%テーブル識別ID%[0] = {};
          args.data.%テーブル識別ID%[0].%フィールド識別ID% = "入力値";
          var option = {};
          option.indexKey = 行数;
          formaItems.product_80_gridtable.setItemData.%テーブル識別ID%(args, option);
      })(jQuery);
      

14.2.2. スマートフォン版

  • API一覧
アイテム名 API
文字列 formaItems.product_72_textbox.setItemDataSp(Object arg)
複数行文字列 formaItems.product_72_textarea.setItemDataSp(Object arg)
数値 formaItems.product_72_number.setItemDataSp(Object arg)
日付 formaItems.product_72_calendar.setItemDataSp(Object arg)
期間 formaItems.product_72_terms.setItemDataSp(Object arg)
明細テーブル formaItems.product_80_table.setItemDataSp(Object arg)
チェックボックス formaItems.product_80_checkbox.setItemDataSp(Object arg)
ラジオボタン formaItems.product_80_radio.setItemDataSp(Object arg)
セレクトボックス formaItems.product_80_selectbox.setItemDataSp(Object arg)
リストボックス formaItems.product_80_listbox.setItemDataSp(Object arg)
グリッドテーブル formaItems.product_80_gridtable.setItemDataSp(Object arg)
ユーザ選択 formaItems.product_72_userSelect.setItemDataSp(Object arg)
組織選択 formaItems.product_72_departmentSelect.setItemDataSp(Object arg)
組織・役職選択 formaItems.product_72_departmentPostSelect.setItemDataSp(Object arg)
所属組織選択 formaItems.product_72_affiliationSelect.setItemDataSp(Object arg)
隠しパラメータ formaItems.product_72_hidden.setItemDataSp(Object arg)
一覧選択(互換用) formaItems.product_72_itemSelect.setItemDataSp(Object arg)
チェックボックス(互換用) formaItems.product_72_checkbox.setItemDataSp(Object arg)
ラジオボタン(互換用) formaItems.product_72_radio.setItemDataSp(Object arg)
セレクトボックス(互換用) formaItems.product_72_selectbox.setItemDataSp(Object arg)
リストボックス(互換用) formaItems.product_72_listbox.setItemDataSp(Object arg)
  • サンプルコード

    引数のargは、下記の構造のオブジェクトで指定します。
    入力値は、アイテムのデータ型に合わせて指定します。
    • 文字列 入力値の反映

      1
      2
      3
      4
      5
      6
      7
      (function($){
          var args = {};
          args.input_id = "%フィールド識別ID%";
          args.inputDataList = {};
          args.inputDataList.%フィールド識別ID% = "入力値";
          formaItems.product_72_textbox.setItemDataSp(args);
      })(jQuery);
      
    • リストボックス・チェックボックス 入力値の反映

      複数要素の場合、カンマ区切りの文字列で指定します。画面では、送信値に一致する行が選択されます。
      1
      2
      3
      4
      5
      6
      7
      (function($){
          var args = {};
          args.input_id = "%フィールド識別ID%";
          args.inputDataList = {};
          args.inputDataList.%フィールド識別ID% = "入力値1,入力値2,入力値3";
          formaItems.product_80_listbox.setItemDataSp(args);
      })(jQuery);
      
    • グリッドテーブル・明細テーブル 全行の反映

       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      11
      12
      (function($){
          var args = {};
          args.tableId = "%テーブル識別ID%";  
          args.dataInputId = [];
          args.dataInputId[0] = "%フィールド識別ID%";
          args.inputDataList = [];
          for(var i=0; i<valueArray.length; i++){
              args.inputDataList[i] = {};
              args.inputDataList[i].%フィールド識別ID% = valueArray[i];   
          }
          formaItems.product_80_gridtable.setItemDataSp(args);
      })(jQuery);
      
    • グリッドテーブル・明細テーブル 特定行の反映

      グリッドテーブルの場合は、削除された行数についても行数の計算にて考慮する必要があります。
       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      11
      (function($){
          var args = {};
          args.tableId = "%テーブル識別ID%";  
          args.rowId = 行数;
          args.dataInputId = [];
          args.dataInputId[0] = "%フィールド識別ID%";
          args.inputDataList = [];
          args.inputDataList[0] = {};
          args.inputDataList[0].%フィールド識別ID% = "入力値";
          formaItems.product_80_gridtable.setItemDataSp(args);
      })(jQuery);