您可以透過直接鏈結到記錄的方式建立 REST URI,以修改使用者資料庫裡的記錄。
執行這項作業的原因和時機
若要建立 REST URI,以修改記錄,請執行下列動作:
- 在 Rational® ClearQuest® Web 工具列上,按一下新建變更要求旁的箭頭,然後選取新建 REST URI。 這樣會開啟「新建 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」精靈所建立的。在此範例中, 從記錄類型清單中選取 ALMActivity,從動作類型清單中選取 Activate ,並選取自動儲存變更、自動登入和併入橫幅、工作區樹狀結構和主要工具列勾選框,來建立 REST URI。
http://CQWebServerHost/cqweb/restapi/YourConnection/YourUserDB/RECORD?format=HTML&recordType=ALMActivity&action=Activate&fieldsXml=&autoSave=true&loginId={{loginid}}&password={{password}}
變數與範本位置保留元具有下列意義:
- CQWebServerHost
- 您的 ClearQuest Web 伺服器主機系統的網址。這個值是在建立 REST URI 範本時定義的。
- YourConnection
- 您的 ClearQuest 連線。這個值是在建立 REST URI 範本時定義的。
- YourUserDB
- 您的 ClearQuest 使用者資料庫。這個值是在建立 REST URI 範本時定義的。
- format
- 資源要求的預設格式為 HTML。
如果需要,您可以將格式變更為 XML 或 ATOM。
- {{loginid}}
- 您登入 ID 的位置保留元。
- {{password}}
- 您密碼的位置保留元。
下列範例顯示如何輸入日期欄位、參照欄位、參照清單和多行欄位值來作為 REST URI 裡的參數。
- 此範例顯示如何提供日期欄位值作為 REST URI 裡的參數,以提交或修改記錄:
fieldsXML=<Field><Name>f_datetime</Name><Value><![CDATA[2008-09-08%2009%3A44%3A34]]></Value></Field>
結果:記錄欄位欄位日期時間會設為 08/09/08 09:44:34。
- 下一個範例顯示如何提供參照欄位或參照清單值作為 REST URI 裡的參數,以提交或修改記錄:
fieldsXML=<Field><Name>customer</Name><Value><!CDATA[Joe%20Lee]]></Value><Value><!CDATA[Jane%20Smith]]></Value></Field><Field><Name>Project</Name><Value><!CDATA[Classics]]></Value></Field>
結果: 在記錄的客戶參照清單中,新增了 Joe Lee 和 Jane Smith,並且在專案參照欄位中,新增了 Classics。
- 此範例顯示如何提供多行欄位值作為 REST URI 裡的參數,以提交或修改記錄:
fieldsXML=<Field><Name>Description</Name><Value><![CDATA[firstline%0Asecondline]]></Value></Field>
結果:在說明記錄欄位裡,firstline 和 secondline 文字已格式化為顯示在個別的行上。