建立 REST URI 來檢視記錄

您可以透過直接鏈結到記錄的方式來建立 REST URI,以檢視使用者資料庫裡的記錄。 您所建立的 REST URI 在檢視記錄時開啟記錄的速度,會比在尋找記錄時更為快速。 原因是當您建立 REST URI 範本來檢視記錄時,必須指定記錄類型,這樣會縮小搜尋的範圍。
執行這項作業的原因和時機

若要建立 REST URI,以檢視記錄,請執行下列動作:

  1. Rational® ClearQuest® Web 工具列上,按一下新建變更要求旁的箭頭,然後選取新建 REST URI。這樣會開啟「新建 REST URI」精靈。
  2. REST URI 類型清單中選取檢視記錄
  3. 記錄類型清單中選取一個記錄類型。
  4. 選用項目:若要將 Rational ClearQuest Web 登入參數新增至 REST URI 中,請選取自動登入勾選框。
  5. 選用項目:若要在執行 REST URI 時所開啟的視窗中併入橫幅、工作區樹狀結構和主要工具列,請選取併入橫幅、工作區樹狀結構和主要工具列勾選框。
  6. 按一下建立 REST URI 範本就會出現在 REST URI 範本欄位中。
  7. 將範本複製到文字編輯器內,並以適當的值取代由雙重大括弧 {{ }} 括住的位置保留元。

    選用項目:將資源要求的預設格式從 HTML 變更為 XMLATOM

  8. 將已修改的範本複製到您的 Web 應用程式或其他 Web 瀏覽器視窗中。
  9. 按一下重設來建立新的 REST URI 範本,或按一下關閉以結束。
範例

範例

以下用於檢視記錄的 REST URI 範本是使用「新建 REST URI」精靈所建立的。在此範例中,當建立 REST URI 時,選取了 ALMActivity 作為記錄類型的值。

http://CQWebServerHost/cqweb/restapi/YourConnection/YourUserDB/RECORD/{{recordId}}?format=HTML&recordType=ALMActivity&loginId={{loginid}}&password={{password}}
變數與範本位置保留元具有下列意義:
CQWebServerHost
您的 ClearQuest Web 伺服器主機的網址。這個值是在建立 REST URI 範本時定義的。
YourConnection
您的 ClearQuest 連線。這個值是在建立 REST URI 範本時定義的。
YourUserDB
您的 ClearQuest 使用者資料庫。這個值是在建立 REST URI 範本時定義的。
{{recordId}}
您要鏈結到的記錄 ID 的位置保留元。
format
資源要求的預設格式為 HTML。 如果需要,您可以將格式變更為 XMLATOM
{{loginid}}
以您的登入 ID 取代這個位置保留元。
{{password}}
以您的密碼取代這個位置保留元。

意見