Altinn Studio Referanse Brukergrensesnitt Felter Gruppering Repeterende

Repeterende grupper

Oppsett for repeterende grupper

Grupper i datamodellen inneholder ett eller flere felter. Man lager en repeterende gruppe komponent ved å sette "type" til "RepeatingGroup" En gruppe som er repeterende i datamodellen må også settes opp som repeterende i skjemaet/layout-konfigurasjonen, ellers vil lagring av data feile. I JSON defineres en repeterende gruppe som en array/liste med objekter (hvor hvert objekt representerer en rad i en repeterende gruppe). I XML defineres en repetrende gruppe som en liste med elementer (hvor hvert element er en gruppe med egenskaper, gjengitt som en rad i en repeterende gruppe).

Eksempel

Under vises et skjema med en repeterende gruppe som:

Inneholder to komponenter (avkrysningsboks og adresse)
Kan repeteres opp til 3 ganger
Er knyttet til datamodellen gjennom GruppeListe

Vis/skjul innhold Vis konfigurasjonen for dette skjermskuddet

 1{
 2  "$schema": "https://altinncdn.no/toolkits/altinn-app-frontend/4/schemas/json/layout/layout.schema.v1.json",
 3  "data": {
 4    "layout": [
 5      {
 6        "id": "gruppe",
 7        "type": "RepeatingGroup",
 8        "children": [
 9          "avkrysningsboks",
10          "adresse"
11        ],
12        "maxCount": 3,
13        "dataModelBindings": {
14          "group": "GruppeListe"
15        }
16      },
17      {
18        "id": "avkrysningsboks",
19        "type": "Checkboxes",
20        "textResourceBindings": {
21          "title": "Avkrysningsboks"
22        },
23        "dataModelBindings": {
24          "simpleBinding": "GruppeListe.Avkrysning"
25        },
26        "options": [
27          {
28            "label": "Navn",
29            "value": "Verdi1"
30          },
31          {
32            "label": "Adresse",
33            "value": "Verdi2"
34          }
35        ],
36        "required": true
37      },
38      {
39        "id": "adresse",
40        "type": "Address",
41        "dataModelBindings": {
42          "address": "GruppeListe.Adresse",
43          "zipCode": "GruppeListe.Postnr",
44          "postPlace": "GruppeListe.Poststed"
45        },
46        "simplified": true,
47        "readOnly": false,
48        "required": true
49      }
50    ]
51  }
52}

Parametre

Parameter	Påkrevd	Beskrivelse
id	Ja	Unik ID, tilsvarer ID på andre komponenter. Må være unik i layout-filen, og bør være unik på tvers av sider.
type	Ja	Må settes til `Group`
dataModelBindings	Nei	Må settes for repeterende grupper med skjemakomponenter under, og må peke mot den repeterende strukturen i datamodellen.
textResourceBindings	Nei	Kan settes for grupper, se nærmere beskrivelse under.
maxCount	Nei	Antall ganger en gruppe kan repetere.
minCount	Nei	Validering. Setter et minimum antall rader som må eksistere før den repeterende gruppen er godkjennt og bruker kan bevege seg videre.
children	Ja	Liste over komponent-IDer som inkluderes i gruppen.
edit	Nei	Egenskaper og alternativer for redigerings-/utfyllingsvisningen for en repeterende gruppe.
tableHeaders	Nei	Liste over komponenter som skal utgjøre kolonner i tabellvisningen for den repeterende gruppen. Om ingen er spesifisert, blir alle komponenter fra `children` vist.
tableColumns	Nei	Objekt som inneholder egenskaper for kolonnene som vises i tabellen.
stickyHeaders	No	Dersom satt til `true`, gjøres tabell headerene `sticky`.

textResourceBindings

Det er mulig å legge til ulike nøkler i textResourceBindings for å overstyre standardtekster:

title - tittel som blir vist over den repeterende gruppen og over hver gruppe-rad i en Summary-komponent.
summaryTitle - dersom denne er satt, vil den overstyre title i Summary-komponenten.
description - beskrivelse som blir vist over den repeterende gruppen under tittelen.
add_button - blir lagt til på enden av “Legg til ny” teksten på knappen, og kan brukes til å f.eks ha tekst som sier “Legg til ny person”.
add_button_full - blir brukt som egendefinert tekst på “Legg til ny” knappen. Overstyrer add_button dersom begge er satt.
save_button - blir brukt som tekst i “Lagre”-knappen når brukeren fyller ut data.
save_and_next_button - blir brukt som tekst i “Lagre og åpne neste”-knappen dersom denne er aktivert.
edit_button_open - blir brukt som tekst i “Endre” knappen i tabellen når brukeren skal åpne et element.
edit_button_close - blir brukt som tekst i “Endre” knappen tabellen når brukeren skal lukke et element.

Grupper i datamodellen inneholder ett eller flere felter. Grupper er definert som repeterende dersom de har maxCount > 1 i layout-konfigurasjonen. En gruppe som er repeterende i datamodellen må også settes opp som repeterende i skjemaet/layout-konfigurasjonen, ellers vil lagring av data feile. I JSON defineres en repeterende gruppe som en array/liste med objekter (hvor hvert objekt representerer en rad i en repeterende gruppe). I XML defineres en repetrende gruppe som en liste med elementer (hvor hvert element er en gruppe med egenskaper, gjengitt som en rad i en repeterende gruppe).