<jbo:FormEvent>

送信ページのHTMLフォーム要素のリクエスト・オブジェクトにJSPイベントを追加します。

JSP構文

<jbo:FormEvent
   event="eventName"
   [ datasource="datasourceName" ] | [ viewobject="viewobjectName" ]
   [ addrowkey='true'| 'false']
/>

説明

<jbo:FormEvent>データ・タグは、JSPイベントを指定する特別なリクエスト・パラメータをJSPページで送信できます。次のイベントを送信できます。

FormEventデータ・タグは、JSPページのHTMLフォーム要素内で使用します。JSPページは、FormEventデータ・タグで指定された属性値から次の2つのリクエスト・パラメータを作成します。

jboEvent="eventname"
jboEventVo="viewobjectname"

ここで、ビュー・オブジェクト名はオプションです。リクエスト・パラメータを使用して送信するイベントは、ターゲットJSPページのビュー・オブジェクトに適用され、そのページの対応する<jbo:OnEvent>データ・タグの本体で処理されます。FormEvent属性でビュー・オブジェクト名を指定しない場合、イベントはターゲットJSPページのデータソース内のすべてのビュー・オブジェクトに適用されます。イベントを特定のビュー・オブジェクトに適用する場合は、次のいずれかの処理を行います。

注意: ターゲットJSPページには、受け取ったイベントを処理する<jbo:OnEvent>データ・タグが含まれている必要があります。イベント処理の詳細は、<jbo:OnEvent>データ・タグを参照してください。

HTMLフォーム要素内では、次の2つの例は同じ意味です。

<jbo:FormEvent event="Commit" viewobject="myViewObject">

および

<input name="jboEvent" type="hidden" value="Commit" />
<input name="jboEventVo" type="hidden" value="myViewObject" />

ターゲットJSPページは、送信JSPページのリクエスト・オブジェクトから受け取った2つの特別なイベント・パラメータを処理する必要があります。これらのフォーム・パラメータの値が<jbo:OnEvent>データ・タグ内の識別子と一致した場合、OnEventデータ・タグの本体がターゲット・ページで実行されます。詳細は、<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 />