test

Service Registry 3.1 使用者指南

第 2 章 搜尋 Registry

功能表區域的 [搜尋] 和 [檔案管理] 標籤可讓您搜尋 Registry。

使用 [搜尋] 標籤

按一下 [搜尋] 標籤。將開啟 [搜尋] 表單。該表單包含 [選取預先定義的查詢] 組合方塊。還包含有關所選查詢的說明，以及三個按鈕：

該表單的其他內容將根據您選取的查詢而定。預設查詢為 [基本查詢]。

以下幾節說明如何使用這些元件。

選取查詢

[選取預先定義的查詢] 組合方塊包含表 2–1 中顯示的項目。

表 2–1 預先定義的查詢

查詢名稱 

搜尋目的 

基本查詢 

預設常規查詢，可讓您依物件類型、名稱、說明和分類進行搜尋 

基本查詢 - 大小寫相符 

基本查詢的大小寫相符版本 

尋找所有物件 

尋找建立該查詢的使用者所擁有 (發佈) 的所有物件。如果使用者擁有很多物件，則該查詢可能會花費很長時間 

取得呼叫使用者 

為進行查詢的使用者尋找使用者 (User) 物件

WSDL 探索查詢 

尋找 Web 服務描述語言 (WSDL) 文件 

WSDL 連結 (Binding) 探索查詢 

尋找符合 WSDL 連結 (Binding) 定義的抽象服務介面協定連結 

WSDL 連接埠 (Port) 探索查詢 

尋找符合 WSDL 連接埠 (Port) 定義的服務介面之實作 

WSDL 連接埠類型 (PortType) 探索查詢 

尋找符合 WSDL 連接埠類型 (PortType) 定義的抽象服務介面 

WSDL 服務 (Service) 探索查詢 

尋找符合 WSDL 服務 (Service) 定義的 Web 服務 

預設選取為 [基本查詢]。[基本查詢] 和 [基本查詢 — 大小寫相符] 的搜尋表單包含以下元件：

您可以在單一搜尋中指定這些條件中的任何或全部條件。以下小節說明如何執行基本查詢：

使用 [尋找所有物件] 查詢可搜尋您已發佈的所有物件。查詢結果會列出您擁有的所有物件，但不包括可稽核事件 (AuditableEvent) 物件，而且您不可編輯或刪除這類物件。

使用 [取得呼叫使用者] 查詢可檢視或修改您在註冊時建立的使用者資料。

請參閱執行 WSDL 查詢，以取得有關使用 WSDL 查詢的資訊。

依物件類型搜尋

最簡單的搜尋是僅依物件類型搜尋。

[物件類型] 組合方塊中的預設選項為 [RegistryObject]，其會尋找 Registry 中的所有物件。若要縮小搜尋範圍，請變更物件類型。

[分類節點 (ClassificationNode)] 選項列出了分類方案中的概念。分類節點 (ClassificationNode) 是 Concept 的同義詞。

表 2–2 說明 Registry 中可用的物件類型。

表 2–2 Service Registry 物件類型

物件類型 

說明 

即時查詢

表示以查詢語法表述的即時查詢。即時查詢 (AdhocQuery) 物件用於登錄 (Registry) 物件的探索。就用途而言，即時查詢 (AdhocQuery) 物件與關聯性資料庫中的預存程序概念類似。例如，[搜尋] 面板中預先定義的查詢均為即時查詢 (AdhocQuery) 物件。

關聯

定義兩個物件之間的關係。 

可稽核事件

記錄對物件所做的變更。可稽核事件 (AuditableEvent) 物件的集合可構成物件的稽核記錄。

分類

使用分類方案 (ClassificationScheme) 對物件進行分類。

分類節點

表示在內部分類方案 (ClassificationScheme) 中與其他元素具有結構關係的分類元素。也稱為 Concept。

分類方案

表示用於劃分物件類別的分類。在內部分類方案 (ClassificationScheme) 中，所有分類元素在 Registry 中均定義為 Concept 實例。在外部分類方案 (ClassificationScheme) 中，Registry 中不會將值定義為 Concept 實例，而是以其 String 表示方式進行參照。

外部識別碼

使用識別方案 (外部分類方案 [ClassificationScheme]) 中的 String 值，提供物件的附加資訊。識別方案的範例包括 DUNS 號碼和社會福利號碼。

外部連結

可為 Registry 外部的內容提供 URI。 

外部物件

提供中介資料來說明提交的內容，該內容類型實際並不為 Registry 所知，因此必須透過其他屬性進行說明，例如 MIME 類型。 

聯合

表示 Registry 的關聯群組。 

通知

表示來自 Registry 關於符合訂閱 (Subscription) 之事件的通知。

組織

提供有關組織的資訊。可能具有父系，並且可能具有一個或多個子組織。始終將一個使用者 (User) 物件做為主要連絡人，並且可以提供服務 (Service) 物件。

個人 (Person)、使用者 (User)

提供 Registry 中人員和註冊使用者的相關資訊。使用者 (User) 物件可與組織 (Organization) 物件相關聯。

登錄 (Registry)

表示登錄。 

RegistryPackage

表示具有任意數目之登錄 (Registry) 物件的邏輯群組。 

服務 (Service)

提供有關服務的資訊。可能包含一個或多個服務連結 (ServiceBinding) 物件。

ServiceBinding

表示有關如何存取服務的技術資訊。 

SpecificationLink

提供服務連結 (ServiceBinding) 和技術規格 (說明如何透過服務連結 (ServiceBinding) 來使用該服務) 之間的連結。

訂閱 (Subscription)

定義使用者 (User) 對特定類型的可稽核事件 (AuditableEvent) 有興趣。使用者 (User) 可建立訂閱 (Subscription) 以接收特定類型事件的通知。

Procedure若要依物件類型搜尋，請

  1. 從 [物件類型] 組合方塊中選擇物件類型。

  2. 按一下 [搜尋] 按鈕，或將游標置於 [名稱] 或 [說明] 文字欄位中，然後按 [傳回]。

    搜尋將傳回指定類型的所有物件。您可以透過指定名稱、說明、狀態或分類來縮小搜尋範圍。

依名稱和說明搜尋

您可以依名稱、依說明，或綜合兩者來搜尋物件。

Procedure若要依名稱或說明搜尋，請

  1. 在 [名稱或說明] 欄位中鍵入字串。

    依預設，搜尋會尋找與您鍵入的整個字串相符的名稱或說明。您可以使用萬用字元來尋找一系列物件。

    萬用字元為百分比 (%) 和底線 (_)。

    百分比萬用字元可比對多個字元：

    • 鍵入 %off%，可傳回包含字串 off 的名稱或說明，例如 Coffee。

    • 鍵入 nor%，可傳回以 Nor 或 nor 開頭的名稱或說明，例如 North 和 northern。

    • 鍵入 %ica，可傳回以 ica 結尾的名稱或說明，例如 America。

    底線萬用字元可比對單一字元。例如，搜尋字串 _us_ 可比對名為 Aus1 和 Bus3 的物件。

  2. 按一下 [搜尋] 按鈕或按 [傳回]。

依狀態搜尋

Registry 中的物件可具有以下四種狀態之一：

Registry 中物件的預設狀態為 [Submitted (已提交)]。物件可以由 Registry 管理員或物件的所有者批准或停用。如果外部物件 (ExtrinsicObject) 的儲存庫項目已移除，則其狀態為 [Withdrawn (已撤銷)]。

Procedure依狀態搜尋

  1. 從 [狀態] 組合方塊中選擇狀態。

  2. 按一下 [搜尋] 按鈕，或將游標置於 [名稱] 或 [說明] 文字欄位中，然後按 [傳回]。

    搜尋將傳回具有指定狀態的所有物件。您可以透過指定物件類型、名稱、說明或分類來縮小搜尋範圍。

依分類搜尋

分類 (Classification) 物件會使用可在分類方案內部定義有效值的唯一概念 (分類節點 [ClassificationNode] 物件)，對 Registry 中的物件進行分類。在包含多級子概念的樹狀結構階層中，分類方案是父系。表 2–3 說明 Registry 規格提供的分類方案，稱為規範分類方案。此表中的許多專有名詞在 Registry 規格中有定義。

表 2–3 規範分類方案 (Classification Scheme)

分類方案 (Classification Scheme) 名稱 

使用情況 

說明或目的 

AssociationType

經常使用 

定義登錄 (Registry) 物件之間的關聯類型。用做關聯 (Association) 實例的 associationType 屬性值，以說明關聯的性質。

ContentManagementService

很少使用 

定義內容管理服務的類型。用於內容管理服務 (例如驗證或分類服務) 的配置。 

DataType

經常使用 

定義物件屬性的資料類型。用做 Slot 實例的 slotType 屬性值，以說明 Slot 值的資料類型。

DeletionScopeType

偶爾使用 

定義 RemoveObjectsRequest 協定訊息的 deletionScope 屬性值。

EmailType

很少使用 

定義電子郵件位址的類型。 

ErrorHandlingModel

很少使用 

定義內容管理服務的錯誤處理模型的類型。 

ErrorSeverityType

很少使用 

定義處理協定訊息時 Registry 遇到的不同錯誤嚴重性類型。 

EventType

偶爾使用 

定義 Registry 中可能發生的事件類型。 

InvocationModel

很少使用 

定義 Registry 呼叫內容管理服務的不同方式。 

NodeType

偶爾使用 

定義分類方案 (ClassificationScheme) 為其分類節點 (ClassificationNode) (Concept) 物件指定 code 屬性值的不同方式。

NotificationOptionType

很少使用 

定義 Registry 向用戶端通知訂閱 (Subscription) 範圍內事件的不同方式。

ObjectType

偶爾使用 

定義 Registry 可支援的不同 RegistryObject 類型。

PhoneType

很少使用 

定義電話號碼的類型。 

QueryLanguage

很少使用 

定義 Registry 支援的查詢語言。 

ResponseStatusType

很少使用 

定義 RegistryResponse 狀態的不同類型。

StatusType

偶爾使用 

定義 RegistryObject 狀態的不同類型。

SubjectGroup

很少使用 

定義使用者為存取控制目的而可歸屬的群組。 

SubjectRole

很少使用 

定義為存取控制目的而可指定給使用者的角色。 

規範分類方案的主要目的不是要對物件進行分類，而是要提供物件屬性的列舉類型。Registry 也包含很多非規範分類方案，您也可以自行建立分類方案。

Procedure若要依分類搜尋，請

  1. 按一下 [選取分類節點] 按鈕。

    將顯示 [分類節點選擇器] 視窗。

  2. 按一下您要使用的分類方案的資料夾圖示。

    每個項目後括號中的數字表示父系包含的概念 (分類節點 [ClassificationNode] 物件) 數。

  3. 展開分類方案下的概念節點，直到找到搜尋所依據的尾節點。尾節點是指不包含任何概念的節點。

  4. 選取尾節點。

  5. 按一下 [分類節點選擇器] 視窗中的 [關閉]。

    在 [值] 文字欄位中會顯示所選概念的 ID。

  6. 按一下 [搜尋] 按鈕，或將游標置於 [名稱] 或 [說明] 文字欄位中，然後按 [傳回]。

執行 WSDL 查詢

[搜尋] 面板包含預先定義的查詢，可讓您使用不同的搜尋條件來搜尋 WSDL 檔案：

本小節說明如何執行這些搜尋。對於所有搜尋作業，您均可指定任意數量的搜尋條件。

Procedure執行 WSDL 探索查詢

  1. 從 [選取預先定義的查詢] 組合方塊中選擇 [WSDL 探索查詢]。

    將顯示搜尋表單。

  2. 在 [名稱] 和/或 [說明] 欄位中鍵入值。

  3. 從 [狀態] 組合方塊中選取值。

  4. 在 [目標名稱空間] 欄位中鍵入值。

  5. 按一下 [搜尋] 或按 [傳回]。

Procedure執行 WSDL 連結 (Binding) 探索查詢

  1. 從 [選取預先定義的查詢] 組合方塊中選擇 [WSDL 連結 (Binding) 探索查詢]。

    將顯示搜尋表單。

  2. 在 [連結名稱] 和/或 [連結說明] 欄位中鍵入值。

  3. 從 [連結狀態] 組合方塊中選取值。

  4. 在 [連結目標名稱空間] 欄位中鍵入值。

  5. 從 [連結協定類型] 組合方塊中選取值。

  6. 從 [連結傳輸類型] 組合方塊中選取值。

  7. 從 [SOAP 連結樣式] 組合方塊中選取值。

  8. 選擇性選取 [考量連接埠類型] 核取方塊。如果您選取此核取方塊，請執行以下作業：

    1. 在 [連接埠類型名稱] 和/或 [連接埠類型說明] 欄位中鍵入值。

    2. 從 [連接埠類型狀態] 組合方塊中選取值。

    3. 在 [連接埠類型目標名稱空間] 欄位中鍵入值。

  9. 按一下 [搜尋] 或按 [傳回]。

Procedure執行 WSDL 連接埠 (Port) 探索查詢

  1. 從 [選取預先定義的查詢] 組合方塊中選擇 [WSDL 連接埠 (Port) 探索查詢]。

    將顯示搜尋表單。

  2. 在 [連接埠名稱] 和/或 [連接埠說明] 欄位中鍵入值。

  3. 從 [連接埠狀態] 組合方塊中選取值。

  4. 在 [連接埠目標名稱空間] 欄位中鍵入值。

  5. 在 [連接埠終點] 欄位中鍵入值。

  6. 選擇性選取 [考量連結] 核取方塊。如果您選取此核取方塊，請執行以下作業：

    1. 在 [連結名稱] 和/或 [連結說明] 欄位中鍵入值。

    2. 從 [連結狀態] 組合方塊中選取值。

    3. 在 [連結目標名稱空間] 欄位中鍵入值。

    4. 從 [連結協定類型] 組合方塊中選取值。

    5. 從 [連結傳輸類型] 組合方塊中選取值。

    6. 從 [SOAP 連結樣式] 組合方塊中選取值。

    7. 選擇性選取 [考量連接埠類型] 核取方塊。如果您選取此核取方塊，請執行以下作業：

      1. 在 [連接埠類型名稱] 和/或 [連接埠類型說明] 欄位中鍵入值。

      2. 從 [連接埠類型狀態] 組合方塊中選取值。

      3. 在 [連接埠類型目標名稱空間] 欄位中鍵入值。

  7. 按一下 [搜尋] 或按 [傳回]。

Procedure執行 WSDL 連接埠類型 (PortType) 探索查詢

  1. 從 [選取預先定義的查詢] 組合方塊中選擇 [WSDL 連接埠類型 (PortType) 探索查詢]。

    將顯示搜尋表單。

  2. 在 [連接埠類型名稱] 和/或 [連接埠類型說明] 欄位中鍵入值。

  3. 從 [連接埠類型狀態] 組合方塊中選取值。

  4. 在 [連接埠類型目標名稱空間] 欄位中鍵入值。

  5. 按一下 [搜尋] 或按 [傳回]。

Procedure執行 WSDL 服務 (Service) 探索查詢

  1. 從 [選取預先定義的查詢] 組合方塊中選擇 [WSDL 服務 (Service) 探索查詢]。

    將顯示搜尋表單。

  2. 在 [服務名稱] 和/或 [服務說明] 欄位中鍵入值。

  3. 從 [服務狀態] 組合方塊中選取值。

  4. 在 [服務目標名稱空間] 欄位中鍵入值。

  5. 選擇性選取 [考量連接埠] 核取方塊。如果您核取此方塊，請執行以下作業：

    1. 在 [連接埠名稱] 和/或 [連接埠說明] 欄位中鍵入值。

    2. 從 [連接埠狀態] 組合方塊中選取值。

    3. 在 [連接埠目標名稱空間] 欄位中鍵入值。

    4. 在 [連接埠終點] 欄位中鍵入值。

    5. 選擇性選取 [考量連結] 核取方塊。如果您選取此核取方塊，請執行以下作業：

      1. 在 [連結名稱] 和/或 [連結說明] 欄位中鍵入值。

      2. 從 [連結狀態] 組合方塊中選取值。

      3. 在 [連結目標名稱空間] 欄位中鍵入值。

      4. 從 [連結協定類型] 組合方塊中選取值。

      5. 從 [連結傳輸類型] 組合方塊中選取值。

      6. 從 [SOAP 連結樣式] 組合方塊中選取值。

      7. 選擇性選取 [考量連接埠類型] 核取方塊。如果您選取此核取方塊，請執行以下作業：

        1. 在 [連接埠類型名稱] 和/或 [連接埠類型說明] 欄位中鍵入值。

        2. 從 [連接埠類型狀態] 組合方塊中選取值。

        3. 在 [連接埠類型目標名稱空間] 欄位中鍵入值。

  6. 按一下 [搜尋] 或按 [傳回]。

接下來的步驟

請參閱尋找服務的 WSDL 文件，以取得有關尋找與所找到服務相關聯之 WSDL 檔案的資訊。

Procedure尋找服務的 WSDL 文件

找到服務後，您通常會想找到與該服務相關聯的 WSDL 檔案，以便可以使用它來建立用戶端代理，以與該服務進行通訊。若要執行此作業，請依照下列步驟進行操作。

  1. 按一下 [服務] 物件的 [詳細資訊] 連結。

  2. 按一下 [關聯 (Association)] 標籤。

    [來源物件] 欄包含一個名為 WSDL 的連結。

  3. 按一下 [WSDL] 連結。

    將顯示 [詳細資訊] 視窗。

  4. 按一下 [檢視儲存庫項目內容] 以檢視 WSDL 檔案。

  5. 使用瀏覽器的 [另存新檔] 功能表項目，將檔案儲存到本機系統中。

檢視搜尋結果

搜尋找到的物件將顯示在 [登錄 (Registry) 物件] 區域。

[登錄 (Registry) 物件] 區域的組成部分如下：

針對外部物件 (ExtrinsicObject) 物件還額外顯示兩個欄：[內容版本] 和 [內容版本註釋]。這些欄適用於外部物件 (ExtrinsicObject) 的儲存庫項目。

對於以下兩種物件，[版本] 和 [版本註釋] 欄會由其他內容替代：

Procedure使用 [書籤] 功能

使用者介面的 [書籤] 功能可讓您在搜尋其他物件的同時，將一個或多個物件保留在 [登錄 (Registry) 物件] 區域中。然後您可以在兩個物件之間建立關係。請參閱建立物件之間的關係，以取得有關如何執行此作業的詳細資訊。

  1. 按一下 [搜尋] 執行查詢。

  2. 在 [登錄 (Registry) 物件] 區域中，請為您要保留在此的一個或多個物件選取 [挑選] 核取方塊，然後按一下 [書籤] 按鈕。

    物件會顯示在搜尋結果上方的 [標有書籤的物件] 區域中。

  3. 執行其他查詢。

接下來的步驟

當您使用完標有書籤的物件後，請為物件選取 [挑選] 核取方塊，然後按一下 [移除書籤] 按鈕。物件會從 [標有書籤的物件] 區域中移除。如果 [標有書籤的物件] 區域中僅有一個物件，則移除該物件後便不再顯示 [標有書籤的物件] 區域。

檢視物件詳細資訊

在搜尋結果表格中，按一下物件的 [詳細資訊] 連結可開啟 [登錄 (Registry) 物件] 區域正下方的 [詳細資訊] 區域。

此區段有一列按鈕和一列標籤：

表 2–4 [詳細資訊] 區域的屬性標籤

標籤名稱 

適用於 

Object-Type 詳細資訊

所有物件 (Object-Type 是物件類型名稱)

槽 

所有物件 

分類 

所有物件 

外部識別碼 (External Identifier) 

所有物件 

關聯 (Association) 

所有物件 

外部連結 (External Link) 

所有物件 

稽核記錄 

所有物件 

郵遞地址 

組織 (Organization)、使用者 (User)

電話號碼 

組織 (Organization)、使用者 (User)

電子郵件地址 

組織 (Organization)、使用者 (User)

使用者 

組織

組織 

組織

服務連結 

服務 (Service)

規格連結 

ServiceBinding

概念 

分類方案 (ClassificationScheme)、分類節點 (ClassificationNode)

成員 

RegistryPackage

受影響的物件 

可稽核事件

按一下標籤以查看物件是否有屬性值。如果有，按一下屬性值的 [詳細資訊] 連結可開啟含有屬性值詳細資訊的瀏覽器視窗。

[關聯 (Association)] 標籤會產生一個表格，表格中的每個關聯各有 3 個連結：

在 [來源物件] 和 [目標物件] 欄中，您正在檢視其關聯的物件類型會以粗體顯示。

[稽核記錄] 標籤不產生帶有 [詳細資訊] 連結的表格，而會產生包含以下資訊的表格：

對於大多數物件，[詳細資訊] 區域欄位如下：

對於許多物件，不需要對這些欄位另加說明 (例如組織 [Organization] 的郵遞地址)。而對於某些物件，則需要對這些欄位加以說明。以下小節說明了這些欄位。

檢視關聯 (Association) 詳細資訊

關聯 (Association) 物件的 [詳細資訊] 區域包含以下附加欄位：

檢視分類方案 (Classification Scheme) 詳細資訊

分類方案 (ClassificationScheme) 物件的 [詳細資訊] 區域包含以下附加欄位︰

檢視外部物件 (Extrinsic Object) 詳細資訊

外部物件 (ExtrinsicObject) 物件的 [詳細資訊] 區域包含以下附加欄位︰

檢視外部連結 (External Link) 詳細資訊

外部連結 (ExternalLink) 物件的 [詳細資訊] 區域包含以下附加欄位：

使用 [檔案管理] 標籤

[檔案管理] 標籤可讓您使用檔案資料夾階層形式瀏覽 Registry 和儲存庫內容。名為登錄 (registry) 的根資料夾包含所有 Registry 內容。

Procedure使用 [檔案管理] 標籤

  1. 按一下 [檔案管理] 連結。

  2. 按一下標記為 registry 的資料夾。該資料夾包含兩個子資料夾：userData (其中放置所有使用者內容) 和分類方案 (ClassificationScheme)。

  3. 按一下連結以檢視此類型的登錄 (Registry) 物件。按一下資料夾或展開節點以檢視下一層級的物件類型。

Procedure檔案管理分類方案

  1. 按一下 [分類方案 (ClassificationScheme)] 資料夾以開啟功能表區域中的 [分類方案 (ClassificationScheme)] 樹狀結構階層。

  2. 按一下任何連結以在 [登錄 (Registry) 物件] 區域中檢視該分類方案。

  3. 按一下分類方案資料夾以查看其下的概念。

    如果概念圖示為資料夾，則其具有子概念，並且您可以按一下該圖示以將其展開。如果概念圖示為檔案，則其不具有任何子概念。

    如果分類方案資料夾為檔案圖示，則分類方案不具有可在 [檔案管理] 區域中檢視的概念。

  4. 按一下概念連結可在 [登錄 (Registry) 物件] 區域中檢視該概念。

Procedure檔案管理 UserData 資料夾

  1. 展開 userData 節點。

  2. 展開 RegistryObject 節點。除非您要檢視所有登錄 (Registry) 物件，否則請勿按該連結。

  3. 按一下資料夾以檢視此類型的登錄 (Registry) 物件。展開節點以檢視下一層級的物件類型。