Interface to building application

GeoIntegrasjon Interface to building application GeoIntegrasjon Standardized electronic interaction for geo-related administrative procedures between case, archives, maps, technical systems, land register and plan records within the municipal sector Versjon 1.0 03.05.2011 Version 1.0 1

Revision history Version Produced by 0.97 27.12.2010 - Tor Kjetil Nilsen, Arkitektum AS og Lars Eggan, Norconsult AS 1.0 03.05.2011 - Tor Kjetil Nilsen, Arkitektum AS Change Initial version Oppdatert figurer for PIM\Applikasjonsskjema ihht GI versjon 1.0 Version 1.0 2

Table of Contents Revision history... 2 Table of Contents... 3 1 Introduction... 4 1.1 Use cases... 5 1.2 Platform Independent Model for Application Forms... 9 1.3 Service Registry... 16 1.4 Mapping... 17 Version 1.0 3

1 Introduction This is a proposal for services based on GeoIntegrasjon for Byggsøk. Version 1.0 4

1.1 Use cases Byggsøk - (Use Case diagram) Endret: 23.12.2010 Task: Fill ByggSøk form with assistance from the map The task is broken down into the following functions and services: 1. The applicant starts by registering gnr and bnr for the property 2. link: VisEiendom (hint=skjemautfylling&søknadsid=xx1234567&retururl=http://www.be.no/... ) Views the property in a map and prepares for the form dialogue. 3. webservice: HentNaboer(søknadsid) Retrieve neighbours that have already been defined in the form. 4. webservice: HentPlaner(søknadsid) Retrieves plans that have already been defined in the form. 5. webservice: HentEiendomsinformasjon(søknadsid) Retrieves property information that have already been defined in the form. 6. The map collects available information about neighbours, plans and real estate information. 7. webservice: OppdaterPlaner(søknadsid, planer) Updating application with plans. Replaces existing information. 8. webservice: OppdaterNaboer(søknadsid, naboer) Updating application with neighbours. Replaces existing information. 9. webservice: OppdaterEiendomsinformasjon(søknadsid, eiendomsinformasjon) Updating application with real estate information. Replaces existing information. 10. Link: Open retururl 11. Fill in the rest of the application. 12. Send application 13. webservice: NySøknad(skjemainfo, innhold) Submitting an application to the municipality and receives an ID in return as a receipt. Version 1.0 5

Figur: 1 Version 1.0 6

Byggsøk med matrikkel - (Use Case diagram) Endret: 23.12.2010 Task: Fill ByggSøk form with assistance from the map Alternative to the simple use case (from item 3 is the same as use case "Byggsøk"). The task is broken down into the following functions and services: 1. The applicant starts by registering gnr and bnr for the property 2. Clicking on "Next" starts collecting information. 2.1 webservice: FinnNaboer(matrikkelnummer) Retrieves neighbours from the "sentral matrikkel" and fills the form automatically. 2.2 webservice: HentMatrikkelenhet(matrikkelnummer) Retrieves real estate information from the "sentral matrikkel" and fills the form automatically. 2.3 webservice: FinnPlanerForMatrikkelenhet(matrikkelnummer) Retrieves plans from the municipality planning register and fills the form automatically. 3. link: VisEiendom (hint=skjemautfylling&søknadsid=xx1234567&retururl=http://www.be.no/... ) Views the property in a map and prepares for the form dialogue. 4. webservice: HentNaboer(søknadsid) Retrieve neighbours that have already been defined in the form. 5. webservice: HentPlaner(søknadsid) Retrieves plans that have already been defined in the form. 6. webservice: HentEiendomsinformasjon(søknadsid) Retrieves property information that have already been defined in the form. 7. The map collects available information about neighbours, plans and real estate information. 8. webservice: OppdaterPlaner(søknadsid, planer) Updating application with plans. Replaces existing information. 9. webservice: OppdaterNaboer(søknadsid, naboer) Updating application with neighbours. Replaces existing information. 10. webservice: OppdaterEiendomsinformasjon(søknadsid, eiendomsinformasjon) Updating application with real estate information. Replaces existing information. 11. Link: Open retururl 12. Fill in the rest of the application. 13. Send application 14. webservice: NySøknad(skjemainfo, innhold) Submitting an application to the municipality and receives an ID in return as a receipt. Version 1.0 7

Figur: 2 Version 1.0 8

1.2 Platform Independent Model for Application Forms Version 1.0 9

1.2.1 ApplicationSchema Eiendomsinformasjon - (Logical diagram) Filling of property information in the form class Eiendomsinformasjon Byggesak::Eiendomsopplysninger + matrikkelnr: Matrikkelnummer + adresse: Adresse [0..1] + bygningsnr: ByggIdent [0..1] + bolignummer: string [0..1] + andrematrikkelnr: string [0..1] Basis::Adresse + postnr: string [0..1] + poststed: string [0..1] + representasjonspunkt: Representasjonspunkt [0..1] «datatype» Felles::Matrikkelnummer {root,leaf} + kommunenummer: String + gårdsnummer: Integer + bruksnummer: Integer + festenummer: Integer [0..1] + seksjonsnummer: Integer [0..1] «datatype» Felles::ByggIdent + bygningsnummer: Integer + endringsløpenummer: Integer [0..1] Basis::Matrikkeladresse + matrikkeladresseident: MatrikkeladresseIdent AdresseIdent «datatype» Basis::MatrikkeladresseIdent + matrikkelnummer: Matrikkelnummer + undernummer: Integer [0..1] Basis::Vegadresse + vegadresseident: VegadresseIdent AdresseIdent «datatype» Basis::VegadresseIdent + kommunenummer: String + adressenavn: String + nummer: Integer + bokstav: String [0..1] Figur: 1 Version 1.0 10

Naboliste - (Logical diagram) Neighbour List structure used by GI Map. Enhanced with the property address and a new ownership structure. class Naboliste Basis::Naboer 1 0..* Basis::Hov edeiendom Basis::Nabo 0..* + eier: Eier + eiendommensadresse: Adresse [0..1] «datatype» Felles::Matrikkelnummer {root,leaf} + kommunenummer: String + gårdsnummer: Integer + bruksnummer: Integer + festenummer: Integer [0..1] + seksjonsnummer: Integer [0..1] Basis::Eiendom + matrikkelnummer: Matrikkelnummer Basis::Eier + eierforhold: EierforholdKode [0..1] + andel: Andel [0..1] Basis::MatrikkelEier + matrikkelnummer: Matrikkelnummer Basis::KontaktEier + kontakt: Kontakt Adresse::EnkelAdresse + adressetype: EnkelAdressetype + adresselinje1: string [0..1] + adresselinje2: string [0..1] + postadresse: PostadministrativeOmraader [0..1] + landkode: Landkode [0..1] +adresser 0..* Kontakt::Kontakt + navn: string Kontakt::Organisasjon + organisasjonsnummer: String [0..1] Kontakt::Person + personid: Personidentifikator [0..1] + etternavn: string [0..1] + fornavn: string [0..1] Figur: 2 Version 1.0 11

Plan - (Logical diagram) Plan Information that can be filled in a form solution. Enhanced with land use(arealbruk) and a structure for the Plan Information(Planopplysninger) that is suitable for the use case. class Plan Byggesak::Planopplysninger + plan: Arealplan + formål: string + utnyttingsgrad: decimal + andrerelevantekrav: string +relatertmatrikkelnr 0..1 «datatype» Felles::Matrikkelnummer {root,leaf} + kommunenummer: String + gårdsnummer: Integer + bruksnummer: Integer + festenummer: Integer [0..1] + seksjonsnummer: Integer [0..1] Utv idet::arealplan + arealplannøkkel: ArealplanBase + planbestemmelse: Planbestemmelse + lovreferanse: Lovreferanse + lovreferansebeskrivelse: string [0..1] + opprinneligplanid: string [0..1] + opprinneligadministrativenhet: Integer [0..1] + forslagsstiller: Forslagsstiller [0..1] «datatype» Basis::ArealplanBase + arealplanid: NasjonalArealplanId + plannavn: string + plantype: Plantype + planstatus: Planstatus + vedtaksdato: Date [0..1] +arealbruk 0..* Utv idet::arealbruk + utnytting: Utnytting «datatype» Utv idet::utnytting + utnyttingstype: Utnyttingstype + utnyttingstall: Integer [0..1] «GIkodeliste» Utv idet:: Utnyttingstype Kodeliste::Kode {root} + kodeverdi: String + kodebeskrivelse: String [0..1] + ergyldig: Boolean [0..1] Figur: 3 Version 1.0 12

Vedlegg - (Logical diagram) Endret: 22.12.2010 GI Archive and document package is used for transmission of the document. class Vedlegg Dokument::Dokument + systemid: string [0..1] + dokumentnummer: string [0..1] + tilknyttetregistreringsom: TilknyttetRegistreringSom [0..1] + dokumenttype: Dokumenttype [0..1] + tittel: string [0..1] + dokumentstatus: Dokumentstatus [0..1] + variantformat: Variantformat [0..1] + format: Format [0..1] + referansejournalpostsystemid: string [0..1] 0..1 Dokument::Fil + filnavn: string + mimetype: string Fra GI Arkiv Filinnhold brukes for små filer, og Filereferanse kan brukes for store filer Dokument::Filinnhold + base64: base64binary Dokument::Filreferanse + uri: anyuri + kvitteringuri: anyuri [0..1] Figur: 4 Version 1.0 13

1.2.2 Service interface Tjenesteskjema - (Logical diagram) Endret: 23.12.2010 New services for buildingcase application. Figur: 5 1.2.2.1 Byggesak Operasjoner Method Comment Parameters HentNaboer() Returnerer: Naboer Array: False Retrieves the list of neighbors from the designated søknadsid søknadsid (som string) HentPlaner() Returnerer: Planopplysninger Array: True Retrieves the list of plans from the designated søknadsid søknadsid (som string) HentEiendomsopplysning er() Retrieves real estate information from the designated søknadsid søknadsid (som string) Version 1.0 14

Method Comment Parameters Returnerer: Eiendomsopplysninger Array: False OppdaterNaboer() Returnerer: void Array: False Replaces the neighboring list at the specified søknadsid naboliste (som Naboer) søknadsid (som string) OppdaterPlaner() Returnerer: void Array: False Replaces the plan information at the specified søknadsid planer (som Planopplysninger) søknadsid (som string) OppdaterEiendomsopply sninger() Returnerer: void Array: False Replaces the real estate information at the specified søknadsid eiendomsinfo (som Eiendomsopplysninger) søknadsid (som string) NyttVedlegg() Returnerer: void Array: False Uploading new attachment / document / file to the specified søknadsid dokument (som Dokument) søknadsid (som string) Version 1.0 15

1.3 Service Registry Overview of the versions of services (wsdl files) and schema (xsd files). http://rep.geointegrasjon.no/skjema/byggesak/xml.wsdl/2011.02.18/giskjemabyggesak20110218.wsdl http://rep.geointegrasjon.no/skjema/byggesak/xml.schema/2011.02.18/giskjemabyggesak20110218.xsd http://rep.geointegrasjon.no/arkiv/dokument/xml.schema/2011.02.18/giarkivdokument20110218.xsd http://rep.geointegrasjon.no/felles/teknisk/xml.schema/2011.02.18/gifellesteknisk20110218.xsd http://rep.geointegrasjon.no/kart/basis/xml.schema/2011.02.18/gikartbasis20110218.xsd Version 1.0 16

1.4 Mapping Overview of the mapping of fields. Main menu Menu level 2 Data field name GeoIntegrasjon XML tag mapping Eiendom/B Eiendomsop yggested plysninger Kommunenummer Eiendomsopplysninger/matrikkelnr/kommunenr Gårdsnummer Eiendomsopplysninger/matrikkelnr/gaardsnummer Bruksnummer Andre Gnr/Bnr Eiendomsopplysninger/matrikkelnr/bruksnummer Eiendomsopplysninger/andreMatrikkelnr Rammebetin gelser Planstatus Festenummer Seksjonsnummer Adresse Postnummer Poststed Bygningsnummer Bolignummer Plantype Planens navn Reguleringsformål i arealdel av kommuneplan/reguleringspl an/bebyggelsesplan - beskriv Andre relevante krav (kommunale vedtekter o.l.) Beregningsregel grad av utnytting iht. gjeldende plan: Grad av utnytting iht. Gjeldende plan: Parter Nabo Velg partstype Navn Adresse Postnummer Poststed Eiendommens adresse Poststed Postnummer Eiendomsopplysninger/matrikkelnr/festenummer Eiendomsopplysninger/matrikkelnr/seksjonsnummer Eiendomsopplysninger/adresse/(Vegadresse)/adressenavn + nummer + bokstav eller /(Matrikkeladresse)/gaardsnummer + bruksnummer + festenummer + undernummer Eiendomsopplysninger/adresse/postnr Eiendomsopplysninger/adresse/poststed Eiendomsopplysninger/bygningsnr/bygningsNummer Eiendomsopplysninger/bolignummer Planopplysninger/plan/arealplanNoekkel/plantype/kodeverdi Planopplysninger/plan/ arealplannoekkel/plannavn Planopplysninger/formaal Planopplysninger/andreRelevanteKrav Planopplysninger/plan/Arealbruk/utnyttingstype/kodeverdi Planopplysninger/utnyttelsesgrad Naboliste/Nabo/eier/(kontakt eller matrikkelnummer)/navn (en eiendom kan eie en annen eiendom) Naboliste/Nabo/eier/kontakt/adresser/adresselinje1 Naboliste/Nabo/eier/kontakt/adresser/postadresse/postnum mer Naboliste/Nabo/eier/kontakt/adresser/postadresse/poststed Naboliste/Nabo/eiendommensadresse/(Vegadresse)/adresse navn + nummer + bokstav eller /(Matrikkeladresse)/gaardsnummer + bruksnummer + festenummer + undernummer Naboliste/Nabo/eiendommensadresse/postnummer Naboliste/Nabo/eiendommensadresse/poststed Version 1.0 17

Vedlegg Kommune Gårdsnummer Bruksnummer Festenummer Seksjonsnummer Bolignummer Type Gruppe Beskrivelse av vedlegg Plassering Naboliste/Nabo/matrikkelNummer/kommunenummer Naboliste/Nabo/matrikkelNummer/gaardsnummer Naboliste/Nabo/matrikkelNummer/bruksnummer Naboliste/Nabo/matrikkelNummer/festenummer Naboliste/Nabo/matrikkelNummer/seksjonsnummer Dokument/dokumenttype/kodeverdi Dokument/tittel Version 1.0 18