Home
Extending product function
Learn how to extend the product.
Programming with HCL Compass CM API
HCL Compass CM API object model overview
The HCL Compass CM API common object model maps HCL Compass objects to a resource proxy hierarchy, based on the WVCM proxy and property model. This common data model enables API client applications to retrieve data, through one set of interfaces, as API resources.
Resources and proxies
The HCL Compass CM API comprises proxy objects for the persistent resources that are stored in the HCL Compass repositories.
Resources
A resource is a named collection of properties that exists in a repository.

Extending product function
Learn how to extend the product.
- HCL Compass REST API developer guide
- Programming with the HCL Compass OSLC CM REST API
  Learn how to use Compass CM REST API that supports both, OSLC v1 and v2.
- Programming with HCL Compass CM API
  - HCL Compass CM API introduction
    The HCL Compass CM API is a unified Java™ API through that you can access HCL Compass.
  - HCL Compass CM API object model overview
    The HCL Compass CM API common object model maps HCL Compass objects to a resource proxy hierarchy, based on the WVCM proxy and property model. This common data model enables API client applications to retrieve data, through one set of interfaces, as API resources.
    - Resources and proxies
      The HCL Compass CM API comprises proxy objects for the persistent resources that are stored in the HCL Compass repositories.
      - Naming conventions
        Each interface derived from the Resource interface has a well-defined set of properties than can be examined and modified by the HCL Compass CM API. Each interface also has a well-defined set of operations that can be invoked on the proxy to effect the underlying resource. Proxy methods whose names begin with get, set, and do perform specific operations.
      - Getting a provider
        A client must get a Provider object before it can get resource proxies and access resources.
      - Getting resource proxies
        The Provider class builds proxies in response to client requests. The client can then invoke methods on the proxy to work with the represented resource.
      - Resources
        A resource is a named collection of properties that exists in a repository.
    - Location objects
      Each resource has a location that uniquely identifies it to the server.
    - Properties and meta-properties
      Resources have properties. Each property has a name, a type, and a value; it might have other meta-properties associated with it (such as its value, size, or an indication of its validity).
    - Collections
      Several HCL Compass CM API methods return collections of resources.
    - Change contexts and context resources
      A change context is a workspace or container for editing context resources which are nonversioned resources, such as records and queries.
    - Exceptions
      All problems are reported by means of an exception object, which is a subclass of the exception object defined by WVCM.
  - Class overviews
    The Javadoc information that is included with the HCL Compass CM API provides an overview section that includes descriptions of the available classes. Each class represents a major collection of operations supported by the API.
  - Configuring HCL Compass CM API logging
    You can configure HCL Compass CM API logging.

Resources

A resource is a named collection of properties that exists in a repository.

Some resources, such as files, have content as well as properties. Some resources are located only on a server. Some are located solely in a client file area. A resource cannot exist in two different locations, but two resources might be so tightly linked that they give that impression. For example, a file in a file area and the corresponding file on the server are two different resources. They are related, but each has its own location, content, and properties.

A proxy object can be used to create, modify, and ultimately destroy resources. After a resource is created, and until it is destroyed, it persists in its repository between invocations of the provider that modifies it.

In the CM API, the Resource interface is the base interface for all API Resource types. An example of a resource is defects in a user database.

The API proxy interfaces form a hierarchy. The root of the hierarchy is javax.wvcm.Resource. These are some of the interfaces that extend the Resource interface:

StpResource extends Resource.
CqResource extends StpResource.
The stp package includes StpActivity, StpFolder, and StpRepository interfaces.
The cq package includes CqAction, CqAttachment, CqAttachmentFolder, CqDbSet, CqFieldDefinition, CqForm, CqGroup, CqHook, CqProjectMember, CqQuery, CqQueryFolder, CqQueryFolderItem, CqRecord, CqRecordType, CqReport, and CqUserDb interfaces.

A resource has a resource type, a unique location (in the form of a Location selector string), and a display name. Each type of resource has a unique interface by which it is accessed.