Web services i Nireg

Transkript

1 Web services i Nireg

2 Direktoratet for byggkvalitet Side: 2 av 12 Innhold 1 LØFTEINNRETNINGER Create Update GetById FindByBygning FindByKommune FindByLeverandor FindBySertifikat FindByFabrnr: KONTROLLER Create GetById GetLatestByNinr FindUninspectedByKommune FindUninspectedByKommuner EIENDOMMER Create Delete FindByOrganisasjon Get APPLIKASJONSOVERSIKT... 12

3 Direktoratet for byggkvalitet Side: 3 av 12 Oversikt Metoder som anvendes via web services Metoder Løfteinnretninger Create Ny løfteinnretning, en eller flere. GetById Hent løfteinnretning basert på et unikt Ninr. FindByBygning Hent løfteinnretninger basert på et unikt bygningsnummer. FindByKommune Hent alle løfteinnretninger i en kommune. FindByLeverandor Hent alle løfteinnretninger levert av en spesifikk leverandør. FindBySertifikat Hent løfteinnretning basert på et sertifikatnummer. FindByFabrnr Hent løfteinnretning basert på et fabrikasjonsnummer. Close Marker en løfteinnretning som stengt. Update Oppdatering av løfteinnretninger. Kontroller Create Ny kontroll, en eller flere. GetById Hent en kontroll basert på en unik Id. GetLatestByNinr Hent siste kontroll utført på en løfteinnretning. FindUninspectedByKommune Hent løfteinnretninger som ikke har blitt kontrollert innen sitt kontrollintervall, i en gitt kommune. FindUninspectedByKommuner Hent løfteinnretninger som ikke har blitt kontrollert innen sitt kontrollintervall, i en eller flere kommuner. Eiendom Create Legg til en ny eiendom i Nireg. Delete Slett en eiendom fra Nireg. FindByOrganisasjon Hent eiendomsinformasjon for en organisasjon. Get Hent en eiendom basert på gårds- og bruksnummer. Kontrollør, kontrolltype og kontrollintervall er tilleggsinformasjon som skal kunne vises for å kunne registrere respektive objekt.

4 Direktoratet for byggkvalitet Side: 4 av 12 1 Løfteinnretninger All auditinformasjon som RegistrertDato, RegistrertAv, EndretData, EndretAv og Vises, registreres ved alle add og update. Ninr LofteinnretningType (FK) Fabrikasjonsnummer Bygningsnummer ByggeAr OmbygningsAr Sertifikatnummer RegistrertDato RegistrertAv EndretDato EndretAv Leverandor KontrollIntervall Skonr Unik identifisering av en Lofteinnretning, genereres av Nireg. Type Lofteinnretning. Installatørens serienummer for løfteinnretningen Unik id av Bygning i Matrikkelen. Byggeår (fire siffer) Ombygningsår (fire siffer) Registreres av TKO, ikke obligatorisk. Dato for førstegangsregistrering. Hvem som registrerte (innlogget bruker). Dato for endring. Hvem som endret (innlogget bruker). Organisajonsnummer till leverandør/heisfirma som har installert løfteinnretningen. Kontrollintervall for periodisk kontroll (24 måneder). ID til sikkerhetskontrollorganet som utførte kontrollen. 1.1 Create Parametere: LofteinnretningTypeId Bygningsnummer Fabrikasjonsnummer ByggeAr OmbygningsAr Sertifikatnummer Leverandor KontrollIntervall Skonr Lofteinnretning Løfteinnretningen som ble registrert.

5 Direktoratet for byggkvalitet Side: 5 av Update Oppdatering av en løfteinnretning (bruker må ha rolle som TKO eller administrator). Tomme/blanke verdier fjerner eksisterende verdier, uspesifiserte verdier ignoreres. Parametere: Ninr LofteinnretningTypeId Bygningsnummer Fabrikasjonsnummer ByggeAr OmbygningsAr Sertifikatnummer Leverandor KontrollIntervall Skonr GetById Gir tilbake en løfteinnretning med gitt Ninr hvis den finnes i Nireg. Ninr Lofteinnretning Løfteinnretninger med gitt Ninr. 1.4 FindByBygning Alle bygg i matrikkelen har et unikt bygningsnummer for å identifisere dem, i tillegg til gårds- og bruksnummer. Ved å oppgi et bygningsnummer vil denne metoden gi tilbake et array av alle løfteinnretninger som er tilknyttet denne bygningen. Bygningsnummer

6 Direktoratet for byggkvalitet Side: 6 av 12 Lofteinnretning[ ] Løfteinnretninger med gitt Bygningsnummer. 1.5 FindByKommune Gir tilbake alle løfteinnretninger som ligger i gitt kommune Kommunenummer Lofteinnretning Løfteinnretninger i gitt kommune. 1.6 FindByLeverandor Gir tilbake alle løfteinnretninger som er levert av en leverandør. Parameteret er den aktuelle leverandørens organisasjonsnummer, lagret i Brønnøysundregistret. Organisasjonsnummer Lofteinnretning Løfteinnretninger med gitt leverandør. 1.7 FindBySertifikat Gir tilbake en løfteinnretning med gitt sertifikatnummer. Sertifikatnummer Lofteinnretning Løfteinnretninger med gitt sertifikatnummer.

7 Direktoratet for byggkvalitet Side: 7 av FindByFabrnr: Gir tilbake en løfteinnretning med gitt fabrikasjonsnummer. Fabrikasjonsnummer Lofteinnretning Beskrivning Løfteinnretninger med gitt fabrikasjonsnummer.

8 Direktoratet for byggkvalitet Side: 8 av 12 2 Kontroller Ninr KontrollType (FK) Kontrollor KontrollertDato DatoRegistrert RegistrertAv DatoEndret Tidsfrist Status Unik identifisering av en Lofteinnretningen kontrollen er utført på. Type Kontroll. Knr til kontrollør, ikke obligatorisk. Dato da kontrollen ble utført. Dato da kontrollen ble registrert. Brukeren som registrerte kontrollen. Dato kontrollen ble endret. Frist for utbedring av eventuelle anmerkninger under kontroll. Status for kontrollen. 2.1 Create Legger til en ny kontroll. Parametere: Ninr KontrollType (FK) KontrollorID DatoKontrollert Kontroll Unik identifisering av en Lofteinnretningen kontrollen er utført på. Type Kontroll. Knr til kontrollør, ikke obligatorisk. Dato da kontrollen ble utført. Kontrollen som ble opprettet. 2.2 GetById Hent en kontroll basert på den unike Id- en til kontrollen. Id Kontroll Kontroll tilhørende den unike Id-en.

9 Direktoratet for byggkvalitet Side: 9 av GetLatestByNinr Hent den siste kontrollen gjort på en løfteinnretning. Ninr Kontroll Den siste kontrollen gjort på en løfteinnretning 2.4 FindUninspectedByKommune Finn alle løfteinnretninger som ikke har blitt kontrollert innen det nødvendige tidsintervallet, for én kommune. KommuneNr KontrollStatus[ ] Ikke-kontrollerte løfteinnretninger i kommunen. 2.5 FindUninspectedByKommuner Finn alle løfteinnretninger som ikke har blitt kontrollert innen det nødvendige tidsintervallet, for én eller flere kommuner. KommuneNr[ ] KontrollStatus[ ] Beskrivning Ikke-kontrollerte løfteinnretninger i kommunen(e).

10 Direktoratet for byggkvalitet Side: 10 av 12 3 Eiendommer I enkelte tilfeller, for eksempel ved sameie, vil det være nødvendig å opprette en eiendom i Nireg sin database for å skape et korrekt eierforhold mot løfteinnretninger. I alle andre tilfeller vil eiendommer og eierskap sjekkes mot Matrikkelen. Orgnr Unik identifisering av en Organisasjon som er eier av eiendommen. Kommunenr Kommunenummeret eiendommen befinner seg i. Gardsnr Bruksnr Gårdsnummeret til eiendommen. Bruksnummeret til eiendommen. 3.1 Create Lag en ny eiendom i Nireg sin database. Parametere: Orgnr Kommunenr Gardsnr Bruksnr Eiendom Eiendommen som ble opprettet. 3.2 Delete Slett en eksisterende eiendom fra Nireg sin database. Eiendom Success Beskrivning Status på utført sletting av eiendom gis som true eller false.

11 Direktoratet for byggkvalitet Side: 11 av FindByOrganisasjon Hent ut eiendommer registrert på en gitt organisasjon. Orgnr Eiendom[ ] Alle eiendommer lagret i Nireg som er tilknyttet en organisasjon. 3.4 Get Hent en spesifikk eiendom basert på organisasjonsnummer, bruksnummer, gårdsnummer og kommunenummer. Parametere: Orgnr Kommunenr Bruksnr Gardsnr Eiendom Beskrivning Eiendom for en organisasjon med det gitte bruks-, gards- og kommunenummeret.

12 Direktoratet for byggkvalitet Side: 12 av 12 4 Applikasjonsoversikt Logisk gruppering av komponenter per funksjonalitet, presentasjon-, business- og datalag: Presentasjon: Brukerorientert-, grensesnittfunksjonalitet (aspx'er). Businesslag: Koblingslogikk for data, rettigheter for løfteinnretninger, kontroller m.m. Datalager: Access til data fra Nireg, Brreg og Matrikkelen. Vi maksimerer gjenbruk av koder gjennom å bruke businesslaget. Per i dag er det ikke behov for å innføre et rent service- lager ettersom det bare skal eksponeres deler av funksjonaliteten gjennom web services.