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
| Property | Constraint | Level | Message |
|---|---|---|---|
kgp:affordance | class skos:Concept | Violation | an action must be a concept of the shared kgp:affordances concept scheme |
kgp:performedAt | node kind sh:IRI | Violation | kgp:performedAt must be a link, not a literal |
kgp:AffordanceValueShape Action — from the shared concept scheme, or narrower under it
kgp:AllowedValueSchemeShape Values of one field — from one scheme, with unique codes
kgp:AllowedValueShape Allowed field value — a scheme concept with a code
| Property | Constraint | Level | Message |
|---|---|---|---|
skos:inScheme | at least 1 | Violation | the allowed value belongs to no scheme — it is a free value, not a vocabulary |
skos:notation | at least 1, at most 1, type xsd:string | Violation | the 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
kgp:ConfirmationMethodShape Confirmation method — from the shared concept scheme, or narrower under it
kgp:ConfirmationShape A confirmation is complete or it is not one
| Property | Constraint | Level | Message |
|---|---|---|---|
kgp:confirmedBy | at least 1 | Warning | confirmed, but by whom is not stated |
kgp:confirmedFrom | at least 1 | Warning | no kgp:confirmedFrom |
kgp:confirmedVia | at least 1, at most 1, class skos:Concept | Warning | the 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
| Property | Constraint | Level | Message |
|---|---|---|---|
dcterms:language | at least 1 | Violation | the node declares no language |
kgp:body | Warning | two kgp:body values in the same language — only one of them is read | |
kgp:source | at least 1 | Warning | no kgp:source — the fact does not say where it came from |
kgp:steward | at most 1, node kind sh:IRI | Warning | kgp: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
| Property | Constraint | Level | Message |
|---|---|---|---|
dcterms:hasVersion | at least 1, at most 1, pattern ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$ | Violation | the dataset version must be in a.b.c.d form |
dcterms:issued | at least 1, at most 1, type xsd:dateTime | Warning | the release date dcterms:issued is missing, repeated or not an xsd:dateTime — kgp:confirmationPeriod has nothing to count from |
dcterms:language | at least 1 | Violation | no dcterms:language — the dataset does not say which languages it is in (the declared-language rule) |
dcterms:license | at least 1 | Violation | no dcterms:license — the terms of use are not declared (the self-declaration rule) |
kgp:confirmationPeriod | at least 1 | Warning | no kgp:confirmationPeriod — "confirmed" with no validity period |
kgp:ontologyPin | at least 1 | Violation | no kgp:ontologyPin — a consumer has nothing to pin against |
kgp:supersedes | at most 1, type xsd:string, pattern ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$ | Warning | kgp:supersedes must be a single version in a.b.c.d form |
kgp:visibility | at least 1 | Violation | no kgp:visibility — who may read the dataset is not stated |
void:uriSpace | at least 1, at most 1 | Violation | no void:uriSpace — the ownership boundary is not declared (the ownership-boundary rule) |
kgp:DeclaredLanguagesDeliveredShape A declared language has text
kgp:DependsOnShape A dependency points to a node
kgp:DocGenreValueShape Document genre — a concept in the subgraph's own scheme
| Property | Constraint | Level | Message |
|---|---|---|---|
skos:inScheme | at least 1 | Violation | the document genre belongs to no scheme — then it is not a vocabulary but a free value |
kgp:EnforcementValueShape kgp:EnforcementValueShape
| Property | Constraint | Level | Message |
|---|---|---|---|
skos:inScheme | value kgp:enforcements | Violation | the enforcement level is not from the kgp:enforcements scheme (off / warn / error) |
kgp:EtomCodeShape kgp:EtomCodeShape
| Property | Constraint | Level | Message |
|---|---|---|---|
kgp:etomCode | pattern ^[0-9]+(\.[0-9]+)*$ | Violation | the 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
| Property | Constraint | Level | Message |
|---|---|---|---|
rdfs:isDefinedBy | at least 1 | Violation | an eTOM term is used without a reference node |
kgp:EvidenceLevelValueShape kgp:EvidenceLevelValueShape
| Property | Constraint | Level | Message |
|---|---|---|---|
skos:inScheme | value kgp:evidenceLevels | Violation | the evidence level is not from the kgp:evidenceLevels concept scheme |
kgp:LanguageTagShape Language code — BCP 47, not the language's own name
kgp:MultilingualDatasetShape Several languages — how to reach them must be stated
kgp:NarrowerMethodLevelShape A narrower method does not raise the evidence level
kgp:OwnerValueShape kgp:OwnerValueShape
kgp:PlanningRoleValueShape Planning role — a concept in the subgraph's own scheme
| Property | Constraint | Level | Message |
|---|---|---|---|
skos:inScheme | at least 1 | Violation | the 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
| Property | Constraint | Level | Message |
|---|---|---|---|
kgp:withholds | at least 1 | Violation | declared a projection but lists no kgp:withholds |
kgp:StewardValueShape Steward — a role from the controlled vocabulary, not free text
kgp:TaggedDefinitionShape A definition carries a language
| Property | Constraint | Level | Message |
|---|---|---|---|
skos:definition | type rdf:langString | Violation | a definition with no language tag |
kgp:TaggedProseShape Prose carries a language
| Property | Constraint | Level | Message |
|---|---|---|---|
rdfs:label | type rdf:langString | Violation | a 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
kgp:WithholdingShape kgp:WithholdingShape
| Property | Constraint | Level | Message |
|---|---|---|---|
dcterms:isVersionOf | at least 1 | Violation | kgp:withholds is present but the dataset does not say what it is a projection of |