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