0.1 Klantinstructie. NTD Actualiseren. Datum. 25 augustus Versie. 1.2 Vastgoedinformatie en Advies

Transcriptie

1 0.1 Klantinstructie NTD Actualiseren Datum 25 augustus 2016 Versie 1.2 Vastgoedinformatie en Advies

2 Versiehistorie Versie datum locatie omschrijving /06/2016 Geheel Nieuwe dienst t.b.v. KLIC-WIN /07/2016 Geheel Aanpassingen i.v.m. upgrade bèta-versie /08/2016 Geheel Aanpassingen i.v.m. uitbreiden NTD Actualiseren documenten Versie augustus / 26

3 Inhoudsopgave 1 Klantinstructie Inleiding NTD Actualiseren documenten NTD Actualiseren netinformatie De NTD Actualiseren gebruiken Stap 1: Inloggen in Mijn Kadaster Stap 2: Selecteren van de beheerder: alleen voor serviceproviders Stap 3: NTD-keuzescherm Geen bronhoudercode NTD Actualiseren documenten Stap 1: NTD Actualiseren documenten gebruiken Stap 2: nieuw documentenbestand uploaden Logbestand controleren/downloaden Een nieuw bestand uploaden (goed-situatie) Tabblad Logbestand Tabblad Statistieken Stap 3: Bestand goedkeuren of afkeuren Bestand goedkeuren Bestand afkeuren NTD Actualiseren netinformatie Stap 1: NTD Actualiseren netinformatie gebruiken Stap 2: nieuw netinformatiebestand uploaden Logbestand controleren/downloaden Een nieuw bestand uploaden (goed-situatie) Tabblad Logbestand Tabblad Statistieken Tabblad Kaart Zoeken op gml-id Stap 3: Bestand goedkeuren of afkeuren Bestand goedkeuren Bestand afkeuren Stap 4: PDF overzicht Uitgangspunten Validatie netinformatie Validatie documenten Bèta-release Versie augustus / 26

4 1 Klantinstructie 1.1 Inleiding De Netbeheerders Testdienst (NTD) is bedoeld om netbeheerders voor te bereiden op aansluiting. Voor de testdienst van het huidige KLIC kiest u NTD huidig: Opvoeren testmelding. Voor de testdiensten van KLIC-WIN kiest u onder Beschikbare testapplicaties NTD Actualiseren de applicatie die u wilt gebruiken. Deze klantinstructie geeft uitleg over de dienst NTD Actualiseren documenten en NTD Actualiseren netinformatie. Op dit moment zijn er hiervan bèta-versies gereleased, dat wil zeggen dat er nog functionaliteit kan worden toegevoegd en de performance nog verbeterd kan worden. Ze zijn bedoeld om de netbeheerder/serviceprovider ervaring te laten opdoen met deze nieuwe applicaties NTD Actualiseren documenten Deze dienst maakt het voor de toekomstige centrale netbeheerders mogelijk om documenten, die in relatie staan met de geactualiseerde netinformatie, centraal op te slaan. Onder documenten kan worden verstaan: huisaansluiting, aansluiting, profielschets, verzoek tot contact en overig,. In de definitieve productie-situatie zullen op basis van gegevens uit de gebiedsinformatie-aanvraag (een Klic-melding van de grondroerder) de documenten met status in productie worden uitgeleverd namens de betrokken centrale netbeheerder. Voor de correcte route wordt geadviseerd om in 1 e instantie deze dienst uit te voeren voordat de netinformatie wordt geüpload. In de NTD wordt bij de dienst NTD Actualiseren netinformatie bij een verwijzing (in de aangeleverde netinformatie) naar een bijlage gecontroleerd of deze bijlage bestaat. Deze controlefunctionaliteit is nog niet beschikbaar maar zal in een latere release worden toegevoegd aan de validaties NTD Actualiseren netinformatie Met deze dienst kunt u uw netinformatie uploaden en valideert het Kadaster of de netinformatie valide is (dat wil zeggen aan het IMKL2015 voldoet). Binnen de tool vindt de validatie plaats en wordt het resultaat van de validatie aan u teruggekoppeld. In de definitieve productie-situatie zullen er validaties zijn ten behoeve van INSPIRE en WION. In deze bèta-release van de NTD Actualiseren netinformatie ligt de focus op INSPIRE-validatie. NB 1: Om gebruik te kunnen maken van de diensten van NTD Actualiseren heeft u een bronhoudercode nodig. Deze code is voor elke netbeheerder uniek. Om deze te krijgen neemt u contact op met ons Klantcontactcenter. Houd uw relatienummer bij de hand of vermeld dit in uw . NB 2: De aangeleverde gegevens kunnen tijdens het bèta-programma door het Kadaster worden verwijderd (bijvoorbeeld bij een nieuwe release). Bij het live gaan van de productionele versie worden alle tijdens de bètaperiode aangeleverde gegevens verwijderd. Versie augustus / 26

5 2 De NTD Actualiseren gebruiken 2.1 Stap 1: Inloggen in Mijn Kadaster U kunt inloggen via Mijn Kadaster of via Kadaster.nl en klikken op inloggen zakelijk rechts boven in het scherm (De inlogcode en het wachtwoord hebt u ontvangen na uw registratie bij het Kadaster). Als u ingelogd bent, ziet u aan de linkerkant van het scherm een aantal menu-items met Klic-diensten. In het menu worden alleen diensten getoond die voor u van toepassing zijn. Klik op Klic Netbeheerder Testdienst. Bent u serviceprovider? Ga nu verder met stap 2: selecteren van de beheerder. Bent u netbeheerder? Ga nu verder met stap 3: NTD-keuzescherm. Versie augustus / 26

6 2.2 Stap 2: Selecteren van de beheerder: alleen voor serviceproviders Serviceproviders krijgen na het selecteren van een dienst onderstaand scherm te zien. In het scherm zijn alle netbeheerders te zien die u voor de gekozen dienst geautoriseerd hebben. U moet hier een keuze maken voor u verder kunt gaan. Alle volgende stappen zullen vervolgens uitgevoerd worden namens de gekozen netbeheerder. M.b.v. een zoekopdracht op beheerder, bronhoudercode en/of relatienummer kunt u de lijst inperken. Selecteer vervolgens de betreffende beheerder. 2.3 Stap 3: NTD-keuzescherm U komt nu eerst in het NTD-keuzescherm. Selecteer hier voor de testdiensten van KLIC-WIN onder Beschikbare testapplicaties NTD Actualiseren de applicatie die u wilt gebruiken. Zijn de diensten bij u uitgegrijsd? Ga nu naar Geen bronhoudercode. Zijn de diensten voor u beschikbaar? Ga nu naar Stap 3: NTD Actualiseren documenten of Stap 4: NTD Actualiseren netinformatie. Versie augustus / 26

7 2.3.1 Geen bronhoudercode Wanneer u nog geen bronhoudercode heeft (voor de betreffende netbeheerder) verschijnt de volgende melding. Om de bronhoudercode te krijgen neemt u contact op met ons Klantcontactcenter. 3 NTD Actualiseren documenten Met deze dienst kunt u documenten uploaden die in relatie staan met de netinformatie. Onder documenten kan worden verstaan: huisaansluiting, aansluiting, profielschets, verzoek tot contact en overig,. Het uploaden van de bestanden gebeurt in een ZIP-file. Op GitHub vindt u de XSD hiervan. De ZIP-file bevat exact 1 bestand met de extensie.xml + de bijbehorende documenten (in PDF-formaat). Het.XML bestand beschrijft de overige documenten (meta-informatie). 3.1 Stap 1: NTD Actualiseren documenten gebruiken U komt nu in de dienst NTD Actualiseren documenten (bèta-versie). Let op: alle statussen hebben enkel betrekking op deze testdienst. De status in productie heeft geen betrekking op de productie omgeving. Toelichting op de velden: +: hiermee kunt u meerdere statussen zien dan enkel de laatste status (van de betreffende aanlevering) Nummer: per upload wordt er een nummer toegekend Bestandsnaam: hier wordt de originele bestandsnaam getoond Tijdstip: dit is het tijdstip van de laatste status update Status: dit is de huidige status Download overzicht: creëer hiermee een status rapport (deze functionaliteit is nog niet beschikbaar) Versie augustus / 26

8 Opmerkingen: hier kunt u naar het logbestand of controleren scherm 3.2 Stap 2: nieuw documentenbestand uploaden Om een nieuw documentenbestand te uploaden gaat u naar Selecteer bestand. Er zal een navigatiescherm openen. Blader naar het bestand dat u wilt uploaden en klik op openen. In de bètaversie van deze dienst wordt de grootte van het ZIP-bestand vooralsnog beperkt tot 200 MB. In een latere release zal het ook mogelijk worden om grotere ZIP-bestanden te uploaden. De naam van het bestand wordt naast de knop Selecteer bestand getoond ter verificatie. Ook ziet u dat er een nieuwe knop verstuur te zien is (zie afbeelding hieronder). Versie augustus / 26

9 Door op de knop verstuur te klikken, verstuurt u het bestand aan het Kadaster. Vervolgens zullen de automatische controles starten. Na het versturen zal er een nieuwe Nummer-regel worden toegevoegd met status Aanlevering geslaagd. Als er al een (eerder aangeleverd) bestand met de status Aanlevering ingepland voor verwerking aanwezig is, zal het Kadaster eerst dat eerder aangeleverd bestand gaan controleren. Er wordt één aanlevering tegelijkertijd verwerkt. Dit proces gebeurt achter de schermen. In deze bèta-versie ontbreekt hier nog een statusbalk met betrekking tot het controleren. Ververs hier niet zelf de webpagina, maar wacht op onderstaande pop-up. (Doet u dit wel, dan zal de gehele webpagina opnieuw geladen worden en dit vertraagt het proces.) U ontvangt van iedere statuswijziging een update in de vorm van een pop-up, bijvoorbeeld: Als de controles gereed zijn, verschijnt er wederom een pop-up. In deze voorbeeldsituatie is de status Gevalideerd met fouten. Versie augustus / 26

10 Kies voor verversen en bekijk vervolgens het logbestand voor de details Logbestand controleren/downloaden U komt nu in het Controleren scherm waar het logbestand aangeeft welke fouten zijn aangetroffen. Met de +knop kunt u een uitgebreidere uitleg zien. De functionaliteit om het logbestand in csv-formaat te downloaden is nog niet beschikbaar en zal in een latere release worden toegevoegd Een nieuw bestand uploaden (goed-situatie) Nadat u de fouten heeft verwerkt en een nieuw bestand wilt uploaden, gaat u wederom naar Selecteer bestand en herhaalt u de stappen zoals eerder in dit hoofdstuk is uitgelegd. Versie augustus / 26

11 D.m.v. een pop-up ontvangt u updates, bijvoorbeeld: Als de controles gereed zijn, verschijnt er wederom een pop-up. In deze goed-situatie zal de laatste status zijn Gereed voor handmatige controle. Kies na Verversen voor Controleren en bekijk de details. Er zal zich een nieuw scherm openen. In dit scherm ziet u de tabbladen Logbestand en Statistieken. Versie augustus / 26

12 3.2.3 Tabblad Logbestand In het tabblad Logbestand is de status zichtbaar van het documentenbestand. In dit geval is zichtbaar dat het om een geschikt bestand voor verwerking gaat Tabblad Statistieken In het tabblad Statistieken vindt u de statistieken die van toepassing zijn voor WION. In het voorbeeld hieronder is een eerste upload van de netbeheerder zichtbaar. Het bestand bevat in totaal 4 documenten (in deze situatie zal het Aantal nieuw 4 zijn en het Aantal gewijzigd 0). Telkens bij een volgende aanlevering zal vermeld worden hoeveel documenten in het aangeleverde bestand nieuwe documenten zijn en hoeveel er worden gewijzigd. Versie augustus / 26

13 3.3 Stap 3: Bestand goedkeuren of afkeuren Nadat alle controles zijn uitgevoerd, kan het bestand worden goedgekeurd of afgekeurd Bestand goedkeuren Indien u voor goedkeuren kiest en dit bevestigt, zal de status veranderen naar Goedgekeurd en In productie. Na het verversen zal de status worden weergegeven In productie. Let op: alle statussen hebben enkel betrekking op deze testdienst. De status in productie heeft geen betrekking op de productie omgeving. Versie augustus / 26

14 3.3.2 Bestand afkeuren Indien u voor afkeuren kiest en dit bevestigt zal de status direct veranderen in Afgekeurd. 4 NTD Actualiseren netinformatie Met deze dienst kunt u uw netinformatie uploaden en valideert het Kadaster of de netinformatie valide is (dat wil zeggen aan het IMKL2015 voldoet). Binnen de tool vindt de validatie plaats en wordt het resultaat van de validatie aan u teruggekoppeld. In de definitieve productie-situatie zullen er validaties zijn ten behoeve van INSPIRE en WION. In deze bètarelease van de NTD Actualiseren netinformatie ligt de focus op INSPIRE-validatie. 4.1 Stap 1: NTD Actualiseren netinformatie gebruiken U komt nu in de dienst NTD Actualiseren netinformatie (bèta-versie). Let op: alle statussen hebben enkel betrekking op deze testdienst. De status in productie heeft geen betrekking op de productie omgeving. Toelichting op de velden: +: hiermee kunt u meerdere statussen zien, dan enkel de laatste status Versie augustus / 26

15 ID: per upload wordt er een id toegekend Bestandsnaam: hier wordt de originele bestandsnaam getoond Tijdstip: dit is het tijdstip van de laatste status update Status: dit is de huidige status Download overzicht: creëer hiermee een status rapport Opmerkingen: hier kunt u naar het logbestand of controleren scherm 4.2 Stap 2: nieuw netinformatiebestand uploaden Om een nieuw netinformatiebestand te uploaden gaat u naar Selecteer bestand. Er zal een navigatiescherm openen. Blader naar het bestand dat u wilt uploaden en klik op openen. In de bètaversie van deze dienst wordt de grootte van het ZIP-bestand beperkt tot 500 MB. Versie augustus / 26

16 De naam van het bestand wordt naast de knop Selecteren bestand getoond ter verificatie. Ook ziet u dat er een nieuwe knop verstuur te zien is (zie afbeelding hieronder). Door op de knop verstuur te klikken verstuurt u het bestand aan het Kadaster. Vervolgens zullen de automatische controles starten. Na het versturen zal er een nieuwe ID-regel worden toegevoegd met status Aanlevering geslaagd. Vervolgens zal het Kadaster het aangeleverde bestand gaan controleren. Dit proces gebeurt achter de schermen. In deze bèta-versie ontbreekt hier nog een statusbalk m.b.t. het controleren. Ververs hier niet zelf de webpagina, maar wacht op onderstaande pop-up. (Doet u dit wel, dan zal de gehele webpagina opnieuw geladen worden en dit vertraagt het proces.) Versie augustus / 26

17 U ontvangt van iedere statuswijziging een update in de vorm van een pop-up, bijvoorbeeld: Als de controles gereed zijn, verschijnt er wederom een pop-up. In deze voorbeeldsituatie is de status Gevalideerd met fouten. Kies voor verversen en bekijk vervolgens het logbestand voor de details Logbestand controleren/downloaden U komt nu in het Controleren scherm waar het logbestand aangeeft welke fouten zijn aangetroffen. Op dit moment wordt dit beperkt tot de eerste 1000 fouten. Het logbestand is ook te downloaden in csv-formaat door op de knop Download log te klikken. Versie augustus / 26

18 Versie augustus / 26

19 4.2.2 Een nieuw bestand uploaden (goed-situatie) Nadat u de fouten heeft verwerkt en een nieuw bestand wilt uploaden, gaat u wederom naar Selecteer bestand en herhaalt u de stappen zoals eerder in dit hoofdstuk uitgelegd. D.m.v. een pop-up ontvangt u updates, bijvoorbeeld: Als de controles gereed zijn, verschijnt er wederom een pop-up. In deze goed-situatie zal de laatste status zijn Gereed voor handmatige controle. Versie augustus / 26

20 Kies na Verversen voor Controleren en bekijk de details. Er zal zich een nieuw scherm openen. In dit scherm ziet u de tabbladen Logbestand, Statistieken en Kaart Tabblad Logbestand In het tabblad Logbestand is de status zichtbaar van het netinformatiebestand. In dit geval is zichtbaar dat het om een valide bestand gaat. Versie augustus / 26

21 4.2.4 Tabblad Statistieken In het tabblad Statistieken vindt u de statistieken voor WION en INSPIRE. In het voorbeeld hieronder is zichtbaar dat het bestand in totaal 148 kabels en leidingen bevat. Ook is er een onderscheid gemaakt per gebruikt thema. Versie augustus / 26

22 Voor de INSPIRE statistieken kiest u aan de bovenzijde de radiobutton INSPIRE. INSPIRE kent andere thema s dan WION. De onderverdeling is gemaakt aan de hand van het IMKL2015 (informatiemodel). Voor meer informatie hierover kunt u de technische toelichting raadplegen Tabblad Kaart In het tabblad Kaart ziet u het nieuwe bestand via Nieuwe aangeleverde netinformatie (concept). U kunt hier een controle doen met een eerder bestand wat in de testdienst is goedgekeurd en de status heeft In Productie Let op: de status heeft enkel betrekking op deze testdienst. De status in productie heeft geen betrekking op de productie omgeving. Let op: vanaf 1: wordt netinformatie weergegeven. Versie augustus / 26

23 4.2.6 Zoeken op gml-id U kunt ook specifiek een gml-id zoeken. Vul hiervoor de betreffende gml-id aan en klik op zoek. Als er een foutieve id wordt opgegeven, verschijnt de melding: 4.3 Stap 3: Bestand goedkeuren of afkeuren Nadat alle controles zijn uitgevoerd, kan het bestand worden goedgekeurd of afgekeurd. Versie augustus / 26

24 4.3.1 Bestand goedkeuren Indien u voor goedkeuren kiest en dit bevestigt, zal de status veranderen naar Goedgekeurd en In productie. Na het verversen zal de status worden weergegeven In productie. Let op: alle statussen hebben enkel betrekking op deze testdienst. De status in productie heeft geen betrekking op de productie omgeving Bestand afkeuren Indien u voor afkeuren kiest en dit bevestigt zal de status direct veranderen in Afgekeurd. Versie augustus / 26

25 4.4 Stap 4: PDF overzicht In het statusoverzicht wordt er per aangeleverd bestand een statusrapport beschikbaar gesteld in PDF. In de PDF is een aantal statistieken zichtbaar. Onderstaand ziet u hiervan een voorbeeld. Versie augustus / 26

26 5 Uitgangspunten De focus op dit moment is INSPIRE netinformatie en in een groeipad zullen controles toegevoegd worden. De IMKL2015 versie die het Kadaster gebruikt in deze bèta-versie van de dienst (IMKL versie 1.1) staat gepubliceerd op de website van geo-standaarden in Nederland. 5.1 Validatie netinformatie De belangrijkste uitgangspunten met betrekking tot de bestands-validatie zijn: Het upload-bestand is een ZIP-file Maximale bestandsgrootte van de ZIP-file is 500 MB (in de bèta versie van deze dienst) In de ZIP zit 1 XML-bestand De uitgebreide omschrijving van de validatieregels is te vinden op Github van het Kadaster. Hier vindt u ook extra informatie (o.a. hints & tips). 5.2 Validatie documenten De belangrijkste uitgangspunten met betrekking tot de documenten-validatie zijn: Het upload-bestand is een ZIP-file Maximale bestandsgrootte van de ZIP-file is 200 MB (in de bèta versie van deze dienst) In de ZIP zit exact 1 XML-bestand. Dit bestand beschrijft de overige documenten (meta-informatie). XSD controle van het XML-bestand (meta-informatie). Alle genoemde bestanden in.xml-bestand moeten aanwezig zijn in het ZIP-bestand. Type aangeleverde documenten: deze moeten.pdf documenten zijn. Lokaal-ID moet uniek zijn: mag één keer voorkomen. Lokaal-ID moet juiste bronhoudercode bevatten. Wanneer document wel in.zip bestand maar niet in.xml bestand (meta-informatie) voorkomt: is niet blokkerend (warning). 5.3 Bèta-release Een belangrijk uitgangspunt bij de bèta-release: De aangeleverde gegevens kunnen tijdens het bèta-programma door het Kadaster worden verwijderd (bijvoorbeeld bij een nieuwe release). Bij het live gaan van de productionele versie worden alle tijdens de bètaperiode aangeleverde gegevens verwijderd. Dit geldt zowel voor netinformatie als voor documenten. Versie augustus / 26