您可以建立 REST URI 來執行查詢。
關於這項作業
若要建立 REST URI,以執行查詢,請執行下列動作:
程序
- 在 Rational® ClearQuest® Web 工具列上,按一下新建變更要求旁的箭頭,然後選取新建 REST URI。這樣會開啟「新建 REST URI」精靈。
- 從 REST URI 類型清單中選取執行查詢。
- 從工作區顯示畫面的選取查詢欄位中選取一項查詢。
- 選用項目:若要將 Rational ClearQuest Web 登入參數新增至 REST URI 中,請選取自動登入勾選框。
- 選用項目:若要在執行 REST URI 時所開啟的視窗中併入橫幅、工作區樹狀結構和主要工具列,請選取併入橫幅、工作區樹狀結構和主要工具列勾選框。
- 按一下建立。 REST URI 範本就會出現在 REST URI 範本欄位中。
- 將範本複製到文字編輯器內,並以適當的值取代由雙重大括弧 {{ }} 括住的位置保留元。
選用項目:將資源要求的預設格式從 HTML 變更為 XML 或 ATOM。
- 將已修改的範本複製到您的 Web 應用程式或其他 Web 瀏覽器視窗中。
- 按一下重設來建立新的 REST URI 範本,或按一下關閉以結束。
範例
範例
以下用於執行查詢的 REST URI 範本是使用「新建 REST URI」精靈所建立的。在此範例中,已選取自動登入勾選框來建立 REST URI。
http://CQWebServerHost/cqweb/restapi/YourConnection/YourUserDB/QUERY/QuerySpecification?format=HTML&loginId={{loginid}}&password={{password}}&noframes=true
變數與範本位置保留元具有下列意義:
- CQWebServerHost
- 您的 ClearQuest Web 伺服器主機的網址。這個值是在建立 REST URI 範本時定義的。
- YourConnection
- 您的 ClearQuest 連線。這個值是在建立 REST URI 範本時定義的。
- YourUserDB
- 您的 ClearQuest 使用者資料庫。這個值是在建立 REST URI 範本時定義的。
- QuerySpecification
- 您在選取查詢欄位裡選取指定的查詢。
- format
- 資源要求的預設格式為 HTML。如果需要,您可以將格式變更為 XML 或 ATOM。
- {{loginid}}
- 以您的登入 ID 取代這個位置保留元。
- {{password}}
- 以您的密碼取代這個位置保留元。
- noframes
- 若這個值為 true,則當您執行 REST URI 來檢視資源時,不會出現 ClearQuest Web 橫幅、工作區樹狀結構和主要工具列。只有當 format=HTML 時,才會與 noframes 過濾器相關。