IM-BIS for Accel Platform IM-BIS デザイナヘルプ 第30版 2023-10-01

一覧選択

画面アイテム「一覧選択」は、データベースから入力値を検索して入力するためのアイテムです。
外部連携の設定を行うことで、一覧選択を実行することができます。

基本設定

ラベル

入力項目の名称などの補助項目として使用します。
ラベルに設定した名称を、入力欄の左に表示します。

表示フォーマット(数値)

数値のフォーマットを指定します。

指定可能なフォーマット

  • 桁区切りなし・小数点ピリオド
    • 2017Summerまでの 表示フォーマットを無効にしたとき と同じ動作です。
  • 3桁カンマ・小数点ピリオド
    • 2017Summerまでの 表示フォーマットを有効にしたとき と同じ動作です。
  • アカウント設定
    • ログインユーザのアカウントコンテキストに基づくフォーマットです。
  • テナント設定
    • テナントのデフォルト設定に基づくフォーマットです。
  • システム設定

コラム

IM-FormaDesigner 2018Summer にて以下の対応が行われました。
これにより、値の変換処理はすべてクライアント側で行われます。

注意

設定によっては、以下の表示フォーマットは値の変換時にサーバへ通信を行います。
使用の際は十分な検証を行ってください。
  • アカウント設定
  • テナント設定
  • システム設定
詳細は「 クライアントサイド JavaScript 」 - 「 ImDecimalFormatter 」 を参照してください。

注意

アイテムのプロパティに指定しているフォーマットを「 設定ファイルリファレンス 」 - 「 数値形式マスタ 」から削除した場合の動作は以下の通りです。
  • フォーム編集画面、実行画面では「桁区切りなし・小数点ピリオド」として動作します。
  • フォーム編集画面で該当アイテムのプロパティダイアログを表示すると画面に警告メッセージを表示します。
  • 実行画面を表示すると該当アイテム分のログ(WARNレベル)を出力します。
表示フォーマットを変更する場合は、一度プロパティを変更してからフォームの更新を行ってください。

入力フォーマット

アイテムに手入力した際に有効な数値として扱われるフォーマットは、表示フォーマットの設定に基づきます。
以下に合致しないフォーマットで入力すると値の欠落が発生する可能性があります。
表示フォーマット 有効な数値として扱われるフォーマット 入力値例
桁区切りなし・小数点ピリオド
  • 桁区切り記号がなく、小数点記号にピリオドを使用している
  • 桁区切り記号にカンマを使用し、小数点記号にピリオドを使用している
  • 123456789.123
  • 123,456,789.123
3桁カンマ・小数点ピリオド
  • 桁区切り記号がなく、小数点記号にピリオドを使用している
  • 桁区切り記号にカンマを使用し、小数点記号にピリオドを使用している
  • 123456789.123
  • 123,456,789.123
アカウント設定
  • 桁区切り記号がなく、小数点記号にアカウントコンテキストに基づく小数点記号を使用している
  • 桁区切り記号および小数点記号にアカウントコンテキストに基づく記号を使用している

アカウントコンテキストの指定フォーマットが「123 456 789,123」の場合の例です。

  • 123456789,123
  • 123 456 789,123
テナント設定
  • 桁区切り記号がなく、小数点記号にテナントのデフォルト設定に基づく小数点記号を使用している
  • 桁区切り記号および小数点記号にテナントのデフォルト設定に基づく記号を使用している

テナントのデフォルト設定の指定フォーマットが「123.456.789,123」の場合の例です。

  • 123456789,123
  • 123.456.789,123
システム設定
  • 桁区切り記号がなく、小数点記号にプロパティに指定したフォーマットに基づく小数点記号を使用している
  • 桁区切り記号および小数点記号にプロパティに指定したフォーマットに基づく記号を使用している

プロパティに指定したフォーマットが「123‘456‘789.123」の場合の例です。

  • 123456789.123
  • 123‘456‘789.123

コラム

クライアントサイドスクリプトAPI において、取得できる値およびパラメータとして指定可能な値のフォーマットは、表示フォーマットの設定に関わらず「桁区切りなし・小数点ピリオド」です。

表示フォーマット(日付)

参照時の入力欄の日付の表示形式を選択します。
指定しない場合は、「日付と時刻の表示形式」で設定した「日付(標準表示)」のフォーマットで表示します。
入力時の日付の表示形式は「個人設定」-「日付と時刻の形式」-「日付(入力)」の設定に基づきます。
詳細は「 一般ユーザ操作ガイド 」-「 日付と時刻の形式を設定する 」を参照してください。

フィールド値入力可

チェックをオンにすると、手入力で入力値を登録できます。

クリアボタン配置

チェックをオンにすると、クリアボタンが配置されます。
アプリケーションの実行時にクリアボタンをクリックすると、入力値をクリアします。

入力チェック

画面アイテムで利用する入力チェックを設定します。

必須入力チェック / [始]必須入力チェック / [終]必須入力チェック

チェックをオンにすると、入力必須項目としてチェックします。

半角英数字のみ

チェックをオンにすると、入力された内容が半角英数字のみとなっているかをチェックします。
入力可能な文字はa-z,A-Z,0-9のいずれかのみで、記号はエラーとして扱います。

最小入力文字数

画面アイテムに指定の文字数以上の文字が入力されているかをチェックします。
項目に入力されていない場合はチェックしません。
スペースは入力されているものとして扱われます。
最大入力文字数と同じ、または最大入力文字数より小さい値を設定してください。

最大入力文字数

画面アイテムに指定の文字数までしか入力できないようにします。
スペースは入力されているものとして扱われます。
最小入力文字数と同じ、または最小入力文字数より大きい値を設定してください。

カスタム入力チェック

入力文字の種類や入力チェック機能をカスタマイズして設定できます。

チェックフォーマット

入力できる文字列のパターンを正規表現で設定します。
設定したパターンに合わない文字列が入力された場合、「エラーメッセージ」に設定したメッセージを表示します。

エラーメッセージ

チェックフォーマットに設定したパターンに合わなかった場合に表示するエラーメッセージを登録します。

最小入力値

入力・計算された値が、指定の値以上となっているかをチェックします。
項目に入力されていない場合はチェックしません。
「負数入力」のチェックがオンの場合には、負数(0より小さい値)を設定することができます。
最大入力値と同じ、または最大入力値より小さい値を設定してください。

最大入力値

入力・計算された値が、指定の値以下となっているかをチェックします。
「負数入力」のチェックがオンの場合には、負数(0より小さい値)を設定することができます。
最小入力値と同じ、または最小入力値より大きい値を設定してください。

負数入力許可(数値)

入力・計算された値に、0未満のマイナスの値を設定してよいかを設定します。
チェックがオフの場合、0未満のマイナスの値が入力されたときにエラーとして扱います。

小数入力許可(数値)

入力・計算された値に、小数の値を設定してよいかを設定します。
チェックがオフの場合、小数の値が入力されたときにエラーとして扱います。

小数部最大入力桁数(数値)

入力・計算された値の小数点以下の桁数を設定します。
(「小数入力許可」のチェックがオンの場合のみ表示する設定項目です。)
ここで設定した桁数は、テーブル設定の対応する列の小数点以下の桁数と一致するように設定してください。

外部連携

データソース名

データソース定義で定義ずみのクエリ一覧から、使用するクエリを選択します。
クエリを選択すると、パラメータ等の設定項目は初期化されます。

一覧選択画面

検索アイコンをクリックした際に表示する選択できる項目一覧のレイアウトを設定します。
  • 画面タイトル

    • 別画面として表示する画面のタイトルを入力します。
  • 簡易検索機能

    • チェックがオンの場合、一覧選択画面上で簡易検索機能を利用できるようにします。
  • 詳細検索機能

    • チェックがオンの場合、一覧選択画面上で詳細検索機能を利用できるようにします。
  • 検索結果表示(初期表示時)

    • チェックがオンの場合、初期表示時に検索結果を表示します。
      対象データ件数が多いときの初期表示時のパフォーマンスを考慮し、初期表示時に検索結果を表示させたくない場合に設定します。
  • 項目幅の自動調整

    • チェックがオンの場合、検索結果表の列の項目幅が表の幅に収まるように自動調整をします。
      チェックがオフの場合、検索結果表の列の項目幅を自動調整せずに、一定の幅で表示します。
      表の幅に収まらない場合はスクロールバーを表示します。
  • 初期表示のソート順

    • 初期表示時の検索結果表のソート対象項目と並び順(昇順/降順)を指定します。
  • 非表示項目、一覧表示項目

    • クエリの取得値の設定項目のうち、一覧に表示する項目を「一覧表示項目」の枠に、一覧に表示しない項目を「非表示項目」に設定します。

コラム

一覧選択画面での簡易検索機能は、出力値に設定されているすべての「文字列型」の列に対して部分一致で行います。
一覧選択画面での詳細検索機能は、列毎に詳細な検索をすることができます。

注意

IM-FormaDesigner 2022Winter から項目幅の自動調整と初期表示のソート順の設定を追加しました。
  • IM-FormaDesigner 2022Spring 以前から、アップデートして、定義情報を変更しない状態の動作は、2022Spring 以前と変更ありません。
    画面設計書出力 」での出力値は空白で出力されます。

パラメータ設定

データソース定義で定義ずみのクエリ一覧から、使用するクエリを選択します。
クエリを選択すると、パラメータ等の設定項目は初期化されます。

取得値設定

選択したクエリで取得するデータのどの取得項目を画面アイテムに表示するかを設定します。
  1. ラジオボタン

    「一覧選択」の入力欄に表示する値を設定します。
    取得項目が1つの場合は、変更できません。
  2. 取得値を表示する画面アイテム

    フォーム上の他の画面アイテムに取得するデータを表示する場合に、セレクトボックスからフィールド識別名で設定します。
    • 取得値に設定できるアイテム

      • 文字列(product_72_textbox)
      • 複数行文字列(product_72_textarea)
      • 数値(product_72_number)
      • 日付(product_72_date)
      • 期間(product_72_term)
      • 一覧選択(互換用)(product_72_itemSelect)
      • 隠しパラメータ(product_72_hidden)

詳細設定

フィールド識別ID / [始]フィールド識別ID / [終]フィールド識別ID

アプリケーションテーブル上での、画面アイテムの物理名(列名)として利用します。
同一のアプリケーション内では、すべての画面アイテムのフィールド識別IDが一意になるように設定してください。

フィールド識別名 / [始]フィールド識別名 / [終]フィールド識別名

アプリケーションテーブル上での、画面アイテムの論理名として利用します。
そのほかに、一覧表示画面での画面アイテムに対応する項目名(論理名)として利用します。

フィールド値DB登録

画面アイテムに入力した値をデータベースへ登録するかを設定します。
チェックがオフの場合、データベースに登録しません。
ワークフロー関数などを利用している場合には、正しく値が表示されない場合がありますので、チェックをオフにしてください。

フィールド初期値 / フィールド初期選択値 / [始]フィールド初期値 / [終]フィールド初期値

入力欄に初期表示する値を設定します。
日付を扱う画面アイテムの場合、初期値として「現在の日付」を表示するかを設定します。
セレクトボックスなどの選択系アイテムの場合、初期表示で選択する値(送信値)を設定します。
「ユーザ選択」の場合は、初期値に「ログインユーザのユーザ名」を表示するかを設定します。
初期値が設定されるのは申請画面のみとなります。

コラム

承認画面におけるフィールド初期値の扱いについて
承認画面で表示したアイテムの初期値には、該当のアイテムを承認画面のフォームにのみ配置した場合であっても「フィールド初期値」の内容は表示されません。
承認画面での表示時点で何も値が設定されていない状態に対し、「申請画面からの未入力」または「承認画面で初めて表示された項目により未入力」なのかが判断できないためです。
承認画面で初期値を設定したい場合、前処理、または初期表示イベント時に外部連携を実行することで設定できます。

ラベル幅

ラベルの値を表示する幅をピクセル単位で指定します。

フィールド幅

入力欄の表示の幅をピクセル単位で指定します。

アイテム名

同一フォーム内で画面アイテムを識別するための名前を指定します。
アプリケーション種別が「IM-Workflow」、またはIM-BISで作成したフォームの場合には、追記設定・案件プロパティの設定時に表示する名称に利用されます。

画面の種類(行項目)

  1. 処理

    BISフローの処理画面の時の表示タイプを設定します。

  2. 参照

    BISフローの参照画面の時の表示タイプを設定します。

表示・入力タイプ(列項目)

  1. 表示・入力可

    入力できる画面アイテムとして表示します。
  2. 表示・参照

    入力はできませんが、設定値や入力済みの値を表示します。
  3. 非表示

    入力・表示ともできません。
    設定値や入力済みの値があっても、表示だけでなく、他の画面アイテムからの参照もできません。

表示タイプ:入力可

../../../../../../_images/input8.png

表示タイプ:参照

../../../../../../_images/reference8.png

アイテムサイズ・配置

フォーム内での表示の位置・高さ・幅を指定します。

画面アイテムとして指定した領域(「フォーム・デザイナ」画面上で赤い点線で囲まれる範囲)の横の長さ(幅)をピクセル単位で指定します。

画面アイテムとして指定した領域(「フォーム・デザイナ」画面上で赤い点線で囲まれる範囲)の縦の長さ(高さ)をピクセル単位で指定します。

X

画面アイテムとして指定した領域(「フォーム・デザイナ」画面上で赤い点線で囲まれる範囲)の左上頂点のフォーム左上からの横位置をピクセル単位で指定します。

Y

画面アイテムとして指定した領域(「フォーム・デザイナ」画面上で赤い点線で囲まれる範囲)の左上頂点のフォーム左上からの縦位置をピクセル単位で指定します。

表示スタイル

iAP UIデザインモード

iAP UIデザインガイドラインに沿ったデザインで、画面アイテムを表示するかを設定します。
チェックがオンの場合、画面アイテムをiAP UIデザインモードで表示します。
../../../../../../_images/iap_input7.png

ラベルスタイル / [前]ラベルスタイル / [後]ラベルスタイル

ラベルの書式を指定します。

フォント

文字のフォントの種類を指定します。

フォントサイズ

文字のサイズをピクセル単位で指定します。

文字色

文字色を色コード(#で始まる16進数)、またはカラーピッカーから選択して指定します。

太字

文字を太字で表示するかを設定します。
チェックがオンの場合、文字を太字で表示します。

斜体

文字を斜体で表示するかを設定します。
チェックがオンの場合、文字を斜体で表示します。

下線

文字に下線を表示するかを設定します。
チェックがオンの場合、文字に下線を表示します。

背景色

背景色を色コード(#で始まる16進数)、またはカラーピッカーから選択して指定します。

折り返し

チェックがオンの場合、ラベル名が表示範囲内に収まりきらないときに折り返します。

フィールドスタイル

フィールドの書式を指定します。

フォント

文字のフォントの種類を指定します。

フォントサイズ

文字のサイズをピクセル単位で指定します。

文字色

文字色を色コード(#で始まる16進数)、またはカラーピッカーから選択して指定します。

太字

文字を太字で表示するかを設定します。
チェックがオンの場合、文字を太字で表示します。

斜体

文字を斜体で表示するかを設定します。
チェックがオンの場合、文字を斜体で表示します。

下線

文字に下線を表示するかを設定します。
チェックがオンの場合、文字に下線を表示します。

背景色

背景色を色コード(#で始まる16進数)、またはカラーピッカーから選択して指定します。

枠線

枠線の設定を行います。

  • 枠あり:枠線が表示されます。
  • 枠なし:枠線は表示されません。
  • 下線のみ:下線が表示されます。

枠線色

枠線色を色コード(#で始まる16進数)、またはカラーピッカーから選択して指定します。

枠線の影

枠線に影をつけるかを設定します。
チェックがオンの場合、枠線に影をつけて表示します。