スクリプトを使った画面遷移

スクリプトの作成方法

「画面 > スクリプト > コントローラ」を設定します。

はじめに、どの画面についてのスクリプトを記述するかを指定します。

画面ごとに「実行タイミング」が用意されています。スクリプトは、指定したタイミングが終了したあとに呼び出されます。

呼び出されるタイミング

ヘルパの「登録時」とコントーラの「登録時」の違い

ヘルパの登録時は XXXHelper#beforeInsert メソッドがスクリプトを呼び出します。これはデータベースに登録する「直前」に呼び出されるものです。

一方、コントローラの登録処理は、データベース登録処理などがすべて完了し、画面表示 (JSP) に制御が移る直前に呼び出されます。

スクリプトの記述ルール

Wagby標準の画面遷移ルールを変更する

コントローラのスクリプトを作成する目的は、Wagby標準の画面遷移ルールを変更することです。 具体的には次のように記述します。

return "redirect:" + 遷移先の画面種別 + モデルID + イベント名(アクション文字列形式)

return "forward:" + 遷移先の画面種別 + モデルID + イベント名(アクション文字列形式)

接頭語 "redirect:" または "forward:" が必要です。
両者の違いは「リダイレクトとフォワード」の節で説明します。 標準は "redirect:"を使うようにしてください。

画面種別はSCREENTYPE関数の仕様に準じます。
モデルIDは先頭を大文字とします。（例:customerモデルの場合、Customerとなる。）

アクション文字列は "action_" という接頭語のあとにイベント名を付与します。
具体的には次節以降のサンプルで確認してください。

画面遷移はそのままに、追加のコードを記述する

画面遷移に変更がない場合は、return文を省略できます。追加コードのみ記述してください。

[例] 登録画面から、再び登録画面へ遷移する

連続した登録処理を行うため、登録画面終了後、再び登録画面に遷移するようにした例です。

return "redirect:insertCustomer.do?action_New";

パラメータを付与する

再呼出された登録画面に、前回の登録画面で選択した値を渡し、初期値として表示することができます。

例えば、他モデル参照（リストボックス）項目 item1 の値を渡す場合、次のようにします。

return "redirect:insertCustomer.do?action_New&item1="+customer.getItem1();

受け取る側 (item1) は、初期値（登録画面表示時）に次のような式を書きます。

TOINT(REQUEST())

複数のパラメータを付与する

複数のパラメータを付与する場合は、各パラメータを & で区切ります。

return "redirect:insertCustomer.do?action_New&item1="+customer.getItem1()+"&item2="+customer.getItem2();

すべての受け取る側の項目には、初期値（登録画面表示時）に REQUEST() 関数を適用してください。

日本語文字列をパラメータとして付与する

日本語文字列（を含む、英語圏以外の文字列）をパラメータとして付与する場合は、文字エンコーディングの配慮が必要となります。

ここではWagbyが提供するユーティリティクラス jp.jasminesoft.util.WebStringEncodeUtilities を使う方法を紹介します。

var WebUtils = Java.type("jp.jasminesoft.util.WebStringEncodeUtilities");
return "redirect:insertCustomer.do?action_New&customername="+WebUtils.encodeString(customer.getCustomername());

[例] 更新処理から、メニューへ遷移する

システムが提供するログオンアカウントモデル "juser" と 1:1 で紐づく「スタッフ (staff)」モデルを作成したとします。このとき、次の要件を満たすようにします。

• メニューからは、自分（ログオンID）だけの「スタッフ」モデルの更新処理が行えるようにする。
• 検索画面や一覧画面は不要。
• 更新後、詳細画面ではなく、すぐにメニューに戻るようにする。

スタッフモデルを用意する

1. スタッフは juser と 1:1 の関係にあるため、スタッフの主キーを juser の主キーと同一にします。具体的には、主キー「スタッフID」項目は、juser モデルの主キー項目 userid を参照するようにします。

   

2. 主キー「スタッフID」項目は、読み込み専用とします。

   

3. 主キー「スタッフID」項目は、検索時に隠し項目とします。

   

4. 主キー「スタッフID」項目の初期値を「ログオンID」とします。これは登録画面表示時、登録時、更新、検索時いずれも設定します。

   

5. 「検索画面と一覧表示画面を同時に表示する」を有効にします。
6. 「検索結果が1件のとき更新画面に遷移する」を "常に" と設定します。

   

   

7. メニューに表示されるラベル名を「スタッフ検索」から「スタッフ更新」へ変更します。

スクリプト

更新画面で保存ボタン押下時に呼び出されるスクリプトを設定します。メニュー画面へ遷移させるようにします。

if (p.errors.sizeJfcwarn() == 0 && p.errors.sizeJfcerror() == 0) {
    return "redirect:mainMenu.do";
}

p.errors.sizeJfcwarn() は警告メッセージの数を返します。p.errors.sizeJfcerror() はエラーメッセージの数を返します。入力チェックで警告またはエラーとなった場合は、画面遷移ルールを指定しません。

更新画面でキャンセルボタン押下時に呼び出されるスクリプトも用意します。ここは return のみとします。

return "redirect:mainMenu.do";

例

メニューから「スタッフ更新」を選択すると、ログオンアカウントに紐付いたスタッフの更新画面が開きます。これは実際には検索一覧画面を開きますが、検索結果が1件のとき更新画面に遷移する設定と併用して実現しています。

保存ボタンまたはキャンセルボタンを押下すると、メニュー画面へ戻ります。

[例] ウィザードの任意の画面へ遷移する

コントローラのスクリプト、もしくはオリジナルボタンのスクリプトに次のような記述を行うことができます。

return "redirect:showModel1P1.do?pkey=1000&action_WizChange&_wizard_page=2";

• モデルが model1 のとき、showModel1P1.do と、"P1" が必要になります。
• イベント名として、action_WizChange=WizChangeを加えてください。
• _wizard_page=数字を加えてください。_wizard_page で画面番号を指定します。数字は1から開始されます。1未満もしくは数字ではないイレギュラー文字が指定された場合は1と扱います。数字が、準備している画面より大きい場合は、最後の画面となります。

[例] 独自ボタン押下で、マルチセッションを使って任意の画面を開く

マルチセッションとは、1つのブラウザでタブを開いたとき、それぞれのタブで Wagby アプリケーションにログオンする仕組みです。[詳細...]

ここでは独自ボタン押下時、マルチセッションを使ってログオンし、任意の画面に遷移するスクリプトを説明します。

独自ボタンのイベント名を "Original1" とします。WEB-INF/script/<モデルID>/ShowList<モデルIDキャメル記法>_Original1.js をエディタで作成します。

function process() {
  var ExcelFunction = Java.type("jp.jasminesoft.util.ExcelFunction");
  var now = ExcelFunction.NOW();
  var s = ExcelFunction.RIGHT(
            ExcelFunction.RPAD(
              ExcelFunction.TEXT(
                ExcelFunction.TIME(
                  ExcelFunction.HOUR(now),
                  ExcelFunction.MINUTE(now),
                  ExcelFunction.SECOND(now)
                ),
                ".#####"
              ),
              6,
              "0"
            ),
            5
          );
  //print(s);
  var _ss = p.request.getParameter("_s");
  if (_ss === null) {
    _ss = "0";
  }
  return "redirect:/"+s+"/showList<遷移先のモデルIDキャメル記法>.do?_ss="+_ss;
}

• Wagbyのマルチセッションは、URLの一部に5桁のランダムな数字を含めて管理しています。これがマルチセッションを実現するための識別子となっています。新規ログオンを行うたびに、新しい数字が生成されます。つまり5桁の数値を使って異なるセッションと扱いますが、これは重複しなければ任意の値でよいとなっています。上のスクリプトでは時分秒から求めています。（厳密には重複するかもしれませんが、可能性は低い、としています。）
• 遷移時に _ss パラメータを付与します。初回は "0" を指定します。そのあとは付与されたマルチセッションの値を使います。一度付与されたマルチセッションの値は p.request.getParameter("_s") で取得できる仕様です。

フォワードとリダイレクト

return で次の画面遷移先を指定するとき、接頭語 forward または redirect のいずれかを指定します。両者の違いは次の通りです。

仕様・制約

生成されるスクリプトファイル

動作するスクリプトは、次のファイル命名規則に従って WEB-INF/script/モデルID フォルダ内に生成されます。

操作アクション + モデル名 + "_" + ボタン操作でサーバに送られる文字列.js

このスクリプトは所定のアクション処理が終了した後に呼び出されます。ファイル名の具体例を示します。

juserモデルの登録処理のあとに呼び出されるスクリプトファイル

WEB-INF/script/juser/InsertJuser_Send.js

customerモデルの「印刷形式で表示」ボタン押下のあとに呼び出されるスクリプトファイル

WEB-INF/script/customer/ShowCustomer_JFCPrintScreen.js

WEB-INF/script/customer/ShowListCustomer_JFCPrintScreen.js

staffモデルの「更新」ボタンを押したあとに呼び出されるスクリプトファイル

WEB-INF/script/staff/UpdateStaff_Send.js

staffモデルの「キャンセル」ボタンを押したあとに呼び出されるスクリプトファイル

WEB-INF/script/staff/UpdateStaff_Cancel.js

帳票出力後の画面遷移は指定できません

帳票出力（一括出力を含む）のスクリプトでは、画面遷移を指定することができません。（指定しても無視されます。）