Service Registry には定義済みクエリーがいくつか含まれていますが、これらは、Web コンソール上の「検索」フォームの「定義済みクエリーを選択」ドロップダウンリスト内に表示されます。管理者は、対象レジストリインストールに固有の新しいクエリーをそのドロップダウンリストに追加できます。
Web コンソールを使って AdhocQuery オブジェクトをレジストリに発行します。
クエリーに指定した名前と説明は、定義済みクエリーのドロップダウンリストに表示されます。クエリーの SQL 文には、ユーザーが入力するデータのプレースホルダを指定します。次のように、対になった一重引用符でデータを囲みます。
select * from registryobject where id = ''$lid''
AdhocQuery オブジェクトの一意の識別子と SQL 文内のプレースホルダを記録します。
ディレクトリ RegistryDomain-base/3.0/jaxr-ebxml に移動します。
ファイル registry-browser-config.xml をテキストエディタで開きます。
次の形式のエントリを registry-browser-config.xml ファイルに追加します。SQL 文内の各プレースホルダに対応する Parameter 要素を指定します。
<Query> <AdhocQueryRef id="unique_identifier"/> <Parameter parameterName="$placeholder_name" datatype="string"> <rim:Name> <rim:LocalizedString xml:lang="en" charset="UTF-8" value="parameter_name_in_en_locale"/> <rim:LocalizedString xml:lang="fr" charset="UTF-8" value="parameter_name_in_fr_locale"/> </rim:Name> <rim:Description> <rim:LocalizedString xml:lang="en" charset="UTF-8" value="parameter_description_in_en_locale"/> <rim:LocalizedString xml:lang="fr" charset="UTF-8" value="parameter_description_in_fr_locale"/> </rim:Description> </Parameter> ... </Query>
unique_identifier は、AdhocQuery オブジェクトの一意の識別子です。
各パラメータの parameterName 属性は、クエリーの SQL 文内のプレースホルダから取り込む必要があります。
datatype 属性には、次のいずれかの値を指定できます。
string: パラメータが検索フォーム内でテキストフィールドとして表示されます。
taxonomyElement: パラメータが検索フォーム内でドロップダウンリストとして表示されます。taxonomyElement データ型を指定すると、Name 要素および Description 要素のあとに次のような SlotList 要素が追加されます。
<rim:SlotList> <rim:Slot name="domain"> <rim:ValueList> <rim:Value> classification_scheme_or_concept_id </rim:Value> </rim:ValueList> </rim:Slot> </rim:SlotList>
classification_scheme_or_concept_id は、Concept (または Subconcept) をドロップダウンリストに表示する必要がある Classification Scheme または Concept の一意の識別子です。該当する Classification Scheme がレジストリにまだ存在しない場合は、発行する必要があります。
スロット名は "domain" にする必要があります。
boolean: パラメータが検索フォーム内でチェックボックスとして表示されます。
datatype が string または boolean である場合は、defaultValue 属性を Parameter 要素に追加して、検索フォームに表示されるデフォルト値を指定することもできます。
サポートするすべてのロケールのために、各パラメータの名前と説明に対してローカライズされた文字列値を指定します。検索フォーム内のパラメータのラベルには、現在のロケールの parameter_name が表示されます。
registry-browser-config.xml ファイル内の既存エントリを参考として使用します。
registry-browser-config.xml ファイルを保存して閉じます。