レコードに直接リンクしてユーザー データベース内のレコードを表示するための REST URI を作成することができます。 レコード表示用に作成した REST URI を使用すると、レコード検索用に作成した REST URI を使用する場合よりも短時間でレコードが開きます。 理由は、レコード表示用の 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 作成時に、[レコード タイプ] の値として ALMActivity が選択されています。
http://CQWebServerHost/cqweb/restapi/YourConnection/YourUserDB/RECORD/{{recordId}}?format=HTML&recordType=ALMActivity&loginId={{loginid}}&password={{password}}
変数とテンプレートのプレースホルダには、次の意味があります。
- CQWebServerHost
- ClearQuest Web サーバー ホストの Web アドレス。この値は、REST URI テンプレートの作成時に定義されます。
- YourConnection
- 使用する ClearQuest 接続。この値は、REST URI テンプレートの作成時に定義されます。
- YourUserDB
- 使用する ClearQuest ユーザー データベース。 この値は、REST URI テンプレートの作成時に定義されます。
- {{recordId}}
- リンクするレコード ID のプレースホルダ。
- format
- リソース要求のデフォルト フォーマットは HTML です。
必要に応じて、このフォーマットを XML または ATOM に変更することができます。
- {{loginid}}
- このプレースホルダを、使用するログオン ID に置き換えます。
- {{password}}
- このプレースホルダを、使用するパスワードに置き換えます。