Gå til innhold

fair-metadata

Utgiver Lisens Status Versjon Validering Endringsdato

Om denne modellen

Denne sida dokumenterer LinkML-modellen fair-metadata, inkludert klassar, eigenskapar, datatypar, valideringsresultat og genererte artefakter. Informasjonen er generert automatisk frå skjemaet og tilhøyrande byggeproses.

Offisiell referanse: FAIR Principles

FAIR Metadata Overbygning er ein metadata-modell som utfyllar norske applikasjonsprofilar (DCAT-AP-NO, SKOS-AP-NO m.fl.) for å sikre maskin-aksjonerbar FAIR-konformitet.

Modellen utvider norske applikasjonsprofilar med tilleggseigenskapar for å oppfylle FAIR-prinsippa (Findable, Accessible, Interoperable, Reusable) for forskingsdata og offentlege datasett.

Typisk brukar: Forskingsinstitusjoner og offentlege verksemder som skal publisere FAIR-konforme datasett, og utviklarar som implementerer FAIR-støtte.

Kom i gang

Her finn du døme på korleis du importerer, validerer og brukar modellen i eigne prosjekt.

Importer i egne LinkML-skjema

imports:
  - https://raw.githubusercontent.com/brreg/linkml-datamodellering-no/fair-metadata-v1.7.0/src/linkml/fair/fair-metadata/fair-metadata-schema

Valider skjemaet mot gold-policy

make mcp-linkml-valider-modell SCHEMA=src/linkml/fair/fair-metadata/fair-metadata-schema.yaml

Valider datafil mot LinkML-skjemaet

make validate-instance SCHEMA=src/linkml/fair/fair-metadata/fair-metadata-schema.yaml INSTANCE=mine-data.yaml

Python-bruk

pip install linkml-runtime pyyaml

from linkml_runtime.loaders import yaml_loader
from fair_metadata_model import FAIRMetadata

fairmetadata = yaml_loader.load('mine-data.yaml', target_class=FAIRMetadata)

Eksempeldatafil

Eksempel som viser korleis ei gyldig datafil basert på denne modellen kan sjå ut i YAML-format.

postar:

  # -------------------------------------------------------------------------
  # Post 1: Ope datasett — Norsk adresseregister
  # -------------------------------------------------------------------------
  - id: https://data.norge.no/fair/metadata/norsk-adresseregister
    ressursIdentifikator: https://data.norge.no/datasets/adresseregister
    ressurstype: dcat:Dataset
    beskrivelse: https://data.norge.no/datasets/adresseregister

    tilgangsmetadata:
      tilgangsURL: https://data.kartverket.no/api/adresser
      tilgangsprotokoll: HTTPS
      tilgangsrettar: http://publications.europa.eu/resource/authority/access-right/PUBLIC
      autentiseringPaakrevd: false

📄 Full eksempelfil (YAML)

Detaljerte eksempel per klasse finst på kvar klasseside, t.d. Classes.

Modellmetadata

Modellmetadata viser sentrale metadata for modellen, inkludert versjon, status, lisens, identifikatorar og avhengigheiter. Verdiane er henta direkte frå skjemaet.

Felt Verdi
Name fair-metadata
Title FAIR Metadata Overbygning
Description FAIR-metadataoverbygning (FAIR-prinsippa)
Schema URI https://data.norge.no/fair/fair-metadata
Versjon 1.7.0
Lisens https://data.norge.no/nlod/no/2.0
Utgiver https://data.norge.no/organizations/974760673
Status http://purl.org/adms/status/Completed
Endringsdato 2026-08-14
Utgivelsesdato 2024-01-01
Imports linkml:types

Avhengigheiter (1)

Denne modellen importerer og gjenbruker komponentar frå andre skjema. Importerte klassar og eigenskapar kan vere synlege i diagram, valideringsrapportar og andre analysar sjølv om dei ikkje blir lista som lokale element i denne modellen.

Dette skjemaet importerer følgjande skjema (direkte og transitivt):

linkml:types  # direkte import

Sjå Importhierarki for oversikt over heile repoet sitt importhierarki.

Importerte modeller: linkml:types

Entity-relationship diagram

ER-diagrammet viser struktur og relasjonar mellom dei lokale klassane i modellen. Importerte klassar er som standard filtrerte bort for å gjere diagrammet enklare å lese.

ER-diagram

Diagrammet viser kun lokale klasser. Klikk for å zoome. Vis fullstendig diagram med importerte klasser.

Datamodell

Dette er den autoritative kjelda for modellen. Alle tabellar, diagram og artefakt på denne sida er genererte frå dette skjemaet.

Kjelde-datamodell i LinkML-format: fair-metadata-schema.yaml

Classes (5)

Classes viser klassar som er definerte lokalt i fair-metadata modellen. Klassar frå importerte modellar er ikkje inkluderte i teljinga, men kan vere refererte frå lokale klassar og kan inngå i valideringsresultat og diagram.
Klassar grupperes i Obligatorisk, Anbefalt, Valgfri og Andre (uklassifisert).

Andre (5)

Class Description
FAIRMetadata Maskin-aksjonerbar metadata som beskriver ein digital ressurs i tråd med FAIR-prinsippa.
Gjenbruksmetadata Metadata som støttar gjenbruk av ressursen (FAIR R1.1, R1.3).
Katalogregistrering Dokumenterer registrering i søkbar katalog (FAIR F4).
Proveniensmetadata Metadata om opphav og endringshistorie (FAIR R1.2).
Tilgangsmetadata Metadata for tilgang, autentisering og tilgjengelegheit (FAIR A1/A2).

Slots (24)

Slots viser eigenskapar som er definert i eller brukt av lokale klassar i modellen.
Eigenskapar grupperes i "Verdiar" som inneheld data, og "Refransar" som refererer til andre klasser.
Defined in kolonna angir kildeskjemaet for eigenskapen. Usage "Definert lokalt" betyr at eigenskapen er definert lokalt. "Brukt lokalt" betyr at eigenskapen er brukt lokalt i modellen.

Verdiar (20)

Slot Description Defined in Usage
ansvarlegAktoer Organisasjon eller aktør som er ansvarleg for ressursen, som URI (FAIR R1.2). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
autentiseringPaakrevd Om autentisering eller autorisasjon er nødvendig (FAIR A1.2). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
beskrivelse URI til ressursen som denne metadata-posten beskriver (FAIR F3). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
bruksavgrensingar Eventuelle juridiske eller praktiske bruksavgrensingar (FAIR R1.1). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
endringsdato Sist endra dato (FAIR R1.2). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
generertAvAktivitet Aktivitet som har generert ressursen (FAIR R1.2). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
id Persistent URI-identifikator for metadata-posten (FAIR F1). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
katalogOppfoeringURL Direkte URL til oppføringa i katalogen (FAIR F4). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
lisens Brukslisens for ressursen som URI (FAIR R1.1). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
metadataPersistens Metadata er tilgjengeleg sjølv om sjølve ressursen ikkje lenger er tilgjengeleg (FAIR A2). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
opprettingsdato Dato ressursen blei oppretta (FAIR R1.2). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
registreringsdato Dato for katalogregistrering (FAIR F4). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
registrertIKatalog URI til katalogen der metadata er registrert (FAIR F4). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
ressursIdentifikator Global og persistent identifikator for ressursen (FAIR F1). Skal vere ein PID (t.d. DOI, Handle, eller stabil URI). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
ressurstype Type digital ressurs, t.d. dcat:Dataset, dcat:DataService eller ein URI frå eit kontrollert vokabular (FAIR F2). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
standardoverensstemming Standardar eller profilar ressursen følgjer, t.d. DCAT-AP-NO eller ISO 19115 (FAIR R1.3 / I3). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
tilgangsprotokoll Kommunikasjonsprotokoll, t.d. HTTPS eller SPARQL (FAIR A1.1). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
tilgangsrettar Tilgangsnivå som URI, t.d. frå EU Publications Office (offentleg, avgrensa, lukka) (FAIR A1.2). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
tilgangsURL URL for maskinell tilgang til ressurs eller metadata (FAIR A1). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
vokabular Kontrollerte vokabular eller ontologiar som ressursen brukar (FAIR I2). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt

Referansar (4)

Slot Description Defined in Usage
gjenbruksmetadata Metadata som støttar gjenbruk av ressursen (FAIR R1.1/R1.3). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
katalogregistrering Dokumenterer registrering i søkbar katalog (FAIR F4). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
proveniensmetadata Metadata om opphav og endringshistorie (FAIR R1.2). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
tilgangsmetadata Metadata for tilgang og tilgjengelegheit (FAIR A1/A2). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt

Enumerations (0)

Enumerations viser kontrollerte verdiområder som er definert i eller brukt lokalt i modellen.
Defined in kolonna angir kildeskjemaet for verdiområdet. Usage "Definert lokalt" betyr at verdiområdet er definert lokalt. "Brukt lokalt" betyr at verdiområdet er brukt lokalt i modellen.

Ingen enumerations definert lokalt eller brukt i denne modellen.

Types (4)

Types viser primitive verdiformat som datoar, URI-ar, språkstrengar og andre grunnleggjande datatypar som er definert i eller brukt i modellen.
Defined in kolonna angir kildeskjemaet for verdiformatet. Usage "Definert lokalt" betyr at verdiformatet er definert lokalt. "Brukt lokalt" betyr at verdiformatet er brukt lokalt i modellen.

Type URI Description Defined in Usage
boolean xsd:boolean A binary (true or false) value linkml:types ✅ Brukt lokalt
date xsd:date a date (year, month and day) in an idealized calendar linkml:types ✅ Brukt lokalt
string xsd:string A character string linkml:types ✅ Brukt lokalt
uriorcurie xsd:anyURI a URI or a CURIE linkml:types ✅ Brukt lokalt

Importerte typer: linkml:types

Subsets (4)

Subsets viser klassifiseringar av klasser og slots som blir brukt i modellen. For AP-NO-modellar vil dette typisk vere Obligatorisk, Anbefalt og Valgfri.
Defined in kolonna angir kildeskjemaet for klassifiseringa. Usage "Definert lokalt" betyr at klassifiseringa er definert lokalt. "Brukt lokalt" betyr at klassifiseringa er brukt lokalt i modellen.

Subset Description Defined in Usage
Accessible Eigenskapar knytt til FAIR A-prinsippa (Accessible). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
Findable Eigenskapar knytt til FAIR F-prinsippa (Findable). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
Interoperable Eigenskapar knytt til FAIR I-prinsippa (Interoperable). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt
Reusable Eigenskapar knytt til FAIR R-prinsippa (Reusable). https://data.norge.no/fair/fair-metadata ✅ Brukt lokalt

Genererte artefakter (6)

Denne seksjonen listar maskinlesbare artefakt som er genererte frå skjemaet. Artefakta blir brukte til validering, integrasjon, dokumentasjon og kodegenerering.

Artefakt Fil
Modellmanifest ihht Modelldcat-ap-no fair-metadata-manifest.yaml
SHACL shapes fair-metadata-shapes.ttl
OWL ontologi fair-metadata-ontology.ttl
RDF/Turtle skjema fair-metadata-schema.ttl
ER-diagram (Mermaid) fair-metadata-erdiagram.md
PlantUML-diagram fair-metadata-filtered.svg · fair-metadata-filtered.puml · fair-metadata.puml (full)

Full byggekonfigurasjon: build.yaml

Valideringsresultat

Valideringsrapporten viser i kva grad modellen etterlever definerte modelleringsreglar og kvalitetskrav. Resultata kan omfatte både lokale og importerte element avhengig av kva reglar som er evaluerte.

Siste validering: 2026-08-15T06:19:07.775525+00:00 — v1.7.0 — policy: gold

Status Feil Åtvaringar
❌ Ikkje godkjent 19 0

Feil (19)

  1. slot_names_snake_case — slot:ressursIdentifikator Slotnamn 'ressursIdentifikator' er ikkje snake_case (berre a-z, 0-9, _)

  2. slot_names_snake_case — slot:tilgangsURL Slotnamn 'tilgangsURL' er ikkje snake_case (berre a-z, 0-9, _)

  3. slot_names_snake_case — slot:autentiseringPaakrevd Slotnamn 'autentiseringPaakrevd' er ikkje snake_case (berre a-z, 0-9, _)

  4. slot_names_snake_case — slot:metadataPersistens Slotnamn 'metadataPersistens' er ikkje snake_case (berre a-z, 0-9, _)

  5. slot_names_snake_case — slot:ansvarlegAktoer Slotnamn 'ansvarlegAktoer' er ikkje snake_case (berre a-z, 0-9, _)

  6. slot_names_snake_case — slot:generertAvAktivitet Slotnamn 'generertAvAktivitet' er ikkje snake_case (berre a-z, 0-9, _)

  7. slot_names_snake_case — slot:registrertIKatalog Slotnamn 'registrertIKatalog' er ikkje snake_case (berre a-z, 0-9, _)

  8. slot_names_snake_case — slot:katalogOppfoeringURL Slotnamn 'katalogOppfoeringURL' er ikkje snake_case (berre a-z, 0-9, _)

  9. all_classes_have_identifier — class:Tilgangsmetadata Klasse 'Tilgangsmetadata' manglar global identifikator (slot med identifier: true)

  10. all_classes_have_identifier — class:Gjenbruksmetadata Klasse 'Gjenbruksmetadata' manglar global identifikator (slot med identifier: true)

  11. all_classes_have_identifier — class:Proveniensmetadata Klasse 'Proveniensmetadata' manglar global identifikator (slot med identifier: true)

  12. all_classes_have_identifier — class:Katalogregistrering Klasse 'Katalogregistrering' manglar global identifikator (slot med identifier: true)

  13. all_classes_have_concept_ref — class:FAIRMetadata Klasse 'FAIRMetadata' manglar annotations.begrepsidentifikator som peikar på begrep i https://concept-catalog.fellesdatakatalog.digdir.no/collections

  14. all_classes_have_concept_ref — class:Tilgangsmetadata Klasse 'Tilgangsmetadata' manglar annotations.begrepsidentifikator som peikar på begrep i https://concept-catalog.fellesdatakatalog.digdir.no/collections

  15. all_classes_have_concept_ref — class:Gjenbruksmetadata Klasse 'Gjenbruksmetadata' manglar annotations.begrepsidentifikator som peikar på begrep i https://concept-catalog.fellesdatakatalog.digdir.no/collections

  16. all_classes_have_concept_ref — class:Proveniensmetadata Klasse 'Proveniensmetadata' manglar annotations.begrepsidentifikator som peikar på begrep i https://concept-catalog.fellesdatakatalog.digdir.no/collections

  17. all_classes_have_concept_ref — class:Katalogregistrering Klasse 'Katalogregistrering' manglar annotations.begrepsidentifikator som peikar på begrep i https://concept-catalog.fellesdatakatalog.digdir.no/collections

  18. schema_has_annotation_oppdateringsfrekvens — schema schema.annotations.oppdateringsfrekvens manglar

  19. no_container_class — schema Ingen tree_root-klasse funnen — kan ikkje sjekke container-klasse-krav

Versjonslog

Versjonsloggen viser endringar mellom publiserte versjonar av modellen. Innhaldet blir generert frå prosjektets release-historikk.

1.7.0 (2026-08-14)

Features

  • generatorar: legg til gen-graphql for GraphQL SDL-generering (cb0a7bd)

Performance Improvements

  • mcp-linkml-validator: parallelliser validate-examples, regenerer valideringsloggar (fc67279)

1.6.0 (2026-08-02)

Features

  • asyncapi: reduser image-storleik frå 4.43 GB til 296 MB (0b61fa2)

1.5.0 (2026-07-30)

Features

  • metadata: dynamisk README-generering frå skjema-metadata (53def55)

Bug Fixes

  • fair-metadata: fjern doble stjerner frå description-felt (594ab72)

1.4.0 (2026-07-10)

Features

  • ci: legg til XSD-generering via avrotize-pipeline (22b585b)
  • legg til flag for publisering av kvar enkelt modell i manifest.yaml som er omdøpt fra generate.yaml. Flytter data og examples katalogane inn under src/linkml/domene slik at alle relaterte filer ligg i samme struktur. (a4cccbd)
  • legg til OpenAPI 3.1 og AsyncAPI 3.0-generering (7be7ef8)
  • mkdocs: konfigurerbar lenke-tekst for offisiell referanse (1d493cd)
  • mkdocs: konfigurerbar lenke-tekst for offisiell referanse og description.md for alle modellar (20d8bf8)
  • validate-capture: parallelliser validering av alle skjema (7d9a0a2)
  • validering: komplett valideringssystem med auto-detect og visuell rapportering (f0607bc)

Bug Fixes

  • ap-no: fjern tvetydig type for lisens og hardkod generator-flagg (e7029d7)
  • release: synk schema-versjon med release-nummer automatisk (1d20298)
  • schemas,mcp-validator: etterlevingsopprett mot Digdir felles modelleringsreglar (regel 6-11, 15) (93a25e7)

1.3.0 (2026-07-09)

Features

  • mkdocs: konfigurerbar lenke-tekst for offisiell referanse (a41c35a)
  • mkdocs: konfigurerbar lenke-tekst for offisiell referanse og description.md for alle modellar (97dacce)

1.2.0 (2026-07-04)

Features

  • validate-capture: parallelliser validering av alle skjema (6267587)

1.1.2 (2026-07-04)

Bug Fixes

  • release: synk schema-versjon med release-nummer automatisk (6dbb358)

1.1.1 (2026-07-04)

Bug Fixes

  • ap-no: fjern tvetydig type for lisens og hardkod generator-flagg (c6514ca)

1.1.0 (2026-07-03)

Features

  • validering: komplett valideringssystem med auto-detect og visuell rapportering (20caed0)

1.0.1 (2026-06-19)

Bug Fixes

  • schemas,mcp-validator: etterlevingsopprett mot Digdir felles modelleringsreglar (regel 6-11, 15) (72aaaf2)

Kontakt

Her finn du informasjon om forvaltningsansvarleg, kontaktpunkt og kanal for feilrapportering eller forslag til forbetringar.

Forvaltningsansvarleg: Brønnøysundregistra

Kontakt: Brønnøysundregistra - Kontakt

Support: GitHub Issues