Sist endret: 29. okt. 2026
Preview: Dette er dokumentasjonen for Altinn Studio v9, som er en forhåndsversjon. Gjeldende versjon er v8. For å se dokumentasjonen for gjeldende versjon, velg v8 i versjonsvelgeren i menyen til venstre.

PersonLookup

Slik lar du brukerne slå opp en person i Folkeregisteret.

Med komponenten Finn person (PersonLookup) kan brukerne slå opp en person i Folkeregisteret. Appen lagrer opplysningene om personen i datamodellen.

Slik fungerer komponenten

  • Brukeren skriver inn både fødselsnummer (eller D-nummer) og etternavn, og klikker på Hent opplysninger eller trykker Enter. Etternavnet må høre til samme person som nummeret.
  • Før søket kontrollerer komponenten at fødselsnummeret eller D-nummeret er gyldig, og at etternavnet ikke er tomt.
  • Finner appen personen, lagrer den opplysningene i datamodellen. Komponenten låser feltene og viser teksten «Fra folkeregisteret». Feltet for etternavn heter nå Navn og viser navnet på personen. Knappen endrer seg til Fjern.
  • Med Fjern tømmer brukeren feltene og kan søke på nytt.

Har feltet for fødselsnummer allerede en verdi, for eksempel fra forhåndsutfylling, viser komponenten den som et ferdig oppslag.

Når oppslaget feiler

SituasjonMelding til brukeren
Fødselsnummeret er ugyldigFødselsnummeret/D-nummeret er ugyldig.
Etternavnet manglerEtternavn kan ikke være tomt.
Ingen person har denne kombinasjonenIngen person er registrert med denne kombinasjonen av fødselsnummer/D-nummer og navn. …
For mange søkDu har nådd grensen for antall søk. …
Brukeren har ikke tilgang til å søkeDu har ikke tilgang til å søke på denne personen. …
Svaret fra serveren har feil formatDet oppstod en feil. Vennligst prøv igjen senere.
Annen feilUkjent feil. Vennligst prøv igjen senere.

Altinn begrenser hvor mange mislykkede søk en bruker kan gjøre, og sperrer søket midlertidig etter for mange forsøk.

Datamodellbindinger

BindingHva appen lagrerPåkrevd
ssnfødselsnummeret eller D-nummeretja
fullNamefullt navn, med mellomnavnnei
firstNamefornavnetnei
middleNamemellomnavnetnei
lastNameetternavnet fra Folkeregisteretnei

Påkrevd og skrivebeskyttet

  • Med required må brukeren hente opplysninger før de kan sende inn. Ellers viser appen meldingen «Du må fylle ut fødselsnummer».
  • Med readOnly viser komponenten verdiene, men ikke knappen.

Legge til komponenten

I Altinn Studio Designer finner du Finn person under Skjema på siden Utforming. Koble ssn til et felt i datamodellen.

I koden ser komponenten slik ut:

App/ui/{taskId}/layouts/{page}.json
{
  "id": "styreleder",
  "type": "PersonLookup",
  "dataModelBindings": {
    "ssn": "Styreleder.Foedselsnummer",
    "fullName": "Styreleder.Navn",
    "firstName": "Styreleder.Fornavn",
    "middleName": "Styreleder.Mellomnavn",
    "lastName": "Styreleder.Etternavn"
  },
  "textResourceBindings": {
    "title": "styreleder.title"
  },
  "required": true
}

Fra v8

Bindingene har fått nye navn i v9: person_lookup_ssn heter nå ssn, person_lookup_name heter fullName, og person_lookup_first_name, person_lookup_middle_name og person_lookup_last_name heter firstName, middleName og lastName. studioctl app upgrade v9 gjør om navnene.

Egenskaper

Komponenten støtter også de [felles komponentegenskapene](../common-properties/).
type Påkrevd Type: "PersonLookup"
Angir hvilken komponenttype konfigurasjonen gjelder.
readOnly Valgfri Standardverdi: false Type: boolean | expression<boolean>
Boolsk verdi eller uttrykk som angir om komponenten skal være skrivebeskyttet eller deaktivert. Selv skrivebeskyttede felt kan foreløpig endres ved å manipulere API-kallet.
required Valgfri Standardverdi: false Type: boolean | expression<boolean>
Boolsk verdi eller uttrykk som angir om komponenten skal være påkrevd.
showValidations Valgfri Type: "Schema" | "Invalid" | "Component" | "Expression" | "CustomBackend" | "Required" | "AllExceptRequired" | "All"[]
Liste over valideringstypene som skal vises.
labelSettings Valgfri Type: object
Styrer hvordan ledeteksten til komponenten vises.
labelSettings.optionalIndicator Valgfri Standardverdi: true Type: boolean
Viser en markering for valgfrie felt ved ledeteksten. Aktivert som standard.
textResourceBindings Valgfri Type: object
Kobler tekstene i komponenten til tekstressurser eller uttrykk.
textResourceBindings.tableTitle Valgfri Type: string | expression<string>
Tittelen som vises i tabellvisningen. Overstyrer den vanlige tittelen.
textResourceBindings.shortName Valgfri Type: string | expression<string>
Alternativt navn i valideringsmeldinger for påkrevde felt. Overstyrer den vanlige tittelen.
textResourceBindings.requiredValidation Valgfri Type: string | expression<string>
Hele valideringsmeldingen som vises når komponenten er påkrevd og mangler verdi. Overstyrer både standardmeldingen og kortnavnet.
textResourceBindings.summaryTitle Valgfri Type: string | expression<string>
Tittelen som vises i oppsummeringen. Overstyrer den vanlige tittelen.
textResourceBindings.summaryAccessibleTitle Valgfri Type: string | expression<string>
Tittelen som brukes i aria-label på redigeringsknappen i oppsummeringen. Overstyrer både den vanlige tittelen og oppsummeringstittelen.
textResourceBindings.title Valgfri Type: string | expression<string>
Ledeteksten til komponenten.
textResourceBindings.description Valgfri Type: string | expression<string>
Valgfri beskrivelse som vises under ledeteksten.
textResourceBindings.help Valgfri Type: string | expression<string>
Valgfri hjelpetekst som vises ved ledeteksten.
forceShowInSummary Valgfri Standardverdi: false Type: boolean | expression<boolean>
Tvinger komponenten til å vises i en oppsummering selv om hideEmptyFields er true i oppsummeringskomponenten.
removeWhenHidden Valgfri Standardverdi: true Type: boolean | expression<boolean>
Overstyrer oppryddingen av data for skjulte komponenter ved slutten av oppgaven.
dataModelBindings Påkrevd Type: object
Kobler verdiene i komponenten til felter i datamodellen.
dataModelBindings.ssn Påkrevd Type: datamodellbinding
Angir hvor i datamodellen komponenten skal lagre fødselsnummeret til personen som slås opp. Slik bruker du datamodellbindinger.
dataModelBindings.fullName Valgfri Type: datamodellbinding
Angir hvor i datamodellen komponenten skal lagre navnet på personen som slås opp. Slik bruker du datamodellbindinger.
dataModelBindings.lastName Valgfri Type: datamodellbinding
Angir hvor i datamodellen komponenten skal lagre etternavnet til personen som slås opp. Slik bruker du datamodellbindinger.
dataModelBindings.middleName Valgfri Type: datamodellbinding
Angir hvor i datamodellen komponenten skal lagre mellomnavnet til personen som slås opp. Slik bruker du datamodellbindinger.
dataModelBindings.firstName Valgfri Type: datamodellbinding
Angir hvor i datamodellen komponenten skal lagre fornavnet til personen som slås opp. Slik bruker du datamodellbindinger.