Información adicional sobre propiedades

Aunque algunas propiedades son específicas de un recurso, muchas propiedades son comunes a todos los recursos. A partir de cualquier recurso, un cliente puede obtener la información siguiente:

Aunque estas propiedades se definen para todos los recursos, es posible que algunos recursos devuelvan valores nulos o vacíos para dichas propiedades o que proporcionen una excepción PROPERTY_NOT_SUPPORTED_BY_SERVER para éstas.

Todas las propiedades (excepto la ubicación) deben solicitarse de forma explícita desde el servidor antes de que puedan estar disponibles desde un proxy.

La clase Resource proporciona métodos genéricos para acceder a los valores de propiedad definidos por un proxy mediante el objeto PropertyName para cada propiedad. WVCM define los métodos Resource.getProperty(PropertyNameList.PropertyName) y Resource.setProperty(PropertyNameList.PropertyName, Object). El método getProperty lanza la excepción PropertyException si el proxy no contiene ningún valor válido para la propiedad identificada por el objeto PropertyName.

También existe el método Resource.lookupProperty() para recuperar un valor de propiedad. Si el valor de propiedad está definido, lookupProperty devuelve el mismo objeto que getProperty. Si el valor de la propiedad no se ha definido, lookupProperty() devuelve la excepción que lanza el método getProperty.

Los métodos setProperty, getProperty y lookupProperty no verifican que el PropertyName haya sido definido por la clase de proxy. Es posible utilizar cualquier proxy para interactuar con cualquier tipo de recurso. Únicamente se producen anomalías en dichas interacciones cuando intentan grabar o recuperar valores de propiedades que no están definidas para el recurso al que hace referencia el proxy; las anomalías se producen únicamente cuando el proveedor de la API intenta transferir dichos valores de propiedad al recurso o desde éste. Tenga en cuenta, sin embargo, que al construir un proxy para una ubicación determinada, el dominio de la ubicación debe coincidir con el dominio del proveedor desde el que se solicita el proxy.

Acceso a campos de un registro ClearQuest

La clase CqRecord.FieldName es una subclase de un PropertyName utilizado para denominar las propiedades de recurso que son campos definidos por esquema de un registro ClearQuest. Tenga en cuenta que, como en el caso de PropertyName, el parámetro de tipo especifica el tipo de valor del campo.

CqFieldValue y CqHistoryFieldValue son ampliaciones de StpProperty y representan los valores de un registro ClearQuest y el campo de historial. Puede utilizar métodos de las interfaces CqFieldValue para que funcionen con los campos de los registros ClearQuest.
  • CqFieldValue es la representación del valor de un campo de registro en forma de objeto ampliado de propiedad.
  • CqHistoryFieldValue contiene el valor de un campo de historial de registro de ClearQuest. El valor de esta propiedad es una colección de series, cada una de las cuales representa un solo suceso en la duración del registro.

Puede utilizar estas ampliaciones que son específicas de los registros ClearQuest para acceder a los campos de un registro. Por ejemplo, consulte Propiedades anidadas


Comentarios