Service Registry 3.1 管理指南

Procedure添加预定义的查询

  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:参数显示为“搜索”表单中的复选框。

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

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

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

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

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