単一選択リストまたは複数選択リストのいずれかのコンボボックスを要素からページに挿入します。
JSP構文
<jbo:InputSelect
[ multiple="true | false" ]
datasource="datasourceInstanceName"
[ dataitem="attributeName" ]
displaydatasource="datasourceInstanceName"
displaydataitem="attributeName"
displayvaluedataitem="attributeName"
[ shownone="true | false" ]
/>
説明
<jbo:InputSelect>
データ・タグには、データ・ソースが2つ必要です。1つはデータベースから選択値を表示し、もう1つはデータベースの値を更新します。また、値を表示するのに使用する属性は、データベースを更新するのに使用する属性と同一である必要はありません。たとえば、単一選択リストに表示される製品リスト表から顧客注文表を更新する場合、データ属性(顧客注文表の更新で使用)がproduct_idである間は、表示属性がproduct_descriptionになります。
入力レンダラでは、すべての値がデータベースの記憶域用文字列に変換されます。
ビジネス・コンポーネントの開発者がデータ属性用の「ビジネス・コンポーネント・コントロール・ヒント」を定義した場合、<jbo:InputSelect>
データ・タグが、「ビジネス・コンポーネント・コントロール・ヒント」の書式化ヒントを使用して、データ属性値の出力を書式設定します。
注意: Netscape Navigatorをブラウザとして使用している場合、データを正しくレンダリングするには、HTMLの<form> </form>
タグの内部にタグを挿入する必要があります。
属性
multiple: オプション。コンボボックス・リストからの複数選択を許可するかどうかを決定します。複数選択リストを挿入する場合は、true
を入力します。挿入しない場合は、デフォルト値false
で単一選択リストが指定されます。
注意: 複数選択リストまたは単一選択リストのいずれを選択する場合でも、更新されるdataitem
属性は、常に単一の値を受け取ります。複数選択リストの場合、値はユーザー選択で作成された属性値のカンマ区切りのリストです。
datasource: ユーザーの選択によって更新される表を表すデータソースID。データソースは、<jbo:DataSource>
データ・タグを使用して作成します。
注意: このデータ・タグを使用する場合は、制約なし(非依存)ビュー・オブジェクトをデータソースとして使用する必要があります。使用しない場合は、データ・タグは完全な問合せを生成できません。デフォルトの問合せが依存ビュー・オブジェクトに対して実行されている場合は、常にマスター・ビュー・オブジェクトによって制限され、インスタンス化されたマスター・ビュー・オブジェクトまたはデータソースがない場合は、例外がスローされます。<jbo:InputSelect>
データ・タグのデータソース定義には、制約のないビュー・オブジェクトを使用するのが適切です。制約のないビュー・オブジェクトを使用するには、アプリケーション・モジュール・ビュー使用方法の編集ウィザードから選択します。制約のないビュー使用方法(オブジェクト)を使用するもう1つの方法は、<jbo:CreateViewObject>
データ・タグを使用して動的に作成する方法です。
dataitem: 選択から更新されるデータを含む、(datasource
内の)特定のビュー・オブジェクト属性の名前。<jbo:AttributeIterate>
タグの本体内では必要ありません。
displaydatasource: 選択リストに表示される表を表すデータソースID。データソースは、<jbo:DataSource>
データ・タグを使用して作成します。
displaydataitem: 選択リストに表示されるデータを含む、(displaydatasource
内の)特定のビュー・オブジェクト属性の名前。
displayvaluedataitem: (displaydatasource
内の)特定のビュー・オブジェクト属性の名前。これに含まれるデータの選択値は、dataitem
およびdatasource
で識別される表の属性を更新する際に使用されます。指定したこのデータ属性は、表示に使用した値とは異なる値を返す場合は、表示属性と同じである必要はありません。
displayvaluedataitem: (displaydatasource
内の)特定のビュー・オブジェクト属性の名前。これに含まれるデータの選択値は、dataitem
およびdatasource
で識別される表の属性を更新する際に使用されます。指定したこのデータ属性は、表示に使用した値とは異なる値を返す場合は、表示属性と同じである必要はありません。
shownone: オプション。コンボボックス・リストでNULL値を選択した場合にNoneを表示するかどうかを決定します。リストにNoneを表示しない場合は、false
を入力します(NULL値は、空または空白の選択肢として表示されます)。入力しない場合は、displaydataitem
属性に1つ以上のNULL値が定義されていれば、デフォルト値true
によってNoneが表示されます。
例
お客様の名前:<jbo:InputSelect multiple="true" datasource="Orders" dataitem="Id"
displaydatasource="customers" displaydataitem="Lastname" displayvaluedataitem="Id" />
お客様の名前:<jbo:InputSelect datasource="Orders" dataitem="CustomerId"
displaydatasource="customers" displaydataitem="Id" displayvaluedataitem="Lastname" />
コントロール・ヒントおよびビジネス・コンポーネント・データ・タグについて
コントロール・ヒントを使用したUIのカスタマイズ
UI用のフォーマッタと書式マスクの定義
Copyright © 1997, 2007, Oracle. All rights reserved.