単一レコード用の編集フォームをページへ挿入し、編集送信のイベントを生成します。
JSP構文
<jbo:DataEdit
datasource="datasourceId"
[ targetURL="event-handling page | the JSP with the component" ]
[ relativeUrlPath="component's JSP page | DataEditComponent.jsp" ]
[ enctype="application/x-www-form-urlencoded | multipart/form-data" ]
/>
説明
<jbo:DataEdit>
コンポーネント・タグは、データソースの特定のレコードを編集するためのHTMLフォームを表示する場合に使用します。フォームに表示できるものは次のとおりです。
DataEditコンポーネント・タグは、編集する行を次の2つの方法で取得します。
DataNavigateコンポーネントを使用してデータソース上の行の現在位置を変更し、その変更をDataEditコンポーネントに反映できます。両方のコンポーネントが同じデータソースにバインドされている必要があります。
行の現在位置を使用せずに特定の行を取得する場合、rowkeyを編集フォームに渡す必要があります。この場合、DataTableコンポーネントを使用できます。DataTableコンポーネントでeditTargetURL属性を編集フォームJSPページの名前に設定すると、DataEditコンポーネントはDataTableコンポーネントからrowkeyを取得できます。また、次のようにフォームで指定した入力パラメータを介してrowkeyを明示的に渡すこともできます。
<td class="tablecell">
<a href="<%=editTargetParam%>?RowKey=<jbo:ShowValue datasource='dsBrowse'
dataitem="RowKey"/>&originURL=<%=originURLParam%>">Edit</a>
</td>
通常、ユーザーが変更内容を確認してから先に進むか編集フォームに戻るかを決定できるように、別のJSPページを用意します。このページは送信JSPページと呼ばれ、targetURL属性で識別されます。編集と処理を同じJSPページ内で実行する場合は、JSPページで送信イベントを処理できるようにする必要があります。
属性
datasource: <jbo:DataSource>
データ・タグで定義されたデータ・ソースid。
指定するデータ・ソースでは、ビュー・オブジェクトを転送専用モードで使用しないでください。<jbo:DataSource>
データ・タグのforwardonly
属性のデフォルト設定はfalse
です。forwardonly
属性をtrue
に設定した場合、ビジネス・コンポーネント・データ・タグ・ライブラリのコンポーネント・タグを使用するJSPページでは、ランタイム・エラーがスローされます。
DataEdit
コンポーネントを含むページにアクションが返送されます。
relativeUrlPath: (オプション)コンポーネント・タグを実装するJSPファイルの場所。デフォルトでは、JDeveloperが提供するファイルDataEditComponent.jsp
が参照されます。コンポーネントの動作をカスタマイズするために作成するコンポーネント実装.jsp
ファイルの名前を指定できます。また、名前を編集してカスタマイズ済の既存のコンポーネント実装.jsp
ファイルを参照できます。
作成または参照するファイルがプロジェクト・ディレクトリsite
(mywork
フォルダ内)のサブディレクトリにある場合は、相対パスを指定する必要があります。たとえば、カスタム・コンポーネント実装ファイルMyDataEditComponent.jsp
をsite
フォルダのサブディレクトリcomponents
に作成した場合、relativeUrlPathの値は/components/MyDataEditComponent.jsp
になります。
enctype: (オプション)FORM
要素の属性。これは、DataEdit
コンポーネントによってサーバーへの転送用に作成されたフォーム・データ・セットのエンコードに使用するコンテンツ・タイプを指定します。サポートされるコンテンツ・タイプは、application/x-www-form-urlencoded
(デフォルト)と、ファイル、非ASCIIデータおよびバイナリ・データを含む送信フォーム用のmultipart/form-data
です。
例
次の例では、バインド先のデータソースに対する編集フォームを表示し、編集された値を処理するために別のJSPページに送信します。この例では、DataEdit
の編集ターゲットはJSP編集フォームです。DataEdit
コンポーネントのJSPページ(タグをJSPページに挿入すると生成されます)の場所は、プロジェクトのJSPページと同じレベルです。
<jbo:ApplicationModule id="am" configname="package1.Package1Module.Package1ModuleLocal" releasemode="Reserved" />
<jbo:DataSource id="ds" appid="am" viewobject="DeptView" />
DeptView Edit Form
<jbo:DataEdit datasource="ds" targetURL="DeptView_SubmitEdit.jsp" />
ビジネス・コンポーネント・データ・タグ・ライブラリのコンポーネント・タグについて
ビジネス・コンポーネントJSPページへのコンポーネント・タグの追加
ビジネス・コンポーネント・データ・タグ・ライブラリのコンポーネント・タグのカスタマイズ
Copyright © 1997, 2006, Oracle. All rights reserved.