Ingest-Vertrag

Die Mechanismen, über die ein Datensatz dem gemeinsamen Graphen beitritt, geschrieben als SHACL-Shapes. Jede Shape trägt ihre eigene Meldung und ihren eigenen Schweregrad.

kgp:AffordanceShape kgp:AffordanceShape

Ziel: kgp:affordance

EigenschaftBedingungStufeMeldung
kgp:affordanceKlasse skos:ConceptViolationeine Aktion muss ein Konzept des gemeinsamen Konzeptschemas kgp:affordances sein
kgp:performedAtKnotenart sh:IRIViolationkgp:performedAt muss ein Link sein, kein Literal

kgp:AffordanceValueShape Aktion — aus dem gemeinsamen Konzeptschema oder enger darunter

Ziel: kgp:affordance

kgp:AllowedValueSchemeShape Werte eines Feldes — aus einem Schema, mit eindeutigen Codes

Ziel: kgp:allowedValue

kgp:AllowedValueShape Zulässiger Feldwert — ein Schemakonzept mit einem Code

Ziel: kgp:allowedValue

EigenschaftBedingungStufeMeldung
skos:inSchememindestens 1Violationder zulässige Wert gehört zu keinem Schema — er ist ein freier Wert, kein Vokabular
skos:notationmindestens 1, höchstens 1, Typ xsd:stringViolationdem zulässigen Wert fehlt genau ein skos:notation-Code (ein xsd:string ohne Sprach-Tag) — statt des Codes gelangt eine Bezeichnung in das Artefakt

kgp:AudienceValueShape Leserrolle — ein Konzept, kein Literal

Ziel: kgp:writtenFor

kgp:ConfirmationMethodShape Bestätigungsmethode — aus dem gemeinsamen Konzeptschema oder enger darunter

Ziel: kgp:confirmedVia

kgp:ConfirmationShape Eine Bestätigung ist vollständig, oder sie ist keine

Ziel: kgp:confirmedAt

EigenschaftBedingungStufeMeldung
kgp:confirmedBymindestens 1Warningbestätigt, aber es ist nicht angegeben, von wem
kgp:confirmedFrommindestens 1Warningkein kgp:confirmedFrom
kgp:confirmedViamindestens 1, höchstens 1, Klasse skos:ConceptWarningdie Bestätigungsmethode muss ein Konzept des Konzeptschemas kgp:confirmationMethods sein oder enger als eines seiner Konzepte — das Niveau wird aus der Methode abgeleitet, nicht von Hand gesetzt

kgp:ContentNodeShape Inhaltsknoten: Sprache, Provenienz, Steward

Ziel: void:inDataset

EigenschaftBedingungStufeMeldung
dcterms:languagemindestens 1Violationder Knoten deklariert keine Sprache
kgp:bodyWarningzwei kgp:body-Werte in derselben Sprache — nur einer davon wird gelesen
kgp:sourcemindestens 1Warningkeine kgp:source — die Tatsache sagt nicht, woher sie stammt
kgp:stewardhöchstens 1, Knotenart sh:IRIWarningkgp:steward an einem Knoten muss auf eine Rolle verweisen und wird nur gesetzt, wenn er vom Steward des Datensatzes abweicht

kgp:DatasetShape Der Datensatz deklariert sich selbst

Ziel: SPARQL-Abfrage

EigenschaftBedingungStufeMeldung
dcterms:hasVersionmindestens 1, höchstens 1, Muster ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$Violationdie Version des Datensatzes muss die Form a.b.c.d haben
dcterms:issuedmindestens 1, höchstens 1, Typ xsd:dateTimeWarningdas Release-Datum dcterms:issued fehlt, ist wiederholt oder kein xsd:dateTime — kgp:confirmationPeriod hat keinen Ausgangspunkt
dcterms:languagemindestens 1Violationkeine dcterms:language — der Datensatz sagt nicht, in welchen Sprachen er vorliegt (Regel der deklarierten Sprachen)
dcterms:licensemindestens 1Violationkeine dcterms:license — die Nutzungsbedingungen sind nicht deklariert (Regel der Selbstdeklaration)
kgp:confirmationPeriodmindestens 1Warningkeine kgp:confirmationPeriod — „bestätigt“ ohne Gültigkeitsdauer
kgp:ontologyPinmindestens 1Violationkein kgp:ontologyPin — ein Konsument hat nichts, woran er pinnen kann
kgp:supersedeshöchstens 1, Typ xsd:string, Muster ^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$Warningkgp:supersedes muss eine einzelne Version in der Form a.b.c.d sein
kgp:visibilitymindestens 1Violationkeine kgp:visibility — es ist nicht angegeben, wer den Datensatz lesen darf
void:uriSpacemindestens 1, höchstens 1Violationkein void:uriSpace — die Eigentumsgrenze ist nicht deklariert (Regel der Eigentumsgrenze)

kgp:DeclaredLanguagesDeliveredShape Eine deklarierte Sprache hat Text

Ziel: SPARQL-Abfrage

kgp:DependsOnShape Eine Abhängigkeit verweist auf einen Knoten

Ziel: kgp:dependsOn

kgp:DocGenreValueShape Dokumentgenre — ein Konzept im eigenen Schema des Teilgraphen

Ziel: kgp:docGenre

EigenschaftBedingungStufeMeldung
skos:inSchememindestens 1Violationdas Dokumentgenre gehört zu keinem Schema — dann ist es kein Vokabular, sondern ein freier Wert

kgp:EnforcementValueShape kgp:EnforcementValueShape

Ziel: kgp:enforcement

EigenschaftBedingungStufeMeldung
skos:inSchemeWert kgp:enforcementsViolationdie Durchsetzungsstufe stammt nicht aus dem Schema kgp:enforcements (off / warn / error)

kgp:EtomCodeShape kgp:EtomCodeShape

Ziel: kgp:etomCode

EigenschaftBedingungStufeMeldung
kgp:etomCodeMuster ^[0-9]+(\.[0-9]+)*$Violationder Prozesscode muss eine GB921-Prozesskennung in punktierter Dezimalform sein (z. B. 1.7.14.4)

kgp:EtomVerticalShape Ein gemeinsamer eTOM-Term — mit deklarierter Quelle

Ziel: SPARQL-Abfrage

EigenschaftBedingungStufeMeldung
rdfs:isDefinedBymindestens 1Violationein eTOM-Term wird ohne Referenzknoten verwendet

kgp:EvidenceLevelValueShape kgp:EvidenceLevelValueShape

Ziel: kgp:minimumEvidenceLevel

EigenschaftBedingungStufeMeldung
skos:inSchemeWert kgp:evidenceLevelsViolationdas Nachweisniveau stammt nicht aus dem Konzeptschema kgp:evidenceLevels

kgp:LanguageTagShape Sprachcode — BCP 47, nicht der Eigenname der Sprache

Ziel: dcterms:language

kgp:MultilingualDatasetShape Mehrere Sprachen — wie sie erreichbar sind, muss angegeben sein

Ziel: SPARQL-Abfrage

kgp:NarrowerMethodLevelShape Eine engere Methode hebt das Nachweisniveau nicht an

Ziel: skos:broader

kgp:OwnerValueShape kgp:OwnerValueShape

Ziel: kgp:owner

kgp:PlanningRoleValueShape Planungsrolle — ein Konzept im eigenen Schema des Teilgraphen

Ziel: kgp:planningRole

EigenschaftBedingungStufeMeldung
skos:inSchememindestens 1Violationdie Planungsrolle gehört zu keinem Schema — sie ist also kein Vokabular, sondern ein Freitextwert

kgp:ProjectionShape Eine Projektion sagt, was sie weglässt

Ziel: dcterms:isVersionOf

EigenschaftBedingungStufeMeldung
kgp:withholdsmindestens 1Violationeine Projektion ist deklariert, aber es ist kein kgp:withholds aufgeführt

kgp:StewardValueShape Steward — eine Rolle aus dem kontrollierten Vokabular, kein Freitext

Ziel: kgp:steward

kgp:TaggedDefinitionShape Eine Definition trägt eine Sprache

Ziel: skos:definition

EigenschaftBedingungStufeMeldung
skos:definitionTyp rdf:langStringViolationeine Definition ohne Sprach-Tag

kgp:TaggedProseShape Prosa trägt eine Sprache

Ziel: rdfs:label

EigenschaftBedingungStufeMeldung
rdfs:labelTyp rdf:langStringViolationeine Bezeichnung ohne Sprach-Tag: In RDF ist das ein einfacher xsd:string, keine Zeichenkette in unbekannter Sprache, und ein Konsument kann seine nicht auswählen

kgp:UndeclaredLanguageShape Text in einer Sprache, die der Datensatz nicht deklariert

Ziel: void:Dataset

kgp:WithholdingShape kgp:WithholdingShape

Ziel: kgp:withholds

EigenschaftBedingungStufeMeldung
dcterms:isVersionOfmindestens 1Violationkgp:withholds ist vorhanden, aber der Datensatz sagt nicht, wovon er eine Projektion ist