プロパティ要求のセットアップ

ClearQuest® CM API クライアント アプリケーションは、プロパティの読み取りまたは更新を行う前に、まずリソースへのプロキシを取得しなければなりません。
クライアントがプロキシの プロパティにアクセスするには、先にそれらのプロパティを、リソースから プロキシ内に読み取る必要があります。プロパティをリソースからプロキシ内に読み取るとき、 クライアント アプリケーションは、プロパティ要求にプロパティの名前を組み込まなければなりません。次に例を示します。
// Create a PropertyRequest - specify the names of 
// properties wanted from the resource. 
PropertyRequest myPropList1 =
  new PropertyRequest(Resource.COMMENT,
                      Resource.CONTENT_LENGTH,
                      Resource.CONTENT_TYPE,
                      Resource.CREATOR_DISPLAY_NAME,
                      Resource.DISPLAY_NAME);
特定のリソース インターフェイスの場合は、インターフェイス自体、または、それが拡張する任意のインターフェイス で定義されたプロパティを指定できます。例えば、 ClearQuest クエリーの場合、 CqQuery インターフェイス、CqContextResource インターフェイス、CqResource インターフェイス、StpResource インターフェイス、または Resource インターフェイスで定義されたプロパティを指定できます。
PropertyRequest myPropListr =
     new PropertyRequest(StpResource.USER_FRIENDLY_LOCATION, 
                         Resource.DISPLAY_NAME,
                // include properties specific to the Query 
                         CqQuery.DISPLAY_FIELDS,
                         CqQuery.DYNAMIC_FILTERS);

プロパティ名を PropertyRequest に組み込んだ後、その要求を リソース プロキシの doReadProperties() メソッドに渡して、 指定したプロパティを読み取ることができます。


フィードバック