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