XKOS Best Practices conformance shapes


Abstract

The XKOS Best Practices shapes are splitted in 2 files : shapes to check for (strict) XKOS conformance, and shapes to check for recommended practices. This file provides the rules to check for conformance, and as such contains shapes with sh:severity of sh:Violation. Users can use either the strict XKOS conformance rules or the strict conformance rules in conjunction with the recommended practices depending on their objective.

Table of Contents


Model documentation

Classification

Property name URI Expected value Card. Description
short name skos:notation xsd:string
1..1
The value must be the short name of the classification, with no language tag.
complete name in english skos:prefLabel rdf:langString
0..*
The value must be the complete name of the classification scheme in english.
date of publication dct:issued xsd:date
1..1
The value must be the publication date of the classification scheme
complete name not in english skos:prefLabel rdf:langString
0..*
The value must be the complete name of the classification scheme in another language than english, with a proper language tag.
short description dc:description rdf:langString
0..*
The value must be a short descriptive text about the classification scheme in english.
long description skos:scopeNote xkos:ExplanatoryNote
0..*
The explanatory note MUST have a xkos:plainText property which value is a long descriptive text about the classification scheme in English, with a language tag set at ‘@en’
top concept skos:hasTopConcept|^skos:topConceptOf skos:Concept
0..*
Reference to a top-level classification entry of this classification. Top level entries can be indicated either from ConceptScheme to root Concepts, using `skos:hasTopConcept`, or from root Concepts to ConceptScheme, using `skos:topConceptOf`.
last modification date dct:modified xsd:date
0..1
The value must be the last modification date of the classification scheme.
creator dct:creator IRI
0..*
An agent responsible for creating the classification scheme.
valid from schema:startDate Literal
0..1
Begin date of the temporal validity of the classification.
valid until schema:startDate Literal
0..1
End date of the temporal validity of the classification.
overall classification xkos:belongsTo skos:Concept
0..1
Connects a major version of a classification to a concept representing the overall classification.
classification levels xkos:levels 7221d1c69e0576a9f5da69b59ef97811
0..1
Lists the classification levels represented as an RDF list of ordered levels (instances of xkos:ClassificationLevel).
domain covered xkos:covers skos:Concept
0..1
The domain covered by the classification or its levels (eg. activities, products, etc.). Subproperties xkos:coversExhaustively and xkos:coversMutuallyExclusively can also be used.
domain covered exhaustively xkos:coversExhaustively skos:Concept
0..1
The domain covered by the classification (exhaustive coverage).
domain covered mutually exhaustively xkos:coversMutuallyExclusively skos:Concept
0..1
The domain covered by the classification (mutually exclusive coverage).
classification depth xkos:numberOfLevels xsd:integer
0..1
Depth of a classification (number of hierarchically imbricated levels) ; 1 for a flat classification.
previous major version xkos:follows Classification
0..1
Links major revisions of classifications.
previous major version (obsoleted) xkos:supersedes Classification
0..1
Links major revisions of classifications, when the new one obsoletes the old one.
variant xkos:variant Classification
0..*
Connects a classification scheme to its variant(s)
long description not in english skos:scopeNote xkos:ExplanatoryNote
0..*
Each explanatory note MUST have a xkos:plainText property which value is a long descriptive text about the classification scheme in another langage than english, with the langage tag set appropriately
other name skos:altLabel rdf:langString
0..*
An alternative appelation to refer to the classification scheme.
langage coverage dct:language xsd:language
0..*
Indicates the langage coverage of the classificaiton scheme. Each value must correspond to a possible langage of labels within that classification.
license dct:license IRI
0..1
The URI to the legal document giving official permission to do something with the classification.
deprecated owl:deprecated xsd:boolean
0..1
Indicates the classification is no longer active and has been superseded by a new revision.
based on legislation eli:based_on IRI
0..1
Legislation on which the nomenclature is based. Use of an ELI (European Legislation Identifier) URI is preferred, if one is available.

Versioned note

  • Nodes: IRI
Property name URI Expected value Card. Description
value (plain text) xkos:plainText rdf:langString
1..1
The value of the note, in plain text (no HTML / XML markup). The literal is tagged with a proper language tag.
language dct:language xsd:language
1..1
The language code of the note. This is a repetition of the language tag of the xkos:plainText attribute, that makes it easier to query/select notes in a certain language.
version dcat:version xsd:int
1..1
The version number of the note. e.g. "1"^^xsd:int, "2"^^xsd:int, etc. Note that this version number will typically be used in the URI of the xkos:ExplanatoryNote.
start date schema:startDate xsd:dateTime
1..1
The date from which this note content is valid.
end date schema:endDate xsd:dateTime
0..1
The date until which this note content was (or will be) valid, indicating it was (or will be) replaced with another note with a different text, and its version number increased by 1. This property is not set in the case if there is no known end date.
value (with markup) rdf:value rdf:XMLLiteral
0..1
If needed the value of the note containing HTML or XML markup.

Timestamped note

  • Nodes: IRI
Property name URI Expected value Card. Description
value (plain text) xkos:plainText rdf:langString
1..1
The value of the note, in plain text (no HTML / XML markup). The literal is tagged with a proper language tag.
language dct:language xsd:language
1..1
The language code of the note. This is a repetition of the language tag of the xkos:plainText attribute, that makes it easier to query/select notes in a certain language.
version dcat:version xsd:int
1..1
The version number of the note. e.g. "1"^^xsd:int, "2"^^xsd:int, etc. Note that this version number will typically be used in the URI of the xkos:ExplanatoryNote.
date of publication dct:issued xsd:dateTime
1..1
The date at which the note was issued. Note that this date will typically be used in the URI of the xkos:ExplanatoryNote.

Correspondence

Property name URI Expected value Card. Description
name in english skos:prefLabel rdf:langString
0..*
A name given to the correspondence table in english.
date of publication dct:issued xsd:date
1..1
The publication date of the correspondence table.
name not in english skos:prefLabel rdf:langString
0..*
A name given to the correspondence table in another language than english, with a proper language tag.
long description skos:scopeNote xkos:ExplanatoryNote
0..*
The explanatory note MUST have a xkos:plainText property which value is a long descriptive text about the classification scheme in English, with a language tag set at ‘@en’
creator dct:creator dct:Agent
0..*
An agent responsible for creating the correspondence table.
scope note skos:scopeNote xkos:ExplanatoryNote
0..*
A short descriptive text about the correspondance table in another language than english. The explanatory note MUST have a xkos:plainText property with a language tag set appropriately.
license dct:license IRI
0..1
The URI to the legal document giving official permission to do something with the entire correspondence table.
basis for rdfs:seeAlso IRI
0..*
Refers to another correspondence table based on the same classifications but with a different approach (e.g. reversing the role of the source and target classification).
weighted by xkos:weightedBy qb:DataSet
0..1
Refers to a matrix that contains the weights / ratios associated to each pair of mapped source and target concepts.

Explanatory Note in english

Property name URI Expected value Card. Description
value xkos:plainText rdf:langString
1..1

Explanatory Note not in english

Property name URI Expected value Card. Description
value xkos:plainText c93fd907cb253ff9c5edd2bbaccc3ce7
1..1