レコード修正用の REST URI の作成

レコードに直接リンクしてユーザー データベース内のレコードを修正するための REST URI を作成することができます。

このタスクについて

レコード修正用の REST URI を作成するには、次のようにします。

手順

  1. Rational® ClearQuest® Web ツールバーで [新規の変更依頼] の横にある矢印をクリックして、[新規 REST URI] を選択します。 [新規 REST URI] ウィザードが開きます。
  2. [REST URI タイプ] リストから [レコードの修正] を選択します。
  3. [レコード タイプ] リストからレコード タイプを選択します。
  4. [アクション タイプ] リストからアクションを選択します。 選択可能なアクション タイプはレコード タイプによって決まります。
  5. オプション: REST URI にパラメータとして追加するレコード フィールドを、[自動的に入力されるレコード フィールド] リストから選択します。
  6. オプション: レコードに対するすべての変更を保存するには、[変更の自動保存] チェック ボックスを選択します。
  7. オプション: Rational ClearQuest Web ログイン パラメータを REST URI に追加するには、 [自動ログイン] を選択します。
  8. オプション: REST URI の実行時に開くウィンドウにバナー、ワークスペース ツリー、メイン ツールバーを組み込むには、 [バナー、ワークスペース ツリー、メイン ツールバーを組み込む] チェック ボックスを選択します。
  9. [作成] をクリックします。 REST URI テンプレートが [REST URI テンプレート] フィールドに表示されます。
  10. テンプレートをテキスト エディタにコピーして、二重中括弧 {{ }} で囲まれたプレースホルダを適切な値に置き換えます。

    オプション: リソース要求のデフォルト フォーマットを、HTML から XML または ATOM に変更します。

  11. 修正したテンプレートを Web アプリケーションまたは別の Web ブラウザ ウィンドウにコピーします。
  12. [リセット] をクリックして新規 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 サーバー ホスト システムの Web アドレス。この値は、REST URI テンプレートの作成時に定義されます。
YourConnection
使用する ClearQuest 接続。この値は、REST URI テンプレートの作成時に定義されます。
YourUserDB
使用する ClearQuest ユーザー データベース。 この値は、REST URI テンプレートの作成時に定義されます。
format
リソース要求のデフォルト フォーマットは HTML です。 必要に応じて、このフォーマットを XML または ATOM に変更することができます。
{{loginid}}
ログオン ID のプレースホルダ。
{{password}}
パスワードのプレースホルダ。

以下の例では、日付フィールド、参照フィールド、参照リスト、複数行フィールドの値を REST URI にパラメータとして入力する方法を示します。


フィードバック