Altinn3: Fjerning av "underskjema" fra datamodellene

De nye datamodellene blir tatt i bruk i testmiljøet mandag 09.09.2024 kl. 12:00

Sep 9, 2024 kl. 13:45: Testmiljøet er nå oppdatert med nye datamodeller.

I Altinn 3 skilles det ikke mellom underskjema og vedlegg. Vi derfor gjort noen endringer i datamodellene. Som følge av endringene har vi også oppdatert valideringsregler og kodelister.

Endring i datamodeller

underskjema-objektet er fjernet fra datamodellene som har utfallBesvarelse og ettersending. Skjemaene som tidligere ble referert fra underskjema-lista, skal nå føres opp i objektet for vedleggsliste:

Eksempel på endring for utfallBesvarelse

Endringen påvirker følgende søknader på Altinn 3:

Tjenestene som er i drift i dag blir ikke påvirket av endringene.

Infrastrukturen skal allerede nå håndtere at man flytter tidligere underskjema til vedleggslisten. Nye xsd-er er lagt ut på dokumentasjonssidene for IG, MB og FA. Man kan imidlertid ikke ta disse i bruk før infrastrukturen er oppdatert med de nye datamodellene. XML-ene man sender inn må altså ha “3.0” som verdi i “dataFormatVersion”-attributtet frem til det eksplisitt gis beskjed om at versjon 4 er klar for å tas i bruk.

Endring i valideringstjenesten

Siden de nevnte datamodellene ikke lenger skiller mellom underskjema og vedlegg, vil vi heller ikke lenger bruke SubForms-objektet i valideringstjenesten. Dette innbærer at man må endre request-bodyen som sendes til api/validation. Se eksempel under:
Før:

"authenticatedSubmitter": "12345678910",
"formData": "<xml-innholdet-ligger-her>",
"subForms": {
  "formName": "Gjennomfoeringsplan",
  "subFormData": "<innhold-i-underskjema>"
},
"attachments": [
  {
    "attachmentTypeName": "Annet",
    "filename": "Annet.pdf",
    "fileSize": 112054
  }
]

Nå:

"authenticatedSubmitter": "12345678910",
"formData": "<xml-innholdet-ligger-her>",
"attachments": [
  {
    "attachmentTypeName": "Gjennomfoeringsplan",
    "filename": "Gjennomføringsplan.xml",
    "fileSize": 12054
  },
  {
    "attachmentTypeName": "Annet",
    "filename": "Annet.pdf",
    "fileSize": 112054
  }
]

Endring i valideringsregler

I og med at underskjema nå skal listes opp sammen med andre vedlegg i vedleggsliste, får underskjema nå samme validering som andre vedlegg. Der utfall skal besvares med vedlegg, er det obligatorisk å gi informasjon om filnavn og vedleggstype fra kodelista på GeoNorge. For noen vedleggstyper gir vi også en advarsel dersom tegnings-/versjonsnummer og -dato ikke er sendt med.

Regelnumrene for IG, MB og FA vil også endres.

Endring i kodelister

På sikt vil vi fase ut kodelista som gir oversikt over Underskjema: https://register.geonorge.no/kodelister/byggesoknad/vedlegg-og-underskjema/underskjema

For å gjøre klart for endringene, har vi gjort noen endringer i kodelista for vedlegg.

Underskjema	Endringer i kodeliste for vedlegg

Underskjema	Endringer i kodeliste for vedlegg
Erklæring om ansvarsrett	Finnes allerede i lista over vedlegg - Erklæring om ansvarsrett
Gjennomføringsplan	Finnes allerede i lista over vedlegg - Gjennomføringsplan. Beskrivelsen er oppdatert slik at det passer bedre med ny versjon.
Gjenpart nabovarsel	Laget ny kode med status “utkast” i gruppe C - Gjenpart av nabovarsel
Matrikkelopplysninger	Laget ny kode med status “utkast” i gruppe H - Matrikkelopplysninger
Sluttrapport for bygningsavfall	Finnes allerede i lista over vedlegg - Sluttrapport for bygningsavfall
Søknad om ansvarsrett for selvbygger	Ikke i bruk som underskjema i dag - Vi gjør ingen endringer
Søknad om Arbeidstilsynets samtykke	Ikke i bruk som underskjema i dag - Vi gjør ingen endringer
Vedleggsopplysninger	Avvikles i Altinn 3 - Vi gjør ingen endringer

PDF-visning

Begrepet “underskjema” brukes ikke i PDF-ene i dag og blir derfor ikke påvirket av endringen.

Hva må endres i XML-ene når endringen er ute i testmiljøet?

Følgende attributter i XMLens rot-element må oppdateres:
- dataFormatVersion="4"
- xmlns="https://skjema.ft.dibk.no/<TJENESTENAVN>/v4"
- xsi:schemaLocation="https://skjema.ft.dibk.no/<TJENESTENAVN>/v4 <TJENESTENAVN>.xsd"
  - <TJENESTENAVN> må erstattes med
    - igangsettingstillatelse
    - midlertidigbrukstillatelse
    - ferdigattest
- Eksempel
  - Før:
  - Etter:
Dersom det tidligere ble lagt informasjon under <underskjema>-objektet må dette konverteres til <vedlegg>-objekt og legges under <vedleggsliste>-objektet.
- Eksempel:
  - Før:
  - Etter:

`https://skjema.ft.dibk.no` virker ikke..?

Denne tjenesten er under arbeid. Skjema for altinn3-tjenestene vil etterhvert tilgjengeliggjøres herfra.