Valideringsregler

Beskrivelse

Denne sida er generert automatisk frå validator-dokumentasjonen i src/mcp-linkml-validator/policies/. Sjå GitHub-repoet for siste versjon.

Policyer for mcp-linkml-validator

Sjekkane i bronze-, silver- og gold-policyane realiserer både Felles modelleringsregler for offentlig forvaltning (Digitaliseringsdirektoratet, v1.0, juni 2022) og FAIR-prinsippa (Findable, Accessible, Interoperable, Reusable).

Digdir-reglar og FAIR-prinsipp — dekningsgrad

#	Namn	Kort skildring	Dekt av	FAIR
1	Forståelighet	Namn og skildringar er forståelege for målgruppa	Bronze: `title` (error), `description` (warning)	F2
2	Meiningsfullheit	Namn speglar innhald og formål	Bronze: `title` (error)	F2
3	Navne- og skrivekonvensjoner	PascalCase for klassar, snake_case/camelCase for eigenskapar	Bronze: `class_names_pascal_case`, `slot_names_snake_case` (warning)	—
4	Identifiserbarheit	Persistente URI-ar for modell, element og eigenskapar	Bronze: `id`, `default_prefix` (HTTPS-URI) (error); `class_uri`, `slot_uri`, identifikator-slot (warning)	F1, F3
5	Visualisering	Modell tilgjengeleg med god visuell representasjon	Ikkje evaluert — ER-diagram vert generert av `make erdiagram`, men ikkje validert	—
6	Modularitet	Handterleg mengde modellelement per modul	Bronze: `class_count_limit` — warning om skjemaet har fleire enn 50 klasser	—
7	Tilgjengeleggjering	Modell fritt tilgjengeleg på nett med open lisens	Bronze: `license` (warning)	R1.1
8	Maskinprosserbarheit	Modell tilgjengeleg i opne, maskinlesbare format	Bronze: `class_uri`, `slot_uri` (indirekte, via regel 4-sjekken)	I1, I2
9	Datering	Modell er datert med publiserings-, endrings- og gyldigheitsdato	Bronze: `version` (warning); Silver: `annotations.endringsdato` (warning)	F4, R1.3
10	Ansvar	Eigarskap og innhaldsansvar for modellen er tydeleg	Silver: `annotations.utgiver` (warning)	R1.2
11	Modellstatus	Modellen har ein eksplisitt status (under utarbeiding, ferdig, forelda …)	Silver: `annotations.status` (warning)	R1.3
12	Sammenhenger mellom modeller	Samanhengar med andre modellar er skildra	Ikkje evaluert — dokumenterast manuelt via `er_profil_av`, `erstatter` o.l. i modellkatalogen	F3
13	Begreper	Modellelement og -eigenskapar er knytte til omgrep	Bronze: `annotations.begrepsidentifikator` på alle klasser (warning)	A2
14	Gjenbruk	Eksisterande modellelement vert gjenbrukt framfor nydefinisjoner	Ikkje evaluert — best practice, ikkje maskinelt sjekkbart	I3
15	Standardiserte datatyper	Primitive datatypar er standardiserte (XSD, RDFS)	Ikkje evaluert — LinkML arvar XSD-typar via `linkml:types`	I1

Merk: Regel 5, 12, 14 og 15 let seg ikkje automatisk validere berre frå skjemastruktur. Dei vert handterte gjennom verktøy (ER-diagram), konvensjonar (CLAUDE.md) og manuell gjennomgang.

To typar validering

Policyfilene her er brukte til to ulike føremål:

Skjemakvalitet (bronze / silver / gold)
Sjekkar at eit LinkML-skjema (.yaml-fila i src/linkml/) held eit visst kvalitetsnivå: metadata, namngjeving, URI-ar, begrepsreferansar osv.
Køyrast med make mcp-linkml-valider-modell SCHEMA=... POLICY=bronze.

Publiseringskonformitet (felles-datakatalog / felles-begrepskatalog)
Sjekkar at eit skjema er i samsvar med krava til ei bestemt ekstern katalog. Brukt for skjema der publish_external: true i manifest.

Nivå for skjemakvalitet

Nivå	Krav	Digdir-reglar	FAIR-prinsipp
`bronze`	Grunnleggande LinkML metadata og modelleringskvalitet (dette repoets baseline)	1, 2, 3, 4, 6, 7, 8, 13	F1, F2, F3 (warning), I1 (warning), R1.1 (warning), A2 (warning)
`silver`	Bronze + AP-NO-konformitet og livssyklusmetadata	1-4, 7-11, 13	Bronze + R1.2, R1.3
`gold`	Silver + FAIR F1-R1.3: full semantisk interoperabilitet	1-4, 7-11, 13	F1-F4, I1-I2, R1.1-R1.3, A2 (alle error)

Kvart nivå arvar krava frå nivåa under (silver arvar bronze osv., via extends:).

Merk — ikkje forveksle med data.norge.no sin kvalitetsskala: Bronze/silver/gold validerer skjemakvaliteten (strukturen i sjølve .yaml-skjemaet), ikkje dei hausta metadataoppføringane. Data.norge.no skårar publiserte oppføringar på ein eigen FAIR-basert prosentskala (Utmerket ≥75 %, God 50-75 %, Tilstrekkeleg 25-50 %, Dårleg <25 %) — sjå data.norge.no: Metadatakvalitet. Eit skjema som validerer på gold her garanterer difor ikkje automatisk "Utmerket" hos data.norge.no, sidan dei to skalaene måler ulike ting.

Kvalitetspolicyer

bronze

Grunnleggjande strukturkrav. Eit skjema som passerer bronse er syntaktisk korrekt og har nødvendig metadata.

Sjekk	Alvor	Digdir-regel	FAIR	Skildring
`schema.id` til stades	error	4 — Identifiserbarheit	F1	Persistent identifikator for skjemaet
`schema.id` er HTTP(S)-URI	error	4 — Identifiserbarheit	F1	Sikrar at identifikatoren er ein oppløyseleg URI
`schema.name` til stades	error	1 — Forståelighet	—	Maskinlesbart namn for skjemaet
`schema.title` til stades	error	1 — Forståelighet, 2 — Meiningsfullheit	F2	Menneskelesbar tittel
`schema.default_prefix` til stades	error	4 — Identifiserbarheit	—	Standardnamnerom for lokale identifikatorar
`schema.default_prefix` er absolutt HTTPS-URI med avsluttande `/`	error	4 — Identifiserbarheit	—	Sikrar korrekt URI-konstruksjon for lokale ressursar
`schema.description` til stades	warning	1 — Forståelighet	F2	Fritekstskildring av skjemaet sitt føremål
`schema.version` til stades	warning	9 — Datering	F4	Versjonsnummer for sporbarheit
`schema.license` til stades	warning	7 — Tilgjengeleggjering	R1.1	Lisens for gjenbruk av skjemaet
Skjema har ikkje fleire enn 50 klasser (unntatt `tree_root`)	warning	6 — Modularitet	—	Handterleg mengde modellelement per modul
Alle klassenamn startar med stor bokstav (PascalCase)	warning	3 — Navne- og skrivekonvensjoner	—	Konsistent namngjevingskonvensjon for klasser
Alle slotnamn er snake_case (berre `a-z`, `0-9`, `_` — ikkje bindestreker)	warning	3 — Navne- og skrivekonvensjoner	—	Konsistent namngjevingskonvensjon for eigenskapar
Alle klasser (unntatt `tree_root`) har `class_uri`	warning	4 — Identifiserbarheit, 8 — Maskinprosserbarheit	F3, I1	Mappar klassen til RDF-vokabular
Alle globale slots har `slot_uri`	warning	4 — Identifiserbarheit, 8 — Maskinprosserbarheit	I1	Mappar eigenskapen til RDF-vokabular
Alle klasser (unntatt `tree_root`) har identifikator-slot	warning	4 — Identifiserbarheit	F1	Sikrar at instansar av klassen kan identifiserast unikt
Alle klasser (unntatt `tree_root`) har `annotations.begrepsidentifikator`	warning	13 — Begreper	A2	Koplar modellelement til fagomgrep i begrepskatalog
Slots med kontrollerte vokabular har korrekte annotations	warning	8 — Maskinprosserbarheit	I1	Sikrar maskinlesbar dokumentasjon av vokabularkrav

snake_case-format: Slotnamn kan berre innehalde små bokstavar (a-z), tal (0-9) og understrek (_). Bindestreker er ikkje tillate — bruk samansette ord utan separasjon (t.d. epost, epostadresse) eller understrek (mobilnummer_utgaar).

FINT-skjema er unntekne frå snake_case-sjekken — dei arvar camelCase frå FINT API-spesifikasjonen.

Kontrollerte vokabular: Slots med annotations.gyldige_verdier skal ha annotations.vokabular_krav (skal|bør|kan) og description skal innehalde matchande SKAL/BØR/BØR-formulering. Sikrar konsistent og maskinlesbar dokumentasjon av vokabularkrav. Sjå CONVENTIONS.md § Kontrollerte vokabular.

silver

Arvar bronse. Legg til livssyklusmetadata og krav frå DCAT-AP-NO og DQV-AP-NO for domenemodellar i norsk offentleg sektor, samt instanssjekkar for kontrollerte vokabular.

Sjekk	Alvor	Digdir-regel	FAIR	Skildring
`schema.annotations.utgiver` er URI på forma `https://data.norge.no/organizations/<orgnr>`	warning	10 — Ansvar	R1.2	Identifiserer kven som har ansvar for modellen
`schema.annotations.endringsdato` er ISO 8601-dato	warning	9 — Datering	R1.3	Datering av siste endring
`schema.annotations.status` er ADMS Status-URI	warning	11 — Modellstatus	R1.3	Eksplisitt livssyklusstatus (`UnderDevelopment`/`Completed`/`Deprecated`/`Withdrawn`)
`Katalog` har `dct:title`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, R1.2	Tittel på katalogen
`Katalog` har `dct:description`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, R1.2	Skildring av katalogen
`Katalog` har `dcat:contactPoint`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, R1.2	Kontaktpunkt for katalogen
`Katalog` har `dct:publisher`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, R1.2	Utgjevar av katalogen
`Katalogpost` har `dct:modified`	error	9 — Datering	R1.3	Endringsdato for katalogposten
`Katalogpost` har `foaf:primaryTopic`	error	9 — Datering	R1.3	Kopling til hovudressursen katalogposten skildrar
`Datasett` har `dct:title`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, R1.2	Tittel på datasettet
`Datasett` har `dct:description`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, R1.2	Skildring av datasettet
`Datasett` har `dcat:contactPoint`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, R1.2	Kontaktpunkt for datasettet
`Datasett` har `dcat:theme`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, R1.2	Tema/kategori for datasettet (Los)
`Datasett` har `dct:publisher`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, R1.2	Utgjevar av datasettet
`Datasett` har `dct:accessRights`	warning	—	—	Tilgangsnivå for datasettet — svarar til trafikklyssystemet (grøn/gul/raud) i Digdir sin veileder «Orden i eget hus», steg 4
`Datasett` har `dcatap:applicableLegislation`	warning	—	—	Gjeldande lovgjeving (lovheimel) for tilgang til datasettet — same steg som over
`Distribusjon` har `dcat:accessURL`	error	—	A1	Tilgangsadresse til distribusjonen
`Datatjeneste` har `dcat:endpointURL`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, A1, R1.2	Endepunkt-URL for tenesta
`Datatjeneste` har `dcat:contactPoint`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, A1, R1.2	Kontaktpunkt for tenesta
`Datatjeneste` har `dct:title`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, A1, R1.2	Tittel på tenesta
`Datatjeneste` har `dct:publisher`	error	1 — Forståelighet, 2 — Meiningsfullheit, 10 — Ansvar	F2, A1, R1.2	Utgjevar av tenesta
`Aktør` har `foaf:name`	error	1 — Forståelighet	F2	Namn på aktøren
Containerklassen (`tree_root`) har attributt med range `Katalog`, `Datasett`, `Kvalitetsmaal`, `Kvalitetsmaaling`	error	—	—	Sikrar at hovudklassene i DCAT-AP-NO/DQV-AP-NO er kopla til containeren
Containerklassen har attributt med range `Distribusjon`, `Datatjeneste`, `Kvalitetsdimensjon`, `Kvalitetsmerknad`	warning	—	—	Sikrar at støtteklassene er kopla til containeren
Instansverdiar for slots med `vokabular_pattern` matchar regex-mønsteret (krev `INSTANCE=`)	error/warning/info	8 — Maskinprosserbarheit	I1	Kode: `instance_slot_invalid_vocabulary_pattern`. Alvor avheng av `vokabular_krav`: error for `skal`, warning for `bør`, info for `kan`
Instansverdiar er frå korrekt vokabular-domene (`gyldige_verdier`) (krev `INSTANCE=`)	error/warning	8 — Maskinprosserbarheit	I1	Kode: `instance_slot_invalid_vocabulary_domain`. Sjekkar at URI-ar startar med `gyldige_verdier`-domenet

Gyldige verdiar for annotations.status: http://purl.org/adms/status/UnderDevelopment, Completed, Deprecated, Withdrawn.

Tilgangsnivå og Digdir sitt trafikklyssystem: dct:accessRights-verdiane frå EU sitt Access Right-vokabular (PUBLIC/RESTRICTED/NON_PUBLIC, sjå tilgangsrettigheter-sloten i dcat-ap-no-schema.yaml) svarar funksjonelt til grøn/gul/raud i trafikklyssystemet frå Digdir sin veileder «Orden i eget hus», steg 4 — vurdere tilgangsnivå. dcatap:applicableLegislation (gjeldende_lovgivning) svarar til lovheimel-kravet i same steg. Desse checkane er sjekka via datasett_tilgangsrettigheter og datasett_lovgivning ovanfor.

Annotasjonsnøklane svarar til Informasjonsmodell-slots i modelldcat-ap-no-schema.yaml (Digdir regel 10 og 8 — Maskinprosserbarheit via ModellDCAT-AP-NO).
make update-modellkatalog genererer Informasjonsmodell-instansar for modellkatalogen frå desse annotasjonane.

Døme (instanssjekk): Dersom spraak-slot har vokabular_krav: skal og vokabular_pattern: "^http://publications\\.europa\\.eu/resource/authority/language/[A-Z]{3}$", så vil verdien "http://example.com/NOB" gje error (feil domene) og "http://publications.europa.eu/resource/authority/language/NORSK" gje error (feil pattern — skal vere 3-bokstavskode).

gold

Arvar sølv og bronse. Implementerer gap til FAIR-prinsippa (Findable, Accessible, Interoperable, Reusable). Alle brot gir error — også dei som er åtvarslane på bronse.

Sjekk	Alvor	Digdir-regel	FAIR	Skildring
`schema.id` til stades	error	4 — Identifiserbarheit	F1	Persistent identifikator for skjemaet — arva frå bronse (allereie error)
`schema.id` er HTTP(S)-URI	error	4 — Identifiserbarheit	F1	Sikrar at identifikatoren er ein oppløyseleg URI — arva frå bronse (allereie error)
`schema.name` til stades	error	1 — Forståelighet	—	Maskinlesbart namn for skjemaet — arva frå bronse (allereie error)
`schema.title` til stades	error	1 — Forståelighet, 2 — Meiningsfullheit	F2	Tittel er del av rike metadata som gjer ressursen søkbar — arva frå bronse (allereie error)
`schema.default_prefix` til stades	error	4 — Identifiserbarheit	—	Standardnamnerom for lokale identifikatorar — arva frå bronse (allereie error)
`schema.default_prefix` er absolutt HTTPS-URI med avsluttande `/`	error	4 — Identifiserbarheit	—	Sikrar korrekt URI-konstruksjon — arva frå bronse (allereie error)
`schema.description` til stades	error	1 — Forståelighet	F2	Fritekstskildring av skjemaet sitt føremål — arva frå bronse, oppgradert til error
`schema.version` til stades	error	9 — Datering	F4	Versjonering støttar katalogregistrering og sporbarheit — arva frå bronse, oppgradert til error
`schema.license` til stades	error	7 — Tilgjengeleggjering	R1.1	Lisens for gjenbruk av skjemaet — arva frå bronse, oppgradert til error
Skjema har ikkje fleire enn 50 klasser (unntatt `tree_root`)	error	6 — Modularitet	—	Handterleg mengde modellelement per modul — arva frå bronse, oppgradert til error
Alle klassenamn startar med stor bokstav (PascalCase)	error	3 — Navne- og skrivekonvensjoner	—	Konsistent namngjevingskonvensjon for klasser — arva frå bronse, oppgradert til error
Alle slotnamn er snake_case	error	3 — Navne- og skrivekonvensjoner	—	Konsistent namngjevingskonvensjon for eigenskapar — arva frå bronse, oppgradert til error
Alle klasser (unntatt `tree_root`) har `class_uri`	error	4 — Identifiserbarheit, 8 — Maskinprosserbarheit	F3, I1	Mappar klassen til RDF-vokabular — arva frå bronse, oppgradert til error
Alle globale slots har `slot_uri`	error	4 — Identifiserbarheit, 8 — Maskinprosserbarheit	I1	Mappar eigenskapen til RDF-vokabular — arva frå bronse, oppgradert til error
Alle klasser (unntatt `tree_root`) har identifikator-slot	error	4 — Identifiserbarheit	F1	Sikrar at instansar av klassen kan identifiserast unikt — arva frå bronse, oppgradert til error
Alle klasser (unntatt `tree_root`) har `annotations.begrepsidentifikator`	error	13 — Begreper	A2	Koplar modellelement til fagomgrep i begrepskatalog — arva frå bronse, oppgradert til error
Slots med kontrollerte vokabular har korrekte annotations	error	8 — Maskinprosserbarheit	I1	Sikrar maskinlesbar dokumentasjon av vokabularkrav — arva frå bronse, oppgradert til error
Skjemaet deklarerer minst eitt standard vokabularprefiks (`dct`, `dcat`, `skos`, `prov`, `rdf`, `rdfs`, `owl`, `foaf`, `xsd`)	error	8 — Maskinprosserbarheit	I2	Standardvokabular sikrar interoperabilitet på tvers av system
Skjemaet har ein slot med `dct:license`	error	7 — Tilgjengeleggjering	R1.1	Lisensinformasjon er føresetnad for gjenbruk — arva frå bronse, oppgradert til error
Skjemaet har ein slot for proveniens (`prov:wasAttributedTo`, `prov:wasGeneratedBy`, `dct:creator`, `dct:publisher` eller `dct:contributor`)	error	10 — Ansvar	R1.2	Proveniens er viktig for tillit til og gjenbruk av data
`schema.annotations.utgiver` til stades	error	10 — Ansvar	R1.2	URI til ansvarleg organisasjon — arva frå sølv, oppgradert til error
`schema.annotations.endringsdato` til stades	error	9 — Datering	R1.3	ISO 8601-dato for siste endring — arva frå sølv, oppgradert til error
`schema.annotations.oppdateringsfrekvens` til stades	error	9 — Datering	R1.3	URI frå EU sin Frequency Named Authority List — arva frå sølv, oppgradert til error
`schema.annotations.status` til stades	error	11 — Modellstatus	R1.3	ADMS Status-URI for modellstatus — arva frå sølv, oppgradert til error
`Distribusjon` har slot med `dct:license`	error	7 — Tilgjengeleggjering	R1.1	Lisens på distribusjonsnivå — arva frå sølv, oppgradert til error
`Datasett` har `dct:accessRights`	error	—	—	Tilgangsnivå (trafikklyssystemet) — arva frå sølv, oppgradert til error
`Datasett` har `dcatap:applicableLegislation`	error	—	—	Lovheimel for tilgang — arva frå sølv, oppgradert til error
Containerklassen har attributt med range `Distribusjon`	error	—	—	Arva frå sølv, oppgradert til error
Containerklassen har attributt med range `Datatjeneste`	error	—	—	Arva frå sølv, oppgradert til error
Containerklassen har attributt med range `Kvalitetsdimensjon`	error	—	—	Arva frå sølv, oppgradert til error
Containerklassen har attributt med range `Kvalitetsmerknad`	error	—	—	Arva frå sølv, oppgradert til error

Publiseringspolicyer

Domene-spesifikke policyer for publisering til nasjonale katalogar. Dei arvar bronze og er meinte brukt i tillegg til medaljongnivåa — typisk i CI-pipelinen for skjema som har ein tilhøyrande datafil.

Policy	Krav	Målkatalog
`felles-begrepskatalog`	Bronse + SKOS-AP-NO-Begrep-konformitet for begrepskatalogskjema	data.norge.no/concepts
`felles-datakatalog`	Bronse + ModelDCAT-AP-NO-konformitet for modellkatalogskjema	data.norge.no/models

felles-begrepskatalog

For begrepskatalogskjema som publiserer til data.norge.no/concepts via SKOS-AP-NO-Begrep. Sjå Publiser til Felles Begrepskatalog for full rettleiing.

Kategori	Krav	Alvor	Kode
Import og prefiks	Importerer `skos-ap-no-schema`	error	`schema_importerer_skos_ap_no`
Import og prefiks	Deklarerer `skos:`-prefix	error	`schema_brukar_skos_prefix`
Import og prefiks	Deklarerer `dct:`-prefix	error	`schema_brukar_dct_prefix`
Containerklasse	Container har attributt med range `Begrep`	error	`container_har_begrep`
Containerklasse	Container har attributt med range `Samling`	warning	`container_har_samling`
`Begrep`-krav	`skos:prefLabel`	error	`begrep_har_anbefalt_term`
`Begrep`-krav	`skos:definition` eller `euvoc:xlDefinition`	error	`begrep_har_definisjon`
`Begrep`-krav	`dct:identifier`	error	`begrep_har_identifikator`
`Begrep`-krav	`dct:publisher`	error	`begrep_har_utgjevar`
`Begrep`-krav	`dcat:contactPoint`	error	`begrep_har_kontaktpunkt`
`Begrep`-krav	`dct:subject`	warning	`begrep_har_fagomrade`
`Begrep`-krav	`dct:creator`	warning	`begrep_har_ansvarleg_verksemd`
`Begrep`-krav	`euvoc:startDate`	warning	`begrep_har_gyldig_fra`
`Begrep`-krav	`euvoc:endDate`	warning	`begrep_har_gyldig_til`
`Begrep`-krav	`dct:created`	warning	`begrep_har_opprettingsdato`
`Begrep`-krav	`dct:modified`	warning	`begrep_har_endringsdato`
`Begrep`-krav	`skos:scopeNote`	warning	`begrep_har_merknad`
`Begrep`-krav	`skos:altLabel`	warning	`begrep_har_tillate_term`
Tospråkskrav	`anbefalt_term` (skos:prefLabel) har range `LangString` og `multivalued: true`	warning	`begrep_anbefalt_term_er_multivalued_langstring`
Tospråkskrav	`har_definisjon` har minst éi Definisjon per språk (nb, nn)	warning	`begrep_har_definisjon_pa_nb_og_nn`
Instanssjekk	`dct:publisher`-verdi er `https://data.norge.no/organizations/<9-sifra orgnr>` og er i lista over kjende utgivarar	error	`utgjevar_er_kjend_org`

Begrep-krava er obligatoriske per SKOS-AP-NO-Begrep. Definisjon-, AssosiativRelasjon-, GeneriskRelasjon-, PartitivRelasjon- og Samling-krav er dokumenterte i policies/felles-begrepskatalog.yaml.

Om tospråkskravet (SK5, SKOS-AP-NO v.2.0.15): begrep_anbefalt_term_er_multivalued_langstring er ein schemasjekk — sikrar at skjemaet kan innehalde tospråkverdiar. begrep_har_definisjon_pa_nb_og_nn er ein instanssjekk via ID-suffiks-konvensjon.

Avgrensing: Tospråkskravet for anbefalt_term kan ikkje validerast i YAML-instansar pga. LinkML sin avgrensing (LangString bærer ikkje språk-tag per verdi i YAML — sjå specs/bugs/langstring-rdflib-roundtrip.md). Bruk RDF-validering (SHACL) eller manuell gjennomgang av .ttl-fila for å verifiere at både @nb og @nn er til stades.

felles-datakatalog

For modellkatalogskjema som publiserer til data.norge.no/models via ModelDCAT-AP-NO. Sjå Publiser til Felles Datakatalog for full rettleiing.

Kategori	Krav	Alvor	Kode
Import og prefiks	Importerer `modelldcat-ap-no-schema`	error	`schema_importerer_modelldcat_ap_no`
Import og prefiks	Deklarerer `dct:`-prefix	error	`schema_brukar_dct_prefix`
Import og prefiks	Deklarerer `dcat:`-prefix	error	`schema_brukar_dcat_prefix`
Containerklasse	Container har attributt med range `Modellkatalog`	error	`container_har_modellkatalog`
Containerklasse	Container har attributt med range `Informasjonsmodell`	error	`container_har_informasjonsmodell`
`Modellkatalog`-krav	`dct:title`	error	`modellkatalog_har_tittel`
`Modellkatalog`-krav	`dct:description`	error	`modellkatalog_har_beskrivelse`
`Modellkatalog`-krav	`dct:identifier`	error	`modellkatalog_har_identifikator`
`Modellkatalog`-krav	`dct:publisher`	error	`modellkatalog_har_utgjevar`
`Modellkatalog`-krav	`dcat:contactPoint`	error	`modellkatalog_har_kontaktpunkt`
`Modellkatalog`-krav	`dct:hasPart`	error	`modellkatalog_har_del`
`Modellkatalog`-krav	`dct:license`	warning	`modellkatalog_har_lisens`
`Modellkatalog`-krav	`modelldcatno:model`	warning	`modellkatalog_har_modell`
`Informasjonsmodell`-krav	`dct:title`	error	`informasjonsmodell_har_tittel`
`Informasjonsmodell`-krav	`dct:publisher`	error	`informasjonsmodell_har_utgjevar`
`Informasjonsmodell`-krav	`dct:description`	warning	`informasjonsmodell_har_beskrivelse`
`Informasjonsmodell`-krav	`dct:identifier`	warning	`informasjonsmodell_har_identifikator`
`Informasjonsmodell`-krav	`modelldcatno:informationModelIdentifier`	warning	`informasjonsmodell_har_modellidentifikator`
`Informasjonsmodell`-krav	`dcat:contactPoint`	warning	`informasjonsmodell_har_kontaktpunkt`
`Informasjonsmodell`-krav	`dct:license`	warning	`informasjonsmodell_har_lisens`
`Informasjonsmodell`-krav	`dcat:theme`	warning	`informasjonsmodell_har_tema`
`Informasjonsmodell`-krav	`modelldcatno:containsModelElement`	warning	`informasjonsmodell_har_modellelement`
Instanssjekk	`dct:publisher`-verdi er `https://data.norge.no/organizations/<9-sifra orgnr>` og er i lista over kjende utgivarar	error	`utgjevar_er_kjend_org`

Modellkatalog- og Informasjonsmodell-krava er obligatoriske per ModelDCAT-AP-NO.

Skiljet mellom skjema- og datavalidering

Kva	Verktøy	Policy
Skjemakvalitet	`make mcp-linkml-valider-modell POLICY=bronze/silver/gold`	Policyfilene her
Datakvalitet (instansar)	`make validate-instance`	—
Publiseringskonformitet	`make mcp-linkml-valider-modell POLICY=felles-datakatalog`	`felles-datakatalog.yaml`

felles-begrepskatalog.yaml har i tillegg eit eige instance_checks:-felt for sjekkar som krev faktiske instansdata (gitt via INSTANCE= til make mcp-linkml-valider-modell), t.d. utgjevar_er_kjend_org (kjende utgivar-URI-ar) og begrep_har_definisjon_pa_nb_og_nn (tospråkskravet — sjå https://github.com/brreg/linkml-datamodellering-no/blob/main/specs/done/avvik-skos-ap-no.md, SK5 Forslag A).

MCP-verktøy

Verktøy	Skildring
`validate_linkml_schema`	Validerer eit skjema med lint + instansvalidering + policy-sjekkar. Parametrar: `schemaText` (påkravd), `policy` (standard: `bronze`), `instanceText` (valfri).
`validate_linkml_instance`	Validerer ein instans mot eit skjema. Tilsvarar `linkml validate --schema`. Parametrar: `schemaText`, `instanceText`, `targetClass` (valfri).