Gå til innhold

samt-bu

Utgiver Lisens Status Versjon Validering Endringsdato

Om denne modellen

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

Offisiell referanse: samt-bu

LinkML-modell av SAMT-bu (Samarbeid om Modernisering av Tenesteforvalting — Barn og unge), tidleg forretningsobjektmodell for tverrgåande samarbeid i kommunesektoren.

Modellen dekkjer barn og unge-relaterte tenester på tvers av kommunesektoren, inkludert skuleinformasjon, elevdata og organisasjonsstruktur for samarbeidande kommunar.

Typisk brukar: Kommunale og offentlege verksemder som samarbeider om modernisering av tenester for barn og unge, og utviklarar som implementerer tverrgåande integrasjonar.

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/samt-bu-v1.10.0/src/linkml/samt/samt-bu/samt-bu-schema

Valider skjemaet mot silver-policy

make mcp-linkml-valider-modell SCHEMA=src/linkml/samt/samt-bu/samt-bu-schema.yaml

Valider datafil mot LinkML-skjemaet

make validate-instance SCHEMA=src/linkml/samt/samt-bu/samt-bu-schema.yaml INSTANCE=mine-data.yaml

Python-bruk

pip install linkml-runtime pyyaml

from linkml_runtime.loaders import yaml_loader
from samt_bu_model import Skole

skole = yaml_loader.load('mine-data.yaml', target_class=Skole)

Eksempeldatafil

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

# --- eksisterende dataset_metadata ---
dataset_metadata:
  - id: samtbuskole:samt-bu-skole-metadata
    tittel: 
      - samt-bu-skole-data
    beskrivelse: 
      - demodatasett for å teste samt-bu-skole modellen
    tema:
      - https://psi.norge.no/los/tema/skole-og-utdanning
      - https://psi.norge.no/los/tema/grunnskole
    ble_generert_ved:
      - https://data.norge.no/vocabulary/provenance-activity-type#administrative-decision
      - https://data.norge.no/vocabulary/provenance-activity-type#collecting-from-third-party
      - https://data.norge.no/vocabulary/provenance-activity-type#collecting-from-user
    dekningsomraade:
      - http://publications.europa.eu/resource/authority/country/NOR
    nokkelord:

📄 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 samt-bu
Title SAMT - Barnehagar og skular
Description Skular og barnehagar
Schema URI https://data.norge.no/samt/samt-bu
Versjon 1.10.0
Lisens https://data.norge.no/nlod/no/2.0
Utgiver https://data.norge.no/organizations/971032146
Status http://purl.org/adms/status/UnderDevelopment
Endringsdato 2026-08-14
Utgivelsesdato 2026-06-10
Imports linkml:types
../../ap-no/dqv-ap-no/dqv-ap-no-schema

Avhengigheiter (5)

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
└── common-ap-no-schema  # transitiv import
    └── dqv-core-schema  # transitiv import
        └── dcat-ap-no-schema  # transitiv import
            └── dqv-ap-no-schema  # direkte import

Sjå Importhierarki for oversikt over heile repoet sitt importhierarki.

Importerte modeller: linkml:types, common-ap-no, dcat-ap-no, dqv-ap-no, dqv-core

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: samt-bu-schema.yaml

Classes (10)

Classes viser klassar som er definerte lokalt i samt-bu 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).

Obligatorisk (3)

Class Description
Rektor Høgaste akademiske leder av en skole
Skole En skole er en privat eller offentlig institusjon eller et lærested hvor lærere underviser i ulike fag, oftest som grunnlag for videre utdannelse og yrkesliv.
Skoleeier Superklasse for alle typer skoleeiere.

Anbefalt (2)

Class Description
Basisgruppe Skoleklasse som hovedsaklig samler elever i ulike fag.
Kontaktlaerer En lærer med ansvar for ei basisgruppe og er skolens kontaktpunkt for elevane i basisgruppa

Valgfri (1)

Class Description
Elev En person som går på skole

Andre (4)

Class Description
Fylke Fylke (etter norrønt fylki) er en betegnelse på et undernasjonalt, regionalt geografisk område, tilsvarende amt og len.
Kommune En kommune er et geografisk avgrenset område som utgjør en egen politisk og administrativ enhet innen en statsdannelse.
Person Eit menneske individ
PrivatVirksomhet Virksomhet, eller foretak, er betegnelser for en juridisk person eller en organisasjon som produserer varer eller tjenester.

Importerte klasser: common-ap-no, dcat-ap-no, dqv-core

Slots (13)

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 (6)

Slot Description Defined in Usage
fylkesnummer Fylkesnummer er definerte identifikasjonskoder for Norges fylker og to territorier (Svalbard og Jan Mayen). https://data.norge.no/samt/samt-bu ✅ Brukt lokalt
id URI-identifikator for ressursen. https://data.norge.no/ap-no/common-ap-no ✅ Brukt lokalt
kommunenummer Kommunenummer er en nummerrekke som identifiserer kommuner eller kommunefrie områder. https://data.norge.no/samt/samt-bu ✅ Brukt lokalt
navn Namn på ressursen. https://data.norge.no/samt/samt-bu ✅ Brukt lokalt
organisasjonsnummer Organisasjonsnummer er i Norge et ni-sifret registreringsnummer som tildeles av Enhetsregisteret ved Brønnøysundregistrene for en organisasjon (foretak, idrettslag og lignende). https://data.norge.no/samt/samt-bu ✅ Brukt lokalt
trinniva Grunnskolen (6-15 år) er delt opp i 10 trinn, eit for kvart år. https://data.norge.no/samt/samt-bu ✅ Brukt lokalt

Referansar (7)

Slot Description Defined in Usage
del_av_skole Skolen basisgruppa tilhører https://data.norge.no/samt/samt-bu ✅ Brukt lokalt
enhetsleder_for Enhet rektor er enhetsleder for https://data.norge.no/samt/samt-bu ✅ Brukt lokalt
har_saerlig_ansvar_for Elev kontaktlæreren har særlig ansvar for https://data.norge.no/samt/samt-bu ✅ Brukt lokalt
har_skoleeier Skoleeier for skolen https://data.norge.no/samt/samt-bu ✅ Brukt lokalt
horer_til_basisgruppe Basisgruppe elev tilhører https://data.norge.no/samt/samt-bu ✅ Brukt lokalt
jobber_paa_skole Skolen kontaktlæreren jobber på https://data.norge.no/samt/samt-bu ✅ Brukt lokalt
tilknyttet_basisgruppe Basisgruppe kontaktlærer er tilknyttet https://data.norge.no/samt/samt-bu ✅ Brukt lokalt

Importerte slots: common-ap-no, dcat-ap-no, dqv-core

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.

Importerte enums: common-ap-no, dqv-core

Types (2)

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
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, common-ap-no

Subsets (3)

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
Anbefalt Anbefalte eigenskapar i ein AP-NO-profil. https://data.norge.no/ap-no/common-ap-no ✅ Brukt lokalt
Obligatorisk Obligatoriske eigenskapar i ein AP-NO-profil. https://data.norge.no/ap-no/common-ap-no ✅ Brukt lokalt
Valgfri Valfrie eigenskapar i ein AP-NO-profil. https://data.norge.no/ap-no/common-ap-no ✅ Brukt lokalt

Importerte subsets: common-ap-no

Genererte artefakter (15)

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 samt-bu-manifest.yaml
SHACL shapes samt-bu-shapes.ttl
JSON-LD kontekst samt-bu-context.jsonld
JSON Schema samt-bu-schema.json
XML Schema (XSD) samt-bu-schema.xsd
OpenAPI 3.1 samt-bu-openapi.yaml
AsyncAPI 3.0 samt-bu-asyncapi.yaml
OWL ontologi samt-bu-ontology.ttl
RDF/Turtle skjema samt-bu-schema.ttl
Python-klasser samt-bu-model.py
Protobuf-skjema samt-bu-schema.proto
GraphQL-skjema samt-bu-schema.graphql
ER-diagram (Mermaid) samt-bu-erdiagram.md
Eksempeldata (Turtle) samt-bu-eksempel.ttl
PlantUML-diagram samt-bu-filtered.svg · samt-bu-filtered.puml · samt-bu.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:01.262089+00:00 — v1.10.0 — policy: silver

Status Feil Åtvaringar
❌ Ikkje godkjent 8 8

Feil (8)

  1. container_missing_required_class — class:SamtBuContainer Container 'SamtBuContainer' manglar attributt med range 'Katalog'

  2. container_missing_required_class — class:SamtBuContainer Container 'SamtBuContainer' manglar attributt med range 'Kvalitetsmaal'

  3. instance_slot_invalid_vocabulary_pattern — instance:datasettdistribusjoner[0].status 'http://publications.europa.eu/resource/authority/distribution-status/COMPLETED' passar ikkje vokabular_pattern ^http://purl.org/adms/status/(Completed|Deprecated|UnderDevelopment|Withdrawn)$ for slot 'status' (vokabular_krav: skal)

  4. instance_slot_invalid_vocabulary_domain — instance:datasettdistribusjoner[0].status 'http://publications.europa.eu/resource/authority/distribution-status/COMPLETED' er ikkje frå vokabular-domenet http://purl.org/adms/status/ for slot 'status' (vokabular_krav: skal)

  5. instance_slot_invalid_vocabulary_pattern — instance:datasettdistribusjoner[1].status 'http://publications.europa.eu/resource/authority/distribution-status/COMPLETED' passar ikkje vokabular_pattern ^http://purl.org/adms/status/(Completed|Deprecated|UnderDevelopment|Withdrawn)$ for slot 'status' (vokabular_krav: skal)

  6. instance_slot_invalid_vocabulary_domain — instance:datasettdistribusjoner[1].status 'http://publications.europa.eu/resource/authority/distribution-status/COMPLETED' er ikkje frå vokabular-domenet http://purl.org/adms/status/ for slot 'status' (vokabular_krav: skal)

  7. instance_slot_invalid_vocabulary_pattern — instance:gjeldende_lovgivninger[0].spraak 'samtbuskole:no' passar ikkje vokabular_pattern ^http://publications.europa.eu/resource/authority/language/[A-Z]{3}$ for slot 'spraak' (vokabular_krav: skal)

  8. instance_slot_invalid_vocabulary_domain — instance:gjeldende_lovgivninger[0].spraak 'samtbuskole:no' er ikkje frå vokabular-domenet http://publications.europa.eu/resource/authority/language/ for slot 'spraak' (vokabular_krav: skal)

Åtvaringar (8)

  1. all_classes_have_class_uri — class:Kontaktlaerer Klasse 'Kontaktlaerer' manglar class_uri (formal ressursbeskrivelse)

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

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

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

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

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

  7. schema_has_annotation_oppdateringsfrekvens — schema schema.annotations.oppdateringsfrekvens manglar

  8. container_missing_recommended_class — class:SamtBuContainer Container 'SamtBuContainer' manglar attributt med range 'Datatjeneste'

Versjonslog

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

1.10.0 (2026-08-14)

Features

  • generatorar: legg til gen-graphql for GraphQL SDL-generering (cb0a7bd)
  • make,ci: fullført logging-rammeverk med DEBUG/INFO/ERROR-nivå (9b72abe)

Bug Fixes

  • build-manifest: legg til manglande generator-flagg i 11 build.yaml (916d9df)
  • mcp-linkml-validator: vis reelle MCP-feil + patch relativ-import-bug for versjonslåste (4773c74)
  • mkdocs: rett inkonsistent valideringsbadge og -resultat (9cb9fbb)
  • samt-bu: description endring for å trigge release-please og generate workflowane. (42ddec7)
  • samt-bu: rett ugyldig format/spraak-verdiar i eksempelfil (982bbd1)
  • samt-bu: trigger ny release-please køyring for å verifisere om det kun er samt-bu som får trigga ny versjon. (6624bf8)
  • validering: bruk validation_policy konsekvent, fjern bronze-fallback, kopier validation-loggar (cb816aa)

Performance Improvements

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

1.9.0 (2026-08-02)

Features

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

Bug Fixes

  • docgen: endre Metadata til Modellmetadata og flytt anker til metadata.sh (a83174b)
  • samt-bu: Endrer description for ein attributt for å trigge revalidering av samt-bu modellen i CI pipeline (e09fa5a)

1.8.0 (2026-07-30)

Features

  • makefile: containeriser alle Python-kall (a1833a2)
  • metadata: dynamisk README-generering frå skjema-metadata (53def55)

1.7.0 (2026-07-27)

Features

  • docgen: fullstendig tabellradteljing, versjonerte imports og Subsets-kolonne (de26c53)

1.6.0 (2026-07-10)

Features

  • ap-no: publiser common-ap-no i nav-meny og omdøp katalog (9653abf)
  • ci: legg til XSD-generering via avrotize-pipeline (22b585b)
  • docgen: vis alle brukte typar/enums inkl. importerte i index.md (cdb0480)
  • 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)
  • makefile: legg til timing og stille logging for gen-xsd og gen-informasjonsmodell-instance (0d00e6f)
  • mkdocs: konfigurerbar lenke-tekst for offisiell referanse og description.md for alle modellar (20d8bf8)
  • mkdocs: konfigurerbare seksjons-kjelder i index.md (122c704)
  • validate-capture: parallelliser validering av alle skjema (7d9a0a2)

Bug Fixes

  • ap-no: fjern tvetydig type for lisens og hardkod generator-flagg (e7029d7)
  • los: rett alle Los-URI-avvik og legg til rettleiing (LO1–LO5) (05df4cc)
  • løys valideringsfeil i samt-bu og rotårsak i dqv-ap-no (BUG-6) (cc5f104)
  • mkdocs: flytt horisontal linje frå badges til etter description og fjern støymeldingar (3389d3d)
  • release: synk schema-versjon med release-nummer automatisk (1d20298)
  • samt-bu,asyncapi: fjern overflødige åtvaringar frå make samt (1dfd071)
  • samt-bu: legg på begrepsidentifikator på person klassen (ef615b2)
  • samt-bu: legg til begrepesidentifikator for Kontaktlaerer klassen (86a44b2)
  • samt-bu: legg til begrepsidentifikator for skole klassen (a779825)
  • samt-bu: legg til begrepsidentifikator for skoleeier (7406526)
  • samt-bu: legg til begrpsidentifikator for kommune klassen (baf0bd4)
  • samt-bu: rett stale slotnamn på Kvalitetsdimensjon-instans i eksempel (dbda72a)
  • schemas,mcp-validator: etterlevingsopprett mot Digdir felles modelleringsreglar (regel 6-11, 15) (93a25e7)
  • validation: Viser valideringsresultat for siste validering i index.md for kvar modell i mkdocs portal (3b3baa3)

1.5.0 (2026-07-10)

Features

  • makefile: legg til timing og stille logging for gen-xsd og gen-informasjonsmodell-instance (4791036)

1.4.0 (2026-07-09)

Features

  • ap-no: publiser common-ap-no i nav-meny og omdøp katalog (35da103)
  • mkdocs: konfigurerbar lenke-tekst for offisiell referanse og description.md for alle modellar (97dacce)

Bug Fixes

  • mkdocs: flytt horisontal linje frå badges til etter description og fjern støymeldingar (f5969b3)

1.3.0 (2026-07-06)

Features

  • mkdocs: konfigurerbare seksjons-kjelder i index.md (94c2efb)

1.2.0 (2026-07-04)

Features

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

1.1.0 (2026-07-04)

Features

  • docgen: vis alle brukte typar/enums inkl. importerte i index.md (9d8b13e)

Bug Fixes

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

1.0.6 (2026-07-04)

Bug Fixes

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

1.0.5 (2026-07-03)

Bug Fixes

  • løys valideringsfeil i samt-bu og rotårsak i dqv-ap-no (BUG-6) (49a093a)
  • samt-bu,asyncapi: fjern overflødige åtvaringar frå make samt (76132b4)
  • samt-bu: legg på begrepsidentifikator på person klassen (efd8019)
  • samt-bu: legg til begrepesidentifikator for Kontaktlaerer klassen (3dab033)
  • samt-bu: legg til begrepsidentifikator for skole klassen (7e949f8)
  • samt-bu: legg til begrepsidentifikator for skoleeier (68c79d4)
  • samt-bu: legg til begrpsidentifikator for kommune klassen (999e79a)
  • samt-bu: rett stale slotnamn på Kvalitetsdimensjon-instans i eksempel (6e4d623)
  • validation: Viser valideringsresultat for siste validering i index.md for kvar modell i mkdocs portal (723e61c)

1.0.4 (2026-07-02)

Bug Fixes

  • samt-bu: legg på begrepsidentifikator på person klassen (efd8019)
  • samt-bu: legg til begrepesidentifikator for Kontaktlaerer klassen (3dab033)
  • samt-bu: legg til begrepsidentifikator for skole klassen (7e949f8)
  • samt-bu: legg til begrepsidentifikator for skoleeier (68c79d4)
  • samt-bu: legg til begrpsidentifikator for kommune klassen (999e79a)

1.0.3 (2026-07-01)

Bug Fixes

  • samt-bu,asyncapi: fjern overflødige åtvaringar frå make samt (76132b4)
  • samt-bu: rett stale slotnamn på Kvalitetsdimensjon-instans i eksempel (6e4d623)

1.0.2 (2026-06-20)

Bug Fixes

  • løys valideringsfeil i samt-bu og rotårsak i dqv-ap-no (BUG-6) (49a093a)

1.0.1 (2026-06-19)

Bug Fixes

  • los: rett alle Los-URI-avvik og legg til rettleiing (LO1-LO5) (7673852)
  • 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: KS Digital

Kontakt: KS Digital - Kontakt

Support: GitHub Issues