Notices

Copyright © OASIS Open 2017. All Rights Reserved.

All capitalized terms in the following text have the meanings assigned to them in the OASIS Intellectual Property Rights Policy (the "OASIS IPR Policy"). The full Policy may be found at the OASIS website.

This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published, and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this section are included on all such copies and derivative works. However, this document itself may not be modified in any way, including by removing the copyright notice or references to OASIS, except as needed for the purpose of developing any document or deliverable produced by an OASIS Technical Committee (in which case the rules applicable to copyrights, as set forth in the OASIS IPR Policy, must be followed) or as required to translate it into languages other than English.

The limited permissions granted above are perpetual and will not be revoked by OASIS or its successors or assigns.

This document and the information contained herein is provided on an "AS IS" basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

OASIS requests that any OASIS Party or any other party that believes it has patent claims that would necessarily be infringed by implementations of this OASIS Committee Specification or OASIS Standard, to notify OASIS TC Administrator and provide an indication of its willingness to grant patent licenses to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification.

OASIS invites any party to contact the OASIS TC Administrator if it is aware of a claim of ownership of any patent claims that would necessarily be infringed by implementations of this specification by a patent holder that is not willing to provide a license to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification. OASIS may include such claims on its website, but disclaims any obligation to do so.

OASIS takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on OASIS' procedures with respect to rights in any document or deliverable produced by an OASIS Technical Committee can be found on the OASIS website. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this OASIS Committee Specification or OASIS Standard, can be obtained from the OASIS TC Administrator. OASIS makes no representation that any information or list of intellectual property rights will at any time be complete, or that any claims in such list are, in fact, Essential Claims.

The name "OASIS" is a trademark of OASIS, the owner and developer of this specification, and should be used only to refer to the organization and its official outputs. OASIS welcomes reference to, and implementation and use of, specifications, while reserving the right to enforce its marks against misleading uses. Please see https://www.oasis-open.org/policies-guidelines/trademark for above guidance.


Table of Contents


1. Introduction

This section is non-normative.

This specification defines a vocabulary and resource shapes for common Change Management resources. The intent is to define resources needed to support common integration scenarios and not to provide a comprehensive definition of a Change Request. The resource formats may not match exactly the native models supported by change management service providers, but are intended to be compatible with them. The approach to supporting these scenarios is to delegate operations, as driven by service provider contributed user interfaces, as much as possible and not require a service provider to expose its complete data model and application logic.

Fig. 1 OSLC Change Management 3.0 Overview

1.1 Terminology

Terminology is based on OSLC Core Overview [OSLCCore3], W3C Linked Data Platform [LDP], W3C's Architecture of the World Wide Web [WEBARCH], Hyper-text Transfer Protocol [HTTP11].

1.2 References

1.2.1 Normative references

[HTTP11]
R. Fielding, Ed.; J. Reschke, Ed.. Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing. June 2014. Proposed Standard. URL: https://tools.ietf.org/html/rfc7230
[LDP]
Steve Speicher; John Arwe; Ashok Malhotra. Linked Data Platform 1.0. 26 February 2015. W3C Recommendation. URL: https://www.w3.org/TR/ldp/
[OSLCCore3]
Steve Speicher; Jim Amsden. OSLC Core Overview v3.0. Committee Specification. URL: http://docs.oasis-open.org/oslc-core/oslc-core/v3.0/oslc-core-v3.0-part1-overview.html
[RFC2119]
S. Bradner. Key words for use in RFCs to Indicate Requirement Levels. March 1997. Best Current Practice. URL: https://tools.ietf.org/html/rfc2119

1.2.2 Informative references

[OSLCQM]
Paul McMahan. Open Services for Lifecycle Collaboration Quality Management Specification Version 2.0. Final. URL: http://open-services.net/bin/view/Main/QmSpecificationV2
[OSLCRM]
Ian Green. Open Services for Lifecycle Collaboration Requirements Management Specification Version 2.0. Final. URL: http://open-services.net/bin/view/Main/RmSpecificationV2
[WEBARCH]
Ian Jacobs; Norman Walsh. Architecture of the World Wide Web, Volume One. 15 December 2004. W3C Recommendation. URL: https://www.w3.org/TR/webarch/

1.3 Typographical Conventions and Use of RFC Terms

As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.

The key words MUST, MUST NOT, REQUIRED, SHOULD, SHOULD NOT, RECOMMENDED, MAY, and OPTIONAL in this specification are to be interpreted as described in [RFC2119].

In addition to the namespace URIs and namespace prefixes oslc, rdf, dcterms and foaf defined in the OSLC Core specification, OSLC CM defines the namespace URI of http://open-services.net/ns/cm# with a namespace prefix of oslc_cm

This specification also uses these namespace prefix definitions:

2. Change Management Vocabulary Terms

This specification defines the ChangeRequest superclass, and a number of specific, commonly occurring subclasses, properties and values. Servers may define additional ChangeRequest subclasses and provide additional properties as needed.

2.1 Vocabulary Details

The namespace URI for this vocabulary is: http://open-services.net/ns/cm#

All vocabulary URIs defined in the OSLC Change Management (CM) namespace.

2.1.1 RDFS Classes in this namespace

ChangeNotice, ChangeRequest, Defect, Enhancement, Priority, ReviewTask, Severity, State, Task

2.1.2 RDF Properties in this namespace

affectedByDefect, affectsPlanItem, affectsRequirement, affectsTestResult, authorizer, blocksTestExecutionRecord, closeDate, implementsRequirement, parent, priority, relatedChangeRequest, relatedTestCase, relatedTestExecutionRecord, relatedTestPlan, relatedTestScript, sererity, status, testedByTestCase, tracksChangeSet, tracksRequirement

2.1.3 ChangeNotice

http://open-services.net/ns/cm#ChangeNotice

ChangeNotice is an RDFS class.

Represents an assignment notification of a change request. May be used also to bestow authority onto the assigned user to effect the changes.

2.1.4 ChangeRequest

http://open-services.net/ns/cm#ChangeRequest

ChangeRequest is an RDFS class.

The CM Change Request resource

2.1.5 Defect

http://open-services.net/ns/cm#Defect

Defect is an RDFS class.

A software or product defect.

2.1.6 Enhancement

http://open-services.net/ns/cm#Enhancement

Enhancement is an RDFS class.

A request for new functionality.

2.1.7 Priority

http://open-services.net/ns/cm#Priority

Priority is an RDFS class.

Defines the possible oslc_cm:priority property values.

2.1.8 ReviewTask

http://open-services.net/ns/cm#ReviewTask

ReviewTask is an RDFS class.

A request to make a change and review the change.

2.1.9 Severity

http://open-services.net/ns/cm#Severity

Severity is an RDFS class.

Defines the possible oslc_cm:severity property values.

2.1.10 State

http://open-services.net/ns/cm#State

State is an RDFS class.

Defines the possible oslc_cm:state property values.

2.1.11 Task

http://open-services.net/ns/cm#Task

Task is an RDFS class.

An executable and trackable activity.

2.1.12 affectedByDefect

http://open-services.net/ns/cm#affectedByDefect

affectedByDefect is an RDF property.

Change request is affected by a reported defect. It is likely that the target resource will be an oslc_cm:Defect.

2.1.13 affectsPlanItem

http://open-services.net/ns/cm#affectsPlanItem

affectsPlanItem is an RDF property.

Change request affects a plan item. It is likely that the target resource will be an oslc_cm:ChangeRequest.

2.1.14 affectsRequirement

http://open-services.net/ns/cm#affectsRequirement

affectsRequirement is an RDF property.

The ChangeRequest affects a Requirement. It is likely that the target resource will be an oslc_rm:Requirement.

affectsTestResult (Archaic term)

http://open-services.net/ns/cm#affectsTestResult

affectsTestResult is an RDF property.

Associated resource that is affected by this Change Request. It is likely that the target resource will be an oslc_qm:TestResult.

2.1.15 authorizer

http://open-services.net/ns/cm#authorizor

authorizer is an RDF property.

The URI of a resource describing an agent who is responsible authorizing for and/or has authorized effort to be expended to address a set of change requests.

blocksTestExecutionRecord (Archaic term)

http://open-services.net/ns/cm#blocksTestExecutionRecord

blocksTestExecutionRecord is an RDF property.

Associated resource that is blocked by this Change Request. It is likely that the target resource will be an oslc_qm:TestExecutionRecord.

2.1.16 closeDate

http://open-services.net/ns/cm#closeDate

closeDate is an RDF property.

The date at which no further activity or work is intended to be conducted.

2.1.17 implementsRequirement

http://open-services.net/ns/cm#implementsRequirement

implementsRequirement is an RDF property.

The ChangeRequest implements the associated Requirement. It is likely that the target resource will be an oslc_rm:Requirement.

2.1.18 parent

http://open-services.net/ns/cm#parent

parent is an RDF property.

The related parent change requests of the subject change request.

2.1.19 priority

http://open-services.net/ns/cm#priority

priority is an RDF property.

Used to indicate the relative importance of ChangeRequests. It is likely that the target resource will be an oslc_cm:Priority.

2.1.20 relatedChangeRequest

http://open-services.net/ns/cm#relatedChangeRequest

relatedChangeRequest is an RDF property.

This relationship is loosely coupled, has no specific meaning, and can be used to link related change requests. It is likely that the target resource will be an oslc_cm:ChangeRequest.

relatedTestCase (Archaic term)

http://open-services.net/ns/cm#relatedTestCase

relatedTestCase is an RDF property.

Related test case resource. It is likely that the target resource will be an oslc_qm:TestCase.

relatedTestExecutionRecord (Archaic term)

http://open-services.net/ns/cm#relatedTestExecutionRecord

relatedTestExecutionRecord is an RDF property.

Related to a test execution resource. It is likely that the target resource will be an oslc_qm:TestExecutionRecord.

relatedTestPlan (Archaic term)

http://open-services.net/ns/cm#relatedTestPlan

relatedTestPlan is an RDF property.

Related test plan resource. It is likely that the target resource will be an oslc_qm:TestPlan.

relatedTestScript (Archaic term)

http://open-services.net/ns/cm#relatedTestScript

relatedTestScript is an RDF property.

Related test script resource. It is likely that the target resource will be an oslc_qm:TestScript.

2.1.21 sererity

http://open-services.net/ns/cm#severity

sererity is an RDF property.

Used to indicate the severity or potential impact of a defect. It is likely that the target resource will be an oslc_cm:Severity.

status (Archaic term)

http://open-services.net/ns/cm#status

status is an RDF property.

Used to indicate the status of the change request based on values defined by the service provider. Most often a read-only property. It is likely that the target resource will be a string corresponding to an oslc_cm:State value.

testedByTestCase (Archaic term)

http://open-services.net/ns/cm#testedByTestCase

testedByTestCase is an RDF property.

Test case by which this change request is tested. It is likely that the target resource will be an oslc_qm:TestCase.

2.1.22 tracksChangeSet

http://open-services.net/ns/cm#tracksChangeSet

tracksChangeSet is an RDF property.

Tracks a change set resource. It is likely that the target resource will be an oslc_config:ChangeSet.

2.1.23 tracksRequirement

http://open-services.net/ns/cm#tracksRequirement

tracksRequirement is an RDF property.

Tracks the associated Requirement or Requirement ChangeSet resources. It is likely that the target resource will be an oslc_rm:Requirement.

3. Change Management Resource Constraints

Property value types that are not defined in the following sections, are defined in OSLC Core - Defining OSLC Properties

Naming convention for relationship properties follows this pattern:

3.1 Resource: ChangeRequest

The Change Request resource properties are not limited to the ones defined in this specification, service providers may provide additional properties. It is recommended that any additional properties exist in their own unique namespace and not use the namespaces defined in these specifications.

cm#ChangeRequest Properties
Prefixed Name Occurs Read-only Value-type Representation Range Description
dcterms:contributor Zero-or-many unspecified AnyResource Either foaf:Person The person(s) who are responsible for the work needed to complete the change request (reference: Dublin Core). It is likely that the target resource will be a foaf:Person but that is not necessarily the case.
dcterms:created Zero-or-one true dateTime N/A Unspecified Timestamp of resource creation (reference: Dublin Core).
dcterms:creator Zero-or-many unspecified AnyResource Either foaf:Person Creator or creators of resource (reference: Dublin Core). It is likely that the target resource will be a foaf:Person but that is not necessarily the case.
dcterms:description Zero-or-one unspecified XMLLiteral N/A Unspecified Descriptive text (reference: Dublin Core) about resource represented as rich text in XHTML content. SHOULD include only content that is valid and suitable inside an XHTML <div> element.
dcterms:identifier Exactly-one true string N/A Unspecified A unique identifier for a resource. Assigned by the service provider when a resource is created. Not intended for end-user display.
dcterms:modified Zero-or-one true dateTime N/A Unspecified Timestamp of latest resource modification (reference: Dublin Core).
dcterms:subject Zero-or-many unspecified string N/A Unspecified Tag or keyword for a resource. Each occurrence of a dcterms:subject property denotes an additional tag for the resource.
dcterms:title Exactly-one unspecified XMLLiteral N/A Unspecified Title (reference: Dublin Core) or often a single line summary of the resource represented as rich text in XHTML content. SHOULD include only content that is valid and suitable inside an XHTML <div> element.
oslc_cm:affectedByDefect Zero-or-many unspecified Resource Reference oslc_cm:Defect Change request is affected by a reported defect. It is likely that the target resource will be an oslc_cm:Defect but that is not necessarily the case.
oslc_cm:affectsPlanItem Zero-or-many unspecified Resource Reference Unspecified Change request affects plan item.
oslc_cm:affectsRequirement Zero-or-many unspecified Resource Reference oslc_rm:Requirement Change request affecting a Requirement. It is likely that the target resource will be an oslc_rm:Requirement but that is not necessarily the case.
oslc_cm:approved Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been approved.
oslc_cm:authorizor Zero-or-many unspecified AnyResource Either foaf:Agent Agents who are responsible authorizing and/or has authorized effort to be expended to address a set of child change requests.
oslc_cm:closed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request is completely done, no further fixes or fix verification is needed.
oslc_cm:closeDate Zero-or-one true dateTime N/A Unspecified The date at which no further activity or work is intended to be conducted.
oslc_cm:fixed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been fixed.
oslc_cm:implementsRequirement Zero-or-many unspecified Resource Reference oslc_rm:Requirement Implements associated Requirement. It is likely that the target resource will be an oslc_rm:Requirement but that is not necessarily the case.
oslc_cm:inProgress Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request in a state indicating that active work is occurring. If oslc_cm:inProgress is true, then oslc_cm:fixed and oslc_cm:closed must also be false.
oslc_cm:parent Zero-or-many unspecified AnyResource Either oslc_cm:ChangeRequest The related parent change requests of the subject change request. Establishes a parent/child relationship between change requests.
oslc_cm:priority Zero-or-many unspecified AnyResource Either oslc_cm:Priority Priority of this change request.
oslc_cm:relatedChangeRequest Zero-or-many unspecified Resource Reference Unspecified This relationship is loosely coupled and has no specific meaning.
oslc_cm:reviewed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been reviewed.
oslc_cm:state Zero-or-one unspecified unspecified Either oslc_cm:State Used to indicate the state of the change request. This property is often read-only, but could be changed using OSLC Actions.
oslc_cm:status Zero-or-one unspecified string N/A Unspecified Used to indicate the status of the change request. This property is often read-only.
oslc_cm:tracksChangeSet Zero-or-many unspecified Resource Reference oslc_config:ChangeSet Tracks a resource that represents a set of changes on the resource.
oslc_cm:tracksRequirement Zero-or-many unspecified Resource Reference oslc_rm:Requirement Tracks the associated Requirement or Requirement ChangeSet resources. It is likely that the target resource will be an oslc_rm:Requirement but that is not necessarily the case.
oslc_cm:verified Zero-or-one unspecified boolean N/A Unspecified Whether or not the resolution or fix of the Change Request has been verified.
oslc:discussedBy Zero-or-one unspecified AnyResource Either oslc:Discussion A series of notes and comments about this change request.
oslc:instanceShape Zero-or-many unspecified Resource Reference oslc:ResourceShape Resource Shape that provides hints as to resource property value-types and allowed values.
oslc:serviceProvider Zero-or-many unspecified Resource Reference oslc:ServiceProvider A link to the resource's OSLC Service Provider. There may be cases when the subject resource is available from a service provider that implements multiple domain specifications, which could result in multiple values for this property.
oslc:shortTitle Zero-or-one unspecified XMLLiteral N/A Unspecified Short name identifying a resource, often used as an abbreviated identifier for presentation to end-users. SHOULD include only content that is valid inside an XHTML <span> element.
rdf:type Zero-or-many unspecified Resource Reference Unspecified The resource type URIs, at least one of which should be oslc_cm:ChangeRequest.

3.2 Resource: ChangeNotice

cm#ChangeNotice Properties
Prefixed Name Occurs Read-only Value-type Representation Range Description
dcterms:contributor Zero-or-many unspecified AnyResource Either foaf:Person The person(s) who are responsible for the work needed to complete the change request (reference: Dublin Core). It is likely that the target resource will be a foaf:Person but that is not necessarily the case.
dcterms:created Zero-or-one true dateTime N/A Unspecified Timestamp of resource creation (reference: Dublin Core).
dcterms:creator Zero-or-many unspecified AnyResource Either foaf:Person Creator or creators of resource (reference: Dublin Core). It is likely that the target resource will be a foaf:Person but that is not necessarily the case.
dcterms:description Zero-or-one unspecified XMLLiteral N/A Unspecified Descriptive text (reference: Dublin Core) about resource represented as rich text in XHTML content. SHOULD include only content that is valid and suitable inside an XHTML <div> element.
dcterms:identifier Exactly-one true string N/A Unspecified A unique identifier for a resource. Assigned by the service provider when a resource is created. Not intended for end-user display.
dcterms:modified Zero-or-one true dateTime N/A Unspecified Timestamp of latest resource modification (reference: Dublin Core).
dcterms:subject Zero-or-many unspecified string N/A Unspecified Tag or keyword for a resource. Each occurrence of a dcterms:subject property denotes an additional tag for the resource.
dcterms:title Exactly-one unspecified XMLLiteral N/A Unspecified Title (reference: Dublin Core) or often a single line summary of the resource represented as rich text in XHTML content. SHOULD include only content that is valid and suitable inside an XHTML <div> element.
oslc_cm:affectedByDefect Zero-or-many unspecified Resource Reference oslc_cm:Defect Change request is affected by a reported defect. It is likely that the target resource will be an oslc_cm:Defect but that is not necessarily the case.
oslc_cm:affectsPlanItem Zero-or-many unspecified Resource Reference Unspecified Change request affects plan item.
oslc_cm:affectsRequirement Zero-or-many unspecified Resource Reference oslc_rm:Requirement Change request affecting a Requirement. It is likely that the target resource will be an oslc_rm:Requirement but that is not necessarily the case.
oslc_cm:approved Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been approved.
oslc_cm:authorizor Zero-or-many unspecified AnyResource Either foaf:Agent Agents who are responsible authorizing and/or has authorized effort to be expended to address a set of child change requests.
oslc_cm:closed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request is completely done, no further fixes or fix verification is needed.
oslc_cm:closeDate Zero-or-one true dateTime N/A Unspecified The date at which no further activity or work is intended to be conducted.
oslc_cm:fixed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been fixed.
oslc_cm:inProgress Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request in a state indicating that active work is occurring. If oslc_cm:inProgress is true, then oslc_cm:fixed and oslc_cm:closed must also be false.
oslc_cm:parent Zero-or-many unspecified AnyResource Either oslc_cm:ChangeRequest The related parent change requests of the subject change request. Establishes a parent/child relationship between change requests.
oslc_cm:priority Zero-or-many unspecified AnyResource Either oslc_cm:Priority Priority of this change request.
oslc_cm:relatedChangeRequest Zero-or-many unspecified Resource Reference Unspecified This relationship is loosely coupled and has no specific meaning.
oslc_cm:reviewed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been reviewed.
oslc_cm:severity Zero-or-many unspecified AnyResource Either oslc_cm:Severity Severity or criticality of this change request.
oslc_cm:state Zero-or-one unspecified unspecified Either oslc_cm:State Used to indicate the state of the change request. This property is often read-only, but could be changed using OSLC Actions.
oslc_cm:status Zero-or-one unspecified string N/A Unspecified Used to indicate the status of the change request. This property is often read-only.
oslc_cm:tracksChangeSet Zero-or-many unspecified Resource Reference oslc_config:ChangeSet Tracks a resource that represents a set of changes on the resource.
oslc_cm:verified Zero-or-one unspecified boolean N/A Unspecified Whether or not the resolution or fix of the Change Request has been verified.
oslc:discussedBy Zero-or-one unspecified AnyResource Either oslc:Discussion A series of notes and comments about this change request.
oslc:instanceShape Zero-or-many unspecified Resource Reference oslc:ResourceShape Resource Shape that provides hints as to resource property value-types and allowed values.
oslc:serviceProvider Zero-or-many unspecified Resource Reference oslc:ServiceProvider A link to the resource's OSLC Service Provider. There may be cases when the subject resource is available from a service provider that implements multiple domain specifications, which could result in multiple values for this property.
oslc:shortTitle Zero-or-one unspecified XMLLiteral N/A Unspecified Short name identifying a resource, often used as an abbreviated identifier for presentation to end-users. SHOULD include only content that is valid inside an XHTML <span> element.
rdf:type Zero-or-many unspecified Resource Reference Unspecified The resource type URIs, at least one of which should be oslc_cm:ChangeRequest.

3.3 Resource: Defect

A software or product defect. Used by Quality Management tools to report defects in testing.

cm#Defect Properties
Prefixed Name Occurs Read-only Value-type Representation Range Description
dcterms:contributor Zero-or-many unspecified AnyResource Either foaf:Person The person(s) who are responsible for the work needed to complete the change request (reference: Dublin Core). It is likely that the target resource will be a foaf:Person but that is not necessarily the case.
dcterms:created Zero-or-one true dateTime N/A Unspecified Timestamp of resource creation (reference: Dublin Core).
dcterms:creator Zero-or-many unspecified AnyResource Either foaf:Person Creator or creators of resource (reference: Dublin Core). It is likely that the target resource will be a foaf:Person but that is not necessarily the case.
dcterms:description Zero-or-one unspecified XMLLiteral N/A Unspecified Descriptive text (reference: Dublin Core) about resource represented as rich text in XHTML content. SHOULD include only content that is valid and suitable inside an XHTML <div> element.
dcterms:identifier Exactly-one true string N/A Unspecified A unique identifier for a resource. Assigned by the service provider when a resource is created. Not intended for end-user display.
dcterms:modified Zero-or-one true dateTime N/A Unspecified Timestamp of latest resource modification (reference: Dublin Core).
dcterms:subject Zero-or-many unspecified string N/A Unspecified Tag or keyword for a resource. Each occurrence of a dcterms:subject property denotes an additional tag for the resource.
dcterms:title Exactly-one unspecified XMLLiteral N/A Unspecified Title (reference: Dublin Core) or often a single line summary of the resource represented as rich text in XHTML content. SHOULD include only content that is valid and suitable inside an XHTML <div> element.
oslc_cm:affectedByDefect Zero-or-many unspecified Resource Reference oslc_cm:Defect Change request is affected by a reported defect. It is likely that the target resource will be an oslc_cm:Defect but that is not necessarily the case.
oslc_cm:affectsPlanItem Zero-or-many unspecified Resource Reference Unspecified Change request affects plan item.
oslc_cm:affectsRequirement Zero-or-many unspecified Resource Reference oslc_rm:Requirement Change request affecting a Requirement. It is likely that the target resource will be an oslc_rm:Requirement but that is not necessarily the case.
oslc_cm:approved Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been approved.
oslc_cm:authorizor Zero-or-many unspecified AnyResource Either foaf:Agent Agents who are responsible authorizing and/or has authorized effort to be expended to address a set of child change requests.
oslc_cm:closed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request is completely done, no further fixes or fix verification is needed.
oslc_cm:closeDate Zero-or-one true dateTime N/A Unspecified The date at which no further activity or work is intended to be conducted.
oslc_cm:fixed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been fixed.
oslc_cm:inProgress Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request in a state indicating that active work is occurring. If oslc_cm:inProgress is true, then oslc_cm:fixed and oslc_cm:closed must also be false.
oslc_cm:parent Zero-or-many unspecified AnyResource Either oslc_cm:ChangeRequest The related parent change requests of the subject change request. Establishes a parent/child relationship between change requests.
oslc_cm:priority Zero-or-many unspecified AnyResource Either oslc_cm:Priority Priority of this change request.
oslc_cm:relatedChangeRequest Zero-or-many unspecified Resource Reference Unspecified This relationship is loosely coupled and has no specific meaning.
oslc_cm:reviewed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been reviewed.
oslc_cm:severity Zero-or-many unspecified AnyResource Either oslc_cm:Severity Severity or criticality of this change request.
oslc_cm:state Zero-or-one unspecified unspecified Either oslc_cm:State Used to indicate the state of the change request. This property is often read-only, but could be changed using OSLC Actions.
oslc_cm:status Zero-or-one unspecified string N/A Unspecified Used to indicate the status of the change request. This property is often read-only.
oslc_cm:tracksChangeSet Zero-or-many unspecified Resource Reference oslc_config:ChangeSet Tracks a resource that represents a set of changes on the resource.
oslc_cm:verified Zero-or-one unspecified boolean N/A Unspecified Whether or not the resolution or fix of the Change Request has been verified.
oslc:discussedBy Zero-or-one unspecified AnyResource Either oslc:Discussion A series of notes and comments about this change request.
oslc:instanceShape Zero-or-many unspecified Resource Reference oslc:ResourceShape Resource Shape that provides hints as to resource property value-types and allowed values.
oslc:serviceProvider Zero-or-many unspecified Resource Reference oslc:ServiceProvider A link to the resource's OSLC Service Provider. There may be cases when the subject resource is available from a service provider that implements multiple domain specifications, which could result in multiple values for this property.
oslc:shortTitle Zero-or-one unspecified XMLLiteral N/A Unspecified Short name identifying a resource, often used as an abbreviated identifier for presentation to end-users. SHOULD include only content that is valid inside an XHTML <span> element.
rdf:type Zero-or-many unspecified Resource Reference Unspecified The resource type URIs, at least one of which should be oslc_cm:ChangeRequest.

3.4 Resource: Enhancement

cm#Enhancement Properties
Prefixed Name Occurs Read-only Value-type Representation Range Description
dcterms:contributor Zero-or-many unspecified AnyResource Either foaf:Person The person(s) who are responsible for the work needed to complete the change request (reference: Dublin Core). It is likely that the target resource will be a foaf:Person but that is not necessarily the case.
dcterms:created Zero-or-one true dateTime N/A Unspecified Timestamp of resource creation (reference: Dublin Core).
dcterms:creator Zero-or-many unspecified AnyResource Either foaf:Person Creator or creators of resource (reference: Dublin Core). It is likely that the target resource will be a foaf:Person but that is not necessarily the case.
dcterms:description Zero-or-one unspecified XMLLiteral N/A Unspecified Descriptive text (reference: Dublin Core) about resource represented as rich text in XHTML content. SHOULD include only content that is valid and suitable inside an XHTML <div> element.
dcterms:identifier Exactly-one true string N/A Unspecified A unique identifier for a resource. Assigned by the service provider when a resource is created. Not intended for end-user display.
dcterms:modified Zero-or-one true dateTime N/A Unspecified Timestamp of latest resource modification (reference: Dublin Core).
dcterms:subject Zero-or-many unspecified string N/A Unspecified Tag or keyword for a resource. Each occurrence of a dcterms:subject property denotes an additional tag for the resource.
dcterms:title Exactly-one unspecified XMLLiteral N/A Unspecified Title (reference: Dublin Core) or often a single line summary of the resource represented as rich text in XHTML content. SHOULD include only content that is valid and suitable inside an XHTML <div> element.
oslc_cm:affectedByDefect Zero-or-many unspecified Resource Reference oslc_cm:Defect Change request is affected by a reported defect. It is likely that the target resource will be an oslc_cm:Defect but that is not necessarily the case.
oslc_cm:affectsPlanItem Zero-or-many unspecified Resource Reference Unspecified Change request affects plan item.
oslc_cm:affectsRequirement Zero-or-many unspecified Resource Reference oslc_rm:Requirement Change request affecting a Requirement. It is likely that the target resource will be an oslc_rm:Requirement but that is not necessarily the case.
oslc_cm:approved Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been approved.
oslc_cm:authorizor Zero-or-many unspecified AnyResource Either foaf:Agent Agents who are responsible authorizing and/or has authorized effort to be expended to address a set of child change requests.
oslc_cm:closed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request is completely done, no further fixes or fix verification is needed.
oslc_cm:closeDate Zero-or-one true dateTime N/A Unspecified The date at which no further activity or work is intended to be conducted.
oslc_cm:fixed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been fixed.
oslc_cm:implementsRequirement Zero-or-many unspecified Resource Reference oslc_rm:Requirement Implements associated Requirement. It is likely that the target resource will be an oslc_rm:Requirement but that is not necessarily the case.
oslc_cm:inProgress Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request in a state indicating that active work is occurring. If oslc_cm:inProgress is true, then oslc_cm:fixed and oslc_cm:closed must also be false.
oslc_cm:parent Zero-or-many unspecified AnyResource Either oslc_cm:ChangeRequest The related parent change requests of the subject change request. Establishes a parent/child relationship between change requests.
oslc_cm:priority Zero-or-many unspecified AnyResource Either oslc_cm:Priority Priority of this change request.
oslc_cm:relatedChangeRequest Zero-or-many unspecified Resource Reference Unspecified This relationship is loosely coupled and has no specific meaning.
oslc_cm:reviewed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been reviewed.
oslc_cm:state Zero-or-one unspecified unspecified Either oslc_cm:State Used to indicate the state of the change request. This property is often read-only, but could be changed using OSLC Actions.
oslc_cm:status Zero-or-one unspecified string N/A Unspecified Used to indicate the status of the change request. This property is often read-only.
oslc_cm:tracksChangeSet Zero-or-many unspecified Resource Reference oslc_config:ChangeSet Tracks a resource that represents a set of changes on the resource.
oslc_cm:verified Zero-or-one unspecified boolean N/A Unspecified Whether or not the resolution or fix of the Change Request has been verified.
oslc:discussedBy Zero-or-one unspecified AnyResource Either oslc:Discussion A series of notes and comments about this change request.
oslc:instanceShape Zero-or-many unspecified Resource Reference oslc:ResourceShape Resource Shape that provides hints as to resource property value-types and allowed values.
oslc:serviceProvider Zero-or-many unspecified Resource Reference oslc:ServiceProvider A link to the resource's OSLC Service Provider. There may be cases when the subject resource is available from a service provider that implements multiple domain specifications, which could result in multiple values for this property.
oslc:shortTitle Zero-or-one unspecified XMLLiteral N/A Unspecified Short name identifying a resource, often used as an abbreviated identifier for presentation to end-users. SHOULD include only content that is valid inside an XHTML <span> element.
rdf:type Zero-or-many unspecified Resource Reference Unspecified The resource type URIs, at least one of which should be oslc_cm:ChangeRequest.

3.5 Resource: ReviewTask

cm#ReviewTask Properties
Prefixed Name Occurs Read-only Value-type Representation Range Description
dcterms:contributor Zero-or-many unspecified AnyResource Either foaf:Person The person(s) who are responsible for the work needed to complete the change request (reference: Dublin Core). It is likely that the target resource will be a foaf:Person but that is not necessarily the case.
dcterms:created Zero-or-one true dateTime N/A Unspecified Timestamp of resource creation (reference: Dublin Core).
dcterms:creator Zero-or-many unspecified AnyResource Either foaf:Person Creator or creators of resource (reference: Dublin Core). It is likely that the target resource will be a foaf:Person but that is not necessarily the case.
dcterms:description Zero-or-one unspecified XMLLiteral N/A Unspecified Descriptive text (reference: Dublin Core) about resource represented as rich text in XHTML content. SHOULD include only content that is valid and suitable inside an XHTML <div> element.
dcterms:identifier Exactly-one true string N/A Unspecified A unique identifier for a resource. Assigned by the service provider when a resource is created. Not intended for end-user display.
dcterms:modified Zero-or-one true dateTime N/A Unspecified Timestamp of latest resource modification (reference: Dublin Core).
dcterms:subject Zero-or-many unspecified string N/A Unspecified Tag or keyword for a resource. Each occurrence of a dcterms:subject property denotes an additional tag for the resource.
dcterms:title Exactly-one unspecified XMLLiteral N/A Unspecified Title (reference: Dublin Core) or often a single line summary of the resource represented as rich text in XHTML content. SHOULD include only content that is valid and suitable inside an XHTML <div> element.
oslc_cm:affectedByDefect Zero-or-many unspecified Resource Reference oslc_cm:Defect Change request is affected by a reported defect. It is likely that the target resource will be an oslc_cm:Defect but that is not necessarily the case.
oslc_cm:affectsPlanItem Zero-or-many unspecified Resource Reference Unspecified Change request affects plan item.
oslc_cm:affectsRequirement Zero-or-many unspecified Resource Reference oslc_rm:Requirement Change request affecting a Requirement. It is likely that the target resource will be an oslc_rm:Requirement but that is not necessarily the case.
oslc_cm:approved Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been approved.
oslc_cm:authorizor Zero-or-many unspecified AnyResource Either foaf:Agent Agents who are responsible authorizing and/or has authorized effort to be expended to address a set of child change requests.
oslc_cm:closed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request is completely done, no further fixes or fix verification is needed.
oslc_cm:closeDate Zero-or-one true dateTime N/A Unspecified The date at which no further activity or work is intended to be conducted.
oslc_cm:fixed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been fixed.
oslc_cm:inProgress Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request in a state indicating that active work is occurring. If oslc_cm:inProgress is true, then oslc_cm:fixed and oslc_cm:closed must also be false.
oslc_cm:parent Zero-or-many unspecified AnyResource Either oslc_cm:ChangeRequest The related parent change requests of the subject change request. Establishes a parent/child relationship between change requests.
oslc_cm:priority Zero-or-many unspecified AnyResource Either oslc_cm:Priority Priority of this change request.
oslc_cm:relatedChangeRequest Zero-or-many unspecified Resource Reference Unspecified This relationship is loosely coupled and has no specific meaning.
oslc_cm:reviewed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been reviewed.
oslc_cm:state Zero-or-one unspecified unspecified Either oslc_cm:State Used to indicate the state of the change request. This property is often read-only, but could be changed using OSLC Actions.
oslc_cm:status Zero-or-one unspecified string N/A Unspecified Used to indicate the status of the change request. This property is often read-only.
oslc_cm:tracksChangeSet Zero-or-many unspecified Resource Reference oslc_config:ChangeSet Tracks a resource that represents a set of changes on the resource.
oslc_cm:tracksRequirement Zero-or-many unspecified Resource Reference oslc_rm:Requirement Tracks the associated Requirement or Requirement ChangeSet resources. It is likely that the target resource will be an oslc_rm:Requirement but that is not necessarily the case.
oslc_cm:verified Zero-or-one unspecified boolean N/A Unspecified Whether or not the resolution or fix of the Change Request has been verified.
oslc:discussedBy Zero-or-one unspecified AnyResource Either oslc:Discussion A series of notes and comments about this change request.
oslc:instanceShape Zero-or-many unspecified Resource Reference oslc:ResourceShape Resource Shape that provides hints as to resource property value-types and allowed values.
oslc:serviceProvider Zero-or-many unspecified Resource Reference oslc:ServiceProvider A link to the resource's OSLC Service Provider. There may be cases when the subject resource is available from a service provider that implements multiple domain specifications, which could result in multiple values for this property.
oslc:shortTitle Zero-or-one unspecified XMLLiteral N/A Unspecified Short name identifying a resource, often used as an abbreviated identifier for presentation to end-users. SHOULD include only content that is valid inside an XHTML <span> element.
rdf:type Zero-or-many unspecified Resource Reference Unspecified The resource type URIs, at least one of which should be oslc_cm:ChangeRequest.

3.6 Resource: Task

cm#Task Properties
Prefixed Name Occurs Read-only Value-type Representation Range Description
dcterms:contributor Zero-or-many unspecified AnyResource Either foaf:Person The person(s) who are responsible for the work needed to complete the change request (reference: Dublin Core). It is likely that the target resource will be a foaf:Person but that is not necessarily the case.
dcterms:created Zero-or-one true dateTime N/A Unspecified Timestamp of resource creation (reference: Dublin Core).
dcterms:creator Zero-or-many unspecified AnyResource Either foaf:Person Creator or creators of resource (reference: Dublin Core). It is likely that the target resource will be a foaf:Person but that is not necessarily the case.
dcterms:description Zero-or-one unspecified XMLLiteral N/A Unspecified Descriptive text (reference: Dublin Core) about resource represented as rich text in XHTML content. SHOULD include only content that is valid and suitable inside an XHTML <div> element.
dcterms:identifier Exactly-one true string N/A Unspecified A unique identifier for a resource. Assigned by the service provider when a resource is created. Not intended for end-user display.
dcterms:modified Zero-or-one true dateTime N/A Unspecified Timestamp of latest resource modification (reference: Dublin Core).
dcterms:subject Zero-or-many unspecified string N/A Unspecified Tag or keyword for a resource. Each occurrence of a dcterms:subject property denotes an additional tag for the resource.
dcterms:title Exactly-one unspecified XMLLiteral N/A Unspecified Title (reference: Dublin Core) or often a single line summary of the resource represented as rich text in XHTML content. SHOULD include only content that is valid and suitable inside an XHTML <div> element.
oslc_cm:affectedByDefect Zero-or-many unspecified Resource Reference oslc_cm:Defect Change request is affected by a reported defect. It is likely that the target resource will be an oslc_cm:Defect but that is not necessarily the case.
oslc_cm:affectsPlanItem Zero-or-many unspecified Resource Reference Unspecified Change request affects plan item.
oslc_cm:affectsRequirement Zero-or-many unspecified Resource Reference oslc_rm:Requirement Change request affecting a Requirement. It is likely that the target resource will be an oslc_rm:Requirement but that is not necessarily the case.
oslc_cm:approved Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been approved.
oslc_cm:authorizor Zero-or-many unspecified AnyResource Either foaf:Agent Agents who are responsible authorizing and/or has authorized effort to be expended to address a set of child change requests.
oslc_cm:closed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request is completely done, no further fixes or fix verification is needed.
oslc_cm:closeDate Zero-or-one true dateTime N/A Unspecified The date at which no further activity or work is intended to be conducted.
oslc_cm:fixed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been fixed.
oslc_cm:inProgress Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request in a state indicating that active work is occurring. If oslc_cm:inProgress is true, then oslc_cm:fixed and oslc_cm:closed must also be false.
oslc_cm:parent Zero-or-many unspecified AnyResource Either oslc_cm:ChangeRequest The related parent change requests of the subject change request. Establishes a parent/child relationship between change requests.
oslc_cm:priority Zero-or-many unspecified AnyResource Either oslc_cm:Priority Priority of this change request.
oslc_cm:relatedChangeRequest Zero-or-many unspecified Resource Reference Unspecified This relationship is loosely coupled and has no specific meaning.
oslc_cm:reviewed Zero-or-one unspecified boolean N/A Unspecified Whether or not the Change Request has been reviewed.
oslc_cm:state Zero-or-one unspecified unspecified Either oslc_cm:State Used to indicate the state of the change request. This property is often read-only, but could be changed using OSLC Actions.
oslc_cm:status Zero-or-one unspecified string N/A Unspecified Used to indicate the status of the change request. This property is often read-only.
oslc_cm:tracksChangeSet Zero-or-many unspecified Resource Reference oslc_config:ChangeSet Tracks a resource that represents a set of changes on the resource.
oslc:discussedBy Zero-or-one unspecified AnyResource Either oslc:Discussion A series of notes and comments about this change request.
oslc:instanceShape Zero-or-many unspecified Resource Reference oslc:ResourceShape Resource Shape that provides hints as to resource property value-types and allowed values.
oslc:serviceProvider Zero-or-many unspecified Resource Reference oslc:ServiceProvider A link to the resource's OSLC Service Provider. There may be cases when the subject resource is available from a service provider that implements multiple domain specifications, which could result in multiple values for this property.
oslc:shortTitle Zero-or-one unspecified XMLLiteral N/A Unspecified Short name identifying a resource, often used as an abbreviated identifier for presentation to end-users. SHOULD include only content that is valid inside an XHTML <span> element.
rdf:type Zero-or-many unspecified Resource Reference Unspecified The resource type URIs, at least one of which should be oslc_cm:ChangeRequest.

3.7 Resource: Status

Defines a set of standard values for property oslc_cm:status.

Range Description
oslc_cm:Closed Completely done, no further fixes or fix verification is needed.
oslc_cm:Inprogress Active work is occurring.
oslc_cm:Fixed The issue is resolved or fixed but the resolution or fix has not yet been verified.
oslc_cm:Approved The resolution or fix is approved and can be delivered.
oslc_cm:Reviewed The resolution or fix has been reviewed.
oslc_cm:Verified The resolution or the fix is verified.

3.8 Resource: Priority

Range Description
oslc_cm:High Highest priority, action on the change request highly recommended.
oslc_cm:Medium Acting on the change request can wait, but not forever.
oslc_cm:Low Action on the change request can be safely deferred.
oslc_cm:PriorityUnassigned The priority of the change request is intentionally not set.

3.9 Resource: Severity

NEEDS UPDATE: Improve descriptions.

Range Description
oslc_cm:Blocker Severe problem. No workaround. Blocks development, test, or usage.
oslc_cm:Critical Severe problem. No workaround.
oslc_cm:Major Prevents function from being used. There is a workaround.
oslc_cm:Normal Affects non-critical functionality. There is a workaround.
oslc_cm:Minor Minimal impact.
oslc_cm:SeverityUnassigned Intentionally set blank.

Priority and severity example:

Example 1
@prefix ex: <http://example.com/bugtracker> .
@prefix oslc: <http://open-services.net/ns/core#> .
@prefix oslc_cm: <http://open-services.net/ns/cm#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix dcterms: <http://purl.org/dc/terms/> .
@prefix skos: <http://www.w3.org/2004/02/skos/core> .

<http://example.com/bugs/2314>
   a oslc_cm:Defect ;
   dcterms:identifier "00002314" ;
   oslc:shortTitle "Bug 2314" ;
   dcterms:title "Invalid installation instructions" ;
   oslc_cm:priority oslc_cm:High ;
   oslc_cm:severity <http://example.com/enums#S1> .

<http://example.com/enums#S1>
   a oslc_cm:Severity;
   dcterms:title "Severe - HOT" ;
   skos:narrower oslc_cm:Critical ;
   ex:icon <http://example.com/severity/S1.gif>.

Appendix A. Change History

This section is non-normative.

Revision Date Editor Changes Made
01 10/19/2016 Jim Amsden Initial CSPRD01