レコードに直接リンクしてユーザー データベース内のレコードを修正するための 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 サーバー ホスト システムの 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>
結果:
レコード フィールド f_datetime が 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>
結果:
レコード内の参照リスト customer に Joe
Lee と Jane Smith が追加され、参照フィールド Project に Classics が追加されました。
- この例は、複数行フィールドの値をレコードの登録または修正用の REST URI にパラメータとして指定する方法を示しています。
fieldsXML=<Field><Name>Description</Name><Value><![CDATA[firstline%0Asecondline]]></Value></Field>
結果: レコード フィールド Description のテキスト firstline と secondline が別の行に表示されるようにフォーマット設定されました。