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

イベントを送信するURLを生成するための便利なタグです。

JSP構文

<jbo:UrlEvent
   [ targeturl='targeturlName']
   [ targeturlparam='paramName']
   event='eventName'
   [ datasource='datasourceName'] | [ viewobject='viewobjectName']
   [ addrowkey='true'| 'false']
   [ extraparameters='param=value'[& 'param=value'...] ]
/>

注意: 別のHTMLタグ内の構文エラーを避けるために、<jbo:UrlEvent>データ・タグの属性で単一の引用符を使用する必要があります。

説明

<jbo:UrlEvent>データ・タグを使用すると、JSPイベントを識別するために特別なリクエスト・パラメータでURLを構成できます。発行できるイベントは次のとおりです。

<jbo:UrlEvent>データ・タグは、URLを取得するあらゆるHTMLタグ内で使用できます。JSPページでは、<jbo:UrlEvent>データ・タグで指定した属性値から次の2つのリクエスト・パラメータを構成します。

jboEvent='eventname'
jboEventVo='viewobjectname'

ビュー・オブジェクトの名前はオプションです。URLとともに送信するイベントはターゲットJSPページのビュー・オブジェクトに適用され、そのページの対応する<jbo:OnEvent>データ・タグの本体で処理されます。UrlEvent属性でビュー・オブジェクト名を省略すると、イベントはターゲットJSPページのデータ・ソース内にあるすべてのビュー・オブジェクトに適用されます。イベントを特定のビュー・オブジェクトに対して適用する場合は、次のようにします。

注意: ターゲットJSPページには、受信するイベントを処理する<jbo:OnEvent>データ・タグを含める必要があります。イベントのハンドリング方法は、<jbo:OnEvent>データ・タグを参照してください。

たとえば、HREFタグ内で<jbo:UrlEvent>データ・タグを使用する場合、次の2つのフォームは同じ意味になります。

<a href="<jbo:UrlEvent targeturl='mytargetpage.jsp' event='next' datasource='myDataSource'/>" >Click for next row.</a>

および

<a href="mytargetpage.jsp?jboEvent=next&jboEventVo=myViewObject" >Click for next row.</a>

ターゲットJSPページでは、送信されたJSPページから受け取った2つの特別なイベント・リクエスト・パラメータを処理します。これらの入力パラメータの値が<jbo:OnEvent>データ・タグ内の識別子と一致する場合、<jbo:OnEvent>データ・タグの本体がターゲット・ページで実行されます。詳細は、<jbo:OnEvent>データ・タグを参照してください。

属性

この例では、<jbo:UrlEvent>データ・タグによって指定されたデータ・ソースの次および最初のイベントを生成するリンクを表示します。イベントを処理するのは<jbo:OnEvent>データ・タグです。

<%@ taglib uri="/webapp/DataTags.tld" prefix="jbo"  %>
<jbo:ApplicationModule id="am" configname="mypackage.MypackageModule.MypackageModuleLocal" 
  releasemode="Stateful" />
<jbo:DataSource id="ds" appid="am" viewobject="EmpView" />
  
<jbo:OnEvent datasource="ds" name="next">
   <jbo:RowsetNavigate datasource="ds" action="Next" />
</jbo:OnEvent>

<jbo:OnEvent datasource="ds" name="first">
  <jbo:RowsetNavigate datasource="ds" action="First" /> 
</jbo:OnEvent>

<jbo:Row id="currentRow" datasource="ds" action="current" >
  Name: <jbo:RenderValue dataitem="Ename" /><br>
  Employee number: <jbo:RenderValue dataitem="Empno" /><br></jbo:Row>

<a href="<jbo:UrlEvent datasource='ds' event='First' />">First record</a>
<a href="<jbo:UrlEvent datasource='ds' event='Next' />">Next record</a>

<jbo:ReleasePageResources /