Handleiding. AGIV GML conversie- en validatietoepassing v

Transcriptie

1 Handleiding AGIV GML conversie- en validatietoepassing v Identificatie Versie Publicatie 21 april 2009 Achtergrond Auteur Joeri Robbrecht, Luc De Kock HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 1 / 41

2

3 Inhoud AGIV GML conversie- en validatietoepassing v Inhoud 3 1 Inleiding 5 2 Afkortingen en definities 7 3 Installatie Installatievoorwaarden De toepassing installeren De toepassing verwijderen De toepassing starten Een korte rondleiding 10 4 Gebruik van de toepassing voor KLIP Doelstelling Input bestanden ESRI Shapefile Autodesk Drawing exchange Format (DXF) Output bestanden Voorbereiding input bestanden Overzicht van verwachte velden Veld KLB_REF Veld ODB_REF Veld KLB_NAME Veld KLB_VERSIO Veld MOD_DATE Veld PRECISION Veld BUFFER Ingeven metadata Uitvoeren conversie Conversie van shapefile naar GML Conversie van DXF/CSV naar GML Bekijken resultaat Gebruik van de toepassing voor validatie Scope van de validatie Valideren van KLB-zone Valideren van ODB-zone 27 5 Gebruik van de toepassing voor GRB Doelstelling De tools voor GRB-meldingen Conversie van shape of DXF naar GML Hoe start ik de conversie? Hoe verloopt de conversie? 31 HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 3 / 41

4 5.3.3 Hoe weet ik of de conversie goed/fout verloopt? Hoe moet een input shapebestand er uitzien? Hoe moet een input dxf-bestand er uitzien? Hoe ziet een output GML-bestand er uit? Validatie van GML Hoe start ik de validatie? Hoe weet ik of de validatie goed/fout verloopt? Hoe moet een input GML-bestand er uitzien? Conversie van GML naar shape of DXF Hoe start je de conversie? Hoe verloopt de conversie? Hoe weet ik of de conversie goed/fout verloopt? Hoe ziet een output shapebestand er uit? Hoe ziet een output DXF-bestand er uit? 36 6 Ondersteuning 39 Bijlage 1 - GML en GML applicatieschema 41 HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 4 / 41

5 1 Inleiding Dit document is een handleiding voor de AGIV GML conversie- en validatietoepassing. Deze toepassing is bedoeld voor gebruikers die gegevens met het AGIV uitwisselen voor KLIP of voor GRB. Met deze toepassing kan je in de eerste plaats shape- of DXF bestanden converteren naar het GML-formaat. Daarnaast kan je GML-bestanden laten valideren tegen GML-schema s. En tenslotte kan je GML-bestanden terug converteren naar shape- of DXF-formaat. Je moet er wel mee rekening houden dat de toepassing enkel geschikt is voor KLIP- of GRB-specifieke gegevens. De toepassing bestaat uit verschillende conversie- en validatietools die in 3 groepen ingedeeld zijn: 1. De conversie- en validatietools voor KLIP. Hiermee kan je specifiek voor KLIP shape- of DXF-bestanden converteren naar GML-formaat of GML-bestanden valideren. 2. De conversie- en validatietools voor GRB. Hiermee kan je specifiek voor GRB shape- of DXF-bestanden converteren naar GML-formaat of GML-bestanden valideren. 3. De GML-tools voor GRB. Hiermee kan je GRB-specifieke GML-bestanden terug converteren naar shape- of DXF-formaat. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 5 / 41

6

7 2 Afkortingen en definities AFKORTING OMSCHRIJVING ODB CSV DXF GML GML applicatieschema GRB GRBMS KLB KLIP MSI-bestand Referentielaag Shapefile XML XML Schema ODB Openbaar domein beheerder. Een instelling die openbaar domein beheert. Bvb. een gemeente die instaat voor het openbaar domein binnen de gemeentegrens. Comma Separated Value. Een tekstformaat voor het opslaan van tabulaire informatie. Rijen worden horizontaal weergegeven en kolommen verticaal. Vergelijkbaar met het formaat Excel van Microsoft. Waarden worden van elkaar gescheiden door een bepaald scheidingsteken. Meestal is het scheidingsteken een komma maar het kan om het even wel ander teken zijn (dit is PC-afhankelijk). Drawing exchange Format. Een open bestandsformaat, gedefinieerd door Autodesk, voor de uitwisseling van CAD gegevens. Voor uitleg, zie Geographic Markup Language. GML is een implementatie van XML, specifiek voor het beschrijven van geografische informatie. De specificaties van GML worden opgelegd door het Open Geospatial Consortium (OGC). Van GML bestaan er verschillende versies. Versie 2 is momenteel courant in gebruik en wordt goed ondersteund door verschillende toepassingen en programmabibliotheken. Het is deze versie waarmee de KLB- en ODBzones worden beschreven. GML versie 3 heeft al een tijdje vaste vorm gekregen, maar wordt nog niet ondersteund door veel toepassingen. De extra functionaliteit die het biedt is niet relevant binnen KLIP. Een XML Schema dat een concrete implementatie van GML beschrijft. Dit schema maakt niet alleen gebruik van elementen en attributen uit de GML namespace, de structuur volgt ook bepaalde regels opgelegd door het OGC opdat documenten die beantwoorden aan dit GML applicatie schema ook zouden kunnen worden getoond in een GIS viewer. Het XML Schema dat een KLB- en ODB-zone beschrijft is een GML applicatieschema. Grootschalig ReferentieBestand Vlaanderen GRB Melding Systeem. Dit is de omgeving voor het melden van GRB-afwijkingen. Meer informatie vindt je onder > projecten > GRB > GRB-bijhouding > de meldingsprocedure Kabel en Leiding Beheerder. Een bedrijf of organisatie die instaat voor het beheer van ondergrondse kabels en/of leidingen. Bvb. een telecombedrijf. Kabel en Leiding Informatie Portaal Een installatiebestand van een Microsoft toepassing. Heeft uiteraard de extensie *.msi. Dit is de benaming voor een laag waarop het interessegebied werd ingetekend of bij voorkeur moet worden geraadpleegd. De gebruiker bepaalt de referentielaag zelf, maar goede voorbeelden zijn: Grootschalig Referentiebestand (GRB), KADVEC, KADSCAN, middenschalige kleurenorthofoto s, topografische kaart 1:10.000, stratenatlas (multinet raster), Een bestandsformaat van ESRI voor het beschrijven van GIS-data. Het wordt beschouwd als de de facto standaard voor uitwisseling van data binnen de wereld van de GIS. Voor uitleg, zie extensible Markup Language. Voor uitleg, zie Een opmaaktaal voor het definiëren van de structuur en inhoud van een XML document. Voor uitleg, zie HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 7 / 41

8

9 3 Installatie 3.1 Installatievoorwaarden Deze toepassing werd ontwikkeld met het Microsoft.NET Framework 2.0. Voor de installatie en het gebruik is de installatie van het Microsoft.NET Framework 2.0 Redistributable Package vereist. De toepassing werd getest en wordt ondersteund op volgende besturingsystemen: Windows 2000 Service Pack 3 Windows XP Service Pack 2 Windows Vista Service Pack 1 De systeemvereisten voor de installatie en het gebruik van deze toepassing komen overeen met die van het Microsoft.NET Framework 2.0 Redistributable Package (raadpleeg de Microsoft website voor een gedetailleerde beschrijving): Windows Installer 3.0, bij voorkeur versie 3.1 Internet Explorer 5.01 of recenter De vereisten van de harde schijf voor het Microsoft.NET Framework en de toepassing zijn: Microsoft.NET Framework 2.0: 280 MB (x86), 610 MB (x64) Toepassing: 12 MB 3.2 De toepassing installeren Je kan het installatiebestand downloaden van de AGIV website: > software > AGIV GML conversie- en validatietool Je start de installatieprocedure door het opstarten van het installatiebestand (MSI-bestand). 3.3 De toepassing verwijderen Je kan de toepassing verwijderen via de systeemtaak programma wijzigen of verwijderen. 3.4 De toepassing starten Je kan de toepassing opstarten door in je systeem het programma AGIV GML conversie- en validatietool te activeren. Je vindt deze toepassing ook terug met dit icoon: HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 9 / 41

10 3.5 Een korte rondleiding Het venster dat je te zien krijgt na het opstarten van de toepassing bestaat uit de volgende onderdelen: 1. Een menubalk met standaardfunctionaliteiten voor het sluiten van de toepassing, voor de controle van het navigatievenster en voor het oproepen van helpdocumenten 2. Een knoppenbalk met standaardfunctionaliteiten voor het opslaan en oproepen van een voorkeur layout en voor de controle van het navigatievenster 3. Een navigatievenster waarmee je de KLIP- of GRB-specifieke tools of de extra GML-tools kan oproepen 4. Een venster waarin de afzonderlijke tools als steekkaarten getoond worden nadat ze uit het navigatievenster opgeroepen werden Je krijgt toegang tot een tool door deze te selecteren in het navigatievenster. De tool verschijnt daardoor als een steekkaart in het grote venster. Zo kan je verschillende of zelfs alle tools als steekkaarten in het grote venster plaatsen. Je kan vervolgens een tool gebruiken door de overeenkomstige steekkaart te selecteren. In de figuur hierna zie je de toepassing waarbij alle tools als steekkaarten werden toegevoegd. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 10 / 41

11 HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 11 / 41

12

13 4 Gebruik van de toepassing voor KLIP 4.1 Doelstelling Deze toepassing helpt de KLB s en ODB s bij het beschrijven van hun interessegebied in een afgesproken GML-formaat. Error! Reference source not found. toont een globaal overzicht van de werking van deze toepassing voor het aanmaken van KLIP GML bestanden voor ODB en KLB zones.. Overzicht van de werking van de GML conversie en validatie toepassing In de eerste plaats heeft de KLB of ODB de mogelijkheid om op basis van een GIS- of CADbestand dat zijn interessegebied beschrijft, het XML/GML uitwisselingsformaat aan te maken dat moet worden opgeladen in KLIP. Daarnaast biedt de toepassing ook de mogelijkheid om bestaande GML-bestanden te valideren. Deze bijkomende functionaliteit heeft eigenlijk maar zin voor GML-bestanden die de gebruiker zelf heeft aangemaakt, of bestanden die door de conversietoepassing werden aangemaakt en nadien door de gebruiker werden gewijzigd. De toepassing biedt de gebruiker de mogelijkheid om basisbestanden te converteren naar het GML-formaat dat geschikt is voor opladen in de KLIP-portaal. De invoer bestaat uit één of meerdere bronbestanden aangevuld met de metadata die de gebruiker manueel kan ingeven. Het resultaat is één GML-bestand dat de KLB- of ODB-zone beschrijft en één XML Schema dat de namen bevat van de attributen (er worden maximaal 6 attributen toegelaten) die specifiek zijn voor elke gebruiker. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 13 / 41

14 Aangezien de bronbestanden geometrie bevatten kan de conversietoepassing alleen worden gebruikt voor het aanmaken van GML bestanden waarin de features worden beschreven aan de hand van hun geometrie. Het is bijvoorbeeld niet mogelijk om met de conversietoepassing een GML bestand aan te maken dat een lijst bevat van NIS-codes of perceels-id s. Deze GML bestanden zullen nog steeds langs een andere weg moeten worden aangemaakt. Anderzijds is de validatietoepassing wél in staat is om alle mogelijke GML bestanden te controleren op eventuele fouten. 4.2 Input bestanden De conversietoepassing aanvaardt als input: een ESRI Shapefile of een AutoCAD DXF. De inputbestanden moeten wel aan bepaalde voorwaarden voldoen opdat de conversietoepassing de GML output zou kunnen genereren. Hier volgt een beschrijving van beide formaten en een beknopt overzicht van de randvoorwaarden ESRI Shapefile Het bestandsformaat shape van ESRI is een populair uitwisselingsformaat voor GIS-data. Niettegenstaande het geen open formaat is, wordt het wél beschouwd als de facto standaard voor uitwisseling van data binnen de wereld van de GIS. Een Shapefile bestaat doorgaans uit 3 bestanden die elkaar inhoudelijk aanvullen: 1. shape: bevat de geometrie van de features (extensie: shp); 2. index: bevat de index van de features in de shape (extensie: shx); 3. dbase: bevat de attribuutinformatie van de features in de shape (extensie: dbf). Bij de verwijzing naar een ESRI Shapefile wordt meestal alleen het shape-bestand vermeld, maar een Shapefile is slechts volledig wanneer de drie bestanden aanwezig zijn. Optioneel kan een Shapefile nog worden aangevuld met enkele andere bestanden bijvoorbeeld voor het definiëren van een projectiesysteem. Deze bestanden zijn niet noodzakelijk voor het gebruik binnen KLIP. Raadpleeg deze whitepaper op de ESRI website voor een uitgebreide beschrijving van dit bestandsformaat: HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 14 / 41

15 Enkele voorwaarden waaraan de ESRI Shapefile moet voldoen zijn: - de shapefile mag geen punten bevatten, alleen lijnen en polygonen; - geometrie is beschreven in het Belgische Lambert 72 coördinaatsysteem (de toepassing voert geen coördinaattransformatie uit). De velden uit het dbase-bestand van de Shapefile zullen worden overgenomen in het GML bestand na conversie. De toepassing gaat echter op zoek naar bepaalde velden die een speciale betekenis krijgen in het GML bestand. Bij het opladen van het GML bestand in de KLIP portaal zullen deze velden gebruikt worden voor de configuratie en het beheer van de KLB- of ODB-zone. Raadpleeg de paragraaf over de voorbereiding van de inputbestanden voor een uitgebreide beschrijving van deze velden Autodesk Drawing exchange Format (DXF) Het bestandsformaat DXF is een open formaat, gedefinieerd door Autodesk, voor de uitwisseling van CAD gegevens. De toepassing ondersteund deze versies van het DXF formaat: - AutoCAD R12; - AutoCAD R13; - AutoCAD R14; - AutoCAD Net als bij een Shapefile, moet ook voor het DXF bestand de geometrie beschreven zijn in het Belgische Lambert 72 coördinaatsysteem (de toepassing voert geen coördinaattransformatie uit). Elke individuele afwijking wordt beschreven door een apart block dat bestaat uit een gesloten veelhoek (closed polyline) en bijhorende attributen op laag KLBzone voor KLB s en op laag ODBzone voor ODB s. De naam van het block is vrij te kiezen. Zie voor de definitie van de verplichte attribuutvelden. Naast de verplichte attribuutvelden kan de gebruiker eveneens specifieke eigen attributen voorzien. Deze eigen attributen worden meegenomen in het GML bestand. Het aantal toegelaten attributen die door de gebruiker zelf gedefinieerd kunnen worden is beperkt tot maximaal 6 attributen. Een sjabloon DXF bestand dat dit principe illustreert kan afgeladen worden op Output bestanden De structuur en inhoud van het GML bestand wordt beschreven in een GML applicatie schema. Een GML applicatie schema is een gewoon XML Schema dat zelf gebruik maakt van de XML Schema s die deel uitmaken van het GML framework verdeeld door het Open Geospatial Consortium (OGC). Aangezien de informatie die een KLB en een ODB moet opladen in KLIP verschillend is, is er een apart GML applicatieschema voor beide doelgroepen. De GML applicatie schema s voor KLIP maken gebruik van GML Onderstaande figuur verduidelijkt de samenhang tussen de verschillende XML bestanden. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 15 / 41

16 Merk op dat het XML Schema attributes.xsd door de conversietoepassing wordt aangemaakt, maar eigenlijk deel uitmaakt van het XML Schema dat de KLB- of ODB-zone beschrijft. Het vormt met andere woorden een aanvulling op het standaard schema waarin attributen die eigen zijn aan de gebruiker worden gedefinieerd. Het XML Schema attributes.xsd wordt niet aangemaakt als de gebruiker geen eigen attributen definieert. Er worden maximaal 6 gebruikersattributen ondersteund door het schema. Indien er meer dan 6 attributen door de gebruiker meegegeven worden in het input bestand zal tijdens de validatie van het GML een foutmelding gegeven worden en zal de validatie falen. De XML Schema s van het GML 2 framework die in KLIP worden gebruikt verschillen van de schema s die door het OGC worden verdeeld. Er zijn enkele kleine aanpassingen gebeurd opdat de schema s ook zouden worden aanvaard door recente XML parsers. Het is dus niet aangewezen om de KLIP GML bestanden te valideren tegen de XML Schema s die door het OGC worden verdeeld. De XML Schema s van het GML 2 framework en de GML applicatie schema s voor KLIP maken deel uit van de installatie van de toepassing. Ze kunnen in de installatiefolder worden geraadpleegd: [Installatiefolder] Agiv \---- AGIV GML conversie en validatietoepassing \----schemas +----KLBzone KLBZone-2.0.xsd KLB-zone GML applicatie schema feature.xsd geometry.xsd aangepaste GML 2 XML Schema s xlinks.xsd HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 16 / 41

17 \----ODBzone ODBZone-1.3.xsd ODB-zone GML applicatie schema feature.xsd geometry.xsd aangepaste GML 2 XML Schema s xlinks.xsd De schema s kunnen ook worden gedownload van de AGIV website waar de installatietoepassing kan worden gedownload: Voorbereiding input bestanden Bij het uitvoeren van de conversie gaat de toepassing op zoek naar het voorkomen van bepaalde velden in het inputbestand. Alle velden uit het inputbestand worden integraal overgenomen in het GML-bestand, maar bepaalde velden krijgen een speciale betekenis waarvan gebruik zal worden gemaakt bij de configuratie en het beheer van het interessegebied in KLIP. Deze velden of attributen worden nu één voor één besproken Overzicht van verwachte velden Volgende tabel geeft een overzicht van alle verwachte veldnamen die in een inputbestand kunnen voorkomen: Veldnaam (inputbestand) GML attribuutnaam (outputbestand) Type Verplicht in input? Verplicht in output? KLB_REF klbreference token Neen Ja ODB_REF odbreference token Neen Ja KLB_NAME klbname string Neen Neen KLB_VERSIO klbversion string Neen Neen MOD_DATE lastmodificationdate date Neen Neen PRECISION precision nonnegativeinteger Neen Neen BUFFER (*) buffer nonnegativeinteger Neen Ja (*) Het veld BUFFER wordt niet beschouwd als een bijzonder veld als het inputbestand polygonen bevat. Alleen voor lijnen is dit veld belangrijk om de lijngeometrie te vertalen in een polygoongeometrie. Volgende tabel geeft een overzicht van de types van de waarden van de velden: Type Beschrijving Voorbeeld string Een tekst van maximaal 255 karakters. Ook karakters die een speciale betekenis hebben in XML zijn toegestaan (bvb. <, >, &, ). Die zone daar token Een string zonder wit-ruimte (spaties, tabs, etc.). ABC123 date Een datum (zonder tijdsindicatie) in het formaat YYYY-MM-DD HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 17 / 41

18 nonnegativeinteger Een positief geheel getal: 0, 1, 2, 3, Veld KLB_REF Het veld KLB_REF wordt verwacht in het inputbestand voor de aanmaak van een KLB-zone. Het bevat een unieke referentie van het feature in de KLB-zone. Het veld is alleen verplicht wanneer de input bestaat uit een DXF-bestand en een gekoppeld CSVbestand. Zoals weergegeven in Error! Reference source not found. wordt de expliciete koppeling tussen beide bestanden gelegd op basis van unieke waarden in dit veld. Bij de conversie wordt de waarde van het veld toegekend aan het verplichte GML attribuut klbreference. Indien het veld KLB_REF ontbreekt wordt in het GML bestand een automatisch volgnummer toegekend (1, 2, 3, ) Veld ODB_REF Het veld ODB_REF wordt verwacht in het inputbestand voor de aanmaak van een ODB-zone. Het bevat een unieke referentie van het feature in de ODB-zone. Het veld is alleen verplicht wanneer de input bestaat uit een DXF-bestand en een gekoppeld CSVbestand. Zoals weergegeven in Error! Reference source not found. wordt de expliciete koppeling tussen beide bestanden gelegd op basis van unieke waarden in dit veld. Bij de conversie wordt de waarde van het veld toegekend aan het verplichte GML attribuut odbreference. Indien het veld ODB_REF ontbreekt wordt in het GML bestand een automatisch volgnummer toegekend (1, 2, 3, ) Veld KLB_NAME Het veld KLB_NAME wordt verwacht in het inputbestand voor de aanmaak van een KLB-zone. Het bevat een naam voor het feature in de KLB-zone. Het veld is niet verplicht en er wordt geen default waarde voorzien. Bij de conversie wordt de waarde van het veld toegekend aan het GML attribuut klbname Veld KLB_VERSIO Het veld KLB_VERSIO (~ version) wordt verwacht in het inputbestand voor de aanmaak van een KLB-zone. Het bevat een indicatie van de versie voor het feature in de KLB-zone bvb of versie 5. Het veld is niet verplicht en er wordt geen default waarde voorzien. Bij de conversie wordt de waarde van het veld toegekend aan het GML attribuut klbversion Veld MOD_DATE Het veld MOD_DATE wordt verwacht in het inputbestand voor de aanmaak van een KLB-zone. Het bevat de datum van laatste wijziging van het feature in de KLB-zone. Het veld bevat alleen de datum en geen tijdsindicatie. Het formaat is steeds YYYY-MM-DD. Het veld is niet verplicht en er wordt geen default waarde voorzien. Bij de conversie wordt de waarde van het veld toegekend aan het GML attribuut lastmodificationdate Veld PRECISION Het veld PRECISION wordt verwacht in het inputbestand voor de aanmaak van een KLB-zone. Het bevat een indicatie van de nauwkeurigheid van de geometrie van het feature in de KLB-zone. De waarde wordt uitgedrukt in gehele meters. Het veld is niet verplicht en er wordt geen default waarde voorzien. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 18 / 41

19 Bij de conversie wordt de waarde van het veld toegekend aan het GML attribuut precision. Raadpleeg figuur Gebruik van velden BUFFER en PRECISION bij het opladen van KLB-zone voor de betekenis van dit veld bij het opladen van een lijn of polygoon in KLIP Veld BUFFER Het veld BUFFER wordt verwacht in het inputbestand voor de aanmaak van een KLB-zone én ODB-zone, wanneer het inputbestand features bevat met een lijngeometrie. Het bevat de grootte van de buffer die rond de lijngeometrie moet worden genomen bij het opslaan van het lijnfeature als een polygoon in KLIP (KLIP werkt immers uitsluitend op basis van polygonen). De waarde wordt uitgedrukt in gehele meters. Het veld is niet verplicht, maar als het ontbreekt wordt default waarde 0 voorzien. Bij het opladen van een lijnenfeature met buffer 0 in KLIP wordt automatisch de kleinst mogelijke buffer van 1 meter aangenomen. Bij de conversie wordt de waarde van het veld toegekend aan het GML attribuut buffer. Raadpleeg figuur Gebruik van velden BUFFER en PRECISION bij het opladen van KLB-zone voor de betekenis van dit veld bij het opladen van een lijn of polygoon in KLIP. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 19 / 41

20 Gebruik van velden BUFFER en PRECISION bij het opladen van KLB-zone 4.5 Ingeven metadata Bij het converteren heeft de gebruiker de mogelijkheid om metadata in te geven. Deze metadata beschrijft de referentielaag waarmee de informatie die is opgeslagen in het bronbestand best kan worden geraadpleegd. Voor het ingeven van de metadata, voer je de volgende operaties uit: 1. Activeer tabblad Metadata. 2. Geef de titel in van de referentielaag. 3. Geef de naam in van de eigenaar van de referentielaag. 4. Geef de versie in van de referentielaag. 5. Selecteer het schaalniveau van de referentielaag. Merk op het invullen van de metadata niet verplicht is. Bij het invullen van één van de velden worden alle velden meteen verplicht. De gebruiker kan dus ofwel geen metadata voorzien, ofwel alle metadatavelden. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 20 / 41

21 Overzicht tab Metadata 4.6 Uitvoeren conversie Conversie van shapefile naar GML Voor het converteren van een shapefile die een interessegebied beschrijft naar het overeenkomstig GML-bestand, voer je de volgende operaties uit: 1. Selecteer KLB GML of ODB GML in het navigatie venster. 2. Activeer tabblad Shape naar GML. 3. Geef het volledige pad in naar de locatie van het input shape bestand. 4. Geef het volledige pad in naar de locatie waar de output moet worden gegenereerd. De output bestaat uit een GML-bestand en het bijhorende XML Schema attributes.xsd. 5. Start de conversie. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 21 / 41

22 Dialoog voor uitvoeren conversie van Shapefile naar GML Als er tijdens het aanmaken van het GML bestand een fout optreedt, dan verschijnt deze links onderaan in het scherm. Melding van fout bij conversie Meteen na de conversie wordt de validatie uitgevoerd op het gegenereerde bestand. Een fout bij validatie zal worden aangeboden als een webpagina die vanuit de toepassing kan worden geopend. Merk op dat de validatie integraal deel uitmaakt van de conversie: een GML bestand wordt door de KLIP portaal alleen maar aanvaard als de validatie geen fouten geeft Conversie van DXF/CSV naar GML Voor het converteren van een DXF- en CSV- bestand die een interessegebied beschrijft naar het overeenkomstig GML-bestand, voer je de volgende operaties uit: 1. Selecteer KLB GML of ODB GML in het navigatie venster. 2. Activeer tabblad DXF naar GML. 3. Geef het volledige pad in naar de locatie van het input DXF bestand. 4. Geef het volledige pad in naar de locatie waar de output moet worden gegenereerd. De HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 22 / 41

23 output bestaat uit een GML-bestand en het bijhorende XML Schema attributes.xsd. 5. Start de conversie. Dialoog voor uitvoeren conversie van DXF- en CSV-bestand naar GML Als er tijdens het aanmaken van het GML bestand een fout optreedt, dan verschijnt deze links onderaan in het scherm. Meteen na de conversie wordt de validatie uitgevoerd op het gegenereerde bestand. Een fout bij validatie zal worden aangeboden als een webpagina die vanuit de toepassing kan worden geopend. Merk op dat de validatie integraal deel uitmaakt van de conversie: een GML bestand wordt door de KLIP portaal alleen maar aanvaard als de validatie geen fouten geeft. 4.7 Bekijken resultaat Het resultaat na conversie is een GML bestand dat het interessegebied beschrijft. Steeds meer desktop GIS-toepassingen kunnen het GML formaat lezen. Om snel een beeld te hebben van de output na de conversie zijn er enkele gratis toepassingen beschikbaar waarmee de dataset kan worden gevisualiseerd. Een lijst van freeware kan op de AGIV website worden geraadpleegd: Een voorbeeld van zo n toepassing is de gratis viewer van TatukGIS. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 23 / 41

24 Raadplegen GML in TatukGIS 4.8 Gebruik van de toepassing voor validatie De toepassing biedt de gebruiker de mogelijkheid om de structuur en inhoud van een GML bestand te valideren tegen het GML applicatie schema dat een KLB- of ODB-zone beschrijft. De validatie die deze toepassing uitvoert is maar een deel van de validatie die de KLIP-portaal doet bij het opladen van het GML uitwisselingsbestand. Het heeft met andere woorden geen zin om een GMLbestand op te laden in de KLIP-portaal als de inhoud van het bestand niet door de validatietoepassing is aanvaard. Merk op dat de validatietoepassing de inhoud maar in beperkte mate kan testen. De juistheid van CRAB straatcodes of perceels-id s bijvoorbeeld zal niet worden nagegaan, maar het formaat van deze attributen kan wel worden gecontroleerd Scope van de validatie De GML validatietoepassing controleert of GML bestanden aan de structuur en inhoud van het GML applicatie schema beantwoorden. Een GML applicatie schema, kan, net als elk ander XML Schema heel nauwe voorwaarden opleggen aan de structuur van een XML bestand. Ook de vorm waaraan de inhoud moet beantwoorden kan worden vastgelegd, maar de geldigheid ervan niet. Daarvoor moet extra informatie worden geraadpleegd en dit kan uitsluitend gebeuren bij het opladen in de KLIP website zelf. Volgende tabel geeft een overzicht van de verschillende types GML features die kunnen voorkomen in een GML bestand en het bereik van de validatie door de GML validatietoepassing. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 24 / 41

25 Type GML feature Valideert wél Valideert niet (Multi)PolygonGeometry (Multi)LineStringGeometry structuur (content model) van dit GML element gebruik van Belgische Lambert 72- coördinaten CityReference formaat van de NIS-code (5 digits, niet beginnend met een 0, bvb voor de gemeente Aartselaar) bestaan van de NIS-code (bvb. code is geen NIS-code van een Belgische gemeente) StreetReference AddressReference division, section, groundnumber, exponent, power, bisnumber formaat van de straatnaamcode (strikt positief geheel getal) formaat van de velden van een adres zoals beschreven in de CRAB documentatie De verschillende onderdelen van een perceels identificatie zoals beschreven in de aanbeveling voor uitwisseling van perceelsgegevens bestaan van een straatnaam in CRAB met deze code bestaan van een adres (combinatie straatnaamcode + huisnummer) in CRAB bestaan van een kadastrale perceels identificatie Valideren van KLB-zone Voor het valideren van een GML-bestand dat een KLB-zone beschrijft, voer je volgende operaties uit: 1. Selecteer KLB GML of ODB GML in het navigatie venster. 2. Activeer tabblad GML Validatie. 3. Geef het volledige pad in naar de locatie van het GML-bestand of selecteer aan de hand van een aparte dialoog. 4. Start de validatie. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 25 / 41

26 Overzicht tab GML validatie (voor KLB) Als het GML-bestand geen fouten bevat, dan verschijnt onderaan links in het groen de boodschap Validatie ok!. Melding van een geslaagde validatie Indien er wel een fout wordt gevonden in het GML-bestand, dan verschijnt onderaan links in het rood de boodschap Validatie niet ok! gevolgd door een link naar een HTML-pagina die een lijst van foutboodschappen bevat. De pagina wordt lokaal bewaard en kan worden geraadpleegd met elke webbrowser. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 26 / 41

27 Melding van fout bij validatie Webpagina met foutenlijst na validatie Valideren van ODB-zone De validatie van een ODB-zone verloopt analoog aan de validatie van een KLB-Zone. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 27 / 41

28

29 5 Gebruik van de toepassing voor GRB 5.1 Doelstelling Voor het GRB worden gegevens uitgewisseld tussen het AGIV en GRB-gebruikers in het kader van de GRB-meldingsprocedure. Deze procedure legt vast op welke manier GRB-afwijkingen gemeld kunnen worden en welke feedback een melder hierover kan krijgen. (zie > projecten > GRB > GRB-bijhouding > De meldingsprocedure) Hierna vind je een overzicht van de verschillende mogelijkheden die er zijn om GRB-afwijkingen te melden, en de rol die de AGIV GML conversie- en validatietoepassing hierin speelt: maken van GRB-afwijkingen On line maken van GRB-afwijkingen in GML maken van GRB-afwijkingen in Shape maken van GRB-afwijkingen in dxf Conversie Shape naar GML + validatie Conversie DXF naar GML + validatie validatie GRB-afwijkingen in GML opladen Controle (AGIV) GRB-afwijkingen Gecontroleerd Met feedback in GML Validatie + conversie Gml2shape Validatie + Conversie Gml2dxf GRB-afwijkingen Gecontroleerd Met feedback in shape GRB-afwijkingen Gecontroleerd Met feedback in dxf Rol van de AGIV GML conversie- en validatietoepassing bij het melden van GRB-afwijkingen. GRB-afwijkingen kunnen op 3 manieren gemaakt en gemeld worden: HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 29 / 41

30 1. de gebruiker maakt GRB-afwijkingen rechtstreeks on-line, 2. de gebruiker maakt GRB-afwijkingen in GML-formaat en upload deze naar AGIV. Het is aan te raden om de structuur van het GML-bestand te controleren vóórdat het opgeladen wordt. Hiervoor gebruik je de validatietool voor GRB-meldingen 3. de gebruiker maakt GRB-afwijkingen in shape- of DXF-formaat, converteert deze vervolgens naar een GML-bestand en upload dit tenslotte naar AGIV. Hiervoor gebruik je de conversietool voor GRB-meldingen. Het GML-bestand wordt na de conversie automatisch aan de validatietoepassing onderworpen Alle afwijkingen worden vervolgens door AGIV inhoudelijk gecontroleerd. Daarbij kan het gebeuren dat AGIV afwijkingen verbetert of aanpast. Informatie over de uitslag van de controles wordt voor elke individuele afwijking in extra attributen opgenomen. De afwijkingen met de extra attributen worden tenslotte terugbezorgd aan de melder in GML-formaat. De gebruiker kan deze vervolgens terug naar shape- of DXF-formaat converteren met de GML-tools: gml2shape en gml2dxf. Deze conversie wordt voorafgegaan door een automatische validatie van het GML-bestand. 5.2 De tools voor GRB-meldingen De conversie- en validatietools vind je in het navigatievenster onder GRB Melding. De steekkaart die je hiermee oproept, bestaat uit 3 tabbladen: een eerste voor de conversie van shape naar GML, een tweede voor de conversie van dxf naar GML en een derde voor de validatie van een GML-bestand. De validatietool is bedoeld voor gebruikers die zelf GML-bestanden genereren. De extra GML-tools voor de conversie van GML naar shape- of DXF-formaat vind je in het navigatievenster onder GML Tools. Er is een aparte steekkaart voor de conversie naar shape en één voor de conversie naar dxf. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 30 / 41

31 5.3 Conversie van shape of DXF naar GML Hoe start ik de conversie? Je roept de steekkaart Melding GML op. Vervolgens kies je het tabblad Shape naar GML of DXF naar GML. Je vult achtereenvolgens de naam (met het volledige pad) in van het inputbestand en van het outputbestand waarna je de conversie start Hoe verloopt de conversie? Achter de schermen gebeurt veel meer dan een simpele conversie: De structuur van het inputbestand én de geometrie van de afzonderlijke GRB-afwijkingen wordt gecontroleerd. GRB-afwijkingen met een foute geometrie (donuts, multipart ) zullen niet opgenomen worden in het output GML-bestand. Het inputbestand wordt vervolgens geconverteerd naar een output GML-bestand Meteen na de conversie wordt het gegenereerde bestand gevalideerd tegen het GML applicatieschema voor GRB-meldingen. Merk op dat het output GML-bestand enkel kan geüpload worden als de validatie geen fouten geeft Hoe weet ik of de conversie goed/fout verloopt? Je vindt een leesvenster in het midden van de steekkaart. Fouten of correcties uit de controle van het inputbestand worden hier getoond. Als het inputbestand een shapefile is, dan vind je in dit leesvenster het aantal geconverteerde shapes. Merk op dat shapes met een foute geometrie (donuts, multiparts ) niet geconverteerd worden. Wanneer er tijdens de validatie van het GML-bestand geen fouten gedetecteerd worden, dan wordt de boodschap GML validatie OK getoond. Deze verschijnt onderaan het applicatievenster. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 31 / 41

32 Wanneer er tijdens de validatie van het GML-bestand fouten gedetecteerd worden, dan wordt de boodschap GML validatie niet OK! getoond. Deze verschijnt onderaan het applicatievenster. Daarenboven worden deze fouten weggeschreven in een html-pagina, die door de gebruiker onmiddellijk kan geopend worden Hoe moet een input shapebestand er uitzien? Het input bestand moet een ESRI Shapefile zijn met de volgende vaste structuur: : ESRI Shapefile Elke individuele afwijking wordt beschreven door een aparte veelhoek (shape). De bijhorende attributen worden in een overeenkomstig dbf-bestand opgenomen. De veelhoek wordt als een Polygonshape geconstrueerd. bestanden <bestandsnaam>.shp <bestandsnaam>.shx <bestandsnaam>.dbf attribuutomschrijving attribuutnaam Definitie identificator idn getal (15,0) (>0) oorzaak afwijking Oorzaak getal (4,0) (>0) verduidelijking Verduid tekst (254) datum vaststelling Vstldatum tekst (10) Formaat: jjjj-mm-dd bouwheer Bouwh getal (4,0) datum beschrijving Bschrdatum tekst (10) Formaat: jjjj-mm-dd Je gebruikt bij voorkeur de sjabloonbestanden voor GRB-afwijkingen. Het sjabloonbestand in shapeformaat kan je van de AGIV-website downloaden. ( > AGIV Home > Projecten > GRB > GRB-bijhouding > de meldingsprocedure) Hoe moet een input dxf-bestand er uitzien? Het inputbestand moet een AutoCAD dxf-bestand zijn met de volgende vaste structuur: HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 32 / 41

33 Autodesk Drawing exchange Format (dxf) Elke individuele afwijking wordt beschreven door een apart block dat bestaat uit een gesloten veelhoek (closed polyline) en bijhorende attributen op laag afwijking. De naam van het block is vrij te kiezen. bestanden <bestandsnaam>.dxf attribuutomschrijving Attribuutnaam Definitie (=prompt) (=tag) identificator Idn niet van toepassing oorzaak afwijking Oorzaak niet van toepassing verduidelijking Verduid niet van toepassing; de syntaxregels moeten wel toegepast worden datum vaststelling Vstldatum Formaat: jjjj-mm-dd bouwheer Bouwh niet van toepassing datum beschrijving Bschrdatum Formaat: jjjj-mm-dd Je gebruikt bij voorkeur de sjabloonbestanden voor GRB-afwijkingen. Het sjabloonbestand in dxfformaat kan u van de AGIV-website downloaden ( > AGIV Home > Projecten > GRB > GRB-bijhouding > de meldingsprocedure) Hoe ziet een output GML-bestand er uit? De structuur en de inhoud van het GML-bestand wordt beschreven in een GML applicatieschema, specifiek voor GRB-meldingen. Meer uitleg over GML en GML applicatieschema s kan je in bijlage 1 vinden. 5.4 Validatie van GML Hoe start ik de validatie? Je roept de steekkaart Melding GML op. Vervolgens kies je het tabblad GML validatie. Je vult achtereenvolgens de naam (met het volledige pad) in van het GML-bestand waarna je de validatie start. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 33 / 41

34 5.4.2 Hoe weet ik of de validatie goed/fout verloopt? Wanneer er tijdens de validatie van het GML-bestand geen fouten gedetecteerd worden, dan wordt de boodschap GML validatie OK getoond. Deze verschijnt onderaan het applicatievenster. Wanneer er tijdens de validatie van het GML-bestand fouten gedetecteerd worden, dan wordt de boodschap GML validatie niet OK! getoond. Deze verschijnt onderaan het applicatievenster. Daarenboven worden deze fouten weggeschreven in een html-pagina, die door de gebruiker onmiddellijk kan geopend worden. Merk op dat de validatietoepassing voornamelijk de structuur van de gegevens controleert. Er wordt bijvoorbeeld niet nagegaan of de ingesloten afwijkingen terecht zijn, of dat ze juist afgebakend zijn. Deze controles gebeuren interactief bij het AGIV nadat de bestanden geüpload zijn Hoe moet een input GML-bestand er uitzien? De structuur en de inhoud van het GML-bestand wordt beschreven in een GML applicatieschema, specifiek voor GRB-meldingen. Meer uitleg over GML en GML applicatieschema s kan je in bijlage 1 vinden. 5.5 Conversie van GML naar shape of DXF Hoe start je de conversie? In het navigatievenster vind je onder de rubriek GML tools 2 extra toepassingen: GML2Shapefile en GML2DXF. Beide toepassingen hebben een eigen steekkaart, met eenzelfde structuur. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 34 / 41

35 De tools zijn voorzien om GML-bestanden te converteren zowel voor KLIP als voor GRB-Meldingen. Het spreekt voor zich dat de structuur van de bestanden (zowel input als output) verschillend is voor KLIP of voor GRB. Daarom wordt het GML-bestand vóór conversie gevalideerd tegen een specifiek GML-applicatieschema (er is een apart GML-applicatieschema voor GRB en voor KLIP). Voor GRB-meldingen moet je het applicatieschema GRB Melding selecteren 1. Je vult vervolgens de naam (met het volledige pad) in van het inputbestand en van het outputbestand. Daarna kan je de conversie starten Hoe verloopt de conversie? Achter de schermen gebeurt veel meer dan een simpele conversie: Het GML-bestand wordt eerst gevalideerd tegen het gekozen GML applictieschema. Dit moet nagaan of alle gegevens voor GRB Meldingen in de gepaste structuur aanwezig zijn Indien er tijdens de validatie geen fouten gedetecteerd worden, dan wordt het GML bestand geconverteerd Hoe weet ik of de conversie goed/fout verloopt? Wanneer er tijdens de validatie van het GML-bestand geen fouten gedetecteerd worden, dan wordt de boodschap Conversie voltooid getoond. Deze verschijnt onderaan het applicatievenster. Wanneer er tijdens de validatie van het GML-bestand fouten gedetecteerd worden, dan wordt de boodschap Validatie GML bestand is mislukt! getoond. Deze verschijnt onderaan het applicatievenster. Daarenboven worden deze fouten weggeschreven in een html-bestand, dat onmiddellijk kan geopend worden. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 35 / 41

36 5.5.4 Hoe ziet een output shapebestand er uit? Het output bestand is een ESRI Shapefile met de volgende vaste structuur: ESRI Shapefile Elke individuele afwijking wordt beschreven door een aparte veelhoek (shape). De bijhorende attributen worden in een overeenkomstig dbf-bestand opgenomen. De veelhoek wordt als een Polygonshape geconstrueerd. bestanden <bestandsnaam>.shp <bestandsnaam>.shx <bestandsnaam>.dbf attribuutomschrijving Attribuutnaam definitie identificator Idn getal (15,0) (>0) oorzaak afwijking Oorzaak getal (4,0) (>0) verduidelijking Verduid tekst (254) datum vaststelling Vstldatum tekst (10),formaat: jjjj-mm-dd bouwheer Bouwh getal (4,0) datum beschrijving Bschrdatum tekst (10),formaat: jjjj-mm-dd Status validatie StatusVali Getal (2,0) (>0) Is aangepast? Isaangepas Getal (1,0) (>0) Opmerking controle OpmContr Tekst (254) Datum controle DatumContr Tekst (10), formaat jjjj-mm-dd Hoe ziet een output DXF-bestand er uit? Het outputbestand is een AutoCAD dxf-bestand met de volgende vaste structuur: Autodesk Drawing exchange Format (dxf) Elke individuele afwijking wordt beschreven door een apart block dat bestaat uit een gesloten veelhoek (closed polyline) en bijhorende attributen op laag afwijking. bestanden <bestandsnaam>.dxf attribuutomschrijving Attribuutnaam definitie (=prompt) (=tag) identificator Idn niet van toepassing HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 36 / 41

37 oorzaak afwijking Oorzaak niet van toepassing verduidelijking Verduid niet van toepassing; de syntaxregels moeten wel toegepast worden datum vaststelling Vstldatum Formaat: jjjj-mm-dd bouwheer Bouwh niet van toepassing datum beschrijving Bschrdatum Formaat: jjjj-mm-dd Status validatie StatusVali Niet van toepassing Is aangepast? Isaangepas Niet van toepassing Opmerking controle OpmContr Niet van toepassing Datum controle datumcontr Formaat:jjjj-mmdd HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 37 / 41

38

39 6 Ondersteuning Voor vragen of opmerkingen kan u steeds contact opnemen met het AGIV: Per helpdesk@agiv.be Per telefoon: +32 (0) HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 39 / 41

40

41 Bijlage 1 - GML en GML applicatieschema Voor KLIP of voor GRB-meldingen worden gegevens tussen gebruikers en het AGIV uitgewisseld via GML-bestanden. Het is duidelijk dat voor KLIP andere informatie uitgewisseld wordt dan voor GRB-meldingen. Voor KLIP moet er dan ook nog eens een onderscheid gemaakt worden tussen de bestanden die aangeodben worden door Kabel- en LeidingBeheerders (KLB) en de bestanden van de Beheerders Openbaar Domein (ODB). Samengevat betekent dit dat de GML-bestanden voor deze verschillende doelgroepen een andere structuur en inhoud hebben. De structuur en de inhoud van een GML-bestand wordt beschreven in een GML applicatie schema. Een GML applicatieschema is een XML schema dat uitgebreid is met de mogelijkheid om ook geografische informatie op te nemen. Daarvoor maakt het GML applicatieschema zelf gebruik van XML schema s die deel uitmaken van het GML framework verdeeld door het Open Geospatial Consortium (OGC). De onderstaande figuur verduidelijkt de oorsprong en de relatie tussen de GML-bestanden en de verschillende XML-schema s voor GRB-meldingen. GML-bestand Beschrijving: GML-bestand met GRB-afwijkingen dat door de gebruikers aangeodben wordt GML-bestand met gecontroleerde en eventueel aangepaste GRB-afwijkingen dat door AGIV teruggestuurd wordt naar de melders Oorsprong: gebruikers, AGIV Refereert naar GRBMelding.xsd (GML applicatieschema) Beschrijving: Het GML applicatieschema beschrijft de structuur en de inhoud van de GML-bestanden die voor GRB-meldingen uitgewisseld worden. Het GML-applicatieschema dient als referentie wanneer GML-bestanden gevalideerd worden. Oorsprong: AGIV Maakt gebruik van Feature.xsd Maakt gebruik van Beschrijving: XML schema s die toelaten om geografische gegevens op te nemen in GML-bestanden. Oorsprong: OGC geometry.xsd xlinks.xsd Het GML applicatieschema en de OGC XML-schemas worden bij de installatie van de toepassing in de installatiemap geplaatst en kunnen daar geraadpleegd worden. HandleidingAgivGMLConversieEnValidatieToepassingv _final.docx 28/04/ :24 41 / 41