ステレオタイプ"edit"のContentで定義されるactionには、主に以下のものがあります。
- 画面が取り扱うデータモデルの初期化(新規作成、複写作成、一覧からの引き継ぎ)を行うaction
- データモデルの編集サービスを呼び出すaction
- データモデルの確定(コミット)サービスを呼び出すaction
サンプルのContente定義では、上記で挙げたactionに加えてデータモデルの複写作成や印刷を行うサービスを定義してあります。
"新規作成"actionは、Areaの起動時に実行される初期化commandから呼び出されます。
command内で、Pageのcontextが"新規作成"の場合に呼ばれるように定義されています。
データモデルの新規作成サービスを呼び出し、空のデータモデルを取得して"仮払申請書"に格納しています。
また、同じ画面内に存在する"status"のContentに渡す"申請書情報"にも同じデータモデルを格納しています。
<!--======================================================
== 新規生成で画面を起動した場合の初期化アクション
=======================================================-->
<action id="新規作成">
<doService service="仮払申請書新規作成">
<outputServiceSession>
<outputValue item="仮払申請書"/>
</outputServiceSession>
</doService>
<set item="申請書情報" value="item:仮払申請書"/>
</action>
"複写作成"actionは、Areaの起動時に実行される初期化commandから呼び出されます。
command内で、Pageのcontextが"複写作成"の場合に呼ばれるように定義されています。
一覧画面から引き継いだ"選択申請書"をパラメータとしてデータモデルの複写作成サービスを呼び出し、
新しいデータモデルを取得して"仮払申請書"に格納しています。
また、同じ画面内に存在する"status"のContentに渡す"申請書情報"にも同じデータモデルを格納しています。
<!--======================================================
== 複写生成で画面を起動した場合の初期化アクション
=======================================================-->
<action id="複写作成">
<doService service="仮払申請書複写作成">
<inputServiceSession>
<inputValue item="選択申請書"/>
</inputServiceSession>
<outputServiceSession>
<outputValue item="仮払申請書"/>
</outputServiceSession>
</doService>
<set item="申請書情報" value="item:仮払申請書"/>
</action>
"引継"actionは、Areaの起動時に実行される初期化commandから呼び出されます。
command内で、Pageのcontextが"修正"か"参照"の場合に呼ばれるように定義されています。
一覧画面から引き継いだ"選択申請書"を"仮払申請書"にそのまま格納しています。
また、同じ画面内に存在する"status"のContentに渡す"申請書情報"にも同じデータモデルを格納しています。
また、setSavePoint命令を使用して、編集対象のデータモデルに対してロールバックの準備を行っています。
ここでセーブポイントを設定しておくことで、保存しないで画面を閉じる場合などの編集をキャンセルしたい場合に対応できるようになります。
<!--======================================================
== 修正、参照で画面を起動した場合の初期化アクション
=======================================================-->
<action id="引継">
<set item="仮払申請書" value="item:選択申請書"/>
<set item="申請書情報" value="item:選択申請書"/>
<setSavePoint item="仮払申請書"/>
</action>
"編集"actionは、画面上で保存ボタンが押されたときに呼び出されます。
画面上の各入力フィールドに入力された項目をパラメータとして、まず入力値チェックを行うサービスを呼び出しています。
このサービスで何らかのチェックに引っかかった場合は、サービスから例外がthrowされてメッセージダイアログが表示され、処理はその時点で中断されます。
もしチェックに何も引っかからなかった場合は続けてデータモデルの編集サービスを呼び出しています。
パラメータとして、データモデルである"仮払申請書"と画面からの入力値を渡しています。
これにより、データモデルに対して各項目が設定されます。そしてサービスから返される編集済みのデータモデルを"仮払申請書"に設定しています。
<!--======================================================
== 画面の入力項目を仮払申請書に設定するアクション
=======================================================-->
<action id="編集">
<doService service="仮払申請書の入力値をチェックする">
<inputServiceSession>
<inputValue item="仮払希望日"/>
<inputValue item="仮払精算予定日"/>
<inputValue item="仮払申請額"/>
<inputValue item="仮払目的"/>
</inputServiceSession>
</doService>
<doService service="仮払申請書編集">
<inputServiceSession>
<inputValue item="仮払希望日"/>
<inputValue item="仮払精算予定日"/>
<inputValue item="仮払申請額"/>
<inputValue item="仮払目的"/>
<inputValue item="仮払申請書"/>
</inputServiceSession>
<outputServiceSession>
<outputValue item="仮払申請書"/>
</outputServiceSession>
</doService>
</action>
"編集キャンセル"actionは、画面上で保存を行わないまま画面を閉じるような場合に呼び出されます。
undo命令を使用することで、あらかじめsetSavePointを行っておけばその時点まで
データモデルに対して行われた編集をロールバックすることが出来ます。
<!--==========================================================
== 画面上で行われた編集をロールバックする
===========================================================-->
<action id="編集キャンセル">
<undo item="仮払申請書"/>
</action>
"保存"actionは、画面上で保存ボタンが押されたときに、編集actionの直後に呼び出されます。
"編集"actionにより編集済みのデータモデルをパラメータとして、データモデルの保存サービスを呼び出しています。
これにより、サービスが必要な処理を行った後データモデルの確定(コミット)をおこないます。
<!--======================================================
== 画面上で保存を行った場合のアクション
=======================================================-->
<action id="保存">
<doService service="仮払申請書保存">
<inputServiceSession>
<inputValue item="仮払申請書"/>
<inputValue item="ログイン利用者情報"/>
</inputServiceSession>
<outputServiceSession>
</outputServiceSession>
</doService>
</action>
最後に、"印刷"actionが定義されています。
これは、データモデルをパラメータとして印刷サービスの呼び出しを行っています。
<!--======================================================
== 画面上で印刷を行った場合のアクション
=======================================================-->
<action id="印刷">
<doService service="仮払申請書印刷">
<inputServiceSession>
<inputValue item="仮払申請書"/>
<inputValue item="ログイン利用者情報"/>
</inputServiceSession>
<outputServiceSession>
</outputServiceSession>
</doService>
</action>
