[oslc-core] Resource shapes in query capability

[Joe Ross]

We are trying to use resource shapes to advertise metadata about resources 
types that can be queried by OSLC clients. However, the description in the 
table in the OSLC Core spec seems to indicate a different usage, which is 
not clear:

"oslc:resourceShape  zero-or-one  ... The Query Capability SHOULD provide 
a Resource Shape that describes the query base URI. "

Is the intent that a query capability can only be used to query for 
instances of a single type of resource, since "occurs" is zero-or-one?
Also, not clear what is meant by "a Resource Shape that describes the 
query base URI."

We thought that the Resource Shape would be used to describe the resources 
that are managed by the provider and can be searched/retrieved using the 
query URL. If not, then it's not clear where we can expose that metadata 
to clients.

This other paragraph later on in the specification seems to describe the 
use that we intended:

"An OSLC Service may provide one or more Query Capabilities to enable 
query of resources. A Query Capability provides a base URI for forming 
Query Resource URIs and MAY provide Resource Shapes that describe the 
property values that may be expected in the resources that are queryable 
via the query capability. Thus, Query Capabilities provide a way to 
discover the resources managed by an OSLC Service. "

This seems to indicate that there can be multiple resource shapes for a 
query capability and that they describe properties of the resources being 
managed by the provider.

Which of these is correct?

Thanks,

================================================
Joe Ross/Austin/IBM, joeross at us.ibm.com
Tivoli Autonomic Computing & Component Technologies
512-286-8311, T/L 363-8311
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://open-services.net/pipermail/oslc-core_open-services.net/attachments/20110916/cf139e94/attachment-0003.html>