Ingest contract

The mechanisms by which a dataset joins the shared graph, written as SHACL shapes. Each shape carries its own message and severity.

kgp:AffordanceShape kgp:AffordanceShape

target: kgp:affordance

PropertyConstraintLevelMessage
kgp:affordanceclass skos:ConceptViolationan action must be a concept of the shared kgp:affordances concept scheme
kgp:performedAtnode kind sh:IRIViolationkgp:performedAt must be a link, not a literal

kgp:AffordanceValueShape Action — from the shared concept scheme, or narrower under it

target: kgp:affordance

kgp:AllowedValueSchemeShape Values of one field — from one scheme, with unique codes

target: kgp:allowedValue

kgp:AllowedValueShape Allowed field value — a scheme concept with a code

target: kgp:allowedValue

PropertyConstraintLevelMessage
skos:inSchemeat least 1Violationthe allowed value belongs to no scheme — it is a free value, not a vocabulary
skos:notationat least 1, at most 1, type xsd:stringViolationthe allowed value lacks exactly one skos:notation code (an xsd:string with no language tag) — a label goes into the artifact instead of the code

kgp:AudienceValueShape Reader role — a concept, not a literal

target: kgp:writtenFor

kgp:ConfirmationMethodShape Confirmation method — from the shared concept scheme, or narrower under it

target: kgp:confirmedVia

kgp:ConfirmationShape A confirmation is complete or it is not one

target: kgp:confirmedAt

PropertyConstraintLevelMessage
kgp:confirmedByat least 1Warningconfirmed, but by whom is not stated
kgp:confirmedFromat least 1Warningno kgp:confirmedFrom
kgp:confirmedViaat least 1, at most 1, class skos:ConceptWarningthe confirmation method must be a concept of the kgp:confirmationMethods concept scheme, or narrower than one of its concepts — the level is derived from the method, not set by hand

kgp:ContentNodeShape Content node: language, provenance, steward

target: void:inDataset

PropertyConstraintLevelMessage
dcterms:languageat least 1Violationthe node declares no language
kgp:bodyWarningtwo kgp:body values in the same language — only one of them is read
kgp:sourceat least 1Warningno kgp:source — the fact does not say where it came from
kgp:stewardat most 1, node kind sh:IRIWarningkgp:steward on a node must reference a role, and is only set when it differs from the dataset's steward

kgp:DatasetShape The dataset declares itself

target: SPARQL query

PropertyConstraintLevelMessage
dcterms:hasVersionat least 1, at most 1, pattern ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$Violationthe dataset version must be in a.b.c.d form
dcterms:issuedat least 1, at most 1, type xsd:dateTimeWarningthe release date dcterms:issued is missing, repeated or not an xsd:dateTime — kgp:confirmationPeriod has nothing to count from
dcterms:languageat least 1Violationno dcterms:language — the dataset does not say which languages it is in (the declared-language rule)
dcterms:licenseat least 1Violationno dcterms:license — the terms of use are not declared (the self-declaration rule)
kgp:confirmationPeriodat least 1Warningno kgp:confirmationPeriod — "confirmed" with no validity period
kgp:ontologyPinat least 1Violationno kgp:ontologyPin — a consumer has nothing to pin against
kgp:supersedesat most 1, type xsd:string, pattern ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$Warningkgp:supersedes must be a single version in a.b.c.d form
kgp:visibilityat least 1Violationno kgp:visibility — who may read the dataset is not stated
void:uriSpaceat least 1, at most 1Violationno void:uriSpace — the ownership boundary is not declared (the ownership-boundary rule)

kgp:DeclaredLanguagesDeliveredShape A declared language has text

target: SPARQL query

kgp:DependsOnShape A dependency points to a node

target: kgp:dependsOn

kgp:DocGenreValueShape Document genre — a concept in the subgraph's own scheme

target: kgp:docGenre

PropertyConstraintLevelMessage
skos:inSchemeat least 1Violationthe document genre belongs to no scheme — then it is not a vocabulary but a free value

kgp:EnforcementValueShape kgp:EnforcementValueShape

target: kgp:enforcement

PropertyConstraintLevelMessage
skos:inSchemevalue kgp:enforcementsViolationthe enforcement level is not from the kgp:enforcements scheme (off / warn / error)

kgp:EtomCodeShape kgp:EtomCodeShape

target: kgp:etomCode

PropertyConstraintLevelMessage
kgp:etomCodepattern ^[0-9]+(\.[0-9]+)*$Violationthe process code must be a GB921 process identifier in dotted-decimal form (e.g. 1.7.14.4)

kgp:EtomVerticalShape A shared eTOM term — with its source declared

target: SPARQL query

PropertyConstraintLevelMessage
rdfs:isDefinedByat least 1Violationan eTOM term is used without a reference node

kgp:EvidenceLevelValueShape kgp:EvidenceLevelValueShape

target: kgp:minimumEvidenceLevel

PropertyConstraintLevelMessage
skos:inSchemevalue kgp:evidenceLevelsViolationthe evidence level is not from the kgp:evidenceLevels concept scheme

kgp:LanguageTagShape Language code — BCP 47, not the language's own name

target: dcterms:language

kgp:MultilingualDatasetShape Several languages — how to reach them must be stated

target: SPARQL query

kgp:NarrowerMethodLevelShape A narrower method does not raise the evidence level

target: skos:broader

kgp:OwnerValueShape kgp:OwnerValueShape

target: kgp:owner

kgp:PlanningRoleValueShape Planning role — a concept in the subgraph's own scheme

target: kgp:planningRole

PropertyConstraintLevelMessage
skos:inSchemeat least 1Violationthe planning role belongs to no scheme — so it is not a vocabulary but a free-text value

kgp:ProjectionShape A projection says what it leaves out

target: dcterms:isVersionOf

PropertyConstraintLevelMessage
kgp:withholdsat least 1Violationdeclared a projection but lists no kgp:withholds

kgp:StewardValueShape Steward — a role from the controlled vocabulary, not free text

target: kgp:steward

kgp:TaggedDefinitionShape A definition carries a language

target: skos:definition

PropertyConstraintLevelMessage
skos:definitiontype rdf:langStringViolationa definition with no language tag

kgp:TaggedProseShape Prose carries a language

target: rdfs:label

PropertyConstraintLevelMessage
rdfs:labeltype rdf:langStringViolationa label with no language tag: in RDF this is a plain xsd:string, not a string in an unknown language, and a consumer cannot pick theirs

kgp:UndeclaredLanguageShape Text in a language the dataset does not declare

target: void:Dataset

kgp:WithholdingShape kgp:WithholdingShape

target: kgp:withholds

PropertyConstraintLevelMessage
dcterms:isVersionOfat least 1Violationkgp:withholds is present but the dataset does not say what it is a projection of