GI-Link/Kart
GI-Kart brukes sammen med LINK pakken for at sak/arkivsystemet skal kunne hente ut informasjon som naboer, område og punkter fra kartsystemet. GI-LINK kall kan gjøres mot både Innsyns saksbehandler (krever pålogging) og Innsyn publikum.
Arbeidsflyten består av to faser:
- LINK (alt starter da i sak/arkivsystemet så overføres kontrollen til Innsyn saksbehandler appen og så går kontrollen tilbake til sak/arkivsystemet)
- KartBasis (sak/arkivsystemet henter ved hjelp av KartBasis-endepunktet resultater som er lagret i fase 1 i form av SOAP XML-format)
LINK-delen av arbeidsflyten
Arbeidsflyten da kan være som følgende:
- Det velges et objekt (f.eks. adresse, matrikkelenhet, plan eller bygning) i sak/arkivsystemet
- Så trykkes det på "Hent naboer", "Hent partsliste", "Hent naboliste", "Hent område" eller "Hent punkt" knappen i sak/arkivsystemet
- Sak/arkivsystemet lager da tilsvarende lenke til Innsyn saksbehandler applikasjon og åpner den.
Lenken inneholder da typisk instruksjon i form av funksjon som kan være visAdresse, visEiendom, visBygning eller visPlan samt med informasjon for at Innsynsaksbehandler appen skal kunne finne søkeobjektet (f.eks adresse, matrikkelnummer, bygningsnummer osv) og eventuelt et valgfritt hint som tilsier hva som skal gjøres (lagNaboliste, lagOmraade eller lagPunkt)
Eksempel:
https://lillestroem.kommunegis.no/saksbehandler?funksjon=VisEiendom&kommunenummer=0301&gaardsnummer=214&bruksnummer=347&festenummer=0&seksjonsnummer=0&hint=lagnaboliste&sesjon=abc0937632935&link2=http://www.geodata.no
For at dette skal kunne fungere må sak/arkivsystemet konfigureres.
Eksempel på innstillinger i ACOS:
-
Innsyn saksbehandler applikasjon i sin tur gjennomfører søket i henhold til angitt funksjon og dens parametere og så zoomer til og markerer funnet objekt i kartet
-
Hvis hint parameter er angitt så vises det tilsvarende panel hvor man kan justere naboliste eller partsliste eller lage punkt/område i kartet:
-
Etter det kan man trykke på "Lagre" knapp så skal partsliste, naboliste, punkt eller område bli lagret for å bli etterpå hentet av sak/arkivsystemet ved bruk av sesjonsid parameter som nøkkel. Det finnes også en mulighet å laste ned partsliste eller naboliste som csv-fil ved å trykke på "Last ned (.csv)" knapp som kan være nyttig i noen tilfeller.
-
Siste steg skal være å avslutte prosessen med å trykke på "Avslutt" knappen. Innsyn saksbehandler applikasjon skal da, hvis verdien for link2 parameter er angitt, overføre kontrollen tilbake til sak/arkivsystemet ved å åpne lenken fra link2
GI-LINK kall som støttes av Innsyn saksbehandler
Syntaks
https://<kommune>.kommunegis.no/saksbehandler?funksjon=<funksjon>&<funksjon-parametere>&[hint=<hint>&sesjon=<sesjonsid>][&link2=<url>]
- kommune, kommunen hvor GI-kallet gjøres mot
- hint (valgfri)
- lagPunkt
- lagOmråde
- lagNaboliste (krever medlemskap i AGOL gruppen EierBegrenset eller EierPerson)
- lagPartsliste (krever medlemskap i AGOL gruppen EierBegrenset eller EierPerson)
- sesjon er påkrevd kun hvis hint er angitt og må være unik nok for å identifisere lagrede resultater (f.eks guid)
- link2 er valgfri og kan inneholde url som da åpnes i ny fane når man klikker på "Avslutt" knappen i appen
Funksjoner
- visAdresse
- visBygning
- visEiendom
- visPlan
Funksjon-parametere:
- kommunenummer
- adressenavn
- nummer
- bokstav (valgfri)
Eksempler:
lagPunkt
lagOmråde
lagNaboliste
lagPartsliste
Funksjon-parametere:
- bygningsnummer
Eksempler:
lagPunkt
lagOmråde
lagNaboliste
lagPartsliste
Funksjon-parametere:
- kommunenummer
- gaardsnummer
- bruksnummer
- festenummer (valgfri)
- seksjonsnummer (valgfri)
lagPunkt
lagOmråde
lagNaboliste
lagPartsliste
Funksjon-parametere:
- planidentifikasjon
- kommunenummer (valgfri)
Eksempler:
lagPunkt
lagOmråde
lagNaboliste (støttes, men gir samme resultat som hentPartsliste)
lagPartsliste
GI-Link kall som støttes av Innsyn publikum
Syntaks
https://<kommune>.kommunegis.no?funksjon=<funksjon>&<funksjon-parametere>
Funksjoner
- visAdresse
- visBygning
- visEiendom
- visPlan
Funksjon-parametere:
- kommunenummer
- adressenavn
- nummer
- bokstav (valgfri)
Eksempler:
Funksjon-parametere:
- bygningsnummer
Eksempler:
Funksjon-parametere:
- kommunenummer
- gaardsnummer
- bruksnummer
- festenummer (valgfri)
- seksjonsnummer (valgfri)
Eksempler:
Funksjon-parametere:
- planidentifikasjon
- kommunenummer (valgfri)
Eksempler:
KartBasis-delen av arbeidsflyten
Når sak/arkivsystemet får kontrollen tilbake skal det laste ned naboliste, område eller punkt ved hjelp av tilsvarende GeoIntegrasjon KartBasis kall og der skal det brukes samme sesjonsid som ble brukt i LINK-delen av prosessen.
For dette formålet brukes det KartBasis url https://nt.geodataonline.no/geointegrasjon/KartBasisService.svc
URL'en må angis i innstillinger til sak/arkivsystemet. Overnevnt endepunkt støtter følgende metoder av GeoIntegrasjon kartbasisgrensesnitt:
- HentNaboliste (både part- og naboliste hentes ved hjelp av denne metoden. Hvis brukeren ikke er medlem av ArcGIS Online gruppen EierPerson, hentes disse med personnummer med kun fødselsdato, eksempel 160192xxxxx)
- HentOmråde
- HentPunkt
Siden partsliste og naboliste kan inneholde sensitiv informasjon (personnumre, eiernavn osv) er tilgangen til KartBasis-endepunktet begrenset med ip-adresse filtrering (det brukes liste-av-tillatte ip-adresser og alle ip-adresser som ikke står på den listen blokkeres med 403 Forbidden):
For å få tilgang må ip-adresse(r) av server(e) sendes til Geodata.
Styring av DOK-lag
Synliget på overordnet DOK-temalag kan syres med et eget URL-parameter activateDokThemes og kan legges til i URL med en kommaseparert liste (komma må være url encodet, altså %2C) av dok-tema som ønskes vist. DOK-tema kan hentes fra lag-liste i Innsyn-klient:
Eksempel: