OSLC Core Common Properties DRAFT

By: The OSLC Core Specification Workgroup

This is a DRAFT document that is under review. You can help by reviewing carefully, raising issues for discussion on the OSLC Core WG mailing list.

Purpose

The purpose of this document is to record common properties for use across OSLC specifications, but not to require them. OSLC resources are not required to include these properties. OSLC workgroups should consult this list of properties before defining each new property and if a suitable common property exists, then the workgroup should use that common property rather than defining a new one.

Dublin Core Properties

These are the Dublin Core Metadata Element Set properties that are considered common (reference: Dublin Core).

• Namespace URI: http://purl.org/dc/terms
• Suggested Prefix: dcterms

OSLC Properties

These are the OSLC defined properties that are considered common.

• Namespace URI: http://open-services.net/xmlns/oslc#
• Suggested Prefix: oslc

Common Resource definitions

The OSLC Core specification may define common resource definitions, available for use in OSLC domain specifications as value-types.

oslc:Comment

A Comment resource represents a single note, or comment, in a discussion thread.

• Name: Comment
• URI: http://open-services.net/xmlns/oslc#Comment
• Description: Data necessary to represent a comment
• Properties:
  • dc:identifier (String, exactly-one) A service defined identifier
  • dc:creator (Resource of type foaf:Person, exactly-one) The person who created the comment
  • dc:title (XMLLiteral xhtml, zero-or-one) A brief title for the comment
  • dc:created (!DateTime, exactly-one) When the comment resource was created
  • dc:description (XMLLiteral xhtml, exactly-one) Details or body of the comment
  • oslc:discussion (Resource of type oslc:Discussion, exactly-one) reference to owning Discussion resource
  • oslc:inReplyTo (Resource of type oslc:Comment, zero-or-one) reference to comment this comment is in reply to

oslc:Discussion

A Discussion resource is intended to represent a sequence of comments or notes regarding the associated resource.

• Name: Discussion
• URI: http://open-services.net/xmlns/oslc#Discussion
• Description: Contains a series of comment properties
• Properties of Comments resource shape:
  • oslc:discussionAbout (Resource, exactly-one) reference to associated resource
  • oslc:comment (Resource oslc:Comment, zero-or-more)

Comment Creation

POST {Discussion URI}

Posting a well formed Comment Resources results in the creation of a comment resource. A service provider MUST support at least the following HTTP response status codes: