画面遷移 (6) 画面遷移パラメータまとめ

画面名

アクション名

モデルと画面の組み合わせから構成される文字列です。アドレスバー(URL)の一部になります。

仕様・制約

• 「検索画面と一覧表示画面を同時に表示する」設定を有効とした場合、「検索画面」の設定では検索一覧画面上に独自ボタンは表示されません。「一覧表示画面」の設定で検索一覧画面上にボタンが表示されます。
• 一つの画面に、同じアクション名とイベント名を指すボタンを重複して用意することはできません。

イベント名

(*1) "更新して次へ/前へ" の動作WDN

更新画面に用意される "更新して次へ/前へ" ボタン操作と、スクリプトの関係を示します。

"更新して次へ/前へ" ボタン押下の画面遷移は、リダイレクト方式となっています。このため、スクリプトによって参照できるストアモデルが変わります。

コントローラ>画面:"更新">実行タイミング:"更新して次へ" "更新して前へ"

更新する前のオブジェクトを参照できます。

コントローラ>画面:"更新">実行タイミング:"更新画面を開く"

更新した次のオブジェクトを参照できます。

ここで "更新画面を開く" スクリプトで画面遷移前(つまり主キー1000)の値を参照したい場合は、次のようにします。

var smodel = p.request.getAttribute("model1.update");//ストアモデル
var pmodel = p.request.getAttribute("model1_p.update");//プレゼンテーションモデル

接尾語 ".update" はこの "更新画面を開く" スクリプトでのみ利用できる特別な指定です。この接尾語を用いると、更新される前のオブジェクトを参照できます。

なお、ここで参照するオブジェクトはデータベースへの更新が終わった後の値です。このオブジェクトの値を変更することはできません。（値を変更してもデータベースには反映されません。）

(*2) 独自ボタンのイベント名を定義する場合

開発者が独自ボタンを用意する場合、次の設定を同時に行ってください。
画面 > その他 > Javaソースコードの設定 > カスタマイズ用のクラスを出力する を有効にする。

URLに直接、イベントを指定する

スクリプトや、外部リンクの仕組みを使って遷移先画面の URL を直接指定したとき、イベント名を渡すこともできます。パラメータに "action_" という接頭語を付与し、そのあとに続けてイベント名を記述します。

例:外部リンクメニューボタン作成で、パラメータとイベントを渡す

モデル model1 の検索画面へ遷移し、さらにパラメータ item1 に値を、そして（検索条件の初期値を使うために）Reset イベントを指定する場合は次のように記述します。

/wagby/showListModel1.do?item2=1&action_Reset=

パラメータのキー部分に"action_" + イベント名を指定します。イコールの右側は空白とします。（イベントの指定はキー名のみが参照されるため、値部分は使いません。）

参考:メニュー > 外部サイトへのリンク

モデル参照項目のルール

パラメータの右側に記載する項目（${...}で指定した項目）がモデル参照の場合、次のルールで値を渡します。

• モデル参照の場合はID部を渡します。
• 参照連動の場合は内容部を渡します。

このルールを変更したい場合、項目名の後ろに #id または #content を指定してください。#id は ID 部を、#content は内容部を意味する接尾語です。

例えば参照連動項目 companyname の ID 値を渡したい場合は ${companyname#id} と記述します。

遷移先モデルが複合キーの場合

遷移元を model1、遷移先を model2 とします。model2 は複合キーで、それぞれ pkey1 と pkey2 とします。

この場合は model1 が保持する二つの項目（例 item1, item2）をそれぞれ pkey1, pkey2 に渡すようにします。渡す側と、受け取る側の項目の型を合致させてください。

遷移先モデルのモデル参照項目が複合キーの場合WDN

遷移元を model1、遷移先を model2 とします。model2 内の項目 item3 はモデル参照項目で、参照先モデルを model3 とします。model3 は複合キーで、それぞれ pkey1, pkey2 とします。

model1に用意したボタンで記載するパラメータ

参照先モデルの主キーが複合キーの場合、追加パラメータを次のように記述します。

項目名=${主キー1}$SEP$${主キー2}

主キー項目名を ${...} で記述しますが、さらにキーの連結文字列として、間に$SEP$を加えています。

item3=${item1}$SEP$${item2}

model2に用意するスクリプト

受け側となる model2 では、初期値の式ではなく、スクリプトによって値を解析してセットします。タイミングは「登録（初期データ作成）」です。

var item3 = p.request.getParameter("item3");
if (item3 != null) {
    var ss = item3.split("$SEP$");
    /*
    for (var i in ss) {
        print(i+"="+ss[i]);
    }
    */
    model2.item3Pkey1 = ss[0];
    model2.item3Pkey2 = ss[1];
}

p.request は、Java アプリケーションサーバが管理する request オブジェクトです。getParameter メソッドを使うと、図2で指定したパラメータを受け取ることができます。

$SEP$ を区切り文字として split 関数を呼び出すと、配列が用意されます。個々の値を model2 の要素にセットします。

ここで、model2 では "item3" という項目を用意していますが、内部では次のように管理されています。

項目名_参照先モデルの主キー項目名(1番目)
項目名_参照先モデルの主キー項目名(2番目)

すなわち model2 では "item3_pkey1" と "item3_pkey2" という二つの項目が内部で保持されます。スクリプトではキャメルルールにより、それぞれ "item3Pkey1", "item3Pkey2" と表記されます。(Pkeyの'P'が大文字になっています。) *1

遷移元モデルのモデル参照項目が複合キーの場合

遷移元を model1、遷移先を model2 とします。model1 内の項目 item1 はモデル参照項目で、参照先モデルを model3 とします。model3 は複合キーで、それぞれ pkey1, pkey2 とします。

参照先モデルの主キーが複合キーの場合、追加パラメータを次のように記述します。

項目名=${項目名#id}$SEP$${項目名#id2}

項目名を ${...} で記述しますが、さらに項目名の後ろに #id, #id2,... という接尾語を加えています。接尾語の数字に対応して、model3 の主キー pkey1, pkey2 がそれぞれ渡されます。

遷移先モデル model2 の item 項目に渡す場合、次のようになります。

item=${item1#id}$SEP$${item1#id2}

受け側である model2 では、スクリプトを使って区切り文字 $SEP$ を分割してください。（「遷移先モデルのモデル参照項目が複合キーの場合」で説明済みのため、省略します。）

チェックボックスの場合WDN

チェックボックス型項目の場合、コンマ区切りで値（参照先モデルのID部）が渡されます。遷移先モデルではスクリプトを使って、値を分割してから格納するようにしてください。遷移先モデル model2 の item 項目（これもチェックボックス型を想定）に値を格納するスクリプトの例を示します。

var item = p.request.getParameter("checkbox");
if (item !== null) {
  var array = item.split(",");
  var i;
  for (i=0; i<array.length; i++) {
    /*print("i="+i+","+array[i]);*/
    if (array[i] !== '') {
      model2.addItem(parseInt(array[i]));/*model2のitemはチェックボックス型*/
    }
  }
}

区切り文字を変更する

コンマ以外の文字を区切り文字としたい場合、パラメータを次のように記述します。

item=${checkbox;|}

セミコロンのあとに区切り文字を指定します。受け側のスクリプトもそれにあわせて修正してください。

制約：この区切り文字指定機能に、次の文字は利用できません。

「;」「(」「)」「[」「]」「&」「=」「>」「<」「$」

引数が未設定時の場合

パラメータを受け取る側が数値型項目で、受け取る式を次のように記述したとします。

TOINT(REQUEST())

このとき、渡す側のパラメータが未設定であれば、受け取り側は "0" がセットされます。

渡す側のパラメータが未設定のとき、受け取り側も未設定 (null) とする場合は、次の式とするとよいでしょう。

IF(
  ISBLANK(REQUEST()),
  null, 
  TOINT(REQUEST())
)