Felles standard kodelister

Delte standard kodelister som kan brukes i flere applikasjoner

Hva er felles standard kodelister?

Felles standard kodelister er lister som land, fylker, kommuner, kjønn, sivilstatus etc som du kan bruke i applikasjonen din uten at du selv trenger å vedlikeholde disse kodelistene.

Kodelistene er laget som en egen nuget-pakke som du kan importere til applikasjonen din. Dette er gjort for å holde kjernen i en Altinn 3-applikasjon så liten som mulig, og for å kunne publisere nye utgaver og ta i bruk nye kodelister uten å være avhengig av å måtte oppgradere applikasjonen.

Tilgjengelige kodelister

Følgende kodelister er tilgjengelige fra ulike kilder:

Statistisk sentralbyrå (SSB)

Kartverket (KV)

Posten

Slik legger du til felles standard kodelister i applikasjonen

1. Legg til referanse til Altinn.Codelists NuGet-pakken

Åpne kommandolinjen til repoet for applikasjonen din og naviger til App-mappen der App.csproj-filen ligger, og kjør følgende kommando:

dotnet add package Altinn.Codelists --version 9.0.0-preview.1

Du må oppgi versjonen, fordi kommandoen ellers henter den nyeste stabile versjonen, som foreløpig er versjon 8. Se Altinn.Codelists på NuGet for den nyeste versjonen av 9.

Som et alternativ kan du redigere applikasjonens App.csproj-fil direkte ved å legge til referansen nedenfor i <ItemGroup> der du har pakkereferanser:

<PackageReference Include="Altinn.Codelists" Version="9.0.0-preview.1" />

2. Registrer kodelistene i appens DI-kontainer

Legg til følgende i Program.cs-filen din:

services.AddAltinnCodelists();

Ved å kalle denne metoden vil du registrere alle kodelistene på tvers av alle kilder. Du kan også registrere kodelistene én og én hvis du vil ha kontroll på hvilke kodelister som er tatt i bruk eller konfigurere og tilpasse oppsettet av kodelisten.

2.1 Legg til individuelle kilder

I stedet for å registrere alle tilgjengelige kodelister, kan du velge å registrere bare spesifikke kilder:

SSB (Statistisk sentralbyrå) kodelister:

services.AddSSBClassifications();

Dette registrerer alle SSB-baserte kodelister: fylker, kjønn, kommuner, land, næringsgruppering, sivilstand, yrker og grunnbeløpfolketrygden.

Kartverket kodelister:

services.AddKartverketAdministrativeUnits();

Dette registrerer Kartverkets administrative enhetskodelister: fylker-kv og kommuner-kv.

Posten kodelister:

services.AddPosten();

Dette registrerer Postens postnummerkodeliste: poststed.

Individuelle SSB kodelister: Du kan også legge til individuelle SSB kodelister med tilpasset konfigurasjon:

services.AddSSBClassificationCodelistProvider("næring", Classification.IndustryGrouping, new Dictionary<string, string> { { "level", "1" } });

RestCountries klient: For avansert landsinformasjon utover den grunnleggende SSB landskodelisten:

services.AddRestCountriesClient();

Dette registrerer ICountryClient-grensesnittet som gir detaljert informasjon om alle verdens land med filtreringsmuligheter.

3. Koble applikasjonen din til kodeverket du ønsker å bruke

Bruk en av kodeliste-ID-ene fra de tilgjengelige kodelistene ovenfor.

Du kan gjøre dette enten via Altinn Studio og konfigurere Kodeliste-ID for komponenten din i brukergrensesnittet, eller du kan konfigurere komponenten ved å redigere egenskapen optionsId på komponenten i layout-filen.

Tilpasset konfigurasjon

Mens konfigurasjonen nevnt ovenfor der du kaller services.AddAltinnCodelists(); vil legge til alle tilgjengelige kodelister med standardverdier, kan det være tilfeller der du ønsker å tilpasse konfigurasjonen av en kodeliste. Eksemplene under vil variere noe avhengig av kilden til kodelisten siden de ulike kildene tilbyr ulike muligheter.

Legg til en kodeliste med egendefinert kodeliste-ID

Hvis du ikke ønsker å bruke standard kodeliste-ID, eller bare ønsker å registrere kodelister som er relevante for appen din, kan du registrere hver kodeliste individuelt.

Eksemplet benytter en kodeliste fra SSB og overstyrer kodeliste id’en:

services.AddSSBClassificationCodelistProvider("næring", Classification.IndustryGrouping);

Legg til en kodeliste med standardparametere

Noen av kodelistene godtar parametere som styrer hva systemet returnerer.

Eksemplet benytter en kodeliste fra SSB og spesifiserer et filter for å bare hente verdier fra første nivå (denne spesifikke kodelisten er hierarkisk).

services.AddSSBClassificationCodelistProvider("næring", Classification.IndustryGrouping, new Dictionary<string, string>() { { "level", "1" } });

Standardparametrene er en samling av navn/verdi-par som gjør det mulig å sende inn hvilken som helst parameter som implementasjonen av kodelistetilbyderen kan plukke opp.

Legg til en kodeliste som har støtte for beskrivelses- og/eller hjelpetekstverdier

Mens en vanlig kodeliste bare er nøkkel/verdi-par, kan du utvide dette ved å legge til beskrivelses- og hjelpetekster som gir et mer beskrivende brukergrensesnitt.

Følgende eksempel gjør at notatfeltet fra SSB-klassifiseringen fyller ut beskrivelsesteksten.

services.AddSSBClassificationCodelistProvider("næring", Classification.IndustryGrouping,
    new ClassificationOptions() { MapNotesToDescription = true },
    new Dictionary<string, string>() { { "level", "1" } });

Eksemplet aktiverer en forhåndsdefinert måte å legge til en beskrivelsestekst på. Hvis du vil tilpasse beskrivelsesteksten enda mer, kan du sende inn en funksjon. Eksemplet under sender inn en funksjon som systemet evaluerer når kodelisten fylles ut, og vil returnere en kombinasjon av klassifiseringskoden og notatfeltene, separert med kolon.

services.AddSSBClassificationCodelistProvider(
    "næring",
    Classification.IndustryGrouping,
    new ClassificationOptions()
    {
        MapDescriptionFunc = (classificationCode) => $"{classificationCode.Code}: {classificationCode.Notes}"
    },
    new Dictionary<string, string>() { { "level", "1" } });

Legg til en kodeliste fra SSB som ikke er tilgjengelig i Classification-enumen

For øyeblikket er bare et lite utvalg av de tilgjengelige kodelistene fra SSB inkludert i Classification-enumen. Enumen er egentlig bare en mer lesbar versjon av den underliggende id’en som SSB bruker. Men i vårt tilfelle fungerer den også som en måte å fortelle hvilke kodelister vi har testet eksplisitt mot. Hvis du finner en kodeliste du vil bruke, kan du spesifisere id-en direkte i stedet for enumen.

   services.AddSSBClassificationCodelistProvider("næring", 6);

Oversikt over tilgjengelige kodelister fra SSB eller her for JSON varianten.