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.

Brukerdokumentasjonen for Vardef er skrevet i notebooks som er ferdig installert i tjenesten Vardef-forvaltning i Dapla Lab. Det er opprette egne notebooks for typiske arbeidsoppgaver man ønsker å gjøre i Vardef, og brukeren kan kjøre disse uten å skrive kode selv. I notebooks-ene finner man ferdigskrevet kode som bruker dapla-toolbelt-metadata for å jobbe med Vardef. Hvis man ønsker å se innholdet i notebooks uten å starte tjenesten Vardef-forvaltning, så kan gå inn på lenkene til høyre på denne siden.

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

NB! 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.