添加预定义的查询

Service Registry 包括若干个预定义的查询，这些预定义的查询显示在“ Web 控制台搜索”表单的“选择预定义的查询”下拉式列表中。作为管理员，您可以根据具体的 Registry 安装向下拉式列表中添加新的查询。

添加预定义的查询

1. 使用 Web 控制台将特殊查询 (AdhocQuery) 对象发布到 Registry 中。

   您为查询指定的名称和描述将显示在预定义查询的下拉式列表中。在 SQL 查询语句中，通过将用户提供的数据括在成对单引号中为这些数据指定占位符，如下所示：

   select * from registryobject where id = ''$lid''

2. 记下特殊查询 (AdhocQuery) 对象以及 SQL 语句中任何占位符的唯一标识符，或将其复制并粘贴到文件中。

3. 转至目录 RegistryDomain-base/3.0/jaxr-ebxml。

4. 在文本编辑器中打开文件 registry-browser-config.xml。

   请复制原始文件，这样可以在需要时回退更改。

5. 使用以下格式向 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 是分类方案或概念（其概念（或子概念）必须显示在下拉式列表中）的唯一标识符。如果分类方案尚未存在于 Registry 中，您必须发布此方案。

     插槽名称必须为 "domain"。

   • boolean：参数显示为“搜索”表单中的复选框。

   如果 datatype 为 string 或 boolean，您还可以将 defaultValue 属性添加到 Parameter 元素中，以指定要在“搜索”表单中显示的默认值。

   针对支持的所有语言环境，为每个参数名称和描述指定本地化字符串值。当前语言环境中的 parameter-name 显示为“搜索”表单中的参数标签。

   使用 registry-browser-config.xml 文件中的现有条目作为参考。

6. 保存并关闭 registry-browser-config.xml 文件。

7. 按照停止并重新启动 Registry 的 Application Server 域中的说明进行操作。