Blogg fra september, 2024

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:

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

• Søknad om igangsettingstillatelse

• Søknad om midlertidig brukstillatelse

• Søknad om ferdigattest

• Supplering av søknad

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.

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.