Arkiv Integrasjon
Forutsetning: GI-Arkiv
Innbyggerdialog arkiverer via GI-Arkiv. Se GI-Arkiv for hva Geodata trenger (endepunkter for GI-Arkiv Innsyn og GI-Arkiv Oppdatering, og pålogging) og hvilke IP-adresser som må åpnes i brannmuren.
Arkiv-konfigurasjon
For å kunne lagre innspill til arkiv må vi gjøre en rekke tilpasninger av standard Innbyggerdialog.
Feature Layer: Innbyggerdialog3D
Eier
Featurelayeret må eies av Origo administrator-bruker.
Saksnummer
For å kunne lagre innspillene på korrekt Sak i Arkivet legger vi til et felt ved navn saksNummer på laget Innbyggerdialog3D. Her er stor og liten bokstav viktig!
- Naviger til laget
- Naviger til Data-fanen
- Bytt til Felter på øvre del av skjermens høyreside
- Klikk Legg Til på øvre del av skjermens venstreside
Her er det viktig å sette Default Value til den saksnøkkelen (saksnummeret) som innspillene skal opprette journalposter på.
Innstillinger/Settings
Vi må huka av for "Keep track of created and updated features." under innstillinger/settings.
Feature Layer: Innbyggerdialog3D (visning)
På visningslaget er det nødvendig å legge inn filteret Status=Public.
- Naviger til Innstillingene for laget.
- Trykk på knappen "Oppdater visning"
På den nye siden, gjør følgende:
Web Mapping Application
Tilpasninger
Wep Mapping Application ved navn Innbyggerdialog 3D (demo) må tilpasses
Arkiv-krav
For å integrere mot Arkiv er det krav om å inkludere navn, adresse og telefonnr. Dette for å kunne opprette en avsender i Arkivet.
WebHook
WebHook brukes for å sende godkjente innspill til Arkivet. Manøvrer til fanen "Innstillinger" under Feature Layeret ved navn Innbyggerdialog3D
Scroll ned til du ser seksjonen Webhooks og trykk Opprett webhook
Du vil nå se feltene som må fylles inn
Fyll inn følgende verdier:
- Navn må få et meningsbærende, unikt, navn
- Arrangementer skal være FeaturesCreated,FeaturesUpdated,AttachmentsCreated
- Webhookens mottaker-URL skal være https://webhook.kommunegis.no/geointegrasjon/{kommuneNavn}
- kommuneNavn har følgende skrivemåte
- bare små bokstaver
- æ ø å skrives som ae oe aa
- skrives som ett ord, uten mellomrom (bindestrek og mellomrom sløyfes/hoppes over)
- kommuneNavn har følgende skrivemåte
- Hvis Hemmelighet settes må denne kommuniseres til Geodata
Pass på at webhooken er aktiv
Ruting til eByggeSak-arkiv
Kunder som har et eByggeSak-arkiv ved siden av sitt primære arkiv, kan rute innspill dit ved å legge til ?archive=ebyggesak i webhook-URL-en. Per i dag er ebyggesak den eneste støttede verdien.
Standard URL (primært arkiv):
https://webhook.kommunegis.no/geointegrasjon/KUNDENAVN
URL som ruter til eByggeSak-arkivet:
https://webhook.kommunegis.no/geointegrasjon/KUNDENAVN?archive=ebyggesak
Parameteret er valgfritt. Hvis det utelates, brukes det primære arkivet. eByggeSak-arkivet må klargjøres av Geodata før dere kan bruke parameteret. Ta kontakt med oss hvis dere har behov for ruting til andre arkiver.
Bruk
Etter innspill kommer inn må det foretas et redaksjonelt steg der innspillet godkjennes manuelt. Dette gjøres ved å åpne Feature-Layeret ved navn Innbyggerdialog3D og navigere til Data:
For å godkjenne og lagre et innspill må vi finne feltet Status og sette dette til Public:
Dette vil trigge et kall til Arkivet. Dette kan ta ca ett minutt.