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