単一の値を受け入れる入力フォーム要素をページに挿入します。
<jbo:InputSelectLOV
datasource="datasourceInstanceName"
[ dataitem="attributeName" ]
displaydatasource="datasourceId"
displaydataitem="attributeName"
displayvaluedataitem="attributeName"
formname="HTMLFormName"
[ lovurl="LOV's JSP page" ]
/>
ユーザーは、別のJSPページに表示されるLOV(値リスト)から値を選択します。LOV選択リスト・ページには、検索フィールドも表示されます。ユーザーは、LOVで表示する属性に対する条件値をこのフィールドに入力することにより、LOVリストに表示される選択肢を限定できます。
注意: 指定した単一属性のリストを表示する<jbo:InputSelect>
データ・タグとは異なり、InputSelectLOVデータ・タグで作成されるLOVには表示する属性のセットを指定できます。これにより、LOVには複数列を表示することが可能であり、ユーザーは選択の基準となる詳細な情報を得ることができます。
InputSelectLOVタグには、2つのデータソース(データベースから選択肢を表示するためのデータソースおよびデータベースの値を更新するためのデータソース)が必要です。LOV選択リストには、通常は複数の属性のデータが表示されるため、データベースの更新に使用する単一の属性を選択する必要があります。たとえば、LOV選択リストに表示される製品リスト表から顧客注文表を更新する場合、表示属性にはproduct_id、product_descriptionおよびproduct_quantityが含まれ、(顧客注文表の更新に使用する)特定のデータ属性はproduct_idである場合があります。
入力レンダラは、データベースに格納するためにすべての値をStringに変換します。
ビジネス・コンポーネント開発者がデータ項目(属性)に対してビジネス・コンポーネント・コントロール・ヒントを定義した場合、InputSelectLOVデータ・タグでは、ビジネス・コンポーネント・コントロール・ヒントの書式を使用して属性値の出力を書式設定します。
ブラウザに関する注意
Netscape Navigatorをブラウザとして使用している場合、データを正しくレンダリングするには、HTMLの<form></form>
タグの内部にタグを挿入する必要があります。
Service Pack 1(SP1)を使用するMicrosoft Internet Explorer(IE)をブラウザとしてインストールしている場合、LOVウィンドウはモーダル・ウィンドウとして表示されません。 この場合、ユーザーは、LOVから値を選択する前にメイン・ページに戻ることができます。 この動作が必要でない場合は、SP1を使用しないIEをインストールしてアプリケーションを実行してください。
datasource: ユーザーの選択により更新される表を表すデータソースID。 データソースは、データソース・データ・タグを使用して作成します。
注意: このデータ・タグを使用する場合は、無制約の(ディテールではない)ビュー・オブジェクトをデータソースとして使用する必要があります。無制約のビュー・オブジェクトを使用しない場合、データ・タグは完全な問合せを生成できません。問合せがディテールのビュー・オブジェクトに対して実行される場合は、常にマスター・ビュー・オブジェクトにより制約され、マスター・ビュー・オブジェクトまたはデータソースがインスタンス化されていない場合は例外をスローします。それゆえInputSelectLOVデータ・タグのデータソースを定義する際には、無制約のビュー・オブジェクトを使用します。無制約のビュー・オブジェクトは、アプリケーション・モジュール・エディタの「データ・モデル」ページで選択することにより使用できます。別の方法として、CreateViewObjectデータ・タグを使用して動的に作成する方法があります。
dataitem: LOV選択から更新するデータを含む(datasource内の)特定のビュー・オブジェクト属性の名前。属性名は表の列を表します。AttributeIterateタグ・ボディの内部で使用する場合は必須ではありません。
displaydatasource: LOV選択リストに表示される表を表すデータソースID。 データソースは、データソース・データ・タグを使用して作成します。
displaydataitem: LOV選択リストに表示するデータを含む(displaydatasource内の)1つ以上のビュー・オブジェクト属性の名前。単一列のLOVを表示する場合は単一の属性名を入力し、複数列のLOVを表示する場合はカンマで区切られた属性名のリストを入力します。 たとえば、3つの表示属性で定義された3列を持つLOVを表示するには、AttributeName1,AttributeName2,AttributeName3
と入力します。
displayvaluedataitem: dataitemおよびdatasourceにより識別される表の属性を更新する際に選択された値が使用される、(displaydatasource内の)特定のビュー・オブジェクト属性の名前。このデータ属性の値は、ユーザーが選択した後に入力フィールドにも表示されます。
ヒント: 指定したデータ属性は、ユーザーが参照できるように、displaydataitemパラメータ・リストに含める必要があります。リストに含めない場合、ユーザーは、選択によって入力フィールドに戻された値がLOV選択リストに表示されていたデータと一致しないことに疑問を持つことがあります。
formname: <jbo:InputSelectLOV>
タグを挿入するHTMLフォーム・タグの名前。
lovurl: (オプション)LOV選択リスト・タグを実装する、ユーザーが作成するJSPファイルの場所。 LOVにURLを指定しない場合、<jbo:InputSelectLOV>
タグでは、指定した属性値を使用してデフォルトのLOVページ(lovcomp.jsp
)が作成されます。
<jbo:InputSelectLOV datasource="Orders" dataitem="Contactname"
displaydatasource="customers" displaydataitem="Lastname"
displayvaluedataitem="Id" formname="form1" />
コントロール・ヒントおよびビジネス・コンポーネント・データ・タグについて
コントロール・ヒントを使用するUIのカスタマイズ
UIのフォーマッタおよび書式マスクの定義
Copyright © 1997, 2004, Oracle. All rights reserved.