雖然這些內容是定義給所有資源,但是部分資源可能會對這些資源傳回空值或空的值,或提供它們一個 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 方法擲出的異常狀況。
setProperty、getProperty 和 lookupProperty 方法不會驗證 PropertyName 是否由虛擬物件類別所定義。任何虛擬物件都可以用來與資源的任何類型互動。只有當嘗試寫入或擷取內容值時(其內容未定義給虛擬物件所定址的資源),這類互動才會失敗;只有當 API「提供者」嘗試將這類內容值傳送給資源或從資源傳出時,才會發生失敗。不過請注意,在建構給定位置的虛擬物件時,該位置的網域必須符合從中要求該虛擬物件之提供者的網域。
CqRecord.FieldName 類別是用來命名資源內容的 PropertyName 的一個子類別,這些資源內容是 ClearQuest® 記錄中由綱目所定義的欄位。 請注意,如同 PropertyName,type 參數可指定欄位的值類型。
您可以使用 ClearQuest 記錄特有的這些延伸規格來存取記錄的欄位。 範例請參閱巢狀內容