Statiske svaralternativer og enkle kodelister

Svaralternativer som ikke endrer seg, men som kan filtreres

Statiske svaralternativer og kodelister er lettest å sette opp. Du kan legge dem direkte i komponentkonfigurasjonen (vi kaller dette ofte svaralternativer) eller i en json-fil i app-repositoriet (den enkleste formen for kodeliste). Velg metode basert på hvor mange komponenter som skal bruke dem. Hvis flere komponenter trenger de samme svaralternativene, bør du legge dem i en json-fil og gjøre dem om til en kodeliste.

Du kan også gjøre statiske svaralternativer (litt mer) dynamiske ved å filtrere dem med uttrykk. Trenger du enda mer fleksibilitet, kan du lage en egen kodebasert kodeliste.

I komponentkonfigurasjonen (svaralternativer)

I dette eksempelet setter vi opp en Dropdown-komponent med statiske svaralternativer. Egenskapen options er en liste med objekter, hvor hvert objekt representerer et svaralternativ. value er verdien som lagres i datamodellen når brukeren velger elementet. label er ledeteksten som vises til brukeren.

{
  "id": "some-dropdown-component",
  "type": "Dropdown",
  "textResourceBindings": {},
  "dataModelBindings": {
    "simpleBinding": "soknad.nyGaranti.loyvetype"
  },
  "options": [
    {
      "value": "1",
      "label": "Type 1"
    },
    {
      "value": "2",
      "label": "Type 2"
    },
    {
      "value": "3",
      "label": "Type 3"
    }
  ]
}

Fra JSON-filer (kodeliste)

Legg JSON-lister i options-mappen i app-repositoriet. Appen leser filene automatisk og eksponerer dem via options-API-et. Options-filene må ligge under App/options/. Lager du f.eks. land.json, kan du sette opp en komponent med egenskapen "optionsId": "land". Kodelisten er da tilgjengelig fra API-et via endepunktet {org}/{app}/api/options/land.

Kodelistene må følge et spesifikt format. Her er et eksempel på en kodeliste som inneholder land (App/options/land.json):

[
    {
        "value": "norway",
        "label": "Norge"
    },
    {
        "value": "denmark",
        "label": "Danmark"
    },
    {
        "value": "sweden",
        "label": "country.label.sweden"
    }
]

label-feltet kan inneholde en tekstnøkkel til tekstressursene eller ren tekst.

Referer til kodelisten ved å bruke egenskapen optionsId i komponentkonfigurasjonen:

{
  "id": "some-dropdown-component",
  "type": "Dropdown",
  "textResourceBindings": {},
  "dataModelBindings": {
    "simpleBinding": "soknad.opphavsland"
  },
  "optionsId": "land"
}