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 サーバー ホストの 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 のフィルタに意味はありません。