增加預先定義的查詢

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 資料類型，名稱和說明元素必須後接 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 網域中的說明進行操作。