ソート最終更新日: 2020年8月10日
R8 | R9

検索結果一覧の初期ソートルールを指定します。

例

図1は、顧客モデルの一覧表示画面において「氏名」「氏名かな」「電子メール」の3つの項目をソートキーと指定した例です。

画面表示時は、第一ソートキーで並びます。（この例ではアルファベット降順としています。）

ソートキーと指定した項目は、項目名部分をクリックできます。クリックするとその項目でソートが行われます。同じ項目をクリックすると、ソート順を反転させることができます。

図2は電子メール項目をアルファベット昇順ソートに切り替えた例です。

ソートキーは画面ごと、かつ、利用者ごとに記憶されます。利用を終了し、再びログオンすると、最後に指定したソートキーで並び替えられた一覧画面が表示されます。

検索画面で「検索条件のクリア」を行うと、再検索と同時に初期ソート順に戻ります。

サンプルで用いた顧客モデルの定義を図3に示します。ここでは「氏名」「氏名かな」「電子メール」の3つの項目にソートキーを設定します。

モデル項目詳細定義を開きます。各項目の「ソート順」という欄に数字を指定します。数字の若い順に第一ソートキー、第二ソートキー... と割り当てられます。（図4,図5,図6）

数値の前に「マイナス」を指定すると、初期ソートルールが逆順ソートとなります。（図4の「電子メール」項目）

上の図4,5,6のように複数のソートキーを指定した場合、一覧表示画面の初期表示時は第一ソートキーのみが働くわけではなく、第二以降のソートキーもソート順として反映されます。（後述する SQL の ORDER BY 句に、第一ソートキーから順に列挙されます。）

上の図4,5,6に示した初期設定の昇順/降順にかかわらず、一覧表示画面の列のクリック操作は一度目のクリックで昇順、二度目は降順となります。

ソートはデータベースの SQL 処理 (ORDER BY 句) によって実現しています。そのため、データベースによってルールが変わります。

ソートはデータベースの ORDER BY 句によって実現しています。そのため、データベースに保存しない項目はソートキーとして指定することはできません。

日本語文字でのソートは、利用者が期待した並びにならないことがあります。これは文化的な並びではなく、文字コード順となるためです。

主キーは必ずソートキーに含まれます。(*1)

主キーがソート項目として指定されていなければ、最も最後のソート条件になります。(order by 句の末尾に付与されます。)
主キーがソート項目として指定されていれば、その設定に従います。

*1 ページネーション機能を実現するために、order by 句に主キーを指定する必要があります。

値が "NULL" のソートは、データベースによって扱いが異なります。

SQL Server, MySQL では、最も小さい値として扱われます。
Oracle, DB2, PostgreSQL では、最も大きい値として扱われます。(Oralce 9i 以降では、NULL の扱いを指定することもできます。）
内臓データベース (HSQLDB) では、ソート対象となりません。NULLを含む行が常に先頭になります。

モデル参照項目をソート対象とすることはできません。

その理由は、モデル参照項目は "ID値" でソートするためです。多くの場合、表示されている内容と、ソートの並びが一致しないという印象を受けることになります。

参照連動項目が自モデル保存となっている必要があります。