Notices

Copyright © OASIS Open 2021. 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 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

This section is non-normative.

This specification defines a vocabulary for Tracked Resource Sets.

Note that this document is informative; the normative document for the vocabulary is the machine-readable source in [VOCAB].

1.1 Typographical Conventions and Use of RFC Terms

This section is non-normative.

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.

1.1.1 References

1.1.1.1 Normative references
[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.1.1.2 Informative references
[VOCAB]
Nick Crossley; Frank Budinsky. OSLC Tracked Resource Set Version 3.0: Part 3: Machine-readable vocabulary. http://open-services.net. Finalization. URL: http://open-services.net/ns/trs

1.2 Vocabulary Terms

1.2.1 RDF Vocabulary for Tracked Resource Set

1.2.1.1 Vocabulary Details

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

The OSLC Core Tracked Resource Set vocabulary defines terms used in describing Tracked Resource Sets.

1.2.1.1.1 Classes in this namespace (6)

Base, Change Log, Creation, Deletion, Modification, Tracked Resource Set

Base

http://open-services.net/ns/core/trs#Base

Base is an RDFS class.

A Base identifies the initial set of resources in a Tracked Resource Set.

Change Log

http://open-services.net/ns/core/trs#ChangeLog

Change Log is an RDFS class.

A Change Log describes what resources have been created, modified or deleted, and when.

Creation

http://open-services.net/ns/core/trs#Creation

Creation is an RDFS class.

Represents a resource creation or modification change event.

Deletion

http://open-services.net/ns/core/trs#Deletion

Deletion is an RDFS class.

Represents a resource deletion change event.

Modification

http://open-services.net/ns/core/trs#Modification

Modification is an RDFS class.

Represents a resource creation or modification change event.

Tracked Resource Set

http://open-services.net/ns/core/trs#TrackedResourceSet

Tracked Resource Set is an RDFS class.

A Tracked Resource Set provides a representation of the current state of a Resource Set.

1.2.1.1.2 Properties in this namespace (12)

afterETag, base, beforeETag, change, changed, changeLog, createdFrom, cutoffEvent, order, previous, rdfPatch, trackedResourceSet

afterETag

http://open-services.net/ns/core/trspatch#afterETag

afterETag is an RDF property.

HTTP entity tag of resource immediately after this change.

base

http://open-services.net/ns/core/trs#base

base is an RDF property.

An enumeration of the Resources in the Resource Set.

beforeETag

http://open-services.net/ns/core/trspatch#beforeETag

beforeETag is an RDF property.

HTTP entity tag of resource immediately before this change.

change

http://open-services.net/ns/core/trs#change

change is an RDF property.

The Change Event entries.

changed

http://open-services.net/ns/core/trs#changed

changed is an RDF property.

The Resource that has changed.

changeLog

http://open-services.net/ns/core/trs#changeLog

changeLog is an RDF property.

A Change Log providing an order series of incremental adjustments to the Resource Set.

createdFrom

http://open-services.net/ns/core/trspatch#createdFrom

createdFrom is an RDF property.

URI of antecedent resource for trs:Creation Change Events.

cutoffEvent

http://open-services.net/ns/core/trs#cutoffEvent

cutoffEvent is an RDF property.

The most recent Change Log entry that is accounted for in this Base. When rdf:nil, the Base is an enumeration at the start of time.

order

http://open-services.net/ns/core/trs#order

order is an RDF property.

The sequence in time of the Change Event.

previous

http://open-services.net/ns/core/trs#previous

previous is an RDF property.

The continuation of the Change Log, containing the next group of chronologically earlier Change Events.

rdfPatch

http://open-services.net/ns/core/trspatch#rdfPatch

rdfPatch is an RDF property.

Patch directives describing a modification to the resource's RDF representation.

trackedResourceSet

http://open-services.net/ns/core/trs#trackedResourceSet

trackedResourceSet is an RDF property.

A Tracked Resource Set.

1.3 Conformance

OSLC TRS Servers MUST use the vocabulary terms defined here where required, and with the meanings defined here. Servers MAY augment this vocabulary with additional terms. [CC-1]