属性的值属于特定类型,例如:整数、字符串、日期、时间或对资源的引用。属性类型取决于属性名称和资源类。ClearQuest® CM API 中的属性名称由 PropertyNameList.PropertyName 对象来表示。PropertyNameList.PropertyName 是参数化类型,其中参数指定属性值的类型。一些属性由 WVCM 定义,一些属性由 ClearQuest CM API 定义,作为对 WVCM 的扩展,还有一些属性可能由服务器和客户机应用程序定义。
在 ClearQuest CM API 中,元属性由 MetaPropertyName 对象来标识。MetaPropertyName 可用于从服务器读取属性后访问该属性的元属性。MetaPropertyNames 在 StpProperty 类及其子类中定义。还使用元属性值的类型对其进行了参数化。
属性的 PROPERTY_NAME 和 VALUE 元属性是专有元属性。PROPERTY_NAME 值用于请求和访问属性及其任何元属性。VALUE 是元属性,请求它可确定是否仅在请求中使用属性名。
由每个 CM API 代理接口定义的每种类型的资源识别的一组属性名是一系列类型为 PropertyName 的字段。这些 PropertyName 对象用于从服务器请求属性,并在从服务器获取属性值后访问属性值。 在 CM API 中定义的每个 PropertyName 字段名称是大写标识,其中的单词用下划线隔开(例如,CONTENT_LENGTH)。
属性名的示例为 Resource.COMMENT、Resource.DISPLAY_NAME、Resource.CREATION_DATE 和 Resource.CONTENT_LENGTH。属性名在 Resource 类及其子类中定义。在类中定义的属性适用于类及其所有子类。例如,CqQuery 类具有 CqQuery.DISPLAY_FIELDS、CqQuery.DYNAMIC_FILTERS、CqQuery.USER_FRIENDLY_LOCATION 和 CqQuery.STABLE_LOCATION 属性名,最后两个属性继承自 StpResource 类。每个 Resource 代理子类定义 PropertyName 字段,该字段用于标识与代理表示的资源类型关联的属性并对其进行命名。