検索・一覧表示（一覧表示）グリッドを利用する

定義方法

対象モデルの「画面 > 検索・一覧表示」で、「グリッドで表示する」を有効にします。（このとき「検索画面と一覧表示画面を同時に表示する」も自動的に有効になります。）

「グリッドで表示する」を有効にしたとき、このモデルの REST API 機能が自動的に有効になります。（手動で設定する必要はありません。）

実行

グリッドで表示された一覧表示の例を示します。

ソート（並び替え）

あらかじめ、ソート対象項目にソートのルールを設定しておきます。[詳細...]

列名をクリックすることでソートが行われます。再びクリックすると昇順と降順が入れ替わります。

列の移動

列部分をドラッグ&ドロップで移動することができます。

列の表示幅の変更

列の表示幅をドラッグ&ドロップで変更することができます。

列を非表示にする

グリッドの右端にある「+」ボタンを押下すると、表示対象列名の一覧が表示されます。

列を非表示とすることができます。

同時表示数とページネーション

グリッドの右下にある「同時表示数」を変更することができます。変更と同時にページネーションも変わります。

設定

画面タブ内の検索・一覧表示タブに用意された「同時表示数のパターン」が反映されます。コンマ区切りで複数の数値を指定することができます。

縦スクロールバーを表示する

グリッドの縦のサイズを指定することができます。縦スクロールバーが表示されます。

定義方法

一覧表示部分のスクロールタイプを「ヘッダ列を固定」とします。同時に、ヘッダ行固定時のテーブルの高さを指定します。単位はピクセル (px) またはエム (em) を指定してください。

スクロール時にデータを読み込む(onDemand Grid)

ページネーションを使わず、スクロールバー操作時に必要に応じてデータを取得することができます。（OnDemand Gridと呼びます。）

定義方法

「ページネーションを表示する」の設定を解除します。あわせて、一覧表示部分のスクロールタイプを「ヘッダ列を固定」と、ヘッダ行固定時のテーブルの高さを指定します。単位はピクセル (px) またはエム (em) を指定してください。

一括処理

設定を共通で利用する

グリッドの設定（列の表示・非表示と、並び）を異なる利用者間で共通に利用することができます。

プレファレンス共通設定プリンシパル

グリッドの設定を公開できるアカウントを指定します。これは「プレファレンス共通設定管理」として用意されています。この例ではアカウント「ユーザー1」に付与します。[プリンシパルの詳細...]

設定を公開する

アカウント「ユーザー1」でログオンします。一覧表示グリッドの下部に、共通設定名を入力できる欄が用意されます。

ここで、標準の列設定を変更してみます。

変更後、共通設定名として「顧客一覧ユーザー1設定」と入力します。（名称は任意です。）

カーソルを移動すると「保存」ボタンが表示されますので、これを押下します。

共通設定を再利用する

アカウント「ユーザー2」でログオンします。ユーザー2は「プレファレンス共通設定管理」プリンシパルを付与されていません。そのため共通設定の登録は行えませんが、既存の設定を選択することができます。

共通設定を読み込むと、列の設定が変更されます。

標準の設定に戻す

リポジトリ（設計情報）に指定された標準設定に戻す場合、「グリッド設定をクリア」を選択します。

標準の設定に戻ります。

グラフの出力

一覧表示の値を使ってグラフを出力することができます。詳細は集計・グラフ > 一覧表示画面にグラフを表示するをお読みください。

仕様・制約

仕様

• 検索と一覧表示は一つの画面にまとまります。検索画面と一覧表示画面を別にすることはできません。
• 「一覧表示部分に横スクロールバーを表示する」設定は無効です。グリッド内で必要に応じて横スクロールバーが自動的に表示されます。(*7)
• グリッドが提供する機能（ソート、列の並び替え、列幅の設定、列の非表示設定）を個別に無効とすることはできません。
• グリッドのソートおよび列並び替えは、グリッドのみで有効です。ソートや列の並び替え設定は他の画面機能（印刷形式表示の画面、CSVダウンロードなど）に反映されるものではありません。
• 全文検索と一覧表示（グリッド）の組み合わせを行うことはできません。
• モデル参照（ラジオ、チェック）の折り返し数の設定には対応していません。
• ラベル表記をカスタマイズすることはできません。例えばラベルの途中で改行させる、といった制御を行うことはできません。
• 検索結果が1件のとき詳細画面へ遷移する・検索結果が1件のとき更新画面へ遷移する・検索結果が0件のとき登録画面へ遷移する機能には対応していません。
• 親子モデル同時表示時、子モデルをグリッド表示にした場合は、子モデルの検索条件項目の一つでも必須とすることはできません。（親モデルの詳細画面で、子モデルの検索条件未入力というエラーになります。）

制約

• ブラウザに IE を利用する場合、「出力制御>一覧画面>スタイル」の「ラベルの幅」を設定するようにしてください。この値が未設定の場合、IEで列が表示されない場合があります。

項目の型について

• 複合主キーには未対応です。
• メールアドレス、URL、ファイルはリンク形式ではなく、文字情報として表示されます。
• ファイル型項目のアイコンはグリッドでは表示されません。
• 郵便番号から住所を求める機能は動作しません。 R8.3.1で利用できるようになります。

ボタンについて

• 新規登録や更新、削除の権限にかかわらず、ボタンは常に表示されます。 R8.5.0 で権限に応じてボタンが非表示となります。
• グリッド内に用意されるボタン（一覧更新画面へ遷移するボタン、帳票出力ボタンなど）に表示条件を指定することはできません。 R8.5.0で指定できるようになります。
• 一覧表示画面の各行のユーザ定義処理に対応するボタン(オリジナルボタン)の表示条件および追加パラメータを指定することはできません。 R8.5.0 で対応します。
• 上に関連しますが、ユーザ定義処理に対応するオリジナルボタンの追加パラメータに ${cond.項目名} を利用することはできません。（つまり行毎に用意するボタンは、検索条件から値を取得することはできません。）
• オリジナルボタンの下記の動作には対応していません。
  • アクションにShowSubwindowが設定されている。
  • 式が書かれているラベル。
  • 帳票出力。

利用できない設定

• 一覧表示の「列固定」は無効です。（設定しても機能しません。）
• 複数段一行明細（多段）レイアウトを行うことはできません。
• 検索画面遷移直後の検索処理を止める設定と併用することはできません。
• 一括処理を利用する場合「全データ一括処理の対象とする」設定には未対応です。
• 検索結果が1件のとき詳細表示画面に遷移する機能は未対応です。
• 親子モデルの表示で、子モデルをグリッド形式で表示することはできません。 R8.5.0で利用できるようになります。
• 数値型項目の出力フォーマット指定は無視されます。
• "出力制御 > 一覧画面 > 共通 > 最大表示文字数制限" は無視されます。
• 一覧表示画面の行クリックおよび各項目の閲覧権限、更新権限には対応していません。

絞り込み設定

他モデル参照項目の「入力制御>モデル参照(絞込)」設定は利用できません。 R8.3.1で利用できるようになります。

なお設定時は、"他モデルの参照 > 参照モデル同士の関係性で選択肢を絞り込む > トラブルシューティング > 一覧表示画面で絞込が動作しない"をお読みください。

パフォーマンス

グリッド表示では実行時に利用者が列の非表示設定を行うことができます。そのためモデル定義ではすべての項目の一覧表示設定を有効にして、利用者に表示列を自由に選択させるという運用を想定されるかも知れません。しかしその場合、表示対象データをいったんサーバで作成してブラウザに送出するためパフォーマンスが劣化します。

設計段階では、一覧表示画面で必要となる項目はできるだけ限定し、さらに利用者で表示選択させるというような方針としてください。

トラブルシューティング

ラベルの幅が揃わない / 特定のラベルの縦幅が伸びている

「出力制御>一覧画面>スタイル>ラベルの幅」の設定が行われているか、または適切な値となっているかを確認してください。