增加預先定義的查詢

1. 使用 Web Console 將即時查詢 (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 網域中的說明進行操作。