JClientコントロールの検索モードについて

JClientでは、JClientデータ・パネルで検索モードを有効にしてJUNavigationBarコントロールを使用すると、パラメータ付き問合せをサポートできます。検索モードでは、サポートされているJClientコントロール・バインディングを介してユーザーがデータ・パネルから検索条件を入力できます。

検索モードの操作が可能なデータ・パネルを最も簡単に作成するには、データ・パネルから検索を実行するビジネス・コンポーネント・ビュー・オブジェクトにJUNavigationBarをバインドします。ナビゲーション・バーには「検索」ボタンが表示されます。ユーザーはこのボタンを選択してJClientフォームへのJClientコントロール・バインディングの動作を次のように切り替えます。

検索モード・ボタンの状態は、JUNavigationBarのhasFindButtonプロパティによって制御されます(デフォルトではtrue)。

パラメータ付き問合せ

パラメータ付き問合せは、実行時に値が指定されるプレースホルダが含まれた問合せです。 たとえば、次のPL/SQL文のmin_salaryは、パラメータ値のプレースホルダで、実行時に値が指定されます。

SELECT ename, job, mgr FROM emp WHERE sal < :min_salary

検索モードのデータ・パネルでは、JClientコントロール・バインディングを使用して、バインドされたビジネス・コンポーネント・ビュー・オブジェクトの属性の中から、「Queriable」プロパティがtrueに設定されている属性のフィールドを表示します。ビュー・オブジェクトは、ビジネス・コンポーネントにより実行される最初の問合せを定義します。

検索に使用できるJClientコントロール

一部のJClientコントロール・バインディングでは、検索モードはサポートされません。 データ・パネルを検索用に作成する場合は、検索条件の入力を可能にするため、フォームにはビジネス・コンポーネント・ビュー・オブジェクト属性にバインドされる次のコントロールを使用します。

ユーザーが検索モードを選択する際には、前述のリストに含まれていないコントロールをデータ・パネルで使用不可にすることをお薦めします。検索モードをサポートしていないコントロールを使用不可にすることによって、無効な検索条件の送信を防止できます。

検索モードを使用したデータ・パネルの一般的な使用方法を次に示します。

  1. パネルを検索モードにします。

    たとえば、(ビジネス・コンポーネント・ビュー・オブジェクトにバインドされている)JUNavigationBarにデフォルトで表示される「検索」ボタンをクリックします。

  2. すでにフォームに返されているデータの結果を絞り込むための検索条件を入力します。

  3. 検索モードにより、ワイルド・カードを使用したアンカー検索が行われます。

    ここでは検索列の先頭文字がアンカーとして使用され、入力した文字列で始まるすべての文字列が検索されます。

  4. JClientで同じビュー・オブジェクトにバインドした別のコントロール(JTableコントロールなど)に、パラメータ付き問合せの結果が表示されます。

ビジネス・コンポーネントでのビュー基準の使用方法の詳細は、JavaDocの次のクラスを参照してください。

oracle.jbo.ViewCriteria


JClientでのLOVダイアログのサポートについて

 

Copyright © 1997, 2004, Oracle. All rights reserved.