Handleiding. AGIV GML conversie- en validatietoepassing v

Handleiding AGIV GML conversie- en validatietoepassing v2.2.0.0

Identificatie Versie Publicatie Achtergrond Auteur

2.2.0.0 21 april 2009 Joeri Robbrecht, Luc De Kock

HandleidingAgivGMLConversieEnValidatieToepassingv2.2.0.0_final.docx

1 / 41

Agentschap voor Geografische Informatie Vlaanderen

Inhoud AGIV GML conversie- en validatietoepassing v2.1.0.0

1

Inhoud

3

1

Inleiding

5

2

Afkortingen en definities

7

3

Installatie

9

3.1 Installatievoorwaarden

9

3.2 De toepassing installeren

9

3.3 De toepassing verwijderen

9

3.4 De toepassing starten

9

3.5 Een korte rondleiding

10

Gebruik van de toepassing voor KLIP

13

4.1 Doelstelling

13

4

4.2 Input bestanden

5

14

4.2.1 ESRI Shapefile

14

4.2.2 Autodesk Drawing eXchange Format (DXF)

15

4.3 Output bestanden

15

4.4 Voorbereiding input bestanden

17

4.4.1 Overzicht van verwachte velden

17

4.4.2 Veld KLB_REF

18

4.4.3 Veld ODB_REF

18

4.4.4 Veld KLB_NAME

18

4.4.5 Veld KLB_VERSIO

18

4.4.6 Veld MOD_DATE

18

4.4.7 Veld PRECISION

18

4.4.8 Veld BUFFER

19

4.5 Ingeven metadata

20

4.6 Uitvoeren conversie

21

4.6.1 Conversie van shapefile naar GML

21

4.6.2 Conversie van DXF/CSV naar GML

22

4.7 Bekijken resultaat

23

4.8 Gebruik van de toepassing voor validatie

24

4.8.1 Scope van de validatie

24

4.8.2 Valideren van KLB-zone

25

4.8.3 Valideren van ODB-zone

27

Gebruik van de toepassing voor GRB

29

5.1 Doelstelling

29

5.2 De tools voor GRB-meldingen

30

5.3 Conversie van shape of DXF naar GML

31

5.3.1 Hoe start ik de conversie?

31

5.3.2 Hoe verloopt de conversie?

31

HandleidingAgivGMLConversieEnValidatieToepassingv2.2.0.0_final.docx • 28/04/2009 11:24

3 / 41


5.3.3 Hoe weet ik of de conversie goed/fout verloopt?

31

5.3.4 Hoe moet een input shapebestand er uitzien?

32

5.3.5 Hoe moet een input dxf-bestand er uitzien?

32

5.3.6 Hoe ziet een output GML-bestand er uit?

33

5.4 Validatie van GML 5.4.1 Hoe start ik de validatie?

33

5.4.2 Hoe weet ik of de validatie goed/fout verloopt?

34

5.4.3 Hoe moet een input GML-bestand er uitzien?

34

5.5 Conversie van GML naar shape of DXF

6

33

34

5.5.1 Hoe start je de conversie?

34

5.5.2 Hoe verloopt de conversie?

35

5.5.3 Hoe weet ik of de conversie goed/fout verloopt?

35

5.5.4 Hoe ziet een output shapebestand er uit?

36

5.5.5 Hoe ziet een output DXF-bestand er uit?

36

Ondersteuning

Bijlage 1 - GML en GML applicatieschema


39 41

4 / 41


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.


5 / 41


2

Afkortingen en definities AFKORTING

OMSCHRIJVING

ODB

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 http://www.autodesk.com/dxf. 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.

CSV

DXF

GML

GML applicatieschema

GRB GRBMS KLB

Grootschalig ReferentieBestand Vlaanderen GRB Melding Systeem. Dit is de omgeving voor het melden van GRB-afwijkingen. Meer informatie vindt je onder www.agiv.be > 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.

KLIP

Kabel en Leiding Informatie Portaal

MSI-bestand

Een installatiebestand van een Microsoft toepassing. Heeft uiteraard de extensie *.msi.

Referentielaag

Shapefile

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 http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf.

XML

eXtensible Markup Language. Voor uitleg, zie http://www.w3schools.com/xml.

XML Schema

Een opmaaktaal voor het definiëren van de structuur en inhoud van een XML document. Voor uitleg, zie http://www.w3schools.com/schema.


7 / 41


3 3.1

Installatie 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:

3.2

•

Microsoft .NET Framework 2.0: 280 MB (x86), 610 MB (x64)

•

Toepassing: 12 MB

De toepassing installeren Je kan het installatiebestand downloaden van de AGIV website: www.agiv.be > 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:


9 / 41


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.


10 / 41



11 / 41


4 4.1

Gebruik van de toepassing voor KLIP 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.


13 / 41


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. 4.2.1

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:


14 / 41


http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf

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. 4.2.2

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 2000.

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 4.4.1. 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 http://www.klip.be/Support/ .

4.3

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 2.1.2. Onderstaande figuur verduidelijkt de samenhang tussen de verschillende XML bestanden.


15 / 41


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 feature.xsd

KLB-zone GML applicatie schema

| | |

geometry.xsd xlinks.xsd

aangepaste GML 2 XML Schema’s


16 / 41


\----ODBzone ODBZone-1.3.xsd feature.xsd

ODB-zone GML applicatie schema

geometry.xsd xlinks.xsd

aangepaste GML 2 XML Schema’s

De schema’s kunnen ook worden gedownload van de AGIV website waar de installatietoepassing kan worden gedownload:

http://www.agiv.be/gis/downloads/Default.aspx?dt_id=22

4.4

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.

4.4.1

Overzicht van verwachte velden Volgende tabel geeft een overzicht van alle verwachte veldnamen die in een inputbestand kunnen voorkomen: Veldnaam (inputbestand)

GML attribuutnaam (outputbestand)

KLB_REF

klbReference

ODB_REF

Type

Verplicht

Verplicht

in input ?

in output?

token

Neen

Ja

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.

2005-12-06


17 / 41


nonNegativeInteger 4.4.2

Een positief geheel getal: 0, 1, 2, 3,…

5

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,…).

4.4.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,…).

4.4.4

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”.

4.4.5

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. “1.2.3” 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”.

4.4.6

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”.

4.4.7

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.


18 / 41


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. 4.4.8

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.


19 / 41


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. 2. 3. 4. 5.

Activeer tabblad “Metadata”. Geef de titel in van de referentielaag. Geef de naam in van de eigenaar van de referentielaag. Geef de versie in van de referentielaag. 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.


20 / 41


Overzicht tab Metadata 4.6 4.6.1

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. 2. 3. 4.

Selecteer “KLB GML” of “ODB GML” in het navigatie venster. Activeer tabblad “Shape naar GML”. Geef het volledige pad in naar de locatie van het input shape bestand. 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.


21 / 41


1

2

3 4

5

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. 4.6.2

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. 2. 3. 4.

Selecteer “KLB GML” of “ODB GML” in het navigatie venster. Activeer tabblad “DXF naar GML”. Geef het volledige pad in naar de locatie van het input DXF bestand. Geef het volledige pad in naar de locatie waar de output moet worden gegenereerd. De


22 / 41


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:

http://www.agiv.be/gis/knowhow/?artid=193

Een voorbeeld van zo’n toepassing is de gratis viewer van TatukGIS.


23 / 41


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. 4.8.1

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.


24 / 41


Type GML feature

Valideert wél

Valideert niet

structuur (content model) van dit GML element

gebruik van Belgische Lambert 72coördinaten

CityReference

formaat van de NIS-code (5 digits, niet beginnend met een 0, bvb. 11001 voor de gemeente Aartselaar)

bestaan van de NIS-code (bvb. code 11003 is geen NIS-code van een Belgische gemeente)

StreetReference

formaat van de straatnaamcode (strikt positief geheel getal)

bestaan van een straatnaam in CRAB met deze code

AddressReference

formaat van de velden van een adres zoals beschreven in de CRAB documentatie

bestaan van een adres (combinatie straatnaamcode + huisnummer) in CRAB

division, section, groundNumber, exponent, power, bisNumber

De verschillende onderdelen van een perceels identificatie zoals beschreven in de aanbeveling voor uitwisseling van perceelsgegevens

bestaan van een perceels identificatie

(Multi)PolygonGeometry (Multi)LineStringGeometry

4.8.2

kadastrale

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.


25 / 41


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.


26 / 41


Melding van fout bij validatie

Webpagina met foutenlijst na validatie 4.8.3

Valideren van ODB-zone De validatie van een ODB-zone verloopt analoog aan de validatie van een KLB-Zone.


27 / 41


5 5.1

Gebruik van de toepassing voor GRB 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 www.agiv.be > 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:


29 / 41


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.


30 / 41


5.3 5.3.1

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. 5.3.2

5.3.3

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.


31 / 41


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.

5.3.4

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 .shp .shx .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. (http://www.agiv.be > AGIV Home > Projecten > GRB > GRB-bijhouding > de meldingsprocedure) 5.3.5

Hoe moet een input dxf-bestand er uitzien? Het inputbestand moet een AutoCAD dxf-bestand zijn met de volgende vaste structuur:


32 / 41


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 .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 (http://www.agiv.be > AGIV Home > Projecten > GRB > GRB-bijhouding > de meldingsprocedure) 5.3.6

5.4 5.4.1

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. 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.


33 / 41


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. 5.4.3

5.5 5.5.1

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. 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.


34 / 41


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 . Je vult vervolgens de naam (met het volledige pad) in van het inputbestand en van het outputbestand. Daarna kan je de conversie starten. 5.5.2

5.5.3

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.


35 / 41


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 .shp .shx .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

5.5.5

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 .dxf attribuutomschrijving Attribuutnaam definitie (=prompt) (=tag) identificator Idn niet van toepassing


36 / 41


oorzaak afwijking verduidelijking

Oorzaak Verduid

datum vaststelling bouwheer datum beschrijving Status validatie Is aangepast? Opmerking controle Datum controle

Vstldatum Bouwh Bschrdatum StatusVali Isaangepas OpmContr datumContr

niet van toepassing niet van toepassing; de syntaxregels moeten wel toegepast worden Formaat: jjjj-mm-dd niet van toepassing Formaat: jjjj-mm-dd Niet van toepassing Niet van toepassing Niet van toepassing Formaat:jjjj-mmdd


37 / 41


6

Ondersteuning Voor vragen of opmerkingen kan u steeds contact opnemen met het AGIV: •

Per e-mail: [email protected]

•

Per telefoon: +32 (0)9 261 72 00


39 / 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 gebruikers aangeODBen wordt • GML-bestand met gecontroleerde aangepaste GRB-afwijkingen dat teruggestuurd wordt naar de melders

dat

door

de

en eventueel door AGIV

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

Beschrijving: XML schema’s die toelaten om geografische gegevens op te nemen in GML-bestanden.

Feature.xsd

Oorsprong: OGC Maakt gebruik van

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.


41 / 41

Handleiding. AGIV GML conversie- en validatietoepassing v

Recommend Documents