「画面 > スクリプト」を開きます。実行タイミングを指定して、スクリプトを記述します。
| 実行タイミング | 説明 |
|---|---|
| 登録 | 「初期値 > 登録時」を行ったあとに呼び出されます。登録直前のデータを修正することができます。この処理を行った後のデータが、データベースに保存されます。 |
| 「初期値 > 登録時」を行う前に呼び出す場合は、関数 preprocess を用意することができます。 |
|
| 登録(初期データ作成) | 「初期値 > 登録画面表示時」を行ったあとに呼び出されます。新規登録用のデータを修正することができます。この処理を行った後のデータが、登録画面に表示されます。 |
| 「初期値 > 登録画面表示時」を行う前に呼び出す場合は、関数 preprocess を用意することができます。 |
|
| 更新 | 「初期値 > 更新時」を行ったあとに呼び出されます。更新直前のデータを修正することができます。この処理を行った後のデータが、データベースに保存されます。 |
| 「初期値 > 更新時」を行う前に呼び出す場合は、関数 preprocess を用意することができます。 |
|
| 詳細画面表示 | 「初期値 > 詳細画面表示時」を行ったあとに呼び出されます。表示直前のデータを修正することができます。この処理を行った後のデータが、詳細画面に表示されます。(データベースには反映されません。表示の直前で内部のデータを改変する必要がある場合に利用できます。例えば一部のデータを表示時に隠す、などです。) |
| 「初期値 > 詳細画面表示時」を行う前に呼び出す場合は、関数 preprocess を用意することができます。 |
|
| 詳細画面表示(更新) | 更新画面を開くタイミングでデータベースの値を読み込みますが、そのあとにこのスクリプトが呼び出されます。更新対象データを改変してから、利用者に入力してもらうという場合に利用できます。 |
| 詳細画面表示(一覧) | 一覧画面を開くタイミングでデータベースの値を読み込みますが、そのあとにこのスクリプトが呼び出されます。一覧表示の直前で内部のデータを改変する必要がある場合に利用できます。 |
| 計算 | 定義済みの自動計算式を実行したあとに、このスクリプトが呼び出されます。自動計算式では記述できない、より複雑な処理を実装する場合に利用できます。 なお、このスクリプトを用意する場合、モデルに何らかの四則演算式が指定されている必要があります。(意味のない設定、例えば「値を0にする」といったダミー定義でもよいので、四則演算を使う設定を行ってください。) |
| 一括更新 | 「検索・一覧表示画面 > 一括更新ボタンを表示する」の処理内容を記述します。 |
| 入力チェック・整合性チェック | 標準で用意している、必須チェックや文字数チェックといった機能の後に実行されます。(正確には、入力チェックの最後の処理となります。) |
トランザクション処理はモデル項目詳細定義で記述します。詳細は「モデルをまたがる計算(トランザクション)」で説明します。
画面遷移のタイミングで実行されるスクリプトを作成することもできます。詳細は「画面遷移」で説明します。
Designerで入力したスクリプトから、拡張子 ".js" のファイルが生成されます。 実ファイルは wagbyapp/webapp/$(APPNAME)/WEB-INF/script/モデルIDフォルダ の中に用意されます。
| 実行タイミング | ファイル名 |
|---|---|
| 登録 | モデルIDHelper_beforeInsert.js |
| 登録(初期データ作成) | モデルIDHelper_initialize.js |
| 更新 | モデルIDHelper_beforeUpdate.js |
| 詳細画面表示 | モデルIDHelper_beforeShow.js |
| 詳細画面表示(更新) | モデルIDHelper_beforeShowInUpdate.js |
| 詳細画面表示(一覧) | モデルIDHelper_beforeShowInShowList.js |
| 計算 | モデルIDHelper_calc.js |
| 一括更新 | ShowListモデルIDController_do_updateRule.js |
| 入力チェック | モデルIDPInputCheckHelper_input_check.js |
| トランザクション | モデルIDEntityService_doTransactionBy${トランザクションを設定した項目ID}InsertTransaction.js モデルIDEntityService_doTransactionBy${トランザクションを設定した項目ID}UpdateTransaction.js モデルIDEntityService_doTransactionBy${トランザクションを設定した項目ID}DeleteTransaction.js |
| 画面遷移 | 操作アクション + モデルID + "_" + ボタン操作でサーバに送られる文字列.js |
上記のファイル名に含まれる「項目ID」にはキャメル記法というルールが適用されます。
次の方法で、どのようなスクリプトファイルがどのタイミングで呼び出されるかを調べることができます。
;jp.jasminesoft.jfc.ScriptCodeRunner.isOutputStatusToConsole=true
;jp.jasminesoft.jfc.ScriptCodeRunner4Controller.isOutputStatusToConsole=true(修正後)
jp.jasminesoft.jfc.ScriptCodeRunner.isOutputStatusToConsole=true
jp.jasminesoft.jfc.ScriptCodeRunner4Controller.isOutputStatusToConsole=true