Handleiding. CRAB Edit. Transacties op Lite CRAB. Agentschap voor Geografische Informatie Vlaanderen

Handleiding CRAB Edit Transacties op Lite CRAB Agentschap voor Geografische Informatie Vlaanderen

Inhoud Inhoud 2 1 Inleiding 4 2 Operaties en datatypes 5 2.1 Overzicht 5 2.2 Edit operaties 5 2.2.1 Add 5 2.2.1.1 AddAdres 5 2.2.1.2 AddGebouw 10 2.2.1.3 AddStraat 10 2.2.1.4 AddWegverbinding 14 2.2.2 Update 14 2.2.2.1 UpdateAdres 15 2.2.2.2 UpdateSubadres 16 2.2.2.3 UpdateGebouw 18 2.2.2.4 UpdateStraat 19 2.2.2.5 UpdateWegverbinding 20 2.2.3 Delete 22 2.2.3.1 DeleteAdres 22 2.2.3.2 DeleteGebouw 22 2.2.3.3 DeleteStraat 22 2.2.3.4 DeleteWegverbinding 22 2.2.4 End 23 2.2.4.1 EndAdres 23 2.2.4.2 EndGebouw 23 2.2.4.3 EndStraat 23 2.2.4.4 EndWegverbinding 24 2.2.5 Hulpmethoden 24 2.2.5.1 GetGemeenteOmtrek 24 2.2.5.2 PerformRenumbering 24 2.2.6 Topologieregels 25 2.2.6.1 Gebouwen 25 2.2.6.2 Wegverbindingen 26 2.3 Verdachte gevallen 26 2.3.1 ListVerdachteGevallenQueries 26 2.3.2 CountVerdachteGevallenByQueryId 27 2.3.3 ListVerdachteGevallenByQueryId 27 2.3.4 ListVerdachteGevallenByQueryIdPaged 28 2.3.5 MaskVerdachteGevallen 29 2.4 Rapportering transacties 30 2 / 37 Handleiding CRABTools

2.4.1 ListBeheerdersByGemeente 30 2.4.2 ListTransacties 30 2.4.3 ListTransactiesPaged 32 2.4.4 ListTransactieAggregaten 32 2.5 Fouten 34 2.5.1 Validatiefouten 34 2.5.2 Onverwachte fouten 36 3 Implementatie 37 Handleiding CRABTools 3 / 37

1 Inleiding De CRAB Edit service biedt transactionele operaties aan op de Lite CRAB entiteiten. De transacties gebeuren rechtstreeks op de beheerdatabank. De gebruiker is uiteraard beperkt tot het eigen grondgebied. 4 / 37 Handleiding CRABTools

2 Operaties en datatypes 2.1 Overzicht Voor elke editeerbare entiteit zijn volgende operaties beschikbaar: Add: toevoegen van nieuwe exemplaren; Update: corrigeren van bestaande exemplaren; Delete: verwijderen van foutieve exemplaren; End: beëindigen van afgeschafte exemplaren. Naast de vier genoemde types operaties is er nog de volgende transactionele operatie: PerformRenumbering: een operatie waarmee in één beweging meerdere adressen in een straat kunnen overgebracht worden naar een andere straat. Er is ook een operatie die de gemeentegeometrie ontsluit die intern gebruikt wordt voor validatie van transacties op geometrische data: GetGemeenteOmtrek: deze operatie retourneert de gemeentegrens in Well-Known Text formaat. De CRAB Edit service biedt ook nog een API om met zogeheten verdachte gevallen om te gaan. Dit zijn gegevens waarvoor de datakwaliteitscontrole geen groen licht geeft en die moeten bekeken, dan wel opgelost worden door de gemeentelijke beheerder. De betreffende operaties zijn: ListVerdachteGevallenQueries: het oplijsten van de soorten verdachte gevallen; CountVerdachteGevallenByQueryId: het aantal verdachte gevallen van een bepaalde soort in de gemeente van de gebruiker; ListVerdachteGevallenByQueryId: een oplijsting van de verdachte gevallen van een bepaalde soort in de gemeente van de gebruiker; MaskVerdachteGevallen: een operatie om verdachte gevallen van de categorie 'verdacht' af te vinken. Een derde onderdeel van de CRAB Edit service API betreft de rapportering over transacties. Daartoe zijn volgende operaties voorzien: ListBeheerdersByGemeente: het oplijsten van de beheerders van de gemeente waartoe de gebruiker behoort; ListTransacties: het oplijsten van transacties die door de gemeente zijn gebeurd; ListTransactiesPaged: idem als vorige maar dan met paging; ListTransactieAggregaten: het oplijsten van kengetallen gegroepeerd per type transactie en entiteittype. In wat volgt worden de operaties en hun en parameters nader toegelicht. 2.2 Edit operaties 2.2.1 Add 2.2.1.1 AddAdres Aan de operatie AddAdres wordt een <AddAdresRequest> element meegegeven als parameter. Handleiding CRABTools 5 / 37

Gemeente Postcode Straatnaam Huisnummer [verplicht] Bevat de Nederlandstalige naam van de gemeente. [verplicht] Bevat de postcode die gekoppeld is aan het huisnummer. [verplicht] Bevat de Nederlandstalige naam van de straat. Enkel bestaande straatnamen zijn toegelaten. [verplicht] Bevat het nieuw toe te voegen huisnummer. Moet voldoen aan het formaat ^[1-9][0-9]*(BIS Bis bis TER Ter ter [a-za-z] _[0-9]+){0,1}$ ^ZN$ ^zn$. Is maximaal 11 karakters lang. Mag nog niet bestaan in de opgegeven straatnaam. 6 / 37 Handleiding CRABTools

Status Begindatum Subadressen RrAdres Posities BestaandePercelen BestaandeGebouw NieuweGebouwen [verplicht] Bevat de status van het huisnummer. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de datum waarop het huisnummer administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. [optioneel] Bevat de subadressen die aan het huisnummer gekoppeld zijn. [optioneel] Bevat het (bestaand of nieuw) rijksregisteradres dat aan het huisnummer gekoppeld is. [verplicht] Bevat één of meerdere posities op het terrein die aangeven waar het huisnummer gelegen is. Elke positie dient uniek te zijn qua attribuut herkomst. Huisnummers met status in gebruik kunnen enkel dan posities hebben met herkomst afgeleidvangebouw, manueleaanduidingvangebouw of manueleaanduidingvaningangvangebouw wanneer er ook een koppeling is met een gebouw. Huisnummers met status in gebruik kunnen enkel dan posities hebben met herkomst afgeleidvanperceelkadaster of manueleaanduidingvanperceel wanneer er ook een koppeling is met een perceel. [optioneel] Bevat de bestaande percelen die aan het huisnummer gekoppeld zijn. [optioneel] Bevat de gebouwen die aan het huisnummer gekoppeld zijn. [optioneel] Bevat de nieuw toe te voegen gebouwen die aan het huisnummer gekoppeld zijn. Busnummer/Appnummer [verplicht] Bevat de aanduiding van het subadres. Dit is ofwel een busnummer, ofwel een appartementsnummer. Een van beide dient verplicht ingevuld te worden. Is maximaal 35 karakters lang. Handleiding CRABTools 7 / 37

Positie Status Begindatum RrIndex [verplicht] Bevat de positie op het terrein die aangeeft waar het subadres gelegen is. [verplicht] Bevat de status van het subadres. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de datum waarop het subadres administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. Merk op dat de opgegeven datum kan verschillen van die van het huisnummer waartoe het subadres behoort, maar nooit kleiner kan zijn dan deze. [optioneel] Bevat de indexaanduiding van het rijksregisteradres dat aan het subadres gekoppeld is. Als aanduiding van het rrhuisnummer wordt de waarde overgenomen van het huisnummer waartoe het subadres behoort. Is maximaal vier karakters lang. RrHuisnummer RrIndex RrStraat [verplicht] Bevat de huisnummeraanduiding van het rijksregisteradres dat aan ht huisnummer gekoppeld is. Is maximaal 11 karakters lang. [optioneel] Bevat de indexaanduiding van het rijksregisteradres dat aan het huisnummer gekoppeld is. Is maximaal vier karakters lang. [verplicht] Bevat de rijksregisterstraat. Enkel bestaande zijn toegelaten. RrStraatcode Subkantoncode [verplicht] Bevat de code voor de straat zoals toegekend in het rijksregister. Bestaat uit vier cijfers. [verplicht] Bevat een viercijferige code die behoudens een paar uitzonderingen overeenkomt met de postcode waartoe de rijksregisterstraat behoort. 8 / 37 Handleiding CRABTools

Herkomst Wkt [verplicht] Bevat een aanduiding voor het soort adrespositie. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de geometrie van de adrespositie in Well-Known Text formaat in Lambert-72 projectie (EPSG 31370). Enkel geometriën van het type Point zijn toegestaan. De aangeleverde geometrie moet ook binnen de grenzen van de gemeente vallen. Capakey [verplicht] Bevat de unieke identificator van het perceel. Enkel bestaande percelen zijn toegelaten. Identificator [verplicht] Bevat de unieke identificator van het gebouw zoals gekend in CRAB. Enkel bestaande gebouwen zijn toegelaten. Handleiding CRABTools 9 / 37

AardGebouw Begindatum Geometriemethode Status Wkt [verplicht] Bevat de aard van het gebouw. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de datum waarop het gebouw administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. [verplicht] Bevat de methode waarmee de geometrie van het gebouw is bepaald. De toegelaten waardes worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. De methode grb is echter niet toegelaten daar deze voorbehouden is voor AGIV. [verplicht] Bevat de status van het gebouw. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de geometrie van het gebouw in Well-Known Text formaat in Lambert-72 projectie (EPSG 31370). Enkel geometriën van het type Polygon zijn toegestaan. De aangeleverde geometrie moet ook binnen de grenzen van de gemeente vallen en aan een aantal topologische regels voldoen indien de status van het gebouw in gebruik is. De operatie AddAdres geeft een <AddAdresResponse> element terug. Dit bevat het id van het nieuw toegevoegde adres. 2.2.1.2 AddGebouw Aan de operatie AddGebouw wordt een <AddGebouwRequest> element meegegeven als parameter. De operatie AddGebouw geeft een <AddGebouwResponse> element terug. Dit bevat het id van het nieuw toegevoegde gebouw. 2.2.1.3 AddStraat 10 / 37 Handleiding CRABTools

Aan de operatie AddStraat wordt een <AddStraatRequest> element meegegeven als parameter. Gemeente Straatnaam Straatnaam2 Status Begindatum RrStraten Wegkanten [verplicht] Bevat de Nederlandstalige naam van de gemeente. [verplicht] Bevat de Nederlandstalige naam van de straat. Is maximaal 80 karakters lang. Mag nog niet bestaan in de opgegeven gemeente. [optioneel] Bevat de anderstalige naam van de straat. Is maximaal 80 karakters lang. [verplicht] Bevat de status van de straatnaam. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de datum waarop de straatnaam administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. [optioneel] Bevat de (bestaande of nieuwe) rijksregisterstraten die aan de straat gekoppeld zijn. [optioneel] Bevat de (bestaande of nieuwe) wegverbindingen die aan de straat gekoppeld zijn en informatie specifiek voor die koppelingen. Handleiding CRABTools 11 / 37

Links PariteitLinks EersteHuisnummerLinks LaatsteHuisnummerLinks Rechts PariteitRechts EersteHuisnummerRechts LaatsteHuisnummerRechts [verplicht] Bevat een indicatie of de straat gekoppeld is aan de linkerkant van de wegverbinding. [optioneel] Bevat de aanduiding van de pariteit aan de linkerkant van de wegverbinding. De toegelaten pariteiten worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [optioneel] Bevat een aanduiding van het eerste huisnummer aan de linkerkant van de wegverbinding. [optioneel] Bevat een aanduiding van het laatste huisnummer aan de linkerkant van de wegverbinding. [verplicht] Bevat een indicatie of de straat gekoppeld is aan de rechterkant van de wegverbinding. [optioneel] Bevat de aanduiding van de pariteit aan de rechterkant van de wegverbinding. De toegelaten pariteiten worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [optioneel] Bevat een aanduiding van het eerste huisnummer aan de rechterkant van de wegverbinding. [optioneel] Bevat een aanduiding van het laatste huisnummer aan de rechterkant van de wegverbinding. 12 / 37 Handleiding CRABTools

Wegverbinding [verplicht] Bevat een nieuwe of een bestaande wegverbinding. Identificator [verplicht] Bevat de unieke identificator van de wegverbinding zoals gekend in CRAB. Enkel bestaande wegverbindingen zijn toegelaten. Geometriemethode Morfologie [verplicht] Bevat de methode waarmee de geometrie van de wegverbinding is bepaald. De toegelaten waardes worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. De methode grb is echter niet toegelaten daar deze voorbehouden is voor AGIV. [verplicht] Bevat een aanduiding van de morfologie van de wegverbinding. De toegelaten morfologiën worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. Handleiding CRABTools 13 / 37

Verharding Wkt Begindatum Status [verplicht] Bevat een aanduiding de verharding van de wegverbinding. De toegelaten verhardingen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de geometrie van de wegverbinding in Well-Known Text formaat in Lambert-72 projectie (EPSG 31370). Enkel geometriën van het type LineString zijn toegestaan. De aangeleverde geometrie moet ook binnen de grenzen van de gemeente vallen en aan een aantal topologische regels voldoen indien de status van de wegverbinding in gebruik is. [verplicht] [verplicht] Bevat de datum waarop de wegverbinding administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. [verplicht] Bevat de status van de wegverbinding. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. De operatie AddStraat geeft een <AddStraatResponse> element terug. Dit bevat het id van de nieuw toegevoegde straat. 2.2.1.4 AddWegverbinding Aan de operatie AddWegverbinding wordt een <AddWegverbindingRequest> element meegegeven als parameter. De operatie AddWegverbinding geeft een <AddWegverbindingResponse> element terug. Deze bevat het id van de nieuw toegevoegde wegverbinding. 2.2.2 Update In het CRAB wordt een onderscheid gemaakt tussen correcties en wijzigingen. In het eerste geval gaat het om een rechtzetting van een fout (bv. Van Eikstraat moet zijn Van Eyckstraat ), in het tweede geval gaat het om een verandering in administratieve toestand (bv. gebouw veranderd van status in aanbouw naar in gebruik ). In geval van wijziging van identificerende attributen wordt een nieuw id toegekend. De datum die wordt opgegeven voor het attrribuut begindatum wordt gebruikt als wijzigingsdatum. 14 / 37 Handleiding CRABTools

2.2.2.1 UpdateAdres Aan de operatie UpdateAdres wordt een <UpdateAdresRequest> element meegegeven als parameter. Id IsCorrectie Postcode [verplicht] Bevat het id van het huisnummer. [verplicht] Duidt aan of het gaat om een rechtzetting van een fout in CRAB [true] dan wel om een administratieve wijziging [false]. [verplicht] Bevat de postcode die gekoppeld is aan het huisnummer. Handleiding CRABTools 15 / 37

Huisnummer Status Begindatum Subadressen RrAdres Posities BestaandePercelen BestaandeGebouw NieuweGebouwen [verplicht] Bevat het huisnummer. Moet voldoen aan het formaat ^[1-9][0-9]*(BIS Bis bis TER Ter ter [a-za-z] _[0-9]+){0,1}$ ^ZN$ ^zn$. Is maximaal 11 karakters lang. [verplicht] Bevat de status van het huisnummer. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de datum waarop het huisnummer administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. [optioneel] Bevat de subadressen die aan het huisnummer gekoppeld zijn. [optioneel] Bevat het (bestaand of nieuw) rijksregisteradres dat aan het huisnummer gekoppeld is. [verplicht] Bevat één of meerdere posities op het terrein die aangeven waar het huisnummer gelegen is. Elke positie dient uniek te zijn qua attribuut herkomst. Huisnummers met status in gebruik kunnen enkel dan posities hebben met herkomst afgeleidvangebouw, manueleaanduidingvangebouw of manueleaanduidingvaningangvangebouw wanneer er ook een koppeling is met een gebouw. Huisnummers met status in gebruik kunnen enkel dan posities hebben met herkomst afgeleidvanperceelkadaster of manueleaanduidingvanperceel wanneer er ook een koppeling is met een perceel. [optioneel] Bevat de bestaande percelen die aan het huisnummer gekoppeld zijn. [optioneel] Bevat de gebouwen die aan het huisnummer gekoppeld zijn. [optioneel] Bevat de nieuw toe te voegen gebouwen die aan het huisnummer gekoppeld zijn. De operatie UpdateAdres geeft een <UpdateAdresResponse> element terug. Dit bevat het id van het gecorrigeerde of gewijzigde huisnummer. Merk op dat in het eerste geval het teruggekregen id hetzelfde is als datgene dat in de werd meegegeven. 2.2.2.2 UpdateSubadres Aan de operatie UpdateSubadres wordt een <UpdateSubadresRequest> element meegegeven als parameter. 16 / 37 Handleiding CRABTools

Id IsCorrectie Busnummer/Appnummer Status Begindatum RrAdres Posities [verplicht] Bevat het id van het subadres. [verplicht] Duidt aan of het gaat om een rechtzetting van een fout in CRAB [true] dan wel om een administratieve wijziging [false]. [verplicht] Bevat de aanduiding van het subadres. Dit is ofwel een busnummer, ofwel een appartementsnummer. Een van beide dient verplicht ingevuld te worden. Is maximaal 35 karakters lang. [verplicht] Bevat de status van het subadres. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de datum waarop het subadres administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. [optioneel] Bevat het (bestaand of nieuw) rijksregisteradres dat aan het subadres gekoppeld is. [verplicht] Bevat één of meerdere posities op het terrein die aangeven waar het subadres gelegen is. Elke positie dient uniek te zijn qua attribuut herkomst. De operatie UpdateSubadres geeft een <UpdateSubadresResponse> element terug. Handleiding CRABTools 17 / 37

Dit bevat het id van het gecorrigeerde of gewijzigde subadres. Merk op dat in het eerste geval het teruggekregen id hetzelfde is als datgene dat in de werd meegegeven. 2.2.2.3 UpdateGebouw Aan de operatie UpdateGebouw wordt een <UpdateGebouwRequest> element meegegeven als parameter. Id IsCorrectie AardGebouw Begindatum Geometriemethode [verplicht] Bevat het id van het gebouw. [verplicht] Duidt aan of het gaat om een rechtzetting van een fout in CRAB [true] dan wel om een administratieve wijziging [false]. [verplicht] Bevat de aard van het gebouw. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de datum waarop het gebouw administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. [verplicht] Bevat de methode waarmee de geometrie van het gebouw is bepaald. De toegelaten waardes worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. De methode grb is echter niet toegelaten daar deze voorbehouden is voor AGIV. 18 / 37 Handleiding CRABTools

Status Wkt [verplicht] Bevat de status van het gebouw. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de geometrie van het gebouw in Well-Known Text formaat in Lambert-72 projectie (EPSG 31370). Enkel geometriën van het type Polygon zijn toegestaan. De aangeleverde geometrie moet ook binnen de grenzen van de gemeente vallen en aan een aantal topologische regels voldoen indien de status van het gebouw in gebruik is. De operatie UpdateGebouw geeft een <UpdateGebouwResponse> element terug. Dit bevat het id van het gecorrigeerde of gewijzigde gebouw. Merk op dat in het eerste geval het teruggekregen id hetzelfde is als datgene dat in de werd meegegeven. 2.2.2.4 UpdateStraat Aan de operatie UpdateStraat wordt een <UpdateStraatRequest> element meegegeven als parameter. Handleiding CRABTools 19 / 37

Id IsCorrectie Straatnaam Straatnaam2 Status Begindatum RrStraten Wegkanten [verplicht] Bevat het id van de straat. [verplicht] Duidt aan of het gaat om een rechtzetting van een fout in CRAB [true] dan wel om een administratieve wijziging [false]. [verplicht] Bevat de Nederlandstalige naam van de straat. Is maximaal 80 karakters lang. Mag nog niet bestaan in de opgegeven gemeente. [optioneel] Bevat de anderstalige naam van de straat. Is maximaal 80 karakters lang. [verplicht] Bevat de status van de straatnaam. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de datum waarop de straatnaam administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. [optioneel] Bevat de (bestaande of nieuwe) rijksregisterstraten die aan de straat gekoppeld zijn. [optioneel] Bevat de (bestaande of nieuwe) wegverbindingen die aan de straat gekoppeld zijn en informatie specifiek voor die koppelingen. De operatie UpdateStraat geeft een <UpdateStraatResponse> element terug. Dit bevat het id van de gecorrigeerde of gewijzigde straat. Merk op dat in het eerste geval het teruggekregen id hetzelfde is als datgene dat in de werd meegegeven. 2.2.2.5 UpdateWegverbinding Aan de operatie UpdateWegverbinding wordt een <UpdateWegverbindingRequest> element meegegeven als parameter. 20 / 37 Handleiding CRABTools

Id IsCorrectie Geometriemethode Morfologie Verharding Wkt Begindatum [verplicht] Bevat het id van de wegverbinding. [verplicht] Duidt aan of het gaat om een rechtzetting van een fout in CRAB [true] dan wel om een administratieve wijziging [false]. [verplicht] Bevat de methode waarmee de geometrie van de wegverbinding is bepaald. De toegelaten waardes worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. De methode grb is echter niet toegelaten daar deze voorbehouden is voor AGIV. [verplicht] Bevat een aanduiding van de morfologie van de wegverbinding. De toegelaten morfologiën worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat een aanduiding de verharding van de wegverbinding. De toegelaten verhardingen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. [verplicht] Bevat de geometrie van de wegverbinding in Well-Known Text formaat in Lambert-72 projectie (EPSG 31370). Enkel geometriën van het type LineString zijn toegestaan. De aangeleverde geometrie moet ook binnen de grenzen van de gemeente vallen en aan een aantal topologische regels voldoen indien de status van de wegverbinding in gebruik is. [verplicht] [verplicht] Bevat de datum waarop de wegverbinding administratief is ontstaan. Indien niet gekend wordt 1-1-1830 gebruikt. Handleiding CRABTools 21 / 37

Status [verplicht] Bevat de status van de wegverbinding. De toegelaten statussen worden bekomen met de operatie ListDomeinWaardeByCategorie van de CRAB Read service. De operatie UpdateWegverbinding geeft een <UpdateWegverbindingResponse> element terug. Dit bevat het id van de gecorrigeerde of gewijzigde wegverbinding. Merk op dat in het eerste geval het teruggekregen id hetzelfde is als datgene dat in de werd meegegeven. 2.2.3 Delete In het CRAB wordt een onderscheid gemaakt tussen correcties en wijzigingen. In het eerste geval gaat het om een rechtzetting van een fout (bv. straatnaam Van Eikstraat bestaat niet), in het tweede geval gaat het om een verandering in administratieve toestand (bv. straatnaam is administratief afgeschaft). De delete operaties betreffen het eerste geval. 2.2.3.1 DeleteAdres Aan de operatie DeleteAdres wordt het id van het te verwijderen adres meegegeven als parameter. De operatie DeleteAdres geeft geen terug. Als er geen fout komt als antwoord op de, dan mag de operatie als geslaagd worden beschouwd. 2.2.3.2 DeleteGebouw Aan de operatie DeleteGebouw wordt het id van het te verwijderen gebouw meegegeven als parameter. De operatie DeleteGebouw geeft geen terug. Als er geen fout komt als antwoord op de, dan mag de operatie als geslaagd worden beschouwd. 2.2.3.3 DeleteStraat Aan de operatie DeleteStraat wordt het id van de te verwijderen straat meegegeven als parameter. De operatie DeleteStraat geeft geen terug. Als er geen fout komt als antwoord op de, dan mag de operatie als geslaagd worden beschouwd. 2.2.3.4 DeleteWegverbinding 22 / 37 Handleiding CRABTools

Aan de operatie DeleteWegverbinding wordt het id van de te verwijderen wegverbinding meegegeven als parameter. De operatie DeleteWegverbinding geeft geen terug. Als er geen fout komt als antwoord op de, dan mag de operatie als geslaagd worden beschouwd. 2.2.4 End In het CRAB wordt een onderscheid gemaakt tussen correcties en wijzigingen. In het eerste geval gaat het om een rechtzetting van een fout (bv. straatnaam Van Eikstraat bestaat niet), in het tweede geval gaat het om een verandering in administratieve toestand (bv. straatnaam is administratief afgeschaft). De end operaties betreffen het tweede geval, de zogeheten historeringen. De datum die als parameter wordt meegegeven aan de operaties geldt als einddatum van het exemplaar en diens afhangende objecten. 2.2.4.1 EndAdres Aan de operatie EndAdres worden de volgende parameters meegegeven: De operatie EndAdres geeft geen terug. Als er geen fout komt als antwoord op de, dan mag de operatie als geslaagd worden beschouwd. 2.2.4.2 EndGebouw Aan de operatie EndGebouw worden de volgende parameters meegegeven: De operatie EndGebouw geeft geen terug. Als er geen fout komt als antwoord op de, dan mag de operatie als geslaagd worden beschouwd. 2.2.4.3 EndStraat Aan de operatie EndStraat worden de volgende parameters meegegeven: Handleiding CRABTools 23 / 37

De operatie EndStraat geeft geen terug. Als er geen fout komt als antwoord op de, dan mag de operatie als geslaagd worden beschouwd. 2.2.4.4 EndWegverbinding Aan de operatie EndWegverbinding worden de volgende parameters meegegeven: De operatie EndWegverbinding geeft geen terug. Als er geen fout komt als antwoord op de, dan mag de operatie als geslaagd worden beschouwd. 2.2.5 Hulpmethoden 2.2.5.1 GetGemeenteOmtrek Aan de operatie GetGemeenteOmtrek wordt de Nederlandstalige naam van de gemeente meegegeven als parameter. De operatie GetGemeenteOmtrek geeft een <GetGemeenteOmtrekResponse> element terug. Het resultaat bevat de geometrie van de gemeentegrens in Well-Known Text formaat in Lambert- 72 projectie (EPSG 31370). 2.2.5.2 PerformRenumbering Aan de operatie PerformRenumbering wordt een <RenumberingRequest> element meegegeven als parameter. 24 / 37 Handleiding CRABTools

Datum EndOldAddresses RenumberingLines [verplicht] Bevat de datum waarop het hernummering administratief plaats heeft gevonden. Deze datum wordt gebruikt als begindatum voor de nieuwe exemplaren en (datum 1) als einddatum van de te historeren exemplaren. [verplicht] Duidt aan of de huisnummers die niet worden herbruikt moeten gehistoreerd worden dan wel de status buiten gebruik krijgen. [verplicht] Bevat de mapping van oude huisnummers op nieuwe huisnummers. AdresId Huisnummer Straatnaam [verplicht] Bevat het id van het bronhuisnummer. [verplicht] Bevat het (nieuwe of bestaande) doelhuisnummer. Indien nieuw dient het te voldoen aan het formaat ^[1-9][0-9]*(BIS Bis bis TER Ter ter [a-za-z] _[0-9]+){0,1}$ ^ZN$ ^zn$. Mag maximum 11 karakters lang zijn. [verplicht] Bevat de naam van de bestaande straat. De operatie PerformRenumbering geeft geen terug. Als er geen fout komt als antwoord op de, dan mag de operatie als geslaagd worden beschouwd. Merk op dat deze operatie lang kan duren. Alnaargelang de configuratie van de proxy of stub kan het zijn dat je een TimeOutException krijgt terwijl de uitvoering van de operatie eigenlijk nog bezig is. 2.2.6 Topologieregels 2.2.6.1 Gebouwen geen self-intersection geen overlap met andere gebouwen geen overlap met wegverbindingen minimale oppervlakte 10m² Handleiding CRABTools 25 / 37

maximale oppervlakte 50 000m² 2.2.6.2 Wegverbindingen geen self-intersection geen overlap met andere wegverbindingen geen overlap met gebouwen geen undershoot binnen een tolerantie van 1m minimale lengte 5m maximale lengte 5000m 2.3 Verdachte gevallen 2.3.1 ListVerdachteGevallenQueries De operatie ListVerdachteGevallenQueries wordt aangeroepen zonder parameters. De operatie ListVerdachteGevallenQueries geeft een <ListVerdachteGevallenQueriesResponse> element terug. QueryId EntiteitType ValidatieType Omschrijving Het interne id van het type verdacht geval. Het soort Lite CRAB entiteit (adres, gebouw, perceel, straat of wegverbinding). Het categorie waartoe het type verdacht geval behoort (foutief, verdacht, verbeterbaar). Een korte omschrijving van het type verdacht geval. 26 / 37 Handleiding CRABTools

Instructie LabelHoofding Een beschrijving van hoe het type verdacht geval kan opgelost worden. De naam van de Lite CRAB entiteit. 2.3.2 CountVerdachteGevallenByQueryId Aan de operatie CountVerdachteGevallenByQueryId worden de volgende parameters meegegeven: queryid gemeente Het interne id van het type verdacht geval. De Nederlandstalige naam van de gemeente waarvoor de lijst van verdachte gevallen moet opgesteld worden. De operatie CountVerdachteGevallenByQueryId geeft een <CountVerdachteGevallenByQueryIdResponse> element terug. Dit bevat het aantal verdachte gevallen van het opgegeven type in de opgegeven gemeente. Merk op dat voor een aantal grotere gemeenten het oplijsten van bepaalde types van verdachte gevallen lang kan duren. De operatie krijgt maximaal 50 seconden te tijd om een lijst te produceren, zoniet wordt als resultaat -1 gegeven. 2.3.3 ListVerdachteGevallenByQueryId Aan de operatie ListVerdachteGevallenByQueryId worden de volgende parameters meegegeven: queryid Het interne id van het type verdacht geval. Handleiding CRABTools 27 / 37

gemeente De Nederlandstalige naam van de gemeente waarvoor de lijst van verdachte gevallen moet opgesteld worden. De operatie ListVerdachteGevallenByQueryId geeft een <ListVerdachteGevallenByQueryIdResponse> element terug. EntiteitId Label VolgNummer Het id van het Lite CRAB exemplaar. Een UI vriendelijke kenmerkende tekst voor het exemplaar. Een betekenisloos volgnummer bedoeld voor lijsten in UI (niet idempotent). 2.3.4 ListVerdachteGevallenByQueryIdPaged Aan de operatie ListVerdachteGevallenByQueryIdPaged worden de volgende parameters meegegeven: 28 / 37 Handleiding CRABTools

queryid gemeente pagesize pageindex Het interne id van het type verdacht geval. De Nederlandstalige naam van de gemeente waarvoor de lijst van verdachte gevallen moet opgesteld worden. Het aantal elementen per logische pagina. Het volgnummer van de logische pagina. De operatie ListVerdachteGevallenByQueryIdPaged geeft een <ListVerdachteGevallenByQueryIdPagedResponse> element terug. Het attribuut TotaalAantalGevallen bevat het aantal verdachte gevallen van het opgegeven type in de opgegeven gemeente. 2.3.5 MaskVerdachteGevallen Aan de operatie MaskVerdachteGevallen wordt een <MaskRequest> element meegegeven als parameter. EntiteitIds QueryId Een collectie van id s van Lite CRAB exemplaren. Enkel exemplaren die tot het grondgebied van de aanroepende gemeente behoren worden aanvaard. Het interne id van het type verdacht geval. Merk op dat verdachte gevallen van het type foutief niet maskeerbaar zijn. De operatie MaskVerdachteGevallen geeft geen terug. Als er geen fout komt als antwoord op de, dan mag de operatie als geslaagd worden beschouwd. Handleiding CRABTools 29 / 37

2.4 Rapportering transacties 2.4.1 ListBeheerdersByGemeente De operatie ListBeheerdersByGemeente wordt aangeroepen zonder parameters. Merk op dat de lijst van beheerders gefilterd wordt op de gemeente van de aanroeper van de operatie. De operatie ListBeheerdersByGemeente geeft een <ListBeheerdesByGemeenteResponse> element terug. Gemeente Name De Nederlandstalige naam van de gemeente. De gebruikersnaam van de beheerder. 2.4.2 ListTransacties Aan de operatie ListTransacties worden de volgende parameters meegegeven: gemeente beheerder De Nederlandstalige naam van de gemeente. De gebruikersnaam van de beheerder. 30 / 37 Handleiding CRABTools

tijdstip1 tijdstip2 Bevat de start van de periode waarover gerapporteerd wordt. Bevat het einde van de periode waarover gerapporteerd wordt. De operatie ListTransacties geeft een <ListTransactiesResponse> element terug. Beheerder Beschrijving CrabEntiteitType EntiteitId Tijdstip TransactieType Volgnummer De gebruikersnaam van de beheerder. Een opsomming van wat er in de transactie allemaal gebeurd is. Het soort Lite CRAB entiteit (adres, gebouw, perceel, straat of wegverbinding). Het id van het Lite CRAB exemplaar waarop de transactie betrekking heeft. Merk op dat het id mogelijks niet meer bestaat. Het tijdstip waarop de transactie heeft plaatsgevonden. Het soort transactie (Invoer, Correctie, Historering, Verwijdering, Hernummering) Een betekenisloos volgnummer. Handleiding CRABTools 31 / 37

2.4.3 ListTransactiesPaged Aan de operatie ListTransactiesPaged worden de volgende parameters meegegeven: gemeente beheerder tijdstip1 tijdstip2 pagesize pageindex De Nederlandstalige naam van de gemeente. De gebruikersnaam van de beheerder. Bevat de start van de periode waarover gerapporteerd wordt. Bevat het einde van de periode waarover gerapporteerd wordt. Het aantal elementen per logische pagina. Het volgnummer van de logische pagina. De operatie ListTransactiesPaged geeft een <ListTransactiesPagedResponse> element terug. 2.4.4 ListTransactieAggregaten Aan de operatie ListTransactieAggregaten worden de volgende parameters meegegeven: 32 / 37 Handleiding CRABTools

gemeente beheerder tijdstip1 tijdstip2 De Nederlandstalige naam van de gemeente. De gebruikersnaam van de beheerder. Bevat de start van de periode waarover gerapporteerd wordt. Bevat het einde van de periode waarover gerapporteerd wordt. De operatie ListTransactieAggregaten geeft een element terug. <ListTransactieAggregatenResponse> CrabEntiteitType TransactieType Aantal Het soort Lite CRAB entiteit (adres, gebouw, perceel, straat of wegverbinding). Het soort transactie (Invoer, Correctie, Historering, Verwijdering, Hernummering) Het aantal transacties van het betreffende soort op de betreffende entiteit tijdens de opgegeven periode. Handleiding CRABTools 33 / 37

2.5 Fouten 2.5.1 Validatiefouten Fouten tegen de validatieregels leiden tot een SOAP Fault. Die bevat zowel een tag als een Nederlandstalige omschrijving. <s:fault> <s:code> <s:value>s:sender</s:value> </s:code> <s:reason> <s:text xml:lang="nl-be">a server exception occurred.</s:text> </s:reason> <s:detail> <FaultDetail xmlns="http://www.agiv.be/errorhandling/2010/04" xmlns:i="http://www.w3.org/2001/xmlschema-instance"> <Messages> <FaultMessage> <Source>Gisvl.CrabDecentraal.Edit</Source> <Tag>GemeenteNietEditeerbaar</Tag> <Translations> <MessageText> <Culture>nl-BE</Culture> <Text>Entiteiten in de gemeente Sint-Niklaas kunnen niet worden bewerkt door de huidige gebruiker.</text> </MessageText> </Translations> </FaultMessage> </Messages> </FaultDetail> </s:detail> </s:fault> De gebruikte tags en hun betekenis zijn hieronder weergegeven. De beschrijving in de validatiefout kan contextuele informatie bevatten zoals een verwijzing naar een opgegeven waarde. TAG AttribuutIngevuld CheckAll DatumOngeldig EinddatumIngevuld EinddatumOngeldig ExemplaarBestaatAl GccConstraint GebruikerNietGekoppeld BETEKENIS Er mag geen waarde worden opgegeven voor het attribuut. Foute topologie. De opgegeven waarde ligt niet in het geldig bereik. Een einddatum mag niet worden opgegeven voor het element. De einddatum moet groter zijn dan de begindatum. Het opgegeven exemplaar bestaat al. Er zijn afhankelijke objecten waarvoor de opgegeven datum niet voldoet. De huidige gebruiker is niet gekoppeld aan een 34 / 37 Handleiding CRABTools

GeenToegang GemeenteNietEditeerbaar GeometriemethodeOngeldig HerkomstNietUniek HerkomstOngeldig HuisnummerOngeldig IdBestaatNiet KantOngeldig KantOntbreekt KarakterlengteNietCorrect LijstBevatDubbels LijstwaardeOngeldig LineNoCrossing LineNoUndershoot LineTouches MaxKarakterlengteOverschreden MaxLength MaxSurface MinDatumHernummering MinLength MinSurface NoIndenticalSegments RrAdresZonderPostcode RrStraatBestaatAl RrstraatcodeOngeldig StraatcodeIngevuld gemeente. De gebruiker is niet bevoegd om de operatie uit te voeren. Entiteiten in de gemeente X kunnen niet worden bewerkt door de gebruiker. De geometriemethode 'grb' kan niet worden toegekend door de huidige gebruiker. Een adres kan slechts meerdere adresposities hebben indien die allen een verschillende herkomst hebben. De waarde voor herkomst is niet toegelaten zonder koppeling met een gebouw of perceel. De waarde voor het huisnummer voldoet niet aan het voorgeschreven formaat. Er bestaat geen exemplaar met het opgegeven id. De linker- en rechterpariteit kunnen niet gelijk zijn. Er moet een waarde worden opgegeven voor minstens een van de beide pariteiten. De opgegeven waarde voor moet exact X karakters tellen. De lijst met bronadressen bevat dubbels. De waarde bestaat niet voor het attribuut. Lijnen mogen niet kruisen Lijnen moet aansluiten indien dichter dan 1 m bij elkaar. Foute topologie De opgegeven waarde mag maximaal uit X karakters bestaan. De lengte is groter dan de maximale waarde De oppervlakte m² is groter dan de maximale waarde De datum voor de hernummering moet groter zijn dan X omdat er een huisnummer bij betrokken is met begindatum Y De lengte is kleiner dan de minimale waarde De oppervlakte m² is kleiner dan de minimale waarde Lijnen mogen niet overlappen Er kan geen rijksregisteradres worden opgegeven wanneer de postcode voor gerelateerde huisnummer ontbreekt. De rijksregisterstraat met code X in subkanton Y is reeds gekoppeld aan een andere straat De waarde voor de rrstraatcode voldoet niet aan het voorgeschreven formaat. Een straatcode mag niet worden opgegeven voor een nieuwe straat. Handleiding CRABTools 35 / 37

StraatnaamBestaatNiet SubadresNietEditeren Subadresnummer TemporeleOverlap VerdachtGevalNietMaskeerbaar VerplichtElementOntbreekt WijzigingsdatumOngeldig WktBuitenGemeente WktOngeldig De straatnaam bestaat niet in de gemeente Het bewerken an een subadres is niet mogelijk via de aangeroepen operatie. Er moet een waarde worden opgegeven voor ofwel het busnummer ofwel het appartementsnummer. Er heeft al een exemplaar bestaan met dezelfde identificerende kenmerken. De opgegeven begindatum moet groter zijn dan X Een verdacht geval met validatietype foutief is niet maskeerbaar. Het element is verplicht. De wijzigingsdatum moet minimaal twee dagen later zijn dan de huidige begindatum. De opgegeven geometrie ligt niet binnen de omtrek van gemeente De opgegeven WKT waarde is niet geldig 2.5.2 Onverwachte fouten Onverwachte fouten leiden eveneens tot een SOAP Fault: <s:fault xmlns:a="http://www.w3.org/2005/08/addressing" xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility- 1.0.xsd" xmlns:xml="http://www.w3.org/xml/1998/namespace"> <s:code> <s:value>s:sender</s:value> </s:code> <s:reason> <s:text xml:lang="">an unexpected error occurred, and error details have been logged with id 2c8e02b8-d866-485e-802d-bea211704523.</s:Text> <s:text xml:lang="nl-be">er is een onverwachte fout opgetreden, en de details zijn gelogged met id 2c8e02b8-d866-485e-802d-bea211704523.</s:Text> <s:text xml:lang="fr-be">une erreur imprévue s'est produite, le détail de l'erreur a été logé avec l' id 2c8e02b8-d866-485e-802d-bea211704523.</s:Text> </s:reason> </s:fault> 36 / 37 Handleiding CRABTools

3 Implementatie De CRAB Edit service kan met deze URL worden geraadpleegd: https://crab.agiv.be/edit/crabeditservice.svc De beschrijving van deze web service (het WSDL-bestand) kan als volgt worden bekomen: http://crab.agiv.be/edit/crabeditservice.svc?wsdl Handleiding CRABTools 37 / 37