顧客モデルの一覧表示画面から、サポートモデルの詳細画面へ遷移するボタンを用意した例を図1に示します。
このボタンを押すと、(顧客モデルが保持している)サポートモデルへの主キーを用いて、サポートモデルの詳細画面を開きます。
用意したモデルは「顧客」と「サポート」の二つです。
顧客モデルに、サポートモデルの主キーを保持する項目「サポート番号」を用意します。
図4で示した「顧客モデル」で、「画面>その他>Javaソースコードの設定」を開きます。
ここで追加ボタンを次のように定義します。
| 項目 | 説明 | 入力例 |
|---|---|---|
| 画面名 | どの画面にボタンを追加するかを指定します。ここでは"一覧表示画面(行毎)"とします。 | 一覧表示画面(行毎) |
| 表示する | 有効にします。 | (チェック) |
| 表示条件 | 常にボタンを表示する場合、本欄は空白とします。条件については"ボタン表示条件"をお読みください。 | |
| ボタン名 | 任意の名前を指定します。式で表現することもできます。 | サポート |
| イベント名 | 遷移した画面に対するイベントを指定します。遷移先は詳細画面ですので、詳細画面で受理できるイベント Show を指定します。 | Show |
| アクション名 | 遷移する画面を指定します。[後述] | showSupport |
| 追加パラメータ | 遷移する画面へパラメータを指定することができます。[後述] | supportid=${supportid#id} |
モデルと画面の組み合わせから構成される文字列です。アドレスバー(URL)の一部になります。
詳細画面は次のようになります。
"show" + モデル名(キャメル記法)
このルールにより、モデル "support" の詳細画面に対応するアクション名は "showSupport" になります。 拡張子は不要です。
詳細画面に対して、直接、主キーを渡すことができます。
書式は「キー=値」となっています。キー部分は(遷移先モデルの)項目IDになります。
値部分にプレースホルダ (${ ... }) を用いて、遷移元の項目の値を渡すことができます。遷移元項目がモデル参照の場合、#id を付与することで ID 部を渡すようになります。
図2の動作を実現するための追加パラメータは次のようになります。イコールの左側はサポートモデルの項目で、主キーになります。イコールの右側は顧客モデルの項目です。たまたま同じ名前(supportid)ですが、両者はそれぞれモデルが異なります。
supportid=${supportid#id}
受側のモデル(この例ではサポートモデル)の主キー項目に初期値を設定する必要はありません。主キー項目は、外部パラメータがあればそれを自動的に利用するようになっています。
追加パラメータに記載する項目名に以下を指定することはできません。
顧客モデルの一覧表示画面に二つの独自ボタン「サポート表示」と「サポート更新」を用意した例を紹介します。
「サポート更新」ボタン押下により、サポートモデルの更新画面を開くことができます。
二つ目の独自ボタンとして、更新用のボタンを設定します。
| 項目 | 説明 | 入力例 |
|---|---|---|
| 画面名 | どの画面にボタンを追加するかを指定します。"一覧表示画面(行毎)"とします。 | 一覧表示画面(行毎) |
| 表示する | 有効にします。 | (チェック) |
| 表示条件 | 常にボタンを表示する場合、本欄は空白とします。条件については"ボタン表示条件"をお読みください。 | |
| ボタン名 | 任意の名前を指定します。式で表現することもできます。 | サポート更新 |
| イベント名 | 遷移した画面に対するイベントを指定します。遷移先は更新画面ですので、更新画面で受理できるイベント Update を指定します。これにより更新画面が開きます。 | Update |
| アクション名 | 遷移する画面を指定します。 | updateSupport |
| 追加パラメータ | 遷移する画面へパラメータを指定します。 | supportid=${supportid#id} |
一覧表示画面に用意する独自ボタンの追加パラメータに、検索条件部の値を渡すことができます。
特別表記 ${cond.項目名} を指定します。例えば次のように表記します。
customername=${cond.name}&ourdept=${cond.dept#id}