定義 REST 服務端點

定義 REST 服務之後，下一步是針對不同環境定義 REST 服務端點，以指出服務的位置。

1. 選擇性的： 如果您已啟用安全，且已經為每一個控管啟用設定檔角色指派個別使用者 ID（如控管現有的服務所述），請以指派給「作業」角色的使用者 ID 登入 WSRR Web 使用者介面。
2. 請在 Web 使用者介面中，從視景清單中選取作業，以切換至「作業」視景。
3. 為「暫置」環境建立新的 REST 服務端點。
   1. 按一下動作 > 建立 > REST > 建立 REST 服務端點。
   2. 在名稱欄位中，輸入 http://CSStagingHost:9081/services/catalog/。
   3. 在說明欄位中，輸入暫置系統上型錄服務的服務端點。
   4. 在版本欄位中，輸入 1.0。
   5. 在基本 URL 欄位中，輸入 http://CSStagingHost:9081/services/catalog/，此為端點的 URL 根目錄，該端點提供「型錄搜尋」服務所代表的 REST 資源集合服務。
   6. 在服務名稱空間欄位中，輸入 http://commonServices.org/。
   7. 在端點類型欄位中，輸入 REST。
   8. 在服務名稱欄位中，輸入型錄搜尋。
   9. 在服務版本欄位中，輸入 1.0。
   10. 按一下完成，以儲存新的 REST 服務端點。
4. 將暫置環境分類新增至端點。
   1. 按一下編輯分類。
   2. 展開控管設定檔分類架構 > 環境。
   3. 選取暫置的勾選框，然後按一下新增。 「暫置」分類即會新增至分類清單。
   4. 按一下確定，以指派分類。
5. 將可見性分類新增至端點。 因為這是「暫置」環境中現有的服務，所以有內部端點；此分類會宣告這個端點。
   1. 按一下編輯分類。
   2. 展開可見性分類系統 > 可見性。
   3. 選取內部的勾選框，然後按一下新增。「內部」分類即會新增至分類清單。在此範例中，「暫置」主機是供測試人員使用的內部系統，而不是供一般消費者使用。
   4. 按一下確定，以指派分類。
6. 啟動端點。 因為這是「暫置」環境中已經在使用的現有服務，所以您必須啟動端點的說明來反映這一點。
   1. 按一下核准使用。 端點控管狀態會變更為「線上」。
7. 為「正式作業」環境建立新的 REST 服務端點。
   1. 按一下動作 > 建立 > REST > 建立 REST 服務端點。
   2. 在名稱欄位中，輸入 http://CSProductionHost:9443/services/catalog/。
   3. 在說明欄位中，輸入正式作業系統上型錄服務的服務端點。
   4. 在版本欄位中，輸入 1.0。
   5. 在基本 URL 欄位中，輸入 http://CSProductionHost:9443/services/catalog/，此為端點的 URL 根目錄，該端點提供「型錄搜尋」服務所代表的 REST 資源集合服務。
   6. 在服務名稱空間欄位中，輸入 http://commonServices.org/。
   7. 在端點類型欄位中，輸入 REST。
   8. 在服務名稱欄位中，輸入型錄搜尋。
   9. 在服務版本欄位中，輸入 1.0。
   10. 按一下完成，以儲存新的 REST 服務端點。
8. 將正式作業環境分類新增至端點。
   1. 按一下編輯分類。
   2. 展開控管設定檔分類架構 > 環境。
   3. 選取「正式作業」的勾選框，然後按一下新增。 「正式作業」分類即會新增至分類清單。
   4. 按一下確定，以指派分類。
9. 將可見性分類新增至端點。 因為這是「正式作業」環境中現有的服務，所以有一個外部端點；此分類會宣告這個端點。
   1. 按一下編輯分類。
   2. 展開可見性分類系統 > 可見性。
   3. 選取「外部」的勾選框，然後按一下新增。「外部」分類即會新增至分類清單。
   4. 按一下確定，以指派分類。
10. 啟動端點。 因為這是「正式作業」環境中已經在使用的現有服務，所以您必須啟動端點的說明來反映這一點。
    1. 按一下核准使用。端點控管狀態會變更為「線上」。
    「型錄服務」的 REST 服務端點現在有兩個定義；每一個環境各一個定義。您必須建立這些端點與所代表的 REST 服務的關聯。
11. 建立「REST 服務端點」與「REST 服務」的關聯。
    1. 必要的話，請在 Web 使用者介面中，從視景清單中選取開發，以切換至「開發」視景。
    2. 選取檢視 > 服務模型 > REST 服務。
    3. 從集合視圖中選取型錄搜尋。
    4. 按一下編輯關係，以新增 REST 端點。
    5. 在此 REST 服務的詳細資料視圖中，按一下「新增關係」下的新增 REST 服務端點。
    6. 在「搜尋現有實體」下的名稱欄位中，輸入 *。
    7. 按一下搜尋。
    8. 選取 http://CSProductionHost:9443/services/catalog/ 及 http://CSStagingHost:9081/services/catalog/ 的勾選框
    9. 按一下套用選取的目標。
    10. 按一下完成，以儲存 REST 服務。