単一の値を受け入れる入力フォーム要素をページに挿入します。
JSP構文
<jbo:InputSelectLOV
datasource="datasourceInstanceName"
[ dataitem="attributeName" ]
displaydatasource="datasourceId"
displaydataitem="attributeName"
displayvaluedataitem="attributeName"
formname="HTMLFormName"
[ lovurl="LOV's JSP page" ]
/>
説明
ユーザーは、別のJSPページに表示されるLOV(値リスト)から値を選択します。LOV選択リスト・ページには、検索フィールドも表示されます。ユーザーは、LOVで表示する属性に対する条件値をこのフィールドに入力することにより、LOVリストに表示される選択肢を限定できます。
注意: 指定した単一属性のリストを表示するInputSelectデータ・タグとは異なり、InputSelectLOVデータ・タグで作成されるLOVには表示する属性のセットを指定できます。これにより、LOVには複数列を表示することが可能であり、ユーザーは選択の基準となる詳細な情報を得ることができます。
InputSelectLOVタグには、2つのデータソース(データベースの選択肢を表示するためのデータソースと、データベースの値を更新するためのデータソース)が必要です。LOV選択リストには、通常は複数の属性のデータが表示されるため、データベースの更新に使用する単一の属性を選択する必要があります。たとえば、LOV選択リストに表示される製品リスト表から顧客注文表を更新する場合、表示属性にはproduct_id、product_descriptionおよびproduct_quantityが含まれ、(顧客注文表の更新に使用する)特定のデータ属性はproduct_idである場合があります。
入力レンダラ(InputXXX)は、データベースに格納するためにすべての値をStringに変換します。
ビジネス・コンポーネント開発者がdataitem(属性)に対してBC4Jコントロール・ヒントを定義した場合、InputSelectLOVデータ・タグではBC4Jコントロール・ヒントの書式ヒントを使用して属性値の出力を書式設定します。
注意: Netscape Navigatorをブラウザとして使用している場合、データを正しくレンダリングするには、HTMLの<form></form>タグの内部にタグを挿入する必要があります。
属性
datasource: ユーザーの選択により更新される表を表すデータソースID。データソースは、DataSourceデータ・タグを使用して作成します。
注意: このデータ・タグを使用する場合は、無制約の(ディテールではない)ビュー・オブジェクトをデータソースとして使用する必要があります。無制約のビュー・オブジェクトを使用しない場合、データ・タグは完全な問合せを生成できません。問合せがディテールのビュー・オブジェクトに対して実行される場合は、常にマスター・ビュー・オブジェクトにより制約され、マスター・ビュー・オブジェクトまたはデータソースがインスタンス化されていない場合は例外をスローします。それゆえInputSelectLOVデータ・タグのデータソースを定義する際には、無制約のビュー・オブジェクトを使用します。無制約のビュー・オブジェクトは、アプリケーション・モジュール・エディタで単独のビュー・オブジェクトを作成することで選択できます。別の方法として、CreateViewObjectデータ・タグを使用して動的に作成する方法があります。
dataitem: LOV選択から更新するデータを含む(datasource内の)特定のビュー・オブジェクト属性の名前。属性名は表の列を表します。AttributeIterateタグ本体の内部で使用する場合は必須ではありません。
displaydatasource: LOV選択リストに表示される表を表すデータソースID。データソースは、DataSourceデータ・タグを使用して作成します。
displaydataitem: LOV選択リストに表示するデータを含む(displaydatasource内の)1つ以上のビュー・オブジェクト属性の名前。単一列のLOVを表示する場合は単一の属性名を入力し、複数列のLOVを表示する場合はカンマで区切られた属性名のリストを入力します。たとえば、3つの表示属性で定義された3列を持つLOVを表示するには、"AttributeName1,AttributeName2,AttributeName3
"と入力します。
displayvaluedataitem: LOVリストに表示されるデータが選択されることで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のフォーマッタおよび書式マスクの定義