データ・ソースにバインドされている1つのレコードを表示するコンポーネントを挿入する場合に使用します。
JSP構文
<jbo:DataRecord
datasource="datasourceId"
[ relativeUrlPath="component's JSP page | DataRecordComponent.jsp"]
/>
説明
<jbo:DataRecord>
コンポーネント・タグは、コンポーネントがバインドされているデータ・ソースの1つのレコードを表示する場合に使用します。
DataRecordコンポーネントには、表示する行を取得する方法が2つあります。
DataNavigateコンポーネントを使用してデータ・ソースにおける現在の行を変更し、この変更をDataRecordコンポーネントに反映させることができます。両方のコンポーネントが同じデータ・ソースにバインドされている必要があります。
現在の行による方法を使用せず、特定の行を取得する方法を選択する場合、ユーザー自身の責任で表示フォームにrowkeyを渡すことになります。この場合、ユーザー自身が、フォームで命名されている入力パラメータを介してrowkeyを明示的に渡す必要があります。
<td class="tablecell">
<a href="<%=displayTargetParam%>?RowKey=<jbo:ShowValue datasource='dsBrowse'
dataitem="RowKey"/>&originURL=<%=originURLParam%>">Display</a>
</td>
または、convenienceデータ・タグ<jbo:UrlEvent>
を使用します。
<td class="tablecell"> <a href="<jbo:UrlEvent datasource="dsBrowse" addRowKey="true"> </td>
属性
datasource: <jbo:DataSource>
データ・タグで定義されたデータ・ソースid。
指定するデータ・ソースでは、ビュー・オブジェクトを転送専用モードで使用しないでください。<jbo:DataSource>
データ・タグのforwardonly
属性のデフォルト設定はfalse
です。forwardonly
属性をtrue
に設定した場合、ビジネス・コンポーネント・データ・タグ・ライブラリのコンポーネント・タグを使用するJSPページでは、ランタイム・エラーがスローされます。
relativeUrlPath: (オプション)コンポーネント・タグを実装するJSPファイルの場所。デフォルトでは、JDeveloperが提供するファイルDataRecordComponent.jsp
が参照されます。コンポーネントの動作をカスタマイズするために作成するコンポーネント実装.jsp
ファイルの名前を指定できます。また、名前を編集してカスタマイズ済の既存のコンポーネント実装.jsp
ファイルを参照できます。
作成または参照するファイルがプロジェクト・ディレクトリsite
(mywork
フォルダ内)のサブディレクトリにある場合は、相対パスを指定する必要があります。たとえば、カスタム・コンポーネント実装ファイルMyDataRecordComponent.jsp
をsite
フォルダのサブディレクトリcomponents
に作成した場合、relativeUrlPathの値は/components/MyDataRecordComponent.jsp
になります。
例
次の例は、DataRecordコンポーネントがバインドされているデータ・ソースの1つのレコードを示しています。この例では、DataRecordコンポーネントのJSPページ(JSPページにタグを挿入したときに生成される)の位置は、プロジェクトJSPページと同じレベルにあります。
<jbo:DataRecord datasource="LocationsView" />
Copyright © 1997, 2009, Oracle. All rights reserved.