送信ページのHTMLフォーム要素のリクエスト・オブジェクトにJSPイベントを追加します。
<jbo:FormEvent
event="eventName"
[ datasource="datasourceName" ] | [ viewobject="viewobjectName" ]
[ addrowkey='true'| 'false']
/>
<jbo:FormEvent>
データ・タグは、JSPイベントを指定する特別なリクエスト・パラメータをJSPページで送信できます。次のイベントを送信できます。
<jbo:FormEvent>
データ・タグは、JSPページのHTMLフォーム要素内で使用します。 JSPページは、<jbo:FormEvent>
データ・タグで指定された属性値から次の2つのリクエスト・パラメータを作成します。
jboEvent="eventname"
jboEventVo="viewobjectname"
ここで、ビュー・オブジェクト名はオプションです。 リクエスト・パラメータを使用して送信するイベントは、ターゲットJSPページのビュー・オブジェクトに適用され、そのページの対応する<jbo:OnEvent>
データ・タグ・ボディで処理されます。 FormEvent属性でビュー・オブジェクト名を指定しない場合、イベントはターゲットJSPページのデータソース内のすべてのビュー・オブジェクトに適用されます。イベントを特定のビュー・オブジェクトに適用する場合は、次のいずれかの処理を行います。
または
注意: ターゲットJSPページには、受け取ったイベントを処理する<jbo:OnEvent>
データ・タグが含まれている必要があります。イベント処理の詳細は、<jbo:OnEvent>データ・タグを参照してください。
HTMLフォーム要素内では、次の2つの例は同じ意味です。
<jbo:FormEvent event="Commit" event="myViewObject">
および
<input name="jboEvent" type="hidden" value="Commit" />
<input name="jboEventVo" type="hidden" value="myViewObject" />
ターゲットJSPページは、送信JSPページのリクエスト・オブジェクトからの2つの特別なイベント・パラメータを処理します。 これらのフォーム・パラメータの値が<jbo:OnEvent>
データ・タグ内の識別子と一致した場合は、OnEventデータ・タグ・ボディがターゲット・ページで実行されます。 詳細は、<jbo:OnEvent>
データ・タグを参照してください。
Firstset
、Nextset
、Previousset
およびLastset
First
、Next
、Previous
およびLast
Update
、Delete
、Commit
およびRollback
viewobject
属性でビュー・オブジェクト名を指定する場合、またはターゲットJSPページですべてのビュー・オブジェクトにイベントを適用する場合は、この属性を省略できます。
datasource
属性でデータソース名を指定する場合、またはターゲットJSPページですべてのビュー・オブジェクトにイベントを適用する場合は、この属性を省略できます。
注意: アプリケーション・モジュールで定義された既存のビュー・オブジェクト、またはCreateViewObjectデータ・タグを使用して作成したビュー・オブジェクトを指定できます。ネストされたアプリケーション・モジュールにビュー・オブジェクトが含まれている場合、appmodNested.viewobjectName
のように、ビュー・オブジェクト名をアプリケーション・モジュール名とともに指定する必要があります。
<jbo:OnEvent>
データ・タグ・ボディで特定の行に対して処理を実行する必要がある場合は、この属性を使用します。
この例では、追加情報としてデータソースおよび行キーを使用してビジネス・コンポーネントのUpdateイベントを生成します。
<%@ taglib uri="/webapp/DataTags.tld" prefix="jbo" %>
<jbo:ApplicationModule id="am" configname="mypackage.MypackageModule.MypackageModuleLocal" releasemode="Stateless" /> <jbo:DataSource id="ds" appid="am" viewobject="EmpView" /> <form name="test" action="formSubmit.jsp" method="post"> Name: <jbo:InputText datasource="ds" dataitem="Ename" /> <jbo:FormEvent event="Update" datasource="ds" addrowkey="true" /> <input type="submit" value="Update"> </form> <jbo:ReleasePageResources />
Copyright © 1997, 2004, Oracle. All rights reserved.