Une application client de l'API CM Rational doit d'abord obtenir un proxy sur une ressource avant de pouvoir lire ou mettre à jour des propriétés. Avant qu'un client puisse accéder aux propriétés depuis un proxy, il doit lire ces propriétés depuis la ressource dans un proxy. L'application client doit inclure le nom des propriétés dans une demande de propriété lors de leur lecture depuis la ressource dans un proxy. Par exemple :
// Créez une PropertyRequest - spécifiez les noms des
// propriétés que vous voulez obtenir de la ressource.
PropertyRequest myPropList1 =
new PropertyRequest(Resource.COMMENT,
Resource.CONTENT_LENGTH,
Resource.CONTENT_TYPE,
Resource.CREATOR_DISPLAY_NAME,
Resource.DISPLAY_NAME);
Pour une interface de ressource spécifique, vous pouvez spécifier les propriétés définies dans l'interface elle-même ou l'une des interfaces qu'elles étend. Par exemple, pour une requête ClearQuest, vous pouvez spécifier les propriétés définies dans l'interface CqQuery, l'interface CqContextResource, l'interface CqResource, l'interface StpResource,
ou l'interface Resource :
PropertyRequest myPropListr =
new PropertyRequest(StpResource.USER_FRIENDLY_LOCATION,
Resource.DISPLAY_NAME,
// incluez les propriétés spécifiques à la requête
CqQuery.DISPLAY_FIELDS,
CqQuery.DYNAMIC_FILTERS);
Dès que vous avez inclus les noms de propriété dans une PropertyRequest,
vous pouvez transmettre cette demande à la méthode doReadProperties() du proxy Ressource pour lire les propriétés spécifiées.