Sist endret: 6. mar. 2025

PersonLookup

Søk etter person i folkeregisteret

Bruk

PersonLookup-komponenten søker i det nasjonale folkeregisteret basert på brukerens oppgitte input for fødselsnummer og etternavn, og lagrer resultatet ved hjelp av en datamodellbinding.

Anatomi

Komponenten består av en hovedtittel, en hjelptekst, en beskrivelse, en fødselsnummer-input tittel, et fødselsnummer-input felt, en etternavn-input tittel, et etternavn-input navn og en hent-knapp.

  1. Overskrift – Hovedtittel.
  2. Hjelpetekst – Klikk for hjelpe-popup.
  3. Vis beskrivelse – Beskrivelse av komponenten.
  4. Personnummerfelt – Inndatafelt for fødselsnummer.
  5. Etternavn – Inndatafelt for etternavn.
  6. Hent opplysninger – Hent opplysninger basert på inndata.

Oppførsel

Før en bruker interagerer med komponenten, vises den slik.

alt text

Ved en vellykket henting legger komponenten til en beskrivelse i feltene, som indikerer at dataene som vises er hentet fra folkeregisteret. Knappen forvandles fra en hent-knapp til en fjern-knapp.

alt text

Komponenten har innebygd validering for inputfeltene både ved tap av fokus og ved henting. NIN-inputfeltet validerer formatet til det nasjonale identitetsnummeret i henhold til de offisielle retningslinjene for NIN. Etternavn-inputfeltet kontrollerer at et etternavn er oppgitt. Feilmeldingene for inputfeltsvalideringene vises på PersonLookup-komponenten.

alt text

Gitt gyldig inndata, men med en uoverensstemmelse mellom fødselsnavn og etternavn, viser komponenten en feilmelding etter forsøk på henting. Det er en grense for antallet unike mislykkede oppslag før brukeren midlertidig blokkeres.

alt text

Når antallet tillatte unike mislykkede oppslag overskrides, gjenspeiler komponenten dette.

alt text

Egenskaper

Følgende er en liste over tilgjengelige egenskaper for PersonLookup.

Vi oppdaterer for øyeblikket hvordan vi implementerer komponenter. Listen over egenskaper kan derfor være noe unøyaktig.
EgenskapTypeBeskrivelse
idstringKomponent-ID-en. Må være unik innenfor alle oppsett/sider i et oppsett-sett. Kan ikke slutte med .
typestring“PersonLookup”
dataModelBindings.person_lookup_ssnstringHvor i datamodellen resultatet (fnr) skal lagres
dataModelBindings.person_lookup_namestringHvor i datamodellen resultatet (navn) skal lagres
textResourceBindings.titlestringLedetekst (valgfritt)
textResourceBindings.descriptionstringBeskrivelse (valgfritt)
textResourceBindings.helpstringHjelpetekst (valgfritt)

Konfigurasjon

Vi oppdaterer for øyeblikket Altinn Studio med flere muligheter for innstillinger! Dokumentasjonen oppdateres fortløpende, men det kan være flere innstillinger tilgjengelig enn det som beskrives her og noen innstillinger kan være i betaversjon.

Eksempel

I følgende eksempel konfigurerer vi opp komponenten for å legge til en styreleder. Vi sier at det er påkrevd å oppgi en person, og vi overstyrer tittel. Vi velger å ikke bruke beskrivelse eller hjelpetekst. Resultatet vil vi ha i datamodellen på Styre.Styreleder.

    Legg til styreleder:

    App/ui/layouts/{page}.json
    {
      "$schema": "https://altinncdn.no/toolkits/altinn-app-frontend/4/schemas/json/layout/layout.schema.v1.json",
      {
        "data": {
          "layout": [
            {
              {
                "id": "Styreleder-lookup",
                "type": "PersonLookup",
                "dataModelBindings": {
                  "person_lookup_ssn": "Styre.Styreleder.Foedselsnummer",
                  "person_lookup_name": "Styre.Styreleder.Name"
                },
                "textResourceBindings": {
                  "title": "styre-og-revisjon.Group-1.title"
                },
                "required": true
              },
            }
          ]
        }
      }
    }
    
    Det finnes for øyeblikket ikke mulighet for å konfigurere PersonLookup i Altinn Studio Designer.