ビジネス・コンポーネント・データ・タグ - <jbo:DataNavigate>

ページに行セット・ナビゲーション・バーを挿入し、行ナビゲーション・イベントを処理する場合に使用します。

JSP構文

<jbo:DataNavigate
   datasource="datasourceId"
   [ targetURL="event-handling page | the JSP with the component" ]
   [ relativeUrlPath="component's JSP page | DataNavigateComponent.jsp" ]
/>

説明

<jbo:DataNavigate>コンポーネント・タグは、コンポーネントがバインドされているデータ・ソース上で現在の行の位置を変更可能にする場合に使用します。行の現在位置を変更すると、ユーザーがデータ・ソースを一度に1レコードずつ移動できるようになります。たとえば、DataNavigateコンポーネントを使用して現在の行を変更し、この変更をDataEditコンポーネントまたはDataRecordコンポーネントに反映させることができます。現在の行の表示に使用するコンポーネントは、DataNavigateコンポーネントと同じデータ・ソースにバインドされている必要があります。

DataNavigateコンポーネントによってレンダリングされるナビゲーション・バーには、「先頭へ」、「次へ」、「 前へ」および「最後へ」アクション・リンクが表示されます。ユーザーは、いずれかのアクション・リンクをクリックして行の位置を変更できます。DataNavigateコンポーネントは、現在の行の位置に応じて、次の行ナビゲーション・アクションを処理できます。

DataNavigateコンポーネントのあるJSPページをセッション中に初めて実行したとき、データ・ソースに現在の行が存在しない可能性があります。このため、ナビゲーション・バーをレンダリングする前に、現在の行を明示的に設定する必要があります。DataNavigateコンポーネントを行の現在位置に設定するには、すべてのJSPページでこのスクリプレット・コードを使用する必要があります。

 
<% if (ViewObjectName.getRowSet().getCurrentRow() == null)  { %>    <jbo:RowsetNavigate 
datasource="myDatasource" action="First"/> <% } %>         

通常、ナビゲーション・バーの表示、行ナビゲーション・イベントの処理およびレコードの表示には、同じJSPページを使用します。この場合、targetURLの値を指定する必要はありません。DataNavigateコンポーネントが次の2つの操作を実行するため、同じJSPページでのナビゲーションと表示が可能です。

ただし、別々のJSPページに移動して表示する場合、targetURL属性で表示ページの名前を指定できます。

属性

次の例は、コンポーネントがバインドされているデータ・ソースのナビゲーション・バーを示しています。この例では、DataNavigateのターゲットは、このコンポーネントを含むJSPです。DataNavigateコンポーネントのJSPページ(JSPページにタグを挿入したときに生成される)の位置は、プロジェクトのJSPページと同じレベルにあります。現在の行がNULLの場合、データ・ソースの行の現在位置を設定するためにスクリプレット・コードが必要です。それ以外の場合、DataNavigateコンポーネントは初期化されません。

 
<jbo:ApplicationModule id="am" configname="package1.Package1Module.Package1ModuleLocal" 
  releasemode="Stateful" />
  <jbo:DataSource id="myDS" appid="am" viewobject="DeptView"/>
  <% if (myDS.getRowSet().getCurrentRow() == null)
     { %>
  <jbo:RowsetNavigate datasource="myDS" action="First"/>
  <% } %>
  
  <jbo:DataNavigate datasource="myDS" />         

ビジネス・コンポーネント・データ・タグ・ライブラリのコンポーネント・タグについて
ビジネス・コンポーネントJSPページへのコンポーネント・タグの追加
ビジネス・コンポーネント・データ・タグ・ライブラリのコンポーネント・タグのカスタマイズ