Notices

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 specification is published under the Attribution 4.0 International (CC BY 4.0). Portions of this specification are also provided under the Apache License 2.0.

All contributions made to this project have been made under the OASIS Contributor License Agreement (CLA).

For information on whether any patents have been disclosed that may be essential to implementing this specification, and any offers of patent licensing terms, please refer to the Open Projects IPR Statements page.

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 Open Project or 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 Project Specification or OASIS Standard, to notify the 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 Open Project 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 Open Project 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

1.1 Overview

This section is non-normative.

This specification defines resource shapes for OSLC Quality Management resources. The intent is to define resources needed to support common integration scenarios and not to provide a comprehensive definition of quality management artefacts. The resource formats may not match exactly the native models supported by quality 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 Quality Management Version 2.1 resource relationship overview

1.2 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.3 References

1.3.1 Normative references

[HTTP11]
R. Fielding, Ed.; J. Reschke, Ed.. Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing. IETF, June 2014. Proposed Standard. URL: https://httpwg.org/specs/rfc7230.html
[LDP]
Steve Speicher; John Arwe; Ashok Malhotra. Linked Data Platform 1.0. W3C, 26 February 2015. W3C Recommendation. URL: https://www.w3.org/TR/ldp/
[OSLCCore3]
Steve Speicher; Jim Amsden. OSLC Core Overview v3.0. OASIS. Committee Specification Public Review Draft. URL: https://docs.oasis-open.org/oslc-core/oslc-core/v3.0/csprd03/part1-overview/oslc-core-v3.0-csprd03-part1-overview.html
[RFC2119]
S. Bradner. Key words for use in RFCs to Indicate Requirement Levels. IETF, March 1997. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc2119
[RFC8174]
B. Leiba. Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words. IETF, May 2017. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc8174

1.3.2 Informative references

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

1.4 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", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this specification are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.

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

This specification also uses these namespace prefix definitions:


2. Quality Management Resource Constraints

2.1 Resource: TestPlanShape

Test Plan defines the overall process and strategy for testing a system

TestPlan Properties
Prefixed Name Occurs Read-only Value-type Representation Range Description
dcterms:contributor Zero-or-many false AnyResource Either foaf:Person Contributor or contributors to resource (reference: Dublin Core). It is likely that the target resource will be an 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 true AnyResource Either foaf:Person Creator or creators of resource (reference: Dublin Core). It is likely that the target resource will be an foaf:Person but that is not necessarily the case.
dcterms:description Zero-or-one false 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
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:relation Zero-or-many true Resource Reference Unspecified Related resource or resources to the resource.
dcterms:title Exactly-one false XMLLiteral N/A Unspecified Title (reference: Dublin Core) of the resource represented as rich text in XHTML content. SHOULD include only content that is valid inside an XHTML element.
oslc_qm:relatedChangeRequest Zero-or-many false Resource Reference oslc_cm:ChangeRequest A related change request. It is likely that the target resource will be an oslc_cm:ChangeRequest but that is not necessarily the case.
oslc_qm:runsOnTestEnvironment Zero-or-many false Resource Reference oslc_qm:TestExecutionRecord The test environment that the Test Plan will be run on.
oslc_qm:usesTestCase Zero-or-many false Resource Either oslc_qm:TestCase Test Case used by the Test Plan. It is likely that the target resource will be an oslc_qm:TestCase but that is not necessarily the case.
oslc_qm:validatesRequirementCollection Zero-or-many false Resource Reference oslc_rm:RequirementCollection Requirement Collection that is validated by the Test Plan. It is likely that the target resource will be an oslc_rm:RequirementCollection but that is not necessarily the case.
oslc:instanceShape Zero-or-one true Resource Reference oslc:ResourceShape Resource Shape that provides hints as to resource property value-types and allowed values.
oslc:serviceProvider Zero-or-many true Resource Reference oslc:ServiceProvider The scope of a resource is a link to the resource's OSLC Service Provider.
oslc:shortId Exactly-one true integer N/A Unspecified A short identifier for the resource. Typically the integer shown in the web UI.
rdf:type Zero-or-many true Resource Reference oslc_qm:TestPlan The resource type URIs.

2.2 Resource: TestScriptShape

Test Script defines a program or list of steps used to conduct a test.

TestScript Properties
Prefixed Name Occurs Read-only Value-type Representation Range Description
dcterms:contributor Zero-or-many false AnyResource Either foaf:Person Contributor or contributors to resource (reference: Dublin Core). It is likely that the target resource will be an 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 true AnyResource Either foaf:Person Creator or creators of resource (reference: Dublin Core). It is likely that the target resource will be an foaf:Person but that is not necessarily the case.
dcterms:description Zero-or-one false 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
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:relation Zero-or-many true Resource Reference Unspecified Related resource or resources to the resource.
dcterms:title Exactly-one false XMLLiteral N/A Unspecified Title (reference: Dublin Core) of the resource represented as rich text in XHTML content. SHOULD include only content that is valid inside an XHTML element.
oslc_qm:executionInstructions Zero-or-many true Resource Reference Unspecified Instructions for executing the test script. Note that the value of Occurs is undefined. The resource shape document provided by the QM service provider may be consulted for its value.
oslc_qm:relatedChangeRequest Zero-or-many false Resource Reference oslc_cm:ChangeRequest A related change request. It is likely that the target resource will be an oslc_cm:ChangeRequest but that is not necessarily the case.
oslc_qm:validatesRequirement Zero-or-many false Resource Reference oslc_rm:Requirement Requirement that is validated by the Test Script. It is likely that the target resource will be an oslc_rm:Requirement but that is not necessarily the case.
oslc:instanceShape Zero-or-one true Resource Reference oslc:ResourceShape Resource Shape that provides hints as to resource property value-types and allowed values.
oslc:serviceProvider Zero-or-many true Resource Reference oslc:ServiceProvider The scope of a resource is a link to the resource's OSLC Service Provider.
oslc:shortId Exactly-one true integer N/A Unspecified A short identifier for the resource. Typically the integer shown in the web UI.
rdf:type Zero-or-many true Resource Reference oslc_qm:TestScript The resource type URIs.

2.3 Resource: TestCaseShape

Test Case defines the criteria which determine whether a system exhibits the correct behavior under a specific set of circumstances.

TestCase Properties
Prefixed Name Occurs Read-only Value-type Representation Range Description
dcterms:contributor Zero-or-many false AnyResource Either foaf:Person Contributor or contributors to resource (reference: Dublin Core). It is likely that the target resource will be an 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 true AnyResource Either foaf:Person Creator or creators of resource (reference: Dublin Core). It is likely that the target resource will be an foaf:Person but that is not necessarily the case.
dcterms:description Zero-or-one false 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
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:relation Zero-or-many true Resource Reference Unspecified Related resource or resources to the resource.
dcterms:title Exactly-one false XMLLiteral N/A Unspecified Title (reference: Dublin Core) of the resource represented as rich text in XHTML content. SHOULD include only content that is valid inside an XHTML element.
oslc_qm:relatedChangeRequest Zero-or-many false Resource Reference oslc_cm:ChangeRequest A related change request. It is likely that the target resource will be an oslc_cm:ChangeRequest but that is not necessarily the case.
oslc_qm:testsChangeRequest Zero-or-many false Resource Reference oslc_cm:ChangeRequest Change Request tested by the Test Case. It is likely that the target resource will be an oslc_cm:ChangeRequest but that is not necessarily the case.
oslc_qm:usesTestScript Zero-or-many false Resource Either oslc_qm:TestScript Test Script used by the Test Case. It is likely that the target resource will be an oslc_qm:TestScript but that is not necessarily the case.
oslc_qm:validatesRequirement Zero-or-many false Resource Reference oslc_rm:Requirement Requirement that is validated by the Test Case. It is likely that the target resource will be an oslc_rm:Requirement but that is not necessarily the case.
oslc:instanceShape Zero-or-one true Resource Reference oslc:ResourceShape Resource Shape that provides hints as to resource property value-types and allowed values.
oslc:serviceProvider Zero-or-many true Resource Reference oslc:ServiceProvider The scope of a resource is a link to the resource's OSLC Service Provider.
oslc:shortId Exactly-one true integer N/A Unspecified A short identifier for the resource. Typically the integer shown in the web UI.
rdf:type Zero-or-many true Resource Reference oslc_qm:TestCase The resource type URIs.

2.4 Resource: TestResultShape

Test Result describes the outcome of attempting to execute a test.

TestResult Properties
Prefixed Name Occurs Read-only Value-type Representation Range Description
dcterms:contributor Zero-or-many false AnyResource Either foaf:Person Contributor or contributors to resource (reference: Dublin Core). It is likely that the target resource will be an 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 true AnyResource Either foaf:Person Creator or creators of resource (reference: Dublin Core). It is likely that the target resource will be an foaf:Person but that is not necessarily the case.
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:relation Zero-or-many true Resource Reference Unspecified Related resource or resources to the resource.
dcterms:title Exactly-one false XMLLiteral N/A Unspecified Title (reference: Dublin Core) of the resource represented as rich text in XHTML content. SHOULD include only content that is valid inside an XHTML element.
oslc_qm:affectedByChangeRequest Zero-or-many false Resource Reference oslc_cm:ChangeRequest Change request that affects the Test Result. It is likely that the target resource will be an oslc_cm:ChangeRequest but that is not necessarily the case.
oslc_qm:executesTestScript Zero-or-one false Resource Either oslc_qm:TestScript Test Script executed to produce the Test Result. It is likely that the target resource will be an oslc_qm:TestScript but that is not necessarily the case.
oslc_qm:producedByTestExecutionRecord Zero-or-one false Resource Either oslc_qm:TestExecutionRecord Test Execution Record that the Test Result was produced by. It is likely that the target resource will be an oslc_qm:TestExecutionRecord but that is not necessarily the case.
oslc_qm:reportsOnTestCase Exactly-one false Resource Either oslc_qm:TestCase Test Case that the Test Result reports on. It is likely that the target resource will be an oslc_qm:TestCase but that is not necessarily the case.
oslc_qm:reportsOnTestPlan Zero-or-one true Resource Either oslc_qm:TestPlan Test Plan that the Test Result reports on. It is likely that the target resource will be an oslc_qm:TestPlan but that is not necessarily the case.
oslc_qm:runsOnTestEnvironment Zero-or-one true Resource Reference oslc_qm:TestExecutionRecord Configuration associated with the execution work item executed to generate the execution result.
oslc_qm:status Zero-or-one false string N/A Unspecified Used to indicate the state of the Test Result based on values defined by the service provider. Most often a read-only property.
oslc:instanceShape Zero-or-one true Resource Reference oslc:ResourceShape Resource Shape that provides hints as to resource property value-types and allowed values.
oslc:serviceProvider Zero-or-many true Resource Reference oslc:ServiceProvider The scope of a resource is a link to the resource's OSLC Service Provider.
oslc:shortId Exactly-one true integer N/A Unspecified A short identifier for the resource. Typically the integer shown in the web UI.
rdf:type Zero-or-many true Resource Reference oslc_qm:TestResult The resource type URIs.

2.5 Resource: TestExecutionRecordShape

Test Execution Record is a plan for execution of a test."

TestExecutionRecord Properties
Prefixed Name Occurs Read-only Value-type Representation Range Description
dcterms:contributor Zero-or-many false AnyResource Either foaf:Person Contributor or contributors to resource (reference: Dublin Core). It is likely that the target resource will be an 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 true AnyResource Either foaf:Person Creator or creators of resource (reference: Dublin Core). It is likely that the target resource will be an foaf:Person but that is not necessarily the case.
dcterms:description Zero-or-one false 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
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:relation Zero-or-many true Resource Reference Unspecified Related resource or resources to the resource.
dcterms:title Exactly-one false XMLLiteral N/A Unspecified Title (reference: Dublin Core) of the resource represented as rich text in XHTML content. SHOULD include only content that is valid inside an XHTML element.
oslc_qm:blockedByChangeRequest Zero-or-many false Resource Reference oslc_cm:ChangeRequest Change Request that prevents execution of the Test Execution Record. It is likely that the target resource will be an oslc_cm:ChangeRequest but that is not necessarily the case.
oslc_qm:executesTestScript Zero-or-one false Resource Either oslc_qm:TestScript Test Script executed by the Test Execution Record. It is likely that the target resource will be an oslc_qm:TestScript but that is not necessarily the case.
oslc_qm:relatedChangeRequest Zero-or-many false Resource Reference oslc_cm:ChangeRequest A related change request. It is likely that the target resource will be an oslc_cm:ChangeRequest but that is not necessarily the case.
oslc_qm:reportsOnTestPlan Zero-or-one false Resource Either oslc_qm:TestPlan Test Plan that the Test Execution Record reports on. It is likely that the target resource will be an oslc_qm:TestPlan but that is not necessarily the case.
oslc_qm:runsOnTestEnvironment Zero-or-one false Resource Reference oslc_qm:TestExecutionRecord Indicates the environment details of the test case for this execution record.
oslc_qm:runsTestCase Exactly-one false Resource Either oslc_qm:TestCase Test Case run by the Test Execution Record. It is likely that the target resource will be an oslc_qm:TestCase but that is not necessarily the case.
oslc:instanceShape Zero-or-one true Resource Reference oslc:ResourceShape Resource Shape that provides hints as to resource property value-types and allowed values.
oslc:serviceProvider Zero-or-many true Resource Reference oslc:ServiceProvider The scope of a resource is a link to the resource's OSLC Service Provider.
oslc:shortId Exactly-one true integer N/A Unspecified A short identifier for the resource. Typically the integer shown in the web UI.
rdf:type Zero-or-many true Resource Reference oslc_qm:TestExecutionRecord The resource type URIs.

3. Conformance

Quality Management servers MUST follow the constraints defined here where required, and with the meanings defined here.

Quality Management servers MAY provide additional constraints for specific purposes.