基本動作
検索画面から一覧更新画面へ遷移するボタンが用意されます。
一覧更新画面では表形式でデータの更新・新規登録・削除処理を行うことができます。
更新
各行がそれぞれ一つのデータに対応します。行内の入力欄を修正します。修正中のデータは "修正中" というステータスで管理され、ロックされます。保存処理では、修正中のデータのみが更新されます。
コピー登録・新規登録
各行の左側に用意された「コピー」または「新規」ボタンを押下します。
削除
左側に用意された「削除」欄で、削除したいデータをチェックします。保存ボタンを押下することで削除されます。
保存
現在の編集状態を保存します。保存後にロックは解除されます。エラー行は無視されます。たとえば10行編集中で1行に入力エラー（例 必須入力漏れ）があった場合、保存ボタンを押下することで9件が保存されます。
キャンセル
すべての編集状態を解除し、元の画面（一覧表示画面）へ戻ります。途中まで編集した値は保存されません。
入力チェック
更新があったデータの入力チェック処理を行います。エラーがあった場合は "エラー" と表示されます。
複数ページにまたがる修正
件数が多い場合、複数のページに分割して表示されます。ページを移動した場合でも、編集作業の内容は記憶されています。元のページに戻ると、編集中のデータが復元されます。
ページタイトル
画面例
ページタイトルを "お得意様 まとめて更新" へ変更した例を示します。
定義方法
画面タブ内の検索・一覧表示タブを開きます。「ページタイトル」の欄に文字を入力します。
説明文
画面例
説明文を設定した例を示します。
定義方法
画面タブ内の検索・一覧表示タブを開きます。「説明文」の欄に文字を入力します。
HTMLタグを加える
説明文にHTMLタグを加えることもできます。詳細は"検索・一覧表示>説明文>HTMLタグを加える"をお読み下さい。
更新処理を許可する
画面例
更新処理を許可しない、という設定を行うことができます。次のような動作になります。
- 新規登録は行える。
- 更新・削除処理が行えない。
すなわち一覧更新画面中に「入力できるレコード」と「入力できないレコード」が混在した更新モードになります。
行の「新規」ボタンを押下すると新規入力用のレコードは用意されます。
定義方法
「更新処理を許可する」設定を解除します。（標準で有効になっています。）
削除のチェックボックスを表示する
削除用のチェックボックスを非表示とすることもできます。削除機能を無効にします。
定義方法
「削除のチェックボックスを表示する」設定を解除します。（標準で有効になっています。）
ロック制御
一覧更新画面では、表示されているデータがロックされます。
「次のページ」や「前のページ」に移動した場合、修正されたデータはそのままロックを保持し、修正されていないデータのロックは解除されます。
ページを移動した時にロックの取得に失敗した場合は、そのデータの左端にロック失敗と表示され、編集することはできません。
一覧表示部分のスクロールタイプ（列固定）
画面例
特定の列を軸に、左側と右側に分割することができます。（Excelの「ウィンドウ枠の固定」のイメージです。）
図12は「氏名」項目を左側に、それ以降を右側に分割した例です。右側の部分は項目が多い場合でも自動で均等割付けされます。
定義方法
「画面>一覧更新」タブで、「一覧表示部分のスクロールタイプ」に「列固定」を指定します。 このとき「固定する項目名」と「列固定時のテーブル幅」を指定する必要があります。 前者は項目ID(英語名)を、後者はコンマ区切りで左側と右側部分の比率を指定します。
ラベル幅を指定する
図12の表示例は、項目数が増えた場合でも均等割付となるため、一つ一つの列幅が小さくなり、入力しづらくなります。
各項目のラベル幅を指定することで、図14のようにスクロールバーを表示させることができます。
一覧表示に用いる項目について、ラベル幅をピクセル値で指定します。（図15）
ラベル幅指定を省略すると、Webブラウザが自動的に幅調整を行います。項目が多い場合、必ずしも最適なレイアウトにならないことがあります。この場合はラベル幅の設定を行ってください。
一覧表示部分のスクロールタイプ（ヘッダ行固定）
画面例
列の項目名部分（ヘッダ行）を固定にします。（Excelの「先頭行固定」のイメージです。）
図16,図17はヘッダ行を固定とし、表示領域の高さを300ピクセルと指定した例です。表示部をスクロールしてもヘッダ行は固定されています。
定義方法
「画面>一覧更新」タブで、「一覧表示部分のスクロールタイプ」に「ヘッダ行固定」を指定します。 このとき「ヘッダ行固定時のテーブルの高さ」を指定する必要があります。空白時の初期値は "240px" です。
一覧表示に用いる項目について、ラベル幅をピクセル値で指定します。（「列固定」の図15と同様）
ラベル幅指定を省略すると、Webブラウザが自動的に幅調整を行います。項目が多い場合、必ずしも最適なレイアウトにならないことがあります。この場合はラベル幅の設定を行ってください。
折り返しが効かない場合
"出力制御（スタイル）> CSSクラス名・スタイルの指定 > 例 一覧表示項目の折り返し幅を指定する"をお読みください。
制約
- ヘッダ行を固定したとき、ブラウザの幅を変更して表示ウィンドウサイズを変えた場合でも、一覧表示の幅はウィンドウサイズにあわせて変動しません。最初に表示された幅に固定されます。
テキストエリアの行数・文字数
画面例
一覧更新用のテキストエリアを別に指定することができます。
定義方法
対象項目（ここでは「備考」項目）の「入力項目の種類」をテキストエリアとします。
入力制御タブ内のテキストエリア設定で、一覧更新画面向けの「行数」と「1行の文字数」を指定します。
一覧更新画面の同時表示数
この設定は一覧表示と同様の動作になります。詳細は"検索・一覧表示>一覧表示画面の同時表示数"をお読みください。
一覧更新画面のページネーション
この設定は一覧表示と同様の動作になります。詳細は"検索・一覧表示>一覧表示画面のページネーション"をお読みください。
一覧更新ボタンの表示制御
検索結果が見つかったときのみ、一覧更新ボタンを表示するという制御を行うことができます。 一覧更新ボタンの表示制御欄に、次の式を記述します。
RESULTSIZE()>0
RESULTSIZE 関数は、検索・一覧表示画面でのみ有効です。
用意されているボタン（機能）
一覧更新画面に用意できるボタン（機能）を説明します。
定義方法
画面タブ内の一覧更新タブに用意された「ボタン表示」を有効にします。
| 種別 | 初期状態 | 説明 |
|---|---|---|
| 保存 | ○ | |
| キャンセル | ○ | 一覧表示画面へ戻ります。 |
| 新規登録 | ○ | 新規登録画面を用意している必要があります。 |
| コピー登録 | ○ | 新規登録画面を用意している必要があります。 |
ボタンの表示制御
「一括削除・一括メール送信・一括帳票・一括更新・印刷形式で表示」ボタンは、検索結果が存在する場合のみ表示されます。検索結果が存在しない場合、ボタンも非表示となります。
仕様と制約
扱うことができない項目
- 繰り返し項目
- 繰り返しコンテナ（繰り返しコンテナ用のID および 繰り返しコンテナ内の項目を含みます）
- 「追記型リストボックス」を指定している項目
- 参照先のモデルが複合キーの場合のチェックボックス
編集することができない（表示のみの）項目
- 参照連動
- ファイル名
- 外部キーを指定した項目
- 隠し項目
- 読み込み専用項目
検索条件で絞り込んだ結果に対する一覧更新の実行
一覧更新画面では、検索条件を設定する欄は用意されません。
図1のように、検索・一覧表示画面に一覧更新画面へ移動するボタンを用いる場合は、検索画面で絞り込んだデータのみが一覧更新の対象となります。（すなわち絞り込んだデータに対して、一覧更新を行うことができます。）
メニュー画面より直接、一覧更新画面へ遷移した場合は、すべてのデータが一覧更新の対象となります。
対象モデルの検索条件に初期値など、デフォルトの検索条件を設定していた場合は、条件によって絞り込まれたデータが一覧更新の対象となります。
暗黙条件も有効です。
項目同士の絞り込み設定
"他モデルの参照 > 参照モデル同士の関係性で選択肢を絞り込む > トラブルシューティング > 一覧更新画面で絞込が動作しない"をお読みください。
入力チェック
一覧更新画面では変更を行わなかった行（データ）については入力チェックも行われません。変更のあった行（データ）だけが更新の対象となります。
その他の制約
- 外部キーに指定されているモデル（親モデル）において、コピー登録を行う場合、外部キーを指定したモデル（子モデル）もコピー登録されますが、一覧更新でのコピー登録では外部キーを指定したモデル（子モデル）はコピーされません。
- 一覧表示部分のスクロールタイプ（列固定、ヘッダ行固定）と、多段レイアウトを同時に指定することはできません。レイアウト設計はいずれか一方を使うようにしてください。
- 必須指定を行った項目は、一覧表示の設定を行うか、または初期値（「登録時」または「登録画面表示時」）の設定を行う必要があります。（ただし新規登録画面/コピー登録画面（詳細画面、一覧表示画面）を作成しない場合は、この制約に該当しません。）
「エラー行を無視して保存する」設定を無効にすることはできません。R8.0.3 (ENH936301) で入力エラー時はエラーメッセージを表示して編集画面に戻るようになりました。（これまでは入力エラーでも無視して保存していました。）この改善に伴い、入力チェックボタンは廃止されました。郵便番号から住所を求める機能は行われません。R8.1.0 (ENH1036301) で対応しました。- 住所正規化処理（オプション）には対応していません。
