Utvikling med Fellestjenester Bygg
...
En implementation for test er tilgjengelig på https://fellesbygg.dibk.no/.
Gjennom Altinn må API nøkler, domene whitelisting og testbrukere bestilles før test motoren kan brukes.
Nettsiden ser ut som figuren under:
...
Blankett: Dette er blankett nummeret brukt i DiBK. En oversikt over papir blanketter finnes her: https://dibk.no/no/byggeregler/Byggesoknader/Byggesaksblanketter/
Service Code: Dette er koden for skjema innsendelsen i Altinn. Det er også definert en "service edition code" for hvilken versjon av utgaven/innsendelsen som skal brukes.
Datamodell: nettsiden gir direkte tilgang til XSD filen for de forskjellige skjemaene.
Metadata: vedlegg og annen informasjon om innsendelsen
Dokumentasjon: dette gir tilgang om mer informasjon om de individuelle skjemaene
Innsending (test): Klikk på "Logg inn" for å få tilgang til test XML data basert på skjema XSDene
Det følgende er ett eksempel fra skjemaet "Erklæring om ansvarsrett".
...
Test prosjektet er satt opp på Altinn sitt TT02 test området. Her brukes innlogging og data om fiktive personer. Etter å ha klikket på "Logg inn" lenken, kommer man til ID-porten for innlogging med sin tildelte test person. Vanligvis brukes innlogging type "MinID".
...
Innlogging skjer i ID-porten med redirect tilbake til fellesbygg.dibk.no
TODO: legg inn eksempel på dette
Innsendingskjema
Figuren nedenfor viser test versjonen av skjema innsendelsen. Det har blitt klikket på Erklæring om Ansvarsrett, og en XML med eksempel data basert på ansvarsrettxxx.xsd modellen har blitt generert. Address og kommune informasjon har blitt fylt ut med tilfeldig informasjon.
...
En spesialsydd søknadsløsing basert på Fellestjenester Bygg vil måtte generere en lignende XML, eller sett med XML skjema og vedlegg.
...
Søknaden kan generelt sendes inn på to måter: direkte signatur og arkivering. Dette betyr at søknaden er klar for innsending til kommunen. Det er også mulig å mellomlagre søknaden i Altinn, for enten å hentes ut igjen over API eller det er mulig å fullføre utfylling og innsending direkte i Altinn. Skjemaet kan således sendes direkte ved å klikke "Send inn og arkiver" eller for mellomlagring ved "Lagre til videre utfylling".
...
https://www.altinn.no/api/Help/Api/POST-who-Messages_language_complete_sign
|
...
|
...
|
Attachment seksjonen er valgfri.
Om mellomlagring er ønsket, blir /api/my/messages?complete=false flagget brukt.
Metadata om innsendelsen
Vedlegg informasjon er spesifisert i metadata for de forskjellige innsendelsen, tilgjengelig fra fellesbygg.dibk.no.
Det er viktig at eventuelle vedlegg følger definisjonen gitt i metadata. Her er et eksempel fra " Søknad om midlertidig brukstillatelse":
Metadata
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
Merk at attachment listen is API meldingen må følge formatet definert i metadata.
Metadata | Altinn API message |
|---|---|
{ | "attachments" : [{ |
AllowedFileTypes | FileName (må stemme) |
AttachmentTypeName | AttachmentType (må stemme) |
MaxAttachmentCount (max antall vedlegg av denne typen, 0 betyr ingen grense) | |
MinAttachmentCount (min antall vedlegg av denne typen, 0 at vedlegget er valgfritt) | |
MaxFileSize (fil vedlegg kan ikke være over 200MB) |