DANVA INFORMATIONSMODEL TV-INSPEKTION OG BRØNDRAPPORT 3.0

Transkript

1 DANVA INFORMATIONSMODEL TV-INSPEKTION OG BRØNDRAPPORT 3.0 Beskrivelse Version 1.4 November 2016 I

2 Udarbejdet af: Orbicon Informatik, Trine Schultz og Henrik Madsen Review: Lars Gadegaard Version: 1.4 Dato: 29. november 2016 Indholdsfortegnelse DANVA INFORMATIONSMODEL I 1 Indledning Formål Begreber, Relationer, Attributter og Kodelister Læsevejledning 7 2 Administrative begreber Referencesystem 8 3 Centrale logiske fælles begreber og referencer Rapport LedningHændelse KnudeHændelse LedningRapport 10 4 Operationelle begreber TV-inspektioner kørt efter Fotomanualen 2004 eller nyere DAS5TV-rapporter kørt efter fotomanualer fra før Brøndrapport kørt efter Brøndmanualen Brøndrapporter kørt efter Brøndmanualen 2005 eller før 16 5 Datasnitflader til Dandas TV-inspektioner Brøndrapport kørt efter Brøndmanualen Brøndrapporter kørt efter Brøndmanualen 2005 eller før 19 II

3 1 Indledning TV-inspektion og brøndrapport er et modul på DDV s OIO EA-reol (DDV-reolen), knyttet til Dandas, der igen er bygget på den fælles Kernemodel. 1.1 Formål Formålet med dette dokument er at dokumentere modulet TV-inspektion og brøndrapport 3.0. Dokumentet er frit tilgængeligt via DANVA s informationskanaler. Formålet med TV-inspektion og brøndrapport modulet er, at kunne håndtere TV og brøndrapporter i sammenhæng med en opdateret Dandas Informationsmodel. Udgangspunktet er en 1-til-1 konvertering, med så få ændringer omkring rapporter som muligt i forhold til Dandas 2.6, hvor TV og brøndrapporter var en integreret del af datamodellen. Ændringerne i forhold til Dandas 2.6 er primært at begrebsnavne er skrevet med dansk tegn, og en række knudenavne i modellen er skiftet fra et ID til attributter indeholdende de knudenavne, der indgår i udvekslingsformatet. TV-inspektion og brøndrapport 3.0 understøtter 4 typer af tilsynsrapporter fra ledningsnettet: to typer af TV-inspektioner i ledningsnettet og to typer af brøndrapporter: TV-inspektioner kørt efter Fotomanualen 2004 eller nyere DAS5TV-rapporter kørt efter fotomanualer fra før 2004 Brøndrapporter kørt efter Brøndmanualen 2010 Brøndrapporter kørt efter Brøndmanualen 2005 eller før Rapporterne giver 1. Et overblik tilstanden i ledningsnettet 2. En mulighed for at kontrollere sammenhængen i ledningsnettet 3. En mulighed for at kontrollere anvendte dimensioner og materialer 4. Identifikation af stik til brønde og ledninger. Herved suppleres og valideres viden om ledningsnettet til brug i mange processer som f.eks. ny anlæg, udbygning af ledningsnettet, fornyelsesplanlægning, LER og benchmarking. At TV-inspektion og brøndrapport i dag er et modul indebærer, at dette frit kan opdateres i forhold til Dandas og omvendt. Relationen mellem de to modeller er beskrevet i en snitflade som blot skal overholdes. Side 3 af 20

4 Det har været ønsket at lave en model, som dels kan stå alene med TV-inspektioner og brøndrapporter, dels en model, der via en defineret snitflade kan integreres med Dandas. Integrationen er beskrevet i afsnit Fejl! Henvisningskilde ikke fundet., Fejl! Henvisningskilde ikke fundet.. Beskrivelse af såvel TV-inspektion og brøndrapport som Dandas og den fælles Kernemodel ligger på DDV-reolen. Modellen understøtter ikke databasehistorik En fornyet rapport skal blot overskrive en tidligere version af samme rapport, og vil typisk kun forekomme, hvis der er konstateret fejl i rapporten. Figur 1 DANVA's DDV-reol, som kan findes på Side 4 af 20

5 1.3 Begreber, Relationer, Attributter og Kodelister Attributter og kodelister knyttet til TV-inspektion og brøndrapport findes på DDV-reolen ved at udpege modelnavnet på hylden med logiske datamodeller: Under reolen vises herefter en oversigt hvorfra man kan vælge beskrivelser knyttet til modellen (Visio diagrammer, denne vejledning mv.) og vælge det begreb i datamodellen, som ønskes undersøgt nærmere. I linjen Beskrivelse, kan man finde generel information om informationsmodellen. Der er ingen Standardværdier knyttet til TV-inspektion og brøndrapport. For et valgt begreb vises supplerende dokumentation samt en oversigt over relationer, attributter og koder, der er knyttet til begrebet. Side 5 af 20

6 Oversigt over alle begreber og relationer i TV-inspektion og brøndrapport er vist på følgende skematiske UML-diagram: TV og Brøndrapporter 3.0 Dato: 29. november 2016 Fysiske elementer i Dandas Administrativ pulje Centrale logiske fælles begreber peger på ledning4 Referencer og Relationer i TV- og Brøndrapporter 3.0 peger på ledning4 Brøndrapporter kørt efter Brøndmanual 2010 Brøndrapporter kørt før 2010 TV inspektioner kørt efter Fotomanual 2004 eller nyere 1 Das5TVRapport 1 3 er tilknyttet TV inspektioner kørt før 2004 er tilknyttet XOR 1 TvInspektion 1 3 er tilknyttet XOR 1..* 1..* LedningRapport 0..* er tilknyttet 1 0..* Datasnitflade DanDas3.0::Linie 0..* LednHændelse 0..* Rapport 1 BrøndTilstand er tilknyttet 1 0..* 0..1 er tilknyttet 0..1 DanDas3.0::Knude er tilknyttet Das5TVObs 0..* BrøndTilslutning TvObs 0..* KnudeHændelse XOR er tilknyttet 0..* 1 BrøndHoveddata 0..* 0..* er tilknyttet Kopi fra Kernemodel 2.0::Referencesystem er tilknyttet BrøndVurdering 0..* BrøndObsLøb BrøndObservation 1 er tilknyttet 1 er tilknyttet 0..* BrøndDokument 0..* BrøndKlasseLøb 0..* Brøndklasse Figur 2 UML-diagram for informationsmodellen TV-inspektion og brøndrapport Ovenstående oversigt rummer begreber knyttet til 4 typer af rapporter: TV-inspektioner kørt efter Fotomanualen 2004 eller nyere DAS5TV-rapporter kørt efter fotomanualer fra før 2004 Brøndrapporter kørt efter Brøndmanualen 2010 Brøndrapporter kørt efter Brøndmanualen 2005 eller før Side 6 af 20

7 1.4 Læsevejledning Dokumentet er opbygget således: Generel indledning Beskrivelse af administrative begreber afsnit 2 Beskrivelse af centrale logiske fælles begreber og referencer - afsnit 3 Beskrivelse af operationelle begreber i modellen afsnit 4 Datasnitflader afsnit 5 Side 7 af 20

8 2 Administrative begreber 2.1 Referencesystem Begrebsforklaring: Referencesystem angivelse af kote- og koordinatsystem for den aktuelle forsynings datamodel. Begrebet stammer fra den fælles Kernemodel og nedarves til Dandas samt TV- og brøndrapporter 3.0. Alle de 4 rapporttyper kan indeholde koordinater og brøndrapporterne også koter. Det er derfor vigtigt at stempel disse med hvilke referencesystem der er anvendt, hvis de indeholder koter og/eller koordinater. Bemærk, at referencesystemet ikke er obligatorisk i TV-rapporter, men hvis der er angivet koordinater og koter bør henvisning til referencesystem medtages. Det er således kun ved XML-udveksling af brøndrapportenerne, at angivelse af referencesystem er krævet. Stemplingen af anvendt kote- og koordinatsystem i datamodellen anvendes alene til at afvise indkommende XML-data der anvender andre referencekoder, eller til at konvertere data til de referencekoder, der anvendes i datamodellen. Der er ingen mulighed for at give nøjagtighedsklasser på koter og koordinater i rapporterne. Koter og koordinater vil derfor kun være retningsvisende i forhold til genfinding og overordnet verifikation, og må altså ikke sammenlignes med data fra opmåling. For yderligere beskrivelse af begrebet henvises til modeldokumentation for Dandas Angivelsen af referencesystem er knyttet sammen med referencesystemet registreret i Dandas og den fælles Kernemodel. Er der tale om en stand-alone installation af informationsmodellen TV-inspektion og brøndrapport 3.0, dubleres begrebet blot fra herfra. Der udveksles ikke koter eller koordinater via standard datasnitfladerne mellem TV-inspektion og brøndrapport 3.0 og Dandas. Datasnitfladerne rummer således ikke attributter fra Referencesystem. Der er ingen relationer mellem Referencesystem og enkeltbegreber i informationsmodellen TV-inspektion og brøndrapport Side 8 af 20

9 3 Centrale logiske fælles begreber og referencer En række begreber er fælles for flere rapporttyper. Disse logiske fællesbegreber er markeret med farven lilla i figur 2. De enkelte rapporttyper er desuden markeret med farver, og deres relation til de fælles begreber vil fremgå af UML-diagrammet i figur Rapport Begrebsforklaring: Rapport indeholder en række generelle oplysninger som er fælles for de fire typer af rapporter: TV-inspektioner kørt efter Fotomanualen 2004 eller nyere DAS5TV-rapporter kørt efter fotomanualer fra før 2004 Brøndrapporter kørt efter Brøndmanualen 2010 Brøndrapporter kørt efter Brøndmanualen 2005 eller før TV knytter sig til ledninger og brøndrapporter til brønde og andre Knude.Funktion i Dandas. Rapport indeholder blandt andet rapportnummer samt oplysninger om hvem der har udført rapporter og hvornår rapporten er lavet. Rapport er en generalisering af disse fire rapporttyper I begrebet Rapport er attributten Rapportnr unik og fælles for de fire rapporttyper. Det samme Rapportnr kan altså ikke anvendes i en TV-inspektion og i en Brøndrapport. Det er derfor vigtig, at ledningsejeren fastsætter regler for udfyldelse af Rapportnr. Vedrørende navngivning af knuder/brønde, rapporter, dokumenter mv. henvises til DANVA Vejledning nr. 90: Navngivning i TV-inspektion. Kan downloades fra DANVA. 3.2 LedningHændelse Begrebsforklaring: LedningHændelse er en generalisering af enkeltobservationer fra de to typer af TV-rapporter, og indeholder stedfæstelse af de enkelte observationer. En gruppe af ledningshændelser er enten knyttet til en Tv-Inspektion (kørt efter Fotomanualen fra 2004 eller nyere) eller en Das5TVRapport (kørt efter Fotomanualen fra før 2004). Side 9 af 20

10 3.3 KnudeHændelse Begrebsforklaring: KnudeHændelse er en generalisering af observationer og registreringer fra de to typer af Brøndrapporter, og indeholder information om hvor i brønden en given observation er gjort. 3.4 LedningRapport Figur 3 Relationer til LedningRapport. Se figur 2 for signaturforklaring Begrebsforklaring: LedningRapport er et krydsreferencebegreb fælles for de to typer at TV-rapporter og beskriver den/de ledninger en given rapport dækker. Referencenøglen indeholder sammenhørende værdier af RapportGUID (fra Rapport.GUID) og LedningGUID, hvor LedningGUID findes i Dandas datamodellen via datasnitfladen. Desuden er FraKnudeGUID medtaget som en reference til den knude hvorfra stationeringen af rapporten er registreret. En TV-rapport ny eller gammel kan dække over en eller flere ledninger. En given TV-rapport kan altså kræve en til flere forekomster i LedningRapport. Vær opmærksom på, at med Dandas er ledningsbegrebet ændret i forhold til Dandas 2.6. Det vil sige, at hvis der er dimensionsskift, materialeskift eller saneringer (udskiftninger strømper e.l.) på en strækning mellem to brønde, vil der i Dandas være en sekvens af flere ledninger mellem disse to brønde. TV-operatøren har mulighed for at rapportere, at der køres over en sekvens af flere navngivne strækninger i XML-filens LedningObjektItems, der ved tolkning direkte kan give baggrund for et antal forekomster i LedningRapport. Side 10 af 20

11 Det bedste billede af strækningens fysiske tilstand får man dog, hvis der afleveres en rapport for hver enkelt ledning i stedet for en samlet rapport for en sådan delt strækning fra brønd til brønd. En saneringer på en del af brøndstrækket vil således ikke påvirke kvalitetsbilledet (Fysisk index) for den resterende del af brøndstrækket! Begrebet LedningRapport indeholder desuden en entydig identifikation af den Dandas 3.0::Knude, hvor Tvinspektionen starter, og en fortløbende stationering, der er den aktuelle lednings startstationering i forhold til den sekvens af ledninger, der er dækket af rapporten. Side 11 af 20

12 4 Operationelle begreber De operationelle begreber indgår som de begreber, der specifikt håndterer data fra de fire rapporttyper, der indgår i datamodellen. Her efterfølgende bliver de enkelte rapporttypers operationelle begreber beskrevet. 4.1 TV-inspektioner kørt efter Fotomanualen 2004 eller nyere Figur 4 TV-inspektioner kørt efter Fotomanualen 2004 eller nyere TV-inspektioner udført efter Fotomanualen 2004 eller nyere beskriver ledningens materiale og dimension, tilslutning af stik samt en række standardiserede observationer foretaget i ledningen. Der henvises til DANVA Vejledning nr. 57: Fotomanual, TV-inspektion af afløbsledninger for yderligere information om data, kodelister mv TVInspektion Begrebsforklaring: Begrebet TVInspektion indeholder de overordnede data fra en TV-inspektioner kørt efter Indeholder oplysninger om hvor der er kørt samt overordnede oplysninger om ledningsnettet mv. I begrebet TVInspektion findes bl.a. attributterne Startpunktnr og Slutpunktnr det knudenavn hvorfra rapporten er startet og det knudenavn der er kørt mod (uanset om kameraet ikke har kunnet komme hele Side 12 af 20

13 vejen igennem). Disse anvendes senere som nøgler til at identificere den/de ledninger, som TV-inspektionen dækker i begrebet LedningRapport TVObs Begrebsforklaring: TVObs indeholder de hændelser, der er observeret langs den eller de ledninger en TVinspektioner kørt efter Fotomanualen fra 2004 eller nyere dækker. 4.2 DAS5TV-rapporter kørt efter fotomanualer fra før 2004 Figur 5 DasTV-rapporter kørt efter fotomanualer fra før Das5TVRapport Begrebsforklaring: Begrebet Das5TVRapport indeholder hoveddata fra en TV-inspektion kørt efter Fotomanualen fra før 2004, altså de gamle DAS5 TV-rapporter, som indeholder oplysninger om hvor der er kørt samt overordnede oplysninger om ledningsnettet mv. I modsætning til de nyere rapporter, ligger der ikke i disse rapporter direkte oplysninger om hvorfra og hvor mod, der er kørt. Identifikationen af hvor der er kørt ligger alene i begrebet LedningRapport. Side 13 af 20

14 4.2.2 Das5TvObs Begrebsforklaring: Das5TvObs indeholder de hændelser, der er observeret langs den ledninger en TV-rapport kørt efter Fotomanualen fra før 2004 dækker. 4.3 Brøndrapport kørt efter Brøndmanualen 2010 Figur 6 Brøndrapport kørt efter Brøndmanual 2010 Brøndrapporter kørt efter Brøndmanualen 2010 beskriver en række registreringer af selve den registrerede brønd i begreberne BrøndVurdering og BrøndHoveddata, samt en række registreringer af de tilsluttede ledninger i begrebet BrøndTilslutning. Der henvises til DANVA Vejledning nr. 58: Brøndmanualen, Inspektion og registrering af brønde for yderligere information om data, kodelister mv. Side 14 af 20

15 4.3.1 BrøndHoveddata Begrebsforklaring: BrøndHoveddata indeholder hoveddata fra Brøndrapporter kørt efter Brøndmanualen 2010: Stedfæstelse og oplysninger om brøndens fysiske egenskaber og bestykning - svarende til rapportskemaets øverste del BrøndTilslutning Begrebsforklaring: Begrebet BrøndTilslutning er en registrering af oplysninger for de tilløb der er knyttet til den inspicerede brønd BrøndVurdering Begrebsforklaring: BrøndVurdering er en samling af observationer der knytter sig til brøndens tilstand, svarende til BrøndObservationer/BrøndKlasser fra brøndrapporter før BrøndDokument Begrebsforklaring: BrøndDokument indeholder en liste af dokumenter knyttet til én eller flere Brøndrapporter, dog kun denne rapporttype. Det kunne umiddelbart syntes logisk at anvende den fælles kernemodels linkreferencer, men det er ønsket, at TV-inspektion og brøndrapport modellen kan stå alene uden tilknytning og afhængighed af en komplet Dandas datamodel. Side 15 af 20

16 4.4 Brøndrapporter kørt efter Brøndmanualen 2005 eller før Figur 7 Brøndrapporter kørt efter Brøndmanualen 2005 eller før Observationer i ledninger beskrives med begreberne BrøndObsLøb, der indeholder typer af observationer gjort i tilslutninger og BrøndKlasseLøb, der klassificere observationerne gjort i tilløbene. Dette svarer til begrebet Brøndtilslutning i de nyere rapporter. Observationer i brønd beskrives med begreberne BrøndObservationer, der indeholder typer af observationer gjort i tilslutninger og BrøndKlasse, der klassificere observationerne gjort i brønden Dette svarer til begrebet BrøndVurdering i de nyere rapporter BrøndTilstand Begrebsforklaring: BrøndTilstand indeholder de overordnede data fra brøndrapporter kørt efter Brøndmanualen 2005 eller før: Data om hvor der er inspiceret og overordnede oplysninger om selve brønden og ledningsnettet mv. Side 16 af 20

17 4.4.2 BrøndObsLøb Begrebsforklaring: BrøndObsLøb registrerer en række oplysninger tilslutninger til brønden, herunder materiale og dimension samt evt. navnet på naboknuden BrøndKlasseLøb Begrebsforklaring: BrøndKlasseLøb, som rummer en liste over observationer (RB, IN mv) og klasser på rør tilsluttet brønden BrøndKlasse Begrebsforklaring: BrøndKlasse, som rummer en liste over observationer (RB, IN mv) og klasser på de enkelte brønddele. Side 17 af 20

18 5 Datasnitflader til Dandas 5.1 TV-inspektioner Integration mellem de to typer af TV-inspektioner i modulet TV-inspektion og brøndrapport 3.0 og informationsmodellen Dandas forgår gennem begrebet LedningRapport, der dels bestykkes med informationer fra på den ene side TV-inspektions begreberne Das5TVRapport og TvInspektion og på den anden side den/de Dandas ledninger, som rapporten dækker. Datasnitfladen Find alle ledninger i Dandas 3.0::Linie.Ledning mellem to givne knudenavne anvendes til at skabe denne integration Datasnitfladen Find alle ledninger i Dandas 3.0::Linie.Ledning mellem to givne knudenavne Datasnitfladen skaber forbindelse mellem Rapport og en eller flere Dandas 3.0::Linie.Ledning gennem referencebegrebet LedningRapport Med udgangspunkt i TV-rapportens oplysninger om FraKnude, ModKnude og Ledningsnummer returneres den eller de ledninger, der ligger mellem de to angivne knudenavne. Returneres flere Dandas 3.0::Linie.Ledning.GUID, dubleres forekomsten i LedningRapport. Desuden returneres StartStation Løbenummer Dandas 3.0::Knude.GUID Den aktuelle lednings startstationering i forhold til den sekvens af ledninger, der er dækket af rapporten Løbenummer for den aktuelle ledning i den sekvens af ledninger, der dækker rapporten Entydig identifikation af den Dandas 3.0::Knude, hvor Tv-inspektionen starter. 5.2 Brøndrapport kørt efter Brøndmanualen 2010 Side 18 af 20

19 Brøndrapporter udført efter Brøndmanualen 2010 har dels en relation til den knude, rapporten beskriver: Brøndhoveddata.Broendnr, dels en relation til den Linie.Ledning, som evt. kan identificeres som en et tilløb/fraløb til brønden: BrøndTilslutning.Tilloebspunkt Datasnitfladen Find knude i Dandas 3.0::Knude ud fra givet knudenavn Den gennerelle datasnitflade Find knude i Dandas 3.0::Knude ud fra givet knudenavn kan anvendes til at skabe forbindelsen mellem Brøndhoveddata og knuden i Dandas Med udgangspunkt i knudenavnet fra Brøndhoveddata.Broendnr returneres GUID for den aktuelle Dandas 3.0::Knude. Denne GUID gemmes efterfølgende i Brøndhoveddata.KnudeGUID. Brøndhoveddata fungerer således krydsreferenceobjekt mellem Brøndrapport kørt efter Brøndmanualen 2010 og Dandas 3.0::Knude Datasnitfladen Find første ledning i Dandas 3.0::Linie.Ledning mellem to givne knudenavne Den gennerelle datasnitflade Find første ledning i Dandas 3.0::Linie.Ledning mellem to givne knudenavne kan anvendes til at skabe forbindelsen mellem BrøndTilslutning.Tilloebspunkt og den relaterede ledning i Dandas. Med udgangspunkt i navnet op den inspicerede brønd Brøndhoveddata.Broendnr og det oplyste tilslutningspunkt BrøndTilslutning.Tilloebspunkt returnerer snitfladen en Dandas 3.0::Linie.Ledning.GUID for den første ledning tilsluttet Brøndhoveddata.Broendnr i retning mod BrøndTilslutning.Tilloebspunkt. Denne GUID gemmes efterfølgende i BrøndTilslutning.LinieGUID. Begrebet BrøndTilslutning fungerer således krydsreferenceobjekt mellem Brøndrapport kørt efter Brøndmanualen 2010 og Dandas 3.0::Linie.Ledning 5.3 Brøndrapporter kørt efter Brøndmanualen 2005 eller før Brøndrapporter kørt efter Brøndmanualen 2005 eller før har også dels en relation til den knude, rapporten beskriver: BrøndTilstand.Knudenavn, dels en relation til den Linie.Ledning, som evt. kan identificeres som en et tilløb/fraløb til brønden: BrøndObsLøb.LoebTilFraKnudenavn. Side 19 af 20

20 5.3.1 Datasnitfladen Find knude i Dandas 3.0::Knude ud fra givet knudenavn Den gennerelle datasnitflade Find knude i Dandas 3.0::Knude ud fra givet knudenavn kan anvendes til at skabe forbindelsen mellem BrøndTilstand og knuden i Dandas Med udgangspunkt i knudenavnet fra BrøndTilstand.Knudenavn returneres GUID for den aktuelle Dandas 3.0::Knude. Denne GUID gemmes efterfølgende i BrøndTilstand.KnudeGUID. BrøndTilstand fungerer således krydsreferenceobjekt mellem Brøndrapporter kørt efter Brøndmanualen 2005 eller før og Dandas 3.0::Knude Datasnitfladen Find første ledning i Dandas 3.0::Linie.Ledning mellem to givne knudenavne Den gennerelle datasnitflade Find første ledning i Dandas 3.0::Linie.Ledning mellem to givne knudenavne kan anvendes til at skabe forbindelsen mellem BrøndObsLøb.LoebTilFraKnudenavn og den relaterede ledning i Dandas. Med udgangspunkt i navnet op den inspicerede brønd BrøndTilstand.Knudenavn og det oplyste tilslutningspunkt BrøndObsLøb.LoebTilFraKnudenavn returnerer snitfladen en Dandas 3.0::Linie.Ledning.GUID for den første ledning tilsluttet BrøndTilstand.Knudenavn i retning mod BrøndObsLøb.Loeb- TilFraKnudenavn. Denne GUID gemmes efterfølgende i BrøndObsLøb.LinieGUID. BrøndObsLøb fungerer således krydsreferenceobjekt mellem Brøndrapporter kørt efter Brøndmanualen 2005 eller før og Dandas 3.0::Linie.Ledning. Side 20 af 20