Vardef

Sist endret

June 4, 2025

Vardef er SSBs system for dokumentasjon av variabler. Vardef består av et sentralt datalager som man kan interagere med via et API. Statistikere og forskere i SSB kan interagere med systemet gjennom Vardef-delen av Python-pakken dapla-toolbelt-metadata. På siden Variabeldefinisjoner i Dataportal får man eksempelkode som kan brukes for å hente en variabeldefinisjon med dapla-toolbelt-metadata.

Brukerdokumentasjonen for Vardef er skrevet i notebooks som er ferdig installert i tjenesten Vardef-forvaltning i Dapla Lab. Disse notebooks-ene inneholder ferdigskrevet kode som bruker dapla-toolbelt-metadata og dekker typiske arbeidsoppgaver i Vardef. De kan kjøres direkte av brukeren, uten behov for å skrive egen kode.

På denne siden dokumenteres hvordan notebooks for Vardef-forvaltning kan benyttes for å gjøre ulike arbeidsoppgaver knyttet til Vardef.

CautionNB! Publisering av variabeldefinisjoner er midlertidig blokkert

Publisering av variabeldefinisjoner er for øyeblikket deaktivert.
Årsaken er at det pågår en avklaring rundt eierskap til kortnavn.

Forberedelser

For å benytte Datadoc-delen av dapla-toolbelt-metadata må man først installere pakken i et ssb-project:

Terminal
poetry add dapla-toolbelt-metadata

Funksjonalitet

For benytte seg av Vardef-delen av dapla-toolbelt-metadata så må man først importere modulen:

Notebook
from dapla_metadata.variable_definitions import Vardef

Kodeeksempler er samlet i notebooks som er ferdiginstallert i Dapla Lab tjenesten Vardef-forvaltning. Se eksemplene her.