Gebruikershandleiding

0.1 BGT Controleservice Gebruikershandleiding Datum 6 maart 2014 Versie 1.3

Inhoudsopgave 1 Inleiding...3 2 Eisen aan de levering...4 3 Uit te voeren controles...5 4 Uitvoering Controle...6 4.1 Controleren bestand... 6 4.2 Status aangeleverde bestanden... 7 Bijlage Voorbeeld verwerkingsverslag...10 Versie 1.3 6 maart 2014 2 / 13

1 Inleiding De LV-BGT Controleservice is een ICT component die BGT/IMGeo gegevensverzamelingen controleert op basis van de eisen die gesteld worden in de gegevenscatalogi BGT en IMGeo en verwerkingseisen die gesteld worden door de LV-BGT. Dit document beschrijft achtereenvolgens de eisen die gesteld worden aan de aangeleverde bestanden in hoofdstuk 2. Vervolgens worden in hoofdstuk 3 globaal de uit te voeren controles uitgelegd. Tenslotte worden in hoofdstuk 4 de details met betrekking tot de uitvoering behandeld. In het document Toelichting controles LV-BGT worden alle controles genoemd met een verwijzing naar een foutmelding die de controleservice genereert. Versie 1.3 6 maart 2014 3 / 13

2 Eisen aan de levering Het te controleren bestand dient in een ZIP-archierf aangeleverd te worden. De lengte van het zipbestand en de bestandsnaam is maximaal 90 tekens en alleen de karakters 0-9, a-z, A-Z, - en. mogen in de naam voorkomen. Er zijn een aantal parameters ingesteld waaraan de levering moet voldoen: Maximale toegestane grootte van het ZIP-archief is 100Mb. Maximale toegestane grootte van het BGT-bestand is 500 Mb. Het maximum aantal foutmeldingen dat getoond wordt is 100. Let op: Alleen de eerste 100 foutmeldingen worden getoond in het logbestand. Het maximum aantal coördinaten per object is 5000. Versie 1.3 6 maart 2014 4 / 13

3 Uit te voeren controles Het BGT-bestand wordt altijd gevalideerd tegen het IMGeo-schema en op geldige objectgeometrie. In het beginscherm kan gekozen worden voor het uitvoeren van de volgende controles: Domeinwaarden De geldige combinatie van domeinwaarde en domeinwaardenlijst wordt bepaald in relatie tot de geldigheid van de domeinwaardenlijst voor het kenmerk van dit object. LV-BGT ondersteunt 2 versies van de door Geonovum gepubliceerde domeinwaardenlijsten: een actuele en een vorige versie. Indien voor een kenmerk wordt verwezen naar een vorige versie van een domeinwaardenlijst wordt een waarschuwing gegeven. Topologie De topologiecontrole bestaat uit het controleren van de overlap tussen BGT-vlakobjecten (m.u.v. Functioneel Gebied)op niveau 0 (maaiveld). Voor de overlapcontroles wordt de geometrie gebruikt zoals deze als attribuut bij het BGT-object is aangeleverd en geregistreerd en dus niet de plaatsbepalingspunten. Er wordt geen tolerantie gehanteerd bij de ruimtelijke overlapcontrole, er wordt uitgegaan van de exacte geometrie. Administratief In het IMGeo schema liggen diverse eisen vast die gecontroleerd worden tijdens de schemavalidatie. Controles die niet uitgevoerd kunnen worden door de schemavalidatie vallen onder de administratieve controle. Het gaat dan om bijvoorbeeld een controle op het voor komen van de bronhouder in de LV-BGT, of dat tijdstippen niet in de toekomst liggen enzovoorts. Plaatsbepalingspunten Er wordt gecontroleerd of voor alle punten van een BGT-object een plaatsbepalingspunt geleverd is. Volgorde uitvoering controles Als eerste wordt de schemavalidatie uitgevoerd. Als er een fout geconstateerd wordt, stopt de controle van het bestand. Is dat niet het geval dan doorloopt de controleservice het bestand en voert per object in de volgende volgorde de controles uit: Controle domeinwaarde en administratieve controle Geometrische controle Als er een geometrische fout geconstateerd wordt, vindt de topologiecontrole en controle op plaatsbepalingspunten voor dat object niet plaats. Topologiecontrole Er wordt gecontroleerd of een object overlap vertoont met een eerder ingelezen object. Controle op plaatsbepalingspunten Er wordt gecontroleerd of ieder coördinatenpaar van de WORDT-situatie van een BGT-object voorkomt als plaatsbepalingspunt in het bestand. Dit geldt niet de plustopografie. Om te voorkomen dat gaten en overlap in de BGT ontstaan wordt, als het een mutatiebestand betreft, gecontroleerd of som van de vervallen objecten en de som van de nieuwe objecten identiek is. Versie 1.3 6 maart 2014 5 / 13

4 Uitvoering Controle De LV-BGT Controleservice is opgebouwd uit twee onderdelen; een functie waarmee het te controleren bestand kan worden aangeboden en een functie waarmee de status en het resultaat van de controle kan worden bekeken. In de volgende paragrafen worden beide functies beschreven. 4.1 Controleren bestand Als de BGT upload wordt opgestart, verschijnt het scherm waarin een bestand kan worden aangeboden ter controle. Onderstaand een beschrijving van dit scherm: 1 2 3 4 4 5 1. Controleren bestand Met deze opties wordt de Controlefunctie gestart. Als in Mijn Kadaster is gekozen voor LV-BGT wordt deze functie initieel gestart. 2. Status aangeleverde bestanden. Met deze functie kan de status en het verwerkingsverslag van de aangeleverde bestanden bekeken worden. 3. Selecteren te controleren bestand Met de knop Browse kan het bestand geselecteerd worden dat gecontroleerd moet worden. 4. Type aanlevering 1 Hier kan aangegeven worden of het een initiële levering of een mutatielevering betreft. 5. Controleopties De controleopties die beschreven zijn in het hoofdstuk Uit te voeren controles kunnen hier aan/uit gezet worden. 6. Start controle Nadat er een bestand is gekozen ter controle en op de knop Verzenden is gedrukt, wordt het bestand in de wachtrij van de controleservice geplaatst. 1 Er is ook nog sprake van een type aanlevering pre-mutatie. Deze kan hier niet gekozen worden maar wordt afgeleid uit een mutatielevering. In het logbestand wordt wel gemeld dat er sprake is van een pre-mutatielevering. Versie 1.3 6 maart 2014 6 / 13

4.2 Status aangeleverde bestanden Nadat bestanden ter controle zijn aangeboden, kan met de functie Status aangeleverde bestanden de status en het logbestand bekeken worden. De functie bestaat uit een aantal zoekfuncties op aangeleverde bestanden waarna een lijst verschijnt met daarin aangegeven de status. Als de controle is uitgevoerd, kunnen details over de verwerking bekeken worden. Onderstaand een beschrijving van dit scherm: 1 2 3 4 5 6 7 8 9 10 11 12 1. Aanleverwijze Voor de controleservice is dit altijd Via upload. Alleen relevant voor de registratieservice aangezien het aanbieden van controlebestanden via het upload loket gaat. 2. Referentienummer ophaalverzoek Alleen relevant voor de registratieservice. 3. Identificatieophaalverzoek Alleen relevant voor de registratieservice. 4. Bestandsnaam In dit veld kan de naam of een deel van de naam van het aangeleverde bestand worden ingevuld. 5. Aanleverdatum In dit veld kan de periode opgegeven waarbinnen bestanden zijn aangeboden 6. Aanlevertype In dit veld kan het type bestand gekozen worden; een initieel bestand of een mutatiebestand. 7. Verwerkingsactie De volgende acties worden uitgevoerd op een aangeleverd bestand en zijn relevant voor de controle: - Upload bestand Ophalen bestand - Validatie XML Validatie bestand tegen BGT-schema - Vulling staging area Laden van het bestand in tijdelijke tabellen in de LV-BGT - Validatie bestand intern Administratieve en geometrische controles binnen een bestand - Bijwerken statistieken en schonen Procesgegevens worden bijgewerkt 8. Verwerkingsstatus De volgende statussen kunnen geselecteerd worden en zijn relevant voor de controle: Versie 1.3 6 maart 2014 7 / 13

- In uitvoering De controle is nog niet gereed - Succes De controle is succesvol uitgevoerd - Fout De controle heeft fouten opgeleverd - Geannuleerd De controle is door de beheerder geannuleerd. 9. Zoeken Deze functie selecteert de status en overige gegevens van de aangeleverde bestanden op basis van de zoekcriteria en toont die gegevens in een lijst onder aan het scherm. 10. Reset De functie reset initialiseert de zoekvelden. 11. Toon details verwerking Als een detailregel wordt aangewezen, worden alle gegevens over de verwerking van het aangeleverde bestand in een scherm getoond zoals type aanlevering, uitgevoerde controles, verwerkingstijden enzovoorts. Voor een voorbeeld, zie onderstaande afbeelding: Als vervolgens gekozen wordt voor de optie Download verwerkingsverslag kan het verwerkingsverslag direct bekeken worden of kan het bestand opgeslagen worden. In het verwerkingsverslag staat per verwerkingsactie wat de status is en, in geval van fouten, welke fouten er opgetreden zijn. Zie ook de bijlage Voorbeeld verwerkingsverslag. 12. Verwerkingsmethode; laatse actie en laatste status Voor iedere stap in het proces (valideren xml, vullen staging area, valideren bestand intern) is een wachtrij gemaakt die ieder van die stappen uitvoert. In het scherm wordt van ieder van die stappen de laatste actie en de laatste status getoond. Voor iedere wachtrij kunnen twee bestanden gelijktijdig verwerkt worden. Als een bestand bijvoorbeeld als laatste actie de status Vullen stagingarea heeft met als laatste status Succes, dan worden er op dat moment twee bestanden gecontroleerd (valideren bestand intern). Dit zijn meestal bestanden die door een andere gebruiker zijn aangeboden en daarmee niet zichtbaar. De indicator linksonder Aanlevering in wachtrij geeft aan hoeveel bestanden er in de wachtrij staan, of reeds bezig zijn met de verwerking Opmerking: Versie 1.3 6 maart 2014 8 / 13

Drie velden die alleen van belang zijn voor de registratieservice als bestanden via automatische aanlevering zijn aangeboden bevinden zich aan de rechterzijde van het scherm (dit zijn Referentienummer stuur, Refenrentienummer ophaal en Identificatie ophaal). In bovenstaand scherm zijn deze niet zichtbaar. Versie 1.3 6 maart 2014 9 / 13

Bijlage Voorbeeld verwerkingsverslag Versie 1.3 6 maart 2014 10 / 13

Versie 1.3 6 maart 2014 11 / 13

Versie 1.3 6 maart 2014 12 / 13

Versie 1.3 6 maart 2014 13 / 13