關於內容的其他資訊

雖然部分內容專屬於某一資源,但是有許多內容是所有資源共用的。用戶端可以從任一資源取得下列資訊:

雖然這些內容是定義給所有資源,但是部分資源可能會對這些資源傳回空值或空的值,或提供它們一個 PROPERTY_NOT_SUPPORTED_BY_SERVER 異常狀況。

所有內容(「位置」除外)都必須先從伺服器明確要求,才可從虛擬物件中取得。

「資源」類別利用每一個內容的 PropertyName 物件,提供了用來存取虛擬物件所定義之內容值的一般方法。 WVCM 定義了 Resource.getProperty(PropertyNameList.PropertyName)Resource.setProperty(PropertyNameList.PropertyName, Object) 方法。如果虛擬物件不含 PropertyName 物件所識別之內容的有效值,則 getProperty 方法會擲出異常狀況 PropertyException。

還有 Resource.lookupProperty() 方法可以擷取內容值。 如果已定義內容值,則 lookupProperty() 傳回的物件與 getProperty 所傳回的物件相同。 如果未定義內容值,則 lookupProperty() 會傳回 getProperty 方法擲出的異常狀況。

setPropertygetPropertylookupProperty 方法不會驗證 PropertyName 是否由虛擬物件類別所定義。任何虛擬物件都可以用來與資源的任何類型互動。只有當嘗試寫入或擷取內容值時(其內容未定義給虛擬物件所定址的資源),這類互動才會失敗;只有當 API「提供者」嘗試將這類內容值傳送給資源或從資源傳出時,才會發生失敗。不過請注意,在建構給定位置的虛擬物件時,該位置的網域必須符合從中要求該虛擬物件之提供者的網域。

存取 ClearQuest 記錄的欄位

CqRecord.FieldName 類別是用來命名資源內容的 PropertyName 的一個子類別,這些資源內容是 ClearQuest® 記錄中由綱目所定義的欄位。 請注意,如同 PropertyName,type 參數可指定欄位的值類型。

CqFieldValue 及 CqHistoryFieldValue 是 StpProperty 的延伸規格,分別代表 ClearQuest 記錄欄位及歷程欄位的值。 您可以使用 CqFieldValue 介面的方法來處理 ClearQuest 記錄的欄位。
  • CqFieldValue 是以延伸的 Property 物件來表示記錄欄位值的一種表示法。
  • CqHistoryFieldValue 包含 ClearQuest 記錄歷程欄位的值。 這個內容的值是一組字串的集合,每一個字串代表記錄在生命期限內的單一事件。

您可以使用 ClearQuest 記錄特有的這些延伸規格來存取記錄的欄位。 範例請參閱巢狀內容


意見