Eine ClearQuest CM
API-Clientanwendung muss zunächst einen Proxy für eine Ressource abrufen, bevor
sie Eigenschaften lesen oder aktualisieren kann.
Auf die Eigenschaften in einem Proxy kann ein Client erst zugreifen, wenn er diese Eigenschaften von der Ressource in einen Proxy eingelesen hat. Zum Einlesen der Eigenschaften in einen Proxy muss die Clientanwendung die Namen der Eigenschaften in eine
Anforderung aufnehmen. Beispiel:
// Erstellen einer Anforderung (PropertyRequest) - Angabe der Namen
// der gewünschten Eigenschaften von der Ressource
PropertyRequest myPropList1 =
new PropertyRequest(Resource.COMMENT,
Resource.CONTENT_LENGTH,
Resource.CONTENT_TYPE,
Resource.CREATOR_DISPLAY_NAME,
Resource.DISPLAY_NAME);
Für eine bestimmte Schnittstelle 'Resource' können Sie Eigenschaften
angeben, die in der Schnittstelle selbst oder in einer der Schnittstellen
definiert sind, die von dieser Schnittstelle erweitert werden. Für eine
ClearQuest-Abfrage können Sie
beispielsweise Eigenschaften angeben, die in der Schnittstelle 'CqQuery',
'CqContextResource', 'CqResource' oder 'StpResource' bzw. in der Schnittstelle
'Resource' definiert sind:
PropertyRequest myPropListr =
new PropertyRequest(StpResource.USER_FRIENDLY_LOCATION,
Resource.DISPLAY_NAME,
// Aufnahme von Eigenschaften, die für Query spezifisch sind
CqQuery.DISPLAY_FIELDS,
CqQuery.DYNAMIC_FILTERS);
Nachdem Sie die Eigenschaftsnamen in eine Anforderung
PropertyRequest eingeschlossen haben, können Sie die
Anforderung an die Methode doReadProperties() des
Ressourcen-Proxys übergeben, um die angegebenen Eigenschaften zu lesen.