ビジネス・コンポーネント・イベント・タグ - <jbo:OnEvent>

<jbo:UrlEvent>または<jbo:FormEvent>データ・タグにより送信されるJSPイベントを処理します。

JSP構文

<jbo:OnEvent
   [ name="[eventName | * ]" ] | [ list="listofEventName" ]
   [ datasource="datasourceName" ] | [ viewobject="viewobjectName" ]>
      [JSP_tags]
</jbo:OnEvent>

説明

<jbo:OnEvent>データ・タグにより、送信元JSPページのjboEvent URLパラメータにより識別されるイベントを処理できます。<jbo:OnEvent>データ・タグは、<jbo:OnEvent>タグの条件がtrueの場合にのみJSPページでタグのボディが実行されるため、条件文のように機能します。OnEvent条件をテストするために、JSPページはOnEvent属性の値を、<jbo:UrlEvent>データ・タグまたは<jbo:FormEvent>データ・タグで生成されたリクエスト・パラメータの値と比較します。

OnEvent条件がtrueの場合、一致するデータソースおよびイベント名によって、コンポーネント・タグのaction属性に対するコンテキストが提供されます。このコンポーネント・タグは、<jbo:OnEvent>データ・タグのボディに記述するビジネス・コンポーネント・データ・タグ・ライブラリにあります。たとえば、次のいずれかの定義済ビジネス・コンポーネント・イベントを送信し、認識されたイベントを使用して<jbo:OnEvent>データ・タグのボディ内のアクションを起動できます。

イベント・リクエスト・パラメータは、次のデータ・タグを使用して生成します。

属性

次の各例では、jboEvent URLパラメータをアンカー・リンクで送信しています。

<a href="<targetJSP.jsp>?jboEvent=Create">New</a>

または、特定のビュー・オブジェクトに対してeventNameを使用できます。

<% String voName = dsNav.getViewObjectName(); %>
<a href="<targetJSP.jsp>?jboEvent=<%voName>%.Last">Last</a>

最初の例では、jboEventパラメータの値がビュー・オブジェクト名なしで作成されています。この場合、イベントはJSPページのデータソース内の任意のビュー・オブジェクトに適用されます。2番目の例では、イベントはJSPページのデータソース内の特定のビュー・オブジェクトに対して実行されます。