Vejledning DANDASCheck
Et desktopprogram til kvalitetssikring af DANDAS data (kloaksystemdata)
Indhold
Installation af DANDASCheck
I tilfælde af fejlmelding om manglende ”database engine”:
Opdatering til programmet
Registrering af filtypen .key
Opstart af programmet
Kontrol af data
Udføre kontrol
Funktionaliteten ”Afgrænset kontrol efter dato”
Funktionaliteten ”Pak projekt – vedhæft mail”
Funktionaliteten ”Oprindelse”
Funktionaliteten ”Sammenhold data”
Funktionaliteten ”Hvad kontrollerer programmet for?”
Information om softwareudvikling
Installation af DANDASCheck
DANDASCheck installeres gennem Toolboxen, som åbnes først. Se separat vejledning for installation og anvendelse af Toolboxen.
DANDASCheck kræver ikke en licens, og det er derfor ikke nødvendigt, at der logges ind i Toolboxen. Dette skyldes, at det kan være nødvendigt for eksterne brugere, der ikke er portalbrugere, at anvende værktøjet. Værktøjet kan derfor startes af alle, men det kræver en kontrolpakke og en nøglefil for at anvende programmet (se længere nede).
Installationen startes ved at dobbeltklikke på værktøjet, og følgende vindue kommer frem, hvortil der klikkes ”ja”.
Herefter installeres værktøjet, og når det er færdiginstalleret klikkes der ”ok”. Når værktøjet er installeret, vil der komme et lille logo med teksten ”installed”.
I tilfælde af fejlmelding om manglende "database engine":
Der skal installeres Microsoft Access database engine i 32 bit version
Der er to muligheder afhængigt at øvrig software på computeren. Vælg den korrekte mulighed nedenfor og gennemfør installationen som angivet.
Det undersøges indledningsvist på maskinen om der i listen af installerede programmer fremgår ”Microsoft Access database engine”. Er der i forvejen installeret Microsoft Access database engine i x64 bit er det vigtigt, at 32 bit ikke er i samme version, da det kan skabe konflikt i andre installerede programmer.
1. Der er ikke installeret Microsoft Access database engine, eller den installerede x64 bit er i version
2010 eller tidligere.
Der installeres 32 bit Microsoft Access database engine i 2016 version ved at gøre følgende:
2. Microsoft Access database engine er installeret i x64 bit version 2016 eller senere.
Der installeres 32 bit Microsoft Access database engine i 2010 version ved at gøre følgende:
- Hent og gem til c:\Temp: www.dandas-tv.dk/Software/ADODrivere/Office2010_32bit/AccessDatabaseEngine.exe
- Start Kommandoprompt (cmd.exe) - højreklik og kør som administrator
- Skriv c:\Temp\AccessDatabaseEngine.exe /quiet /passive
- Vent et par minutter
- Da DANDASCheck leder efter nyeste version, skal det manuelt defineres, at det er den ældre version 2010, der repræsenterer 32 bit.
- Åbn stifinder og naviger til C:\EnviDan\EnviToolBox\Tools\TV-Server\AppData\Settings
- Åbn filen Microsoft.ACE.OLEDB.txt (eller lav den, hvis den ikke er der)
- Der skal stå følgende i filen: Provider=Microsoft.ACE.OLEDB.12.0
- Gem og luk.
- Forsøg at åbne TV-servers kontrolprogram igen
Opdatering til programmet
Værktøjet bør altid startes fra Toolboxen (dobbeltklik), da dette sikrer, at der altid arbejdes med den nyeste version.
Oprettes der genveje til opstart af DANDASCheck, kan brugeren opleve at blive informeret om tilgængelige opdateringer. Disse installeres altid gennem Toolboxen.
Skulle der være problemer med at opdatere et værktøj i Toolboxen, anbefales det at fjerne det pågældende værktøj ved at højreklikke på det i Toolboxen og vælge afinstallér. Installér derefter værktøjet igen fra menuen ”EnviDan Tools”.
Registrering af filtypen .key
Nøglefilens filtype (.key) skal registreres på computeren. Dette kræver administratorrettigheder.
Registrering af filtypen udføres i forbindelse med, at DANDASCheck startes op. Højreklik på ikonet for Toolboxen og vælg at starte den som administrator. Herefter startes DANDASCheck inde fra Toolboxen. Derved registreres filtypen korrekt.
DANDASCheck vil forsøge at registrere filtypen hver gang programmet startes, indtil det lykkes.
Opstart af programmet
Når programmet startes første gang skal fremsendt mappe med kontroller i, trækkes ind i programmet vha. ”drag-and-drop” (skal ikke pakkes ud). Skærmbilleder kan afvige fra seneste version.
Efterfølgende vælges den ønskede opsætning.
Til sidst skal nøglefil trækkes ind i programmet vha. ”drag-and-drop”.
Når værktøjet efterfølgende startes op, skal den ønskede nøglefil vælges. Dette gøres vha. ”drag-and-drop”, hvorefter opsætningen automatisk indstilles ud fra nøglefilen. Brugeren kan på denne måde have flere nøglefiler til rådighed, men kun en enkelt i anvendelse ad gangen
Kontrol af data
Når værktøjet efterfølgende startes op, skal den ønskede nøglefil vælges. Dette gøres vha. ”drag-and-drop”, hvorefter opsætningen automatisk indstilles ud fra nøglefilen. Anvender brugeren kun en enkelt nøglefil, kan der højreklikkes på den og vælge at indlæses den som default.
Kontrol af data foregår ved hjælp af ”drag and drop” til DANDASCheck. Mappe med XML-filer trækkes over i programmet, eller enkelte filer kan trækkes.
Når filerne er trukket over i programmet, valideres XML-filerne først. Dette tager et øjeblik, og mens valideringen står på vises nedenstående markering i programmet.
Når markingen skifter til nedenstående markering, er valideringen slut, og der kan nu klikkes på ”Kontroller”, hvorefter indholdskontrollen starter. Hvis der er oprettet flere forskellige kontroller til den samme nøglefil, kan de forskellige kontroller vælges via rullegardin i venstre side.
Udføre kontrol
En kontrol uden fejl eller advarsler vil resultere i én PDF, der indeholder generel information om den udførte kontrol.
Er der fejl i kontrollen fremkommer følgende besked, som fortæller, hvor mange fejl og advarsler der er.
Når der klikkes ”OK” fremkommer en PDF som indeholder generel information om den udførte kontrol, og viser i hvilke(n) XML-fil fejlen(e) er i, samt et vindue med PDF indeholdende præcis fejlbeskrivelse til hver af de fejlede XML-filer.
PDF med generel information om den udførte kontrol. Øverst fremgår navn på kontrolfil og nøglefil samt
dato for seneste ændring og udløbsdato. Nederst fremgår et delområde for hver kontrolleret fil.
I ovenstående eksempel er der 1 fejl og 2 advarsler i forhold til den evaluerede knude-fil, der i alt indeholder 4 knuder. Fejl bør udbedres mens brugeren bør tage stilling til advarsler, da data kan være korrekte nok.
Filer, der er årsag til fejl eller advarsler, vil der fremkomme enkeltvise PDF for. Ved at åbne den tilhørende PDF for fil(er) der fejler, fås detaljerede informationer om kontrollen.
Eksempel på filer fra en udført kontrol. Generel information om en udført kontrol fremgår af ”ProjektXMLInfo.pdf”.
Filer, der resulterer i fejl/advarsler, genererer en separat PDF fil. Alle filer resulterer i en .log fil.
PDF filen for den fejlede kontrol af Knuder åbnes;
PDF med specifik beskrivelse af fejl og advarsler. For knude 20111251 anvendes en ikke-accepteret værdi på 2 for statuskode.
Desuden er der advarsler tilknyttet knude 20111301 og 20110951, der er registreret som henholdsvis 7 (anlagt) og 1 (i drift).
Når fejl er rettet trækkes projektet igen over i programmet, og herefter kommer der besked om at projektet er godkendt.
Funktionaliteten ”Afgrænset kontrol efter dato”
I forbindelse med nogle typer kontrol kan det være muligt at anvende begrænsning ud fra dato. Funktionaliteten kan eksempelvis anvendes, hvis et anlæg ønskes kontrolleret, men filerne også indeholder information om ældre anlæg.
Ved at anvende begrænsningen kan ældre data håndteres anderledes, og dermed ikke bidrage med fejl
eller advarsler, som kan medføre ”unødig støj”. For knuder og ledninger gælder det, hvis de er etableret før denne dato, og for øvrige data hvis de er udført før denne dato (eksempelvis brøndrapporter).
I den generelle information for den udførte kontrol fremgår det, hvorvidt der er sket begrænsning efter dato, hvad datoen er og hvor meget data, der er blevet afgrænset fra at deltage i kontrollen. Der kan i nøglefilen være angivet en alternativ kontrol for data før denne dato. Eksempelvis ”Lempet”. Dette vil fremgå i informationen under Afgrænset Kontrol, hvor ”(Skip before date)” betyder, at data før den valgte dato bliver sprunget over.
PDF med generel information om den udførte kontrol. Der er anvendt begrænsning efter dato.
Afgrænsningen har frasorteret data før 1/1-2019, hvilket har afgrænset 1 knude fra kontrollen.
Funktionaliteten ”Pak projekt – vedhæft mail”
DANDASCheck kan efter kontrol samle de kontrollerede filer med den fremkomne dokumentation og komprimere dem til en fil, der kan sendes på mail. Brugeren kan aktivere denne funktionalitet, ved at sætte flueben.
Denne funktionalitet kan også aktiveres automatisk af nøglefilen, hvis det er en aftalt arbejdsgang i forbindelse med bestemte kontroller.
Først efter fejlfri kontrol vil brugeren få meddelelse om, at den komprimerede fil er klar til at blive sendt. Filen er navngivet efter tidspunkt og er tilføjet i udklipsholderen, så den blot kan indsættes i mailen. Desuden kan adressen på en foruddefineret modtager fremgå af meddelelsen.
Funktionaliteten ”Oprindelse”
Som bruger er det muligt at tilknytte en fil, der angiver tilladte firmaer og oprindelser i forhold til det data, der ønskes kontrolleret. Dette kan eksempelvis være ved kontrol af udført anlæg.
Brugeren kan selv tilknytte filen gennem ”opsætning”, men det kan også ske automatisk gennem nøglefilen som del af kontrolopsætningen. En valgt fil for oprindelse (uanset om det er tilføjet af brugeren eller automatisk) vil altid fremgå med navnet ”Oprindelser_firma.xml”.
Under opsætning fremgår det, om kontrolopsætningen inkluderer krav til oprindelse.
Hvis nøglefilen automatisk har tilknyttet en fil for oprindelse, kan brugeren eksportere den. Dermed har brugeren den til rådighed og vil således på forhånd kunne arbejde med de korrekte oprindelser. Filen eksporteres ved at højreklikke på xml-logoet i DANDASCheck
Funktionaliteten ”Sammenhold data”
Hvis data, efter endt indholdskontrol, ønskes sammenholdt, kan funktionaliteten tilvælges. Dette vil evaluere, om indholdet i det kontrollerede data relaterer til hinanden. Eksempelvis om der er knuder til ledninger eller omvendt.
Funktionaliteten for ”sammenhold data” har ikke indflydelse på fejl eller advarsler i den udførte kontrol, men er et supplement til brugeren, som tilbydes indblik i sammenhænge mellem det kontrollerede data. Brugeren kan derved tage stilling til, om indholdet er som forventet.
Resultatet af ”sammenhold data” vises via brugerens browser. Resultatet kan tilgås uanset om den udførte kontrol medfører fejl eller ej.
Åbnes filen ”sammenholdt data” ses gruppering via overskrifter, som der kan trykkes på. I eksemplet nedenfor er de grupper foldet ud, hvor knuder uden brøndrapporter samt ledninger uden TV-inspektion fremgår.
På denne måde kan det evalueres, hvorvidt omfanget af data svarer til det forventede.
OBS: det er muligt at lave sammenligning af data selvom der konstateres fejl ved kontrollen af data. Den mest retvisende sammenligning opnås, når kontrollen er udført uden fejl.
Funktionaliteten ”Hvad kontrollerer programmet for?”
Det er via programmet muligt for brugeren at få indblik i, hvad indholdskontrollen undersøger filerne for.
Når brugeren har indlæst den krypterede nøglefil, er programmet klar til at kontrollere filer. På dette tidspunkt kan brugeren via spørgsmålstegnet vælge at oprette kontroldokumentation. Dette kan gøres på to måder;
- Dokumentation for den valgte type kontrol (i nedenstående figur for ”nyanlæg”, som er den
kontrol, der pt. er valgt i alle menuerne til venstre). Vælges typisk, hvis brugeren kun ønsker at se,
hvad den valgte kontrol gør.
- Dokumentation for alle typer kontrol, uanset om den aktuelt er valgt eller ej. Derved medtages
eventuelle andre kontroltyper også, fx ”lempet”. Vælges typisk, hvis brugeren på tværs af
kontroller ønsker at have et samlet overblik for indholdet eller forskellen mellem de enkelte
kontroller.
Den oprettede kontroldokumentation præsenteres for brugeren som en PDF fil for hvert element (knude, ledning, projekt, TV-rapport, brøndrapport). Her for alle typer kontrol:
Åbnes en af dokumentationerne, ses på overordnet vis indhold af kontrollen (her for ”ledning”):
I forhold til ”rullegardinet” i programmet kan der for ledning vælges mellem kontrollerne ”nyanlæg” og ”lempet”. I dokumentation kan der fremgå flere (her ”begrænset”), som henviser til intern funktionalitet inde i programmet. Dem kan brugeren ikke anvende direkte.
I eksemplet ovenfor angiver dokumentationen, at der som tilladt referencekode for koordinatsystemet kun må anvendes værdien 9. Anvendes andre værdier, medfører det en fejl (rødt kryds).
Information om softwareudvikling
Både Toolbox, og de tilgængelige programmer gennem Toolbox, er udviklet i et separat udviklingsmiljø. De udviklede programmer, herunder opdateringer, scannes automatisk for virus/malware. Softwaren signeres med certifikat verificeret af GlobalSign. Desuden testes softwaren inden den frigives til eksterne brugere.
Der ses eksempel på certifikat og softwarens digitale signatur nedenfor
