OrganizationLookup
Slik lar du brukerne slå opp en virksomhet i Enhetsregisteret.
Med komponenten Finn virksomhet (OrganizationLookup) kan brukerne slå opp en virksomhet i Enhetsregisteret med organisasjonsnummer. Appen lagrer organisasjonsnummeret og navnet på virksomheten i datamodellen.
Slik fungerer komponenten
- Brukeren skriver inn organisasjonsnummeret og klikker på Hent opplysninger eller trykker Enter.
- Før søket kontrollerer komponenten at organisasjonsnummeret har ni siffer og riktig kontrollsiffer.
- Finner appen virksomheten, lagrer den opplysningene i datamodellen. Komponenten låser feltet og viser teksten «Fra enhetsregisteret». Navnet på virksomheten står under feltet, og knappen endrer seg til Fjern.
- Med Fjern tømmer brukeren feltene og kan søke på nytt.
Har feltet for organisasjonsnummer allerede en verdi, for eksempel fra forhåndsutfylling, viser komponenten den som et ferdig oppslag.
Når oppslaget feiler
| Situasjon | Melding til brukeren |
|---|
| Organisasjonsnummeret er ugyldig | Organisasjonsnummeret er ugyldig |
| Ingen virksomhet har dette nummeret | Organisasjonsnummeret ble ikke funnet i enhetsregisteret |
| Svaret fra serveren har feil format | Ugyldig respons fra server |
| Annen feil | Ukjent feil. Vennligst prøv igjen senere |
Datamodellbindinger
| Binding | Hva appen lagrer | Påkrevd |
|---|
orgnr | organisasjonsnummeret | ja |
name | navnet på virksomheten | nei |
Påkrevd og skrivebeskyttet
- Med
required må brukeren hente opplysninger før de kan sende inn. Ellers viser appen meldingen «Du må fylle ut organisasjonsnummer og hente opplysninger». - Med
readOnly viser komponenten verdiene, men ikke knappen.
Legge til komponenten
I Altinn Studio Designer finner du Finn virksomhet under Skjema på siden Utforming. Koble orgnr til et felt i datamodellen.
I koden ser komponenten slik ut:
App/ui/{taskId}/layouts/{page}.json
{
"id": "revisor",
"type": "OrganizationLookup",
"dataModelBindings": {
"orgnr": "Revisor.Organisasjonsnummer",
"name": "Revisor.Navn"
},
"textResourceBindings": {
"title": "revisor.title"
},
"required": true
}
Fra v8
Komponenten het OrganisationLookup før v9. Bindingene har også fått nye navn: organisation_lookup_orgnr heter nå orgnr, og organisation_lookup_name heter name. studioctl app upgrade v9 gjør om både typen og bindingene.
Egenskaper
Komponenten støtter også de [felles komponentegenskapene](../common-properties/).
type
Påkrevd
Type: "OrganizationLookup"
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.