図1は、顧客モデルの一覧表示画面において「氏名」「氏名かな」「電子メール」の3つの項目をソートキーと指定した例です。
画面表示時は、第一ソートキーで並びます。(この例ではアルファベット降順としています。)
ソートキーと指定した項目は、項目名部分をクリックできます。クリックするとその項目でソートが行われます。同じ項目をクリックすると、ソート順を反転させることができます。
図2は電子メール項目をアルファベット昇順ソートに切り替えた例です。
ソートキーは画面ごと、かつ、利用者ごとに記憶されます。利用を終了し、再びログオンすると、最後に指定したソートキーで並び替えられた一覧画面が表示されます。
検索画面で「検索条件のクリア」を行うと、再検索と同時に初期ソート順に戻ります。
サンプルで用いた顧客モデルの定義を図3に示します。ここでは「氏名」「氏名かな」「電子メール」の3つの項目にソートキーを設定します。
モデル項目詳細定義を開きます。各項目の「ソート順」という欄に数字を指定します。数字の若い順に第一ソートキー、第二ソートキー... と割り当てられます。(図4,図5,図6)
数値の前に「マイナス」を指定すると、初期ソートルールが逆順ソートとなります。(図4の「電子メール」項目)
ソートはデータベースの SQL 処理 (ORDER BY 句) によって実現しています。 そのため、データベースによってルールが変わります。
ソートはデータベースの ORDER BY 句によって実現しています。そのため、データベースに保存しない項目はソートキーとして指定することはできません。
値が "NULL" のソートは、データベースによって扱いが異なります。
モデル参照項目をソート対象とすることは非推奨です。
その理由は、モデル参照項目は "ID値" でソートするためです。多くの場合、表示されている内容と、ソートの並びが一致しないという印象を受けることになります。
参照連動項目が自モデル保存となっている必要があります。
主キーは必ずソートキーに含まれます。