xkos-ap-no
Om denne modellen
Denne sida dokumenterer LinkML-modellen xkos-ap-no, inkludert klassar, eigenskapar, datatypar, valideringsresultat og genererte artefakter. Informasjonen er generert automatisk frå skjemaet og tilhøyrande byggeproses.
Offisiell referanse: Spesifikasjon for klassifikasjonsbeskrivelser (XKOS-AP-NO)
XKOS-AP-NO er den norske applikasjonsprofilen av XKOS (eXtended Knowledge Organization System), tilpassa norsk offentleg sektor og modellert i LinkML.
Profilen dekkjer metadata for klassifikasjonar, klassifikasjonsnivå og kategoriar — tilpassa krava i XKOS-AP-NO-spesifikasjonen frå Digitaliseringsdirektoratet.
Typisk brukar: Offentlege verksemder som skal publisere klassifikasjonar (t.d. kodeverk, nomenklaturer) til Felles datakatalog, og utviklarar som implementerer XKOS-AP-NO-kompatible system.
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/xkos-ap-no-v1.0.0/src/linkml/ap-no/xkos-ap-no/xkos-ap-no-schema
Valider skjemaet mot gold-policy
Valider datafil mot LinkML-skjemaet
make validate-instance SCHEMA=src/linkml/ap-no/xkos-ap-no/xkos-ap-no-schema.yaml INSTANCE=mine-data.yaml
Python-bruk
from linkml_runtime.loaders import yaml_loader
from xkos_ap_no_model import Klassifikasjon
klassifikasjon = yaml_loader.load('mine-data.yaml', target_class=Klassifikasjon)
Eksempeldatafil
Eksempel som viser korleis ei gyldig datafil basert på denne modellen kan sjå ut i YAML-format.
klassifikasjonar:
- id: https://example.org/klassifikasjon/nace2
identifikator_literal: "NACE-Rev2"
tittel:
- NACE Rev. 2
beskrivelse:
- Nomenklatur for økonomiske aktivitetar (NACE Rev. 2).
utgjevar: https://example.org/org/ssb
antall_nivaa: 2
forste_nivaa:
- https://example.org/nivaa/nace2-seksjonar
klassifikasjonsnivaar:
- id: https://example.org/nivaa/nace2-seksjonar
tittel:
- Seksjonar
nivaa_djupn: 1
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 | xkos-ap-no |
| Title | XKOS-AP-NO |
| Description | Utvida klassifikasjon |
| Schema URI | https://data.norge.no/ap-no/xkos-ap-no |
| Versjon | 1.0.0 |
| Lisens | https://data.norge.no/nlod/no/2.0 |
| Utgiver | https://data.norge.no/organizations/991825827 |
| Status | http://purl.org/adms/status/Completed |
| Endringsdato | 2026-06-10 |
| Utgivelsesdato | 2023-01-01 |
| Imports | linkml:types ../common-ap-no/common-ap-no-schema ../dcat-ap-no/dcat-ap-no-schema |
Avhengigheiter (4)
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 # direkte import
└── dqv-core-schema # transitiv import
└── dcat-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-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.
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: xkos-ap-no-schema.yaml
Classes (5)
Classes viser klassar som er definerte lokalt i xkos-ap-no 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 (4)
| Class | Description |
|---|---|
| Kategori | Ein kategori i ein klassifikasjon (skos:Concept). |
| Klassifikasjon | Ei klassifikasjon - ein systematisk struktur av kategoriar brukt til å klassifisere data (skos:ConceptScheme). |
| Klassifikasjonsnivaa | Eit nivå i ein klassifikasjon (xkos:ClassificationLevel). |
| Klassifikasjonssamanlikning | Ein samanlikning mellom to klassifikasjonar (xkos:Correspondence). |
Anbefalt (1)
| Class | Description |
|---|---|
| Kategorisamanlikning | Ein samanlikning mellom to kategoriar på tvers av klassifikasjonar (xkos:ConceptAssociation). |
Importerte klasser: common-ap-no, dcat-ap-no, dqv-core
Slots (48)
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 |
|---|---|---|---|
| anbefalt_term | Føretrukke term/namn for ressursen (skos:prefLabel). | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
| antall_nivaa | Antal nivå i klassifikasjonen (xkos:numberOfLevels). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| beskrivelse | Fritekstbeskrivelse av ressursen (dct:description). | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
| definisjon | Definisjon av kategorien (skos:definition). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| eksklusjonsnotat | Kva som eksplisitt er ekskludert frå kategorien (xkos:exclusionNote). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| endringsdato | Dato for siste endring av ressursen (dct:modified). | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
| har_notat | Fritekstnotat om kategorien (skos:note). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| heimeside | Heimeside for ressursen eller organisasjonen (foaf:homepage). | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
| hovudinnhald | Merknad om kva som typisk er inkludert i kategorien (xkos:coreContentNote). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| id | URI-identifikator for ressursen. | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
| identifikator_literal | Tekstleg identifikator for ressursen (dct:identifier). | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
| inklusjonsnotat | Kva som eksplisitt er inkludert i kategorien (xkos:inclusionNote). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| nivaa_djupn | Djupna (nivånummer) i klassifikasjonsstrukturen (xkos:depth). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| nokkelord | Nøkkelord som beskriv ressursen (dcat:keyword). | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
| notasjon | Notasjon/kode for identifikatoren. | https://data.norge.no/ap-no/dcat-ap-no | ✅ Brukt lokalt |
| tillaten_term | Tillate alternativtermar for kategorien (skos:altLabel). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| tilleggsinnhald | Merknad om kva som unntaksvis er inkludert i kategorien (xkos:additionalContentNote). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| tittel | Namn/tittel på ressursen (dct:title). | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
| utgivelsesdato | Dato ressursen vart første gong publisert (dct:issued). | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
| versjonsnummer | Versjonsnummer for ressursen (owl:versionInfo). | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
Referansar (28)
| Slot | Description | Defined in | Usage |
|---|---|---|---|
| begrep | Fagomgrep som datasettet handlar om. | https://data.norge.no/ap-no/dcat-ap-no | ✅ Brukt lokalt |
| bestar_av | Kategorisamanlikningar som inngår i klassifikasjonssamanlikninga (xkos:madeOf). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| dekker | Fagleg domene klassifikasjonen/nivået dekkjer (xkos:covers). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| dekker_gjensidig_utelukkande | Domene dekkja gjensidig utelukkande (xkos:coversMutuallyExclusively). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| dekker_uttomande | Domene dekkja uttømmande (xkos:coversExhaustively). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| er_eksklusivt_ekvivalent_med | Eksklusiv breid ekvivalens (xkos:exclusivelyBroadMatch). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| er_ekvivalent_med | Breid ekvivalens til kategori i annan klassifikasjon (uneskos:broadMatch). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| er_forste_kategori_i | Klassifikasjon(ar) som kategorien er toppnivåkategori i (skos:topConceptOf). Markerer at kategorien ikkje har nokon overordna kategori i klassifikasjonen. | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| er_i_klassifikasjon | Klassifikasjonen kategorien tilhøyrer (skos:inScheme). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| er_ikkje_ekvivalent_med | Klar ikkje-ekvivalens til kategori i annan klassifikasjon (xkos:disjointMatch). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| er_samanlikna_med | Klassifikasjonar som er samanlikna (xkos:compares). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| erstattar | Eldre klassifikasjon som dette kodeverket erstattar (xkos:supersedes). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| forrige_kategori | Forrige kategori på same nivå i klassifikasjonen (xkos:previous). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| forste_nivaa | Toppnivå i klassifikasjonen (xkos:levels). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| gjeld_for_tidsrom | Tidsrom klassifikasjonen er gyldig for (dct:temporal). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| har_medlem | Kategoriar som høyrer til dette nivået (skos:member). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| inneheld_kategori | Kategoriar klassifikasjonen inneheld (uneskos:contains). Dette er ein snarveg framfor å bruke xkos:levels + skos:member for å liste alle kategoriar direkte. | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| kjeldeomgrep | Kjeldeomgrep i ein kategorisamanlikning (xkos:sourceConcept). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| maalomgrep | Måleomgrep i ein kategorisamanlikning (xkos:targetConcept). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| neste_kategori | Neste kategori på same nivå i klassifikasjonen (xkos:next). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| organisert_etter | Prinsippet klassifikasjonsnivået er organisert etter (xkos:organizedBy). Til dømes kan eit nivå vere organisert etter geografisk plassering, næringsverksemd eller administrativ inndeling. | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| overordna_kategori | Overordna kategori (skos:broader). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| samanliknar | Klassifikasjonar som er samanlikna i korrespondansen (xkos:compares). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| spraak | Språk brukt i ressursen. | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
| tilhorande_klassifikasjonsnivaa | Klassifikasjonsnivå kategorien høyrer til (xkos:belongsTo). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| underordna_kategori | Underordna kategori (skos:narrower). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| underordna_klassifikasjonsnivaa | Underordna klassifikasjonsnivå (xkos:nextLevel). | https://data.norge.no/ap-no/xkos-ap-no | ✅ Brukt lokalt |
| utgjevar | Aktør som er ansvarleg utgjevar (dct:publisher). | https://data.norge.no/ap-no/xkos-ap-no | ✅ 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 (6)
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 |
|---|---|---|---|---|
| date | xsd:date | a date (year, month and day) in an idealized calendar | linkml:types | ✅ Brukt lokalt |
| LangString | rdf:langString | Språktagget streng (rdf:langString). | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
| NonNegativeInteger | xsd:nonNegativeInteger | Ikkje-negativ heltalsverdi (xsd:nonNegativeInteger). | https://data.norge.no/ap-no/common-ap-no | ✅ Brukt lokalt |
| string | xsd:string | A character string | linkml:types | ✅ Brukt lokalt |
| uri | xsd:anyURI | a complete URI | 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 (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 | xkos-ap-no-manifest.yaml |
| SHACL shapes | xkos-ap-no-shapes.ttl |
| OWL ontologi | xkos-ap-no-ontology.ttl |
| RDF/Turtle skjema | xkos-ap-no-schema.ttl |
| ER-diagram (Mermaid) | xkos-ap-no-erdiagram.md |
| PlantUML-diagram | xkos-ap-no-filtered.svg · xkos-ap-no-filtered.puml · xkos-ap-no.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:09.257061+00:00 — v1.0.0 — policy: gold
| Status | Feil | Åtvaringar |
|---|---|---|
| ❌ Ikkje godkjent | 8 | 0 |
Feil (8)
-
all_classes_have_concept_ref—class:KlassifikasjonKlasse 'Klassifikasjon' manglar annotations.begrepsidentifikator som peikar på begrep i https://concept-catalog.fellesdatakatalog.digdir.no/collections -
all_classes_have_concept_ref—class:KlassifikasjonsnivaaKlasse 'Klassifikasjonsnivaa' manglar annotations.begrepsidentifikator som peikar på begrep i https://concept-catalog.fellesdatakatalog.digdir.no/collections -
all_classes_have_concept_ref—class:KategoriKlasse 'Kategori' manglar annotations.begrepsidentifikator som peikar på begrep i https://concept-catalog.fellesdatakatalog.digdir.no/collections -
all_classes_have_concept_ref—class:KlassifikasjonssamanlikningKlasse 'Klassifikasjonssamanlikning' manglar annotations.begrepsidentifikator som peikar på begrep i https://concept-catalog.fellesdatakatalog.digdir.no/collections -
all_classes_have_concept_ref—class:KategorisamanlikningKlasse 'Kategorisamanlikning' manglar annotations.begrepsidentifikator som peikar på begrep i https://concept-catalog.fellesdatakatalog.digdir.no/collections -
schema_has_annotation_oppdateringsfrekvens—schemaschema.annotations.oppdateringsfrekvens manglar -
no_container_class—schemaIngen tree_root-klasse funnen — kan ikkje sjekke container-klasse-krav -
fair_r11—schemaFAIR R1.1: Ingen slot med dct:license funnen
Kontakt
Her finn du informasjon om forvaltningsansvarleg, kontaktpunkt og kanal for feilrapportering eller forslag til forbetringar.
Forvaltningsansvarleg: Digitaliseringsdirektoratet
Kontakt: Digitaliseringsdirektoratet - Kontakt
Support: GitHub Issues