EGL プロパティー displayUse が、button
または hyperlink の場合、プロパティー action
は、ユーザーがボタンまたはリンクをクリックしたときに呼び出されるコードを識別します。ユーザーが action に割り当てる値は、フィールド (またはフィールドを含むレコード)を、Page Designer の Web ページに配置したときにデフォルトとして使用されます。
action の値は次の文字列リテラルの種類の 1 つです。
- PageHandler 内のイベント処理関数の名前
- Web リソース (JSP など) にマップされ、JSF アプリケーション構成リソース・ファイルの navigation-rule エントリーの from-outcome 属性に関連付けられているラベル
- 以下の規則が適用される場合の Java™ Bean のメソッド名
- 形式が Bean 名、ピリオド、およびメソッド名である
- Bean 名が JSF アプリケーション構成リソース・ファイルの管理対象 bean-name エントリーに関連付けられている
action の値を指定しない場合、ユーザーによるフィールドのクリックは以下の効果を持ちます。
- プロパティー displayUse の値が button の場合は、JSF が同じ Web ページを再表示した後、検証が行われる。
- プロパティー displayUse の値が hyperlink の場合、検証が行われないが、JSF は同じ Web ページを再表示する。
EGL ランタイムがアクション・プログラムにページ・フィールド・データを送信する場合、送信されるページ・フィールドはそれぞれ以下の規則に従います。
- ページ・フィールドは、ユーザーが定義する項目に従属するか同じレベルにあり、
- ページ・フィールドの名前は、ページ・フィールド・データを受信するプログラム・プロパティー
inputPageRecord 内のフィールドの名前と同じである。
action
の値を指定しない場合、ユーザーによるフィールドのクリックは以下の効果を持つよう定義されます。
- converse 文により Web ページが表示された場合、コントロールは同じプログラムに戻ります。
- 戻り文節を含む forward 文により Web ページが表示された場合、コントロールは戻り文節に指定されたプログラムに移ります。
前のケースでは (発信元のプログラムであらかじめ呼び出すプログラムを指定する場合)、以下のようにします。
- action に値を指定しない。または、
- action に値を指定し、プロパティー
newWindow を yes に設定する。