This document was last revised or approved by the OASIS OSLC Lifecycle Integration Core (OSLC Core) TC on the above date. The level of approval is also listed above. Check the “Latest version” location noted above for possible later revisions of this document. Any other numbered Versions and other technical work produced by the Technical Committee (TC) are listed at https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=oslc-core#technical.
TC members should send comments on this specification to the TC’s email list. Others should send comments to the TC’s public comment list oslc-core-comments@lists.oasis-open.org, after subscribing to it by following the instructions at the “Send A Comment” button on the TC’s web page at https://www.oasis-open.org/committees/oslc-core/.
This Committee Specification Public Review Draft is being developed under the RF on Limited Terms Mode of the OASIS IPR Policy, the mode chosen when the Technical Committee was established. 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 Intellectual Property Rights section of the TC’s web page (https://www.oasis-open.org/committees/oslc-core/ipr.php).
Note that any machine-readable content (Computer Language Definitions) declared Normative for this Work Product is provided in separate plain text files. In the event of a discrepancy between any such plain text file and display content in the Work Product's prose narrative document(s), the content in the separate plain text file prevails.
[OSLC-CoreVocab-3.0]
OSLC Core Version 3.0. Part 7: Vocabulary.
Edited by Jim Amsden.
31 May 2018.
OASIS Committee Specification Draft 03 / Public Review Draft 03.
http://docs.oasis-open.org/oslc-core/oslc-core/v3.0/csprd03/part7-core-vocabulary/oslc-core-v3.0-csprd03-part7-core-vocabulary.html.
Latest version: http://docs.oasis-open.org/oslc-core/oslc-core/v3.0/oslc-core-v3.0-part7-core-vocabulary.html.
Copyright © OASIS Open 2018. 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.
This section is non-normative.
Various resources and properties may be so commonly used or apply so broadly that it makes sense to define them in one place so they can be easily reused. Some common examples are short names or labels, error messages, discussion threads, traceability/impacts relationship behavior or annotating other vocabulary terms.
Terminology uses and extends the terminology and capabilities of OSLC Core Overview [OSLCCore3], W3C Linked Data Platform [LDP], W3C's Architecture of the World Wide Web [WEBARCH], Hyper-text Transfer Protocol [HTTP11].
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].
This section is non-normative.
Most OSLC vocabularies and resource shape constraints on usages of those vocabularies are given in the various OSLC domain specifications. The motivation for these domain specifications is to define agreed upon, formalized vocabulary terms for key elements in the domain. Domain vocabularies are not intended to restrict what vocabularies servers actually use for those domains, or what domains they support. Rather vocabularies establish a common core of domain terms that reduce accidental variability and foster greater interchange and interoperability between tools that support and users that make use of domains. Servers are free to extend the domains and integrate across domains as required to realize their provided capabilities.
OSLC Core takes a similar approach for common terms that are used across most domains. The intent is to provide a foundation for building domains that again reduces unnecessary variability, and eliminates the need for the various domain specifications to redundantly define similar terms. The follow paragraphs describe the kinds of common terms defined by OSLC core in order to achieve the stated intent.
Archived Resources are typically found in large systems in which an immutable copy of the state of a resource at a given time is captured. The purpose may vary in that it could be simply a way to facilitate access to a backup or snapshot of a resource at a particular point in time. Another use may be to indicate that a resource has been deleted, but is saved by the system for historical or legal reasons. Having a consistent way to indicate that a resource, or a set of them, has been archived helps when defining certain views of the resources or queries.
Archived Resources may be identified by having a property oslc:archived
, with value true
.
Many different kinds of applications have a way to provide comments or notes related to a given resource. These take the form of a discussion, with a sequence of comments. OSLC Core provide a common way for applications to easily add to a comment to a discussion thread or navigate a discussion thread.
Error responses from HTTP request often take the form of HTML pages intended for a human to read, even though these requests are often initiated from applications that don't have a human actively monitoring it. OSLC Core defines a consistent way to request error responses of a certain format, and a prescribed interaction model that helps clients better handle errors automatically.
Consider a user interface for a query builder that allows users to build queries about test cases. It is natural for the query builder to present the user with a list of the properties that apply to test cases that could be used in the query. Suppose the user wants to build a query that returns all the requirements that are validated by a test case. The query builder should describe the available properties from the point of view of the test case. This implies that the query builder should describe the inverse relation asserted by any triple that has the test case as an object. In this example, the query builder should describe assertions of the form {requirement oslc_rm:validatedBy
test case} as {test case validates
requirement}.
Some RDF properties express relations or links between subject and object artifacts. If a change in state of subject and/or object of a triple may result in the assertion becoming invalid, the link may be seen to represent a dependency. OSLC Core provides property oslc:impactType
as a means of defining the dependency represented by an RDF property.
The shape of an RDF resource is a description of the set of triples it is expected to contain and the integrity constraints those triples are required to satisfy. Applications of shapes include validating RDF data, documenting RDF APIs, and providing meta-data to tools, such as form and query builders, that handle RDF data. OSLC Core uses shapes to:
Constraints on OSLC Core and Domain resources SHOULD be described using [ResourceShapes] which is included as part of the OSLC Core multi-part specifications. Servers MAY use other constraint languages such as [SHACL] to define resource constraints.
This section is non-normative.
Some property values are are characterized by a limited set of enumerated values. The type for these property values is called an enumeration in many modeling and programming languages, while the values are called enumeration literals. RDF does not define a specific way of defining enumerated types and enumeration literals. As a result, different vocabularies may take different, but equally valid approaches. In order to foster interoperability and integration, OSLC Core provides a recommended approach for defining enumerated types and enumeration literals. This approach is used in defining the OSLC Core vocabulary terms.
Enumerations in an OSLC vocabulary should be defined as an RDF class. Enumeration literals are the URIs of individuals of that class. For example, consider an enumeration called "Color" that has enumeration literals {red, yellow, green, blue}
(using Java notation). Color would be defined as an RDF class and the enumeration literals would be individuals of that class. A color
property is defined and then used to assert that the color of myCar is blue.
# Color enumeration Color a rdfs:Class ; rdfs:label "Color" ; rdfs:comment "The class of possible color values." . # Color enumeration literals red a Color ; rdfs:label "red" . yellow a Color ; rdfs:label "yellow" . green a Color ; rdfs:label "green" . blue a Color ; rdfs:label "blue" . # A Color property color a rdf:Property ; rdfs:label "color" ; rdfs:comment "Used to specify the color of a resource". # Asserting the color of a resource myCar color blue.
Enumerations can be open or closed. Open enumerations allow additional enumeration literals to be added as needed. Closed enumerations have a fixed set of enumeration literals that is not intended to be extended. Resource shapes can be used to constrain enumerations to a specific set of values. Notice in the example above that the color property did not specify its rdfs:range. This keeps the enumeration completely open to any set of individuals. OSLC prefers to use resource shapes to constrain resources for particular usages, leaving them open for extension for other, possibly unanticipated usages.
A shape can be used to constrain the Color enumeration for a specific purpose. For example, the color of lights in a traffic light should be constrained to exactly red, yellow and green.
# Create a constraint on Color for traffic lights TrafficLightConstraint a oslc:ResourceShape ; oslc:describes fhwa:TrafficLight ; determs:title "Establish constraints for traffic light colors" ; oslc:property colorConstraint . colorConstraint a oslc:Property ; oslc:name "color" ; dcterms:description "The colors for a traffic light as specified by FHWA." oslc:propertyDefinition color ; oslc:occurs oslc:Exactly-one ; oslc:range Color ; oslc:allowValue red, yellow, green ; oslc:readOnly "false" ; oslc:representation oslc:Reference ; oslc:valueType oslc:Resource .
TrafficLightConstraint defines a constraint associated with the vocabulary term fhwa:TrafficLight
. The constraint has one property, colorConstraint whose oslc:propertyDefinition
is the color RDF property. The oslc:range
for the colorConstraint is set to Color, meaning the value of the applicable property is constrained to be of rdf:type
Color. The oslc:allowedValue
property further constrains the values to be red, yelow, or green. If the oslc:allowedValue
were not specified, then the TrafficLightConstraint would allow the enumeration to be open.
A completely different shape constraint could be used for colors that represent the status of a risk mitigation in a software development project.
Unlike the rest of the Core specification, these properties change and grow as new common properties are added by the Core TC. The properties that we list here are available for use in OSLC domain specifications when defining OSLC resources, but this does not mean that they are required to be in OSLC resources. OSLC domain specifications decide which properties are allowed and required for resources needed to realize their use cases. The OSLC common properties include properties defined in other standard vocabularies including:
Defines common properties that may be applicable to any OSLC resource. OSLC domains SHOULD use these properties where applicable rather than defining their own properties. The cardinality, representations, ranges, and other columns of the following table indicate typical usage, but a domain is free to apply its own constraints for particular resource shapes.
Prefixed Name | Occurs | Read-only | Value-type | Representation | Range | Description |
---|---|---|---|---|---|---|
dcterms:contributor |
Zero-or-many | unspecified | AnyResource | Either | foaf:Person |
Contributor or contributors to the resource. It is likely that the target resource will be a foaf:Person but that is not necessarily the case. |
dcterms:created |
Zero-or-one | unspecified | dateTime | N/A | Unspecified | Timestamp of resource creation. |
dcterms:creator |
Zero-or-many | unspecified | AnyResource | Either | foaf:Person |
Creator or creators of the resource. It is likely that the target resource will be a foaf:Person but that is not necessarily the case. |
dcterms:description |
Zero-or-many | unspecified | XMLLiteral | N/A | Unspecified | Descriptive text about resource represented as rich text in XHTML content. |
dcterms:identifier |
Zero-or-many | unspecified | string | N/A | Unspecified | A unique identifier for a resource. Typically read-only and assigned by the service provider when a resource is created. Not typically intended for end-user display. |
dcterms:modified |
Zero-or-many | unspecified | dateTime | N/A | Unspecified | Timestamp of latest resource modification. |
dcterms:references |
Zero-or-many | unspecified | AnyResource | Either | Unspecified | A related resource that is referenced, cited, or otherwise pointed to by the described resource. |
dcterms:relation |
Zero-or-many | unspecified | AnyResource | Either | Unspecified | Relation which identifies a related resource. |
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 |
Zero-or-many | unspecified | XMLLiteral | N/A | Unspecified | Title of the resource represented as rich text in XHTML content. |
oslc:discussedBy |
Zero-or-many | unspecified | Resource | Either | oslc:Comment |
A series of notes and comments about this resource. |
oslc:error |
Zero-or-many | unspecified | AnyResource | Either | Unspecified | A series of errors associated with this resource. |
oslc:instanceShape |
Zero-or-many | unspecified | Resource | Reference | oslc:ResourceShape |
The URI of a Resource Shape that describes the possible properties, occurrence, value types, allowed values and labels. This shape information is useful in displaying the subject resource as well as guiding clients in performing modifications. Instance shapes may be specific to the authenticated user associated with the request that retrieved the resource, the current state of the resource and other factors and thus should not be cached. |
oslc:modifiedBy |
Zero-or-many | unspecified | Resource | Either | foaf:Person |
The URI of a resource describing the entity that most recently modified the subject resource. The link target is usually a foaf:Person or foaf:Agent, but could be any type. This is modeled after dcterms:creator, but Dublin Core currently has no equivalent property. |
oslc:queryable |
Zero-or-one | unspecified | boolean | N/A | Unspecified | Indicates whether a property is queryable (can appear in oslc.where and olsc.select clause) or not. Defaults to true if unspecified. |
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:shortId |
Zero-or-many | unspecified | string | N/A | Unspecified | A short, human-readable, plain text value. This value should be unique in some context that is apparent to human users of a service. |
oslc:shortTitle |
Zero-or-many | unspecified | XMLLiteral | N/A | Unspecified | Shorter form of dcterms:title for the resource represented as rich text in XHTML content. |
rdf:type |
Zero-or-many | unspecified | Resource | Reference | rdfs:Class |
The resource type URIs. |
rdfs:member |
Zero-or-many | unspecified | Resource | Either | Unspecified | OSLC domains might define a number of member or contains relationships between resources. The rdfs:member property is suitable for use when only one such relationship needs to be defined, or when no additional semantics need to be implied by the property name. |
Person
http://xmlns.com/foaf/0.1/Person
Prefixed Name | Occurs | Read-only | Value-type | Representation | Range | Description |
---|---|---|---|---|---|---|
foaf:familyName |
Zero-or-many | unspecified | string | N/A | Unspecified | Family name of person expressed as simple text string. |
foaf:givenName |
Zero-or-many | unspecified | string | N/A | Unspecified | Given name of person expressed as simple text string. |
foaf:mbox |
Zero-or-many | unspecified | string | N/A | Unspecified | A personal mailbox for this person, typically identified using the mailto: URI scheme (see RFC 2368). |
foaf:name |
Zero-or-many | unspecified | string | N/A | Unspecified | The full name of a person expressed as simple text string. |
foaf:nick |
Zero-or-many | unspecified | string | N/A | Unspecified | A short informal nickname or login identifer expressed as simple text string. |
http://open-services.net/ns/core#
.
See section 10. Terms for details on common property terms.
It is common to collect a series of comments on a lifecycle resource, often referred to as a discussion. For example: tasks, bug reports, requirements, assets and so on, are often collected across various types of resources such as project. A project might reflect the planning of work to deliver a product that realizes the requirements as validated through test cases and bug reports. Discussions allow users to collaborate with each other for more efficient and effective delivery. This Discussion resource definition provides a minimal shape describing the needed properties.
Discussion
http://open-services.net/ns/core#Discussion
Prefixed Name | Occurs | Read-only | Value-type | Representation | Range | Description |
---|---|---|---|---|---|---|
oslc:comment |
Zero-or-many | false | AnyResource | Either | oslc:Comment |
Comment about resource. |
oslc:discussionAbout |
Exactly-one | false | Resource | Reference | Unspecified | Reference to associated resource. |
Used in conjunction with Shape: Discussion to provide a minimal resource definition for a collection of comments.
Comment
http://open-services.net/ns/core#Comment
Prefixed Name | Occurs | Read-only | Value-type | Representation | Range | Description |
---|---|---|---|---|---|---|
dcterms:created |
Exactly-one | unspecified | dateTime | N/A | Unspecified | When the comment resource was created. |
dcterms:creator |
Exactly-one | unspecified | AnyResource | Either | foaf:Person |
The person who created the comment. |
dcterms:description |
Exactly-one | unspecified | XMLLiteral | N/A | Unspecified | Details or body of the comment. SHOULD include only content that is valid and suitable inside an XHTML <div> element. |
dcterms:identifier |
Exactly-one | unspecified | string | N/A | Unspecified | A service defined identifier. |
dcterms:title |
Zero-or-one | unspecified | XMLLiteral | N/A | Unspecified | A brief title for the comment. SHOULD include only content that is valid and suitable inside an XHTML <span> element. |
oslc:inReplyTo |
Zero-or-one | unspecified | Resource | Reference | oslc:Comment |
Reference to the comment to which this comment replies. |
See section 10. Terms for details on discussion property terms.
Accept
request header. [HTTP11]oslc:statusCode
as a String that starts with digits, but may contain non-digit text.Used when servers may need a consistent shape to communicate error messages.
Error
http://open-services.net/ns/core#Error
Prefixed Name | Occurs | Read-only | Value-type | Representation | Range | Description |
---|---|---|---|---|---|---|
dcterms:created |
Zero-or-one | unspecified | dateTime | N/A | Unspecified | Optional indication of when the error was detected. |
dcterms:identifier |
Zero-or-many | unspecified | string | N/A | Unspecified | A unique human-readable string identifier for this resource, such as an error number or code. |
dcterms:references |
Zero-or-many | unspecified | AnyResource | Either | Unspecified | A reference to any resources that are the subject of this error. |
oslc:extendedError |
Zero-or-one | true | AnyResource | Either | oslc:ExtendedError |
Extended error information. |
oslc:message |
Exactly-one | true | string | N/A | Unspecified | An informative message describing the error that occurred. |
oslc:statusCode |
Exactly-one | true | string | N/A | Unspecified | The HTTP status code reported with the error. |
Additional details about an error the server had when processing the request.
ExtendedError
http://open-services.net/ns/core#ExtendedError
Prefixed Name | Occurs | Read-only | Value-type | Representation | Range | Description |
---|---|---|---|---|---|---|
oslc:hintHeight |
Zero-or-one | true | string | N/A | Unspecified | Values MUST be expressed in relative length units as defined in the W3C Cascading Style Sheets Specification (CSS 2.1) Em and ex units are interpreted relative to the default system font (at 100% size). |
oslc:hintWidth |
Zero-or-one | true | string | N/A | Unspecified | Values MUST be expressed in relative length units as defined in the W3C Cascading Style Sheets Specification (CSS 2.1) Em and ex units are interpreted relative to the default system font (at 100% size). |
oslc:moreInfo |
Zero-or-one | true | Resource | Reference | Unspecified | A resource giving more information on the error SHOULD be of an HTML content-type. |
oslc:rel |
Zero-or-one | true | string | N/A | Unspecified | If present and set to 'alternate' then indicates that work-around is provided, behavior for other values is undefined. |
See section 10. Terms for details on error property terms.
Resource representations returned via [OSLCCore2] Resource Paging MUST include a resource of type oslc:ResponseInfo, as defined in this section. A response info resource representation describes information about a paged HTTP response body in which it appears.
ResponseInfo
http://open-services.net/ns/core#ResponseInfo
Prefixed Name | Occurs | Read-only | Value-type | Representation | Range | Description |
---|---|---|---|---|---|---|
dcterms:description |
Zero-or-many | unspecified | XMLLiteral | N/A | Unspecified | Descriptive text about resource represented as rich text in XHTML content. |
dcterms:title |
Zero-or-many | unspecified | XMLLiteral | N/A | Unspecified | Title of the resource represented as rich text in XHTML content. |
oslc:nextPage |
Zero-or-one | true | Resource | Reference | Unspecified | Link to the next page of a response. |
oslc:postBody |
Zero-or-one | true | string | N/A | Unspecified | The body of a POST request to return the next page if the response was to a POST request. Where a paged resource supports POST with an application/x-www-form-urlencoded body as an alternative to GET to avoid the request URI exceeding server limitations, the oslc:ResponseInfo in the response to the POST SHOULD contain this property so that a client knows what to POST to get the next page. |
oslc:totalCount |
Zero-or-one | true | integer | N/A | Unspecified | This optional property indicates the total number of results across all pages, its value should be non-negative. In the context of a query resource, this value SHOULD be the total number of results, i.e. the number of resources that match the query. In the context of other resources, the value SHOULD be the total number of property values (i.e. RDF triples) of the resource. Unless Stable Paging is in effect, the total count MAY vary as a client retrieves subsequent pages. |
The W3C RDF Schema vocabulary defines the vocabulary annotation property rdfs:label
. This property is intended to provide a human-readable description for a resource’s name. It is often used to provide a label for RDF properties.
[LinkGuidance] discourages the creation of inverse predicates. However, there is still a need for a property, like rdfs:label, to specify an inverse label for a predicate.
For example, consider the OSLC Requirements Management (RM) property oslc_rm:validatedBy. When used as the predicate of a triple, this property is used to assert that the subject resource, e.g. a Requirement, is validated by the object resource, e.g. a TestCase. The rdfs:label for this property is “validatedBy”.
Now consider the user interface of a query builder that allows users to build queries about TestCases. It is natural for the query builder to present the user with a list of the properties that apply to TestCases. Suppose the user wants to build a query that returns all the Requirements that are validated by a TestCase. The query builder should describe the available properties from the point of view of the TestCase. This implies that the query builder should describe the inverse relation asserted by any triple that has the TestCase as an object. In our example, the query builder should describe oslc_rm:validatedBy as “validates”.
The oslc:inverseLabel property provides a human-readable label for the inverse of the subject property.
For example, the following triple (in Turtle notation) would be added to the OSLC RM vocabulary:
oslc_rm:validatedBy oslc:inverseLabel "validates".
It should be noted that the use of inverse labels is independent of the existence of explicit RDF inverse properties. However, if an inverse property is defined by some vocabulary, then a consistent label should be used in order to avoid confusion. In general, it is good practice to avoid the creation of inverse properties since it creates redundant information and complicates SPARQL queries. Instead, a single property should be wherever possible and it should be given an inverse label in order to describe the property from the perspective of the object.
For example, the OSLC Quality Management (QM) vocabulary defines two properties that are approximately inverse to oslc_rm:validatedBy. These are oslc_qm:validatesRequirement and oslc_qm:validatesRequirementCollection. In this case the choice of inverse label “validates” for oslc_rm:validatedBy is consistent with the actual labels of the inverse properties, namely “validatesRequirement” and “validatesRequirementCollection”.
Some RDF properties express dependency relations between artifacts, and it is often very valuable to trace the impact of a change in an artifact to those artifacts that depend on it directly or indirectly. The concept of dependency is very general. For example, the concept of trace relations is described in SysML: “A generic trace requirement relationship provides a general-purpose relationship between a requirement and any other model element. The semantics of trace include no real constraints and therefore are quite weak.”
As a general guideline, if any assertion involving a given predicate may become invalid if the state of either its subject or object resources change, then we may legitimately regard that predicate as expressing a dependency relation, in which case it may be useful to explicitly describe the nature of the dependency.
An assertion describes a link between subject and object resources whose name is the property or predicate of the assertion. A dependency relationship may be in the same direction as the link, the opposite direction, both directions, or the link may not represent any dependency whose impact might need to be assessed.
For example, in assertions such as {requirement validatedBy testcase}, it may be important to assess the impact of a change in the requirement or a change in the testcase. Typically test cases are updated to reflect changes in requirements in order perform the correct validation. So in this case, property validatedBy would introduce impact that follows the link, from the subject requirement to the object testcase. However, if a team is doing test-driven development, they may treat test cases as formal, executable specifications of requirements and the requirement is simply an informal description of the test case. In this case, the team might consider the impact to be opposite of the link, from the testcase to the requirement.
The property oslc:impactType
asserts that the subject property is a dependency relation and gives
the direction of impact. The resources oslc:FollowsLink
and oslc:OppositeLink
identify
whether the impact follows the direction of the assertion (subject to object), or the opposite direction (object to subject). oslc:SymmetricImpact
describes a symmetric dependency
relation in which the property represents a dependency from both subject to object and object to subject. oslc:NoImpact
indicates the predicate does not represent any dependency between the subject and object resources.
For example, the following triple (in Turtle notation) would be added a vocabulary to indicate test cases are dependent on requirements:
Example 4ex:validatedBy oslc:impactType oslc:FollowsLink .
The same dependency could also be described from the perspective of the test case. In this case, the dependency is opposite of the validatesRequirement predicate:
Example 5ex:validatesRequirement oslc:impactType oslc:OppositeImpact .
ex:validatesRequirementCollection oslc:impactType oslc:OppositeImpact.
Vocabulary terms are discovered via published vocabulary documents at the OSLC Core namespace and shapes at advertised URLs.
The namespace URI for this vocabulary is:
http://open-services.net/ns/core#
All vocabulary URIs defined in the OSLC Core namespace.
AllowedValues, AttachmentContainer, AttachmentDescriptor, Comment, Compact, CreationFactory, Dialog, Discussion, Error, ExtendedError, OAuthConfiguration, PrefixDefinition, Preview, Property, Publisher, QueryCapability, ResourceShape, ResponseInfo, Service, ServiceProvider, ServiceProviderCatalog
allowedValue, allowedValues, archived, attachment, attachmentSize, authorizationURI, comment, creation, creationDialog, creationFactory, default, defaultValue, describes, details, dialog, discussedBy, discussionAbout, document, domain, error, executes, extendedError, futureAction, hidden, hintHeight, hintWidth, icon, iconAltLabel, iconSrcSet, iconTitle, impactType, initialHeight, inReplyTo, instanceShape, inverseLabel, isMemberProperty, label, largePreview, maxSize, message, modifiedBy, moreInfo, name, nextPage, oauthAccessTokenURI, oauthConfiguration, oauthRequestTokenURI, occurs, partOfDiscussion, postBody, prefix, prefixBase, prefixDefinition, property, propertyDefinition, queryable, queryBase, queryCapability, range, readOnly, rel, representation, resourceShape, resourceType, results, selectionDialog, service, serviceProvider, serviceProviderCatalog, shortId, shortTitle, smallPreview, statusCode, totalCount, usage, valueShape, valueType
AllowedValues is an RDFS class.
Provides a way to specify allowed values for one or more properties.
AttachmentContainer is an RDFS class.
An LDP-C that contains attachments for a resource.
AttachmentDescriptor is an RDFS class.
An LDP-RS that contains additional data about an attachment.
Compact is an RDFS class.
A resource describing how to display a link and Preview for another, associated resource.
CreationFactory is an RDFS class.
The CreationFactory definition included in a ServiceProvider.
Dialog is an RDFS class.
Describes information about a dialog such as its title and dimensions.
Discussion is an RDFS class.
A Discussion resource is intended to represent a sequence of comments or notes regarding the associated resource.
Error is an RDFS class.
Basis for forming an error response.
ExtendedError is an RDFS class.
Extended error information.
OAuthConfiguration is an RDFS class.
The OAuthConfiguration definition included in ServiceProvider.
PrefixDefinition is an RDFS class.
The PrefixDefinition definition included in ServiceProvider.
Preview is an RDFS class.
An HTML representation of a resource that can be embedded in another user interface.
Property is an RDFS class.
A Property resource describes one allowed or required property of a resource.
Publisher is an RDFS class.
The Publisher definition included in ServiceProvider.
QueryCapability is an RDFS class.
The QueryCapability definition included in a ServiceProvider.
ResourceShape is an RDFS class.
The Resource Shape used for creation, query and modify. Formally, a shape S applies to a resource R if there is a triple R rdf:type T and there is a triple S oslc:describes T, or if there is a triple R oslc:instanceShape S.
ResponseInfo is an RDFS class.
The ResponseInfo included in query results.
Service is an RDFS class.
The Service definition included in a ServiceProvider.
ServiceProvider is an RDFS class.
The Service Provider resource.
ServiceProviderCatalog is an RDFS class.
The Service Provider Catalog resource.
allowedValue is an RDF property.
Specifies the allowed values for a property (may be more than one).
allowedValues is an RDF property.
Reference to an AllowedValues resource that specifies the allowed values for the property.
archived is an RDF property.
Indicates whether the subject has been marked as archived, no longer an actively updating resource.
attachment is an RDF property.
An attachment associated with a resource. May be used as a membership predicate for an attachment container.
attachmentSize is an RDF property.
Size in bytes of the attachment content.
comment is an RDF property.
Comment about the resource.
creation is an RDF property.
To create a new resource via the factory, post it to this URI.
creationDialog is an RDF property.
Enables clients to create a resource via UI.
creationFactory is an RDF property.
Enables clients to create new resources.
default is an RDF property.
Used in conjunction with oslc:usage property used to identify which service is the default usage.
defaultValue is an RDF property.
A default value for property, inlined into property definition.
describes is an RDF property.
This shape describes resources that are of the RDF type given by the object of the oslc:describes predicate. Formally, a shape S applies to a resource R if there is a triple R rdf:type T and there is a triple S oslc:describes T.
details is an RDF property.
A URL that may be used to retrieve a resource to determine additional details about the service provider.
dialog is an RDF property.
The URI of the HTML dialog.
discussedBy is an RDF property.
A series of notes and comments about this resource.
discussionAbout is an RDF property.
Reference to associated resource.
document is an RDF property.
The URI of an HTML document to be used for the preview.
domain is an RDF property.
Namespace URI of the specification that is implemented by this service. In most cases this namespace URI will be for an OSLC domain, but other URIs MAY be used.
error is an RDF property.
Error information that may be associated with a resource.
executes is an RDF property.
Link from a currently available action to the future action it realizes.
extendedError is an RDF property.
Extended (additional) error information.
futureAction is an RDF property.
A predicate that links to an action that is not currently executable on the subject resource, but may be executable in the future and/or on other resources. For example, in OSLC Automation this is expected to link from an oslc_auto:AutomationPlan to an oslc:Action resource with zero bindings (as it is not executable), with the meaning that the executable form of the action may be available on oslc_auto:AutomationResult resources generated by executing that Automation Plan. Similarly, resource shapes can allow discovery of actions available on the output of a creation factory.
hintHeight is an RDF property.
Preferred height of a delegated user interface. Values must be expressed using length units as specified in Cascading Style Sheets 2.1.
hintWidth is an RDF property.
Preferred width of a delegated user interface. Values must be expressed using length units as specified in Cascading Style Sheets 2.1.
icon is an RDF property.
URI of an image applicable to the resource.
iconAltLabel is an RDF property.
Alternative label used in association with the oslc:icon, such as HTML img tag's alt attribute.
iconSrcSet is an RDF property.
Specification of a set of images of different sizes based on HTML img element srcset attribute.
iconTitle is an RDF property.
Title used in association with the oslc:icon, such as HTML img tag's title attribute.
impactType is an RDF property.
Asserts that the subject property is a dependency relation and gives the direction of impact.
initialHeight is an RDF property.
Recommended initial height of the preview. The presence of this property indicates that the preview supports dynamically computing its size. Values MUST be expressed in relative length units as defined in the W3C Cascading Style Sheets Specification (CSS 2.1). Em and ex units are interpreted relative to the default system font (at 100% size).
inReplyTo is an RDF property.
Reference to comment this comment is in reply to.
instanceShape is an RDF property.
The URI of a Resource Shape that describes the possible properties.
inverseLabel is an RDF property.
Provides a human-readable label for the inverse of the subject property.
isMemberProperty is an RDF property.
Used to define when a property is a member of a container, useful for query.
label is an RDF property.
Very short label for use in menu items.
largePreview is an RDF property.
URI and sizing properties for an HTML document to be used for a large preview.
maxSize is an RDF property.
For String properties only, specifies maximum characters allowed. If not set, then there is no maximum or maximum is specified elsewhere.
message is an RDF property.
An informative message describing the error that occurred.
modifiedBy is an RDF property.
The URI of a resource describing the entity that most recently modified this resource. The link target is usually a foaf:Person or foaf:Agent, but could be any type. This is modeled after dcterms:creator, but Dublin Core currently has no equivalent property.
moreInfo is an RDF property.
A resource giving more information on the error SHOULD be of an HTML content-type.
name is an RDF property.
Name of property being defined, i.e. second part of property's Prefixed Name. For all other uses, consider dcterms:title, rdfs:label, oslc:shortTitle or oslc:label.
nextPage is an RDF property.
Link to next page of response.
oauthAccessTokenURI is an RDF property.
URI for obtaining OAuth access token.
oauthConfiguration is an RDF property.
Defines the three OAuth URIs required for a client to act as an OAuth consumer.
oauthRequestTokenURI is an RDF property.
URI for obtaining OAuth request token.
occurs is an RDF property.
MUST be either http://open-services.net/ns/core#Exactly-one, http://open-services.net/ns/core#Zero-or-one, http://open-services.net/ns/core#Zero-or-many or http://open-services.net/ns/core#One-or-many.
partOfDiscussion is an RDF property.
Reference to owning Discussion resource .
postBody is an RDF property.
The body of a POST request to return the next page if the response was to a POST request. Where a paged resource supports POST with an application/x-www-form-urlencoded body as an alternative to GET to avoid the request URI exceeding server limitations, the oslc:ResponseInfo in the response to the POST SHOULD contain this property so that a client knows what to POST to get the next page.
prefix is an RDF property.
Namespace prefix to be used for this namespace.
prefixBase is an RDF property.
The base URI of the namespace.
prefixDefinition is an RDF property.
Defines a namespace prefix for use in JSON representations and in forming OSLC Query Syntax strings.
property is an RDF property.
The properties that are allowed or required by this shape.
propertyDefinition is an RDF property.
URI of the property whose usage is being described.
queryable is an RDF property.
Indicates whether a property is queryable (can appear in oslc.where and olsc.select clause) or not.
queryBase is an RDF property.
The base URI to use for queries. Queries may be invoked either by HTTP GET or HTTP POST. For HTTP GET, a query URI is formed by appending a key=value pair to the base URI. For HTTP POST, the query parameters are encoded as content with media type application/x-www-form-urlencoded and sent in the request body. The base URI MAY accept other query languages and media types in the request body, e.g. application/sparql-query for SPARQL queries.
queryCapability is an RDF property.
Enables clients query across a collection of resources.
range is an RDF property.
For properties with a resource value-type, Providers MAY also specify the range of possible resource types allowed, each specified by URI. The default range is http://open-services.net/ns/core#Any.
readOnly is an RDF property.
true if the property is read-only. If omitted, or set to false, then the property is writable. Providers SHOULD declare a property read-only when changes to the value of that property will not be accepted after the resource has been created, e.g. on PUT/PATCH requests. Consumers should note that the converse does not apply: Providers MAY reject a change to the value of a writable property.
rel is an RDF property.
If present and set to 'alternate' then indicates that work-around is provided, behavior for other values is undefined.
representation is an RDF property.
Should be http://open-services.net/ns/core#Reference, http://open-services.net/ns/core#Inline or http://open-services.net/ns/core#Either.
resourceShape is an RDF property.
A Creation Factory MAY provide Resource Shapes that describe shapes of resources that may be created.
resourceType is an RDF property.
The expected resource type URI of the resource that will be created using this creation factory. These would be the URIs found in the result resource's rdf:type property.
results is an RDF property.
Used to hold the results of dialog action or JSON query results (default). The JSON query result attribute 'oslc:results' is used whenever a provider doesn't have a suitable property already in its model for such purposes.
selectionDialog is an RDF property.
Enables clients to select a resource via a UI.
service is an RDF property.
Describes a service offered by the service provider.
serviceProvider is an RDF property.
A link to the resource's OSLC Service Provider.
serviceProviderCatalog is an RDF property.
Additional service provider catalog.
shortId is an RDF property.
A short, human-readable, plain text value. This value should be unique in some context that is apparent to human users of a service.
shortTitle is an RDF property.
Shorter form of dcterms:title for the resource.
smallPreview is an RDF property.
URI and sizing properties for an HTML document to be used for a small preview.
statusCode is an RDF property.
The HTTP status code reported with the error.
totalCount is an RDF property.
This optional property indicates the total number of results across all pages, its value should be non-negative. In the context of a query resource, this value SHOULD be the total number of results, i.e. the number of resources that match the query. In the context of other resources, the value SHOULD be the total number of property values (i.e. RDF triples) of the resource. Unless Stable Paging is in effect, the total count MAY vary as a client retrieves subsequent pages.
usage is an RDF property.
An identifier URI for the domain specified usage of this creation factory. If a service provides multiple creation factories, it may designate the primary or default one that should be used with a property value of http://open-services.net/ns/core#default.
valueShape is an RDF property.
if the value-type is a resource type, then Property MAY provide a shape value to indicate the Resource Shape that applies to the resource.
valueType is an RDF property.
A URI that indicates the value type, for example XML Schema or RDF URIs for literal value types, and OSLC-specified for others. If this property is omitted, then the value type is unconstrained.
Any is an RDF description.
Any value type is allowed.
This section is non-normative.
Revision | Date | Editor | Changes Made |
01 | 04 April 2017 | Jim Amsden | CS was approved and published. |
03 | 31 May 2018 | Jim Amsden | Added oslc:error common property to associate oslc:Error resources with any resource. Added missing ResponseInfo resource. Changed previx acc to oslc_acc for consistency. Added oslc:queryable property for OSLC Query Capability. Added oslc:postBody property to ResponseInfo for POST method paging. Added dcterms:references as a common property. Added the created, references, identifier properties to oslc:Error. |
10.1.7 Comment
Comment is an RDFS class.
A Comment resource represents a single note, or comment, in a discussion thread.