Basisregistratie Ondergrond (BRO) Handleiding voor innameloket Geotechnisch Sondeeronderzoek. Datum 4 juli 2017 Status Versie 1.0

Transcriptie

1 Basisregistratie Ondergrond (BRO) Handleiding voor innameloket Geotechnisch Sondeeronderzoek Datum 4 juli 2017 Status Versie 1.0

2

3 Inhoudsopgave Inleiding... 4 Doelgroep... 4 Leeswijzer... 4 Zelfstandig aan de slag... 4 Praktische informatie over het innameloket van de BRO... 6 Inleiding... 6 Algemene eisen... 6 Ontwikkeling BRO per registratieobject... 6 Documentatie... 6 De drie stappen... 7 Beoogd resultaat... 8 Doorlooptijd... 8 Stap 1: Toegang... 9 Inleiding... 9 Middelen... 9 Uitleg en acties... 9 Resultaat Stap 2: Bestand klaarmaken Inleiding Middelen Uitleg en acties Resultaat Stap 3: Het aanbieden van het bestand.. 14 Inleiding Middelen Uitleg en acties Resultaat... 19

4 Inleiding In de Basisregistratie Ondergrond (BRO) worden gegevens over de ondergrond, modellen, infrastructuur en vergunningen opgeslagen. De BRO wordt gefaseerd per registratieobject opgebouwd. Dat betekent ook dat de ingebruikname gefaseerd verloopt. Deze handleiding beschrijft hoe dataleveranciers voor het registratieobject Geotechnisch Sondeeronderzoek (CPT) gegevens kunnen aanleveren via het innameloket van de BRO. Doelgroep Deze handleiding is gericht op: Partijen die CPT-gegevens willen aanleveren aan de BRO, de dataleveranciers Voor zowel inhoudsdeskundigen als andere betrokken medewerkers van de organisaties, bevat deze handleiding informatie. Leeswijzer Allereerst wordt er een introductie met praktische informatie over het innameloket gegeven. Er wordt onder meer ingegaan op de ondersteunende documentatie en er wordt een schematisch overzicht gegeven van de drie stappen om het innameloket te gebruiken. Deze stappen komen vervolgens elk in een afzonderlijk hoofdstuk aan bod: stap 1 toegang, stap 2 het bestand klaarmaken en tot slot stap 3 het aanbieden.! Let op! Aandachtspunten worden telkens in een kader aangegeven. Zelfstandig aan de slag Deze handleiding is erop gericht dat dataleveranciers zelfstandig aan de slag kunnen met het BRO innameloket voor een specifiek registratieobject. Mochten er toch problemen of vragen zijn, dan kan contact opgenomen worden met de BRO Servicedesk. contact@broinfo.nl Telefoonnummer: (bereikbaar op werkdagen tussen 9.00 en uur)! Het gebruik van de BRO Selfservicedesk is echter sneller: support.gdnnet.nl U kunt daar gebruik van maken zodra uw organisatie is aangemeld bij de BRO (zie stap 1). De Selfservicedesk is echter niet toegankelijk met een smartphone of tablet. Pagina 4 van 19

5 Algemene informatie over de BRO is te vinden op: of Pagina 5 van 19

6 Praktische informatie over het innameloket van de BRO Inleiding Dit hoofdstuk geeft praktische informatie over het innameloket van de BRO voor CPT. Algemene eisen Allereerst is er een aantal vereisten waar een dataleverancier aan moet voldoen om gebruik te kunnen maken van het innameloket van de BRO voor CPT: Kennis van het registratieobject Geotechnisch Sondeeronderzoek dat men wil registreren. Technisch inhoudelijke kennis: het op hoofdlijnen kunnen werken met GEF-bestanden. Ontwikkeling BRO per registratieobject De ontwikkeling van de BRO verloopt per registratieobject. Voor elk registratieobject worden namelijk afzonderlijke webservices ontwikkeld om geautomatiseerd gegevens uit te kunnen wisselen met de BRO. Daarnaast wordt er nog gewerkt aan een bronhouderportaal (zie Facultatief wordt voor een aantal registratieobjecten ook het innameloket beschikbaar gesteld om interactief gegevens aan te kunnen leveren. Bij zowel de webservices als het innameloket maakt de BRO als basisregistratie zoveel mogelijk gebruik van de standaarden van de eoverheid. Zo is voor het interactief aanbieden van gegevens bij de BRO via het innameloket eherkenning (minimaal EH2+) nodig. Dit is een digitale sleutel om eenvoudig en veilig in te kunnen loggen bij het innameloket van de BRO. Documentatie Voor het klaarmaken van het bestand in stap 2 biedt de BRO het volgende ondersteunende document: Handreiking voor conversie GEF naar IMBRO De handreiking voor conversie GEF naar IMBRO is te downloaden op bij de documenten (doorklikken naar Geotechnisch Sondeeronderzoek ). Verder zijn de GEF-definitie (Geotechnical Exchange Format for CPT-data, CUR, versie 1.1.2) en de GEF-DISS-definitie (The Pagina 6 van 19

7 Standard for Reporting the Results of a Dissipation Test in the Geotechnical Exchange Format, CUR, november 2000) praktisch. De drie stappen Het gebruik van het innameloket van de BRO voor CPT bestaat uit drie stappen: het regelen van toegang (1), het bestand klaarmaken (2) en tot slot het aanbieden van dat bestand via het innameloket (3). In deze handleiding wordt beschreven wat bij elke stap gedaan moet worden. Zo is de eerste stap het administratieve gedeelte om toegang te krijgen. Dit bestaat uit het aanmelden, het aanvragen van rechten en de authenticatie. De tweede stap is het technisch inhoudelijke gedeelte: het klaarmaken van het bestand. Zodra uw bestand gereed is, kunt u het bestand in de laatste stap aanbieden bij de BRO. Start 1 Dataleverancier Stap 1: Toegang Basisregistratie Ondergrond (BRO) 2 Stap 2: Bestand klaarmaken 1. Registreren 3 Stap Stap 3: Aanbieden 3: Test Einde Systeem van de dataleverancier Innameloket Elke stap wordt uitgebreid beschreven en toegelicht in de volgende hoofdstukken. Fragmenten van de afbeelding komen daarbij terug om aan te geven waar men in het proces zit. Verder is elk hoofdstuk - ofwel elke stap - als volgt opgebouwd: Paragraaf Inleiding Middelen Uitleg en acties Beschrijving Deze paragraaf beschrijft wat het doel van de stap is en vat kort samen wat de stap inhoudt. Deze paragraaf beschrijft wat nodig is om deze stap uit te voeren. Soms kunnen dat ook middelen zijn die vanuit de BRO geleverd worden. Deze paragraaf beschrijft wat gedaan moet worden om de stap uit te voeren. Daar waar Pagina 7 van 19

8 Resultaat afhankelijkheden bestaan, staan de acties in de juiste chronologische volgorde. Deze paragraaf beschrijft wat het resultaat is, als deze stap goed is doorlopen. Online starten met stap 1 op BROinfo De site helpt dataleveranciers en data-afnemers op weg om te werken met de BRO. Ook als het gaat om het werken met het BRO innameloket, kunt u op BROinfo starten. Kies dan allereerst het registratieobject en start vervolgens met Rechten aanvragen. U komt dan automatisch ook bij het aanmeldformulier (zie ook 1.1 in deze handleiding). Als u vervolgens de juiste digitale sleutel heeft (zie 1.2 in deze handleiding) kunt u aan de slag met stap 2. Deze handleiding legt vervolgens uit wat u bij stap 2 en 3 moet doen. Beoogd resultaat Het uiteindelijke doel is dat de dataleverancier interactief gegevens kan aanbieden via het innameloket bij de BRO. Doorlooptijd De doorlooptijd is afhankelijk van de volgende factoren: De benodigde tijd voor de aanvraag van eherkenning niveau 2+ of hoger (zie stap 1). De inspanning van de dataleverancier die nodig is om bestanden aan te bieden volgens de richtlijnen van het BRO-systeem (stap 2 en 3). Pagina 8 van 19

9 Stap 1: Toegang Start 1 Dataleverancier Stap 1: Toegang Basisregistratie Ondergrond (BRO) 2 Stap 2: Bestand klaarmaken 1. Registreren 3 Stap Stap 3: Aanbieden 3: Test Einde Systeem van de dataleverancier Innameloket Inleiding De eerste stap is het administratieve gedeelte: het regelen van de toegang. Dit bestaat uit het aanmelden, het aanvragen van rechten en de authenticatie. Middelen Naast de algemene eisen die in het hoofdstuk met algemene informatie zijn genoemd, zijn voor stap 1 geen aanvullende middelen nodig. Uitleg en acties 1.1 Aanmelden en rechten aanvragen Niet iedereen heeft toegang tot het innameloket van de BRO. Daarom moeten dataleveranciers zich eerst aanmelden bij de BRO. Dat kan op kies de landelijke voorziening BRO en vervolgens het registratieobject CPT. Start daar met Rechten aanvragen. U komt dan via de eerste vraag automatisch bij het aanmeldformulier. Zodra uw aanmelding is verwerkt, ontvangt u inloggegevens voor de BRO Selfservicedesk waar u vervolgens rechten kunt aanvragen voor CPT.! Als een dataleverancier namens een bronhouder gegevens wil aanleveren, dan moet de bronhouder ook aangemeld Pagina 9 van 19

10 zijn bij de BRO. Daarnaast moet bij de BRO bekend zijn dat de dataleverancier namens die bronhouder gemachtigd is om gegevens aan te leveren. Alleen dan heeft een dataleverancier toegang tot de BRO. Zolang de BRO-wet echter nog niet van kracht is, is van formeel bronhouderschap nog geen sprake. Tot die tijd is het ministerie van Infrastructuur en Milieu bronhouder. Machtigen is vooralsnog niet van toepassing. 1.2 Aanvragen eherkenning Als authenticatie voor het innameloket wordt eherkenning gebruikt. Dit is een digitale sleutel om eenvoudig en veilig in te kunnen loggen bij het innameloket van de BRO. Het is te vergelijken met DigiD. Het verschil is dat DigiD door de overheid verstrekt wordt aan burgers en eherkenning door commerciële bedrijven aan organisaties. eherkenning is beschikbaar in verschillende betrouwbaarheidsniveaus. Voor het BRO innameloket is minimaal betrouwbaarheidsniveau EH2+ nodig. Heeft u nog geen eherkenning met minimaal betrouwbaarheidsniveau 2+? Met dit stappenplan van eherkenning kunt u eherkenning aanvragen bij een van de zes leveranciers of kijk voor meer informatie op Het aanvragen van eherkenning loopt buiten de BRO om. Houdt u er rekening mee dat het enige tijd kost voordat u over eherkenning beschikt. Resultaat Na het uitvoeren van de acties van stap 1 is de toegang tot het innameloket van de BRO geregeld voor het registratieobject CPT. U kunt met uw gebruikersnaam en wachtwoord plus smscode van eherkenning inloggen. Voordat dat zover is (stap 3), komt in stap 2 het klaarmaken van het bestand aan bod. Pagina 10 van 19

11 Stap 2: Bestand klaarmaken Start 1 Dataleverancier Stap 1: Toegang Basisregistratie Ondergrond (BRO) 2 Stap 2: Bestand klaarmaken 1. Registreren 3 Stap Stap 3: Aanbieden 3: Test Einde Systeem van de dataleverancier Innameloket Inleiding Nadat in stap 1 de toegang is geregeld, volgt in deze stap het klaarmaken van het bestand om de CPT-gegevens aan te bieden bij de BRO. Hier start het technisch inhoudelijk gedeelte. Dit hoofdstuk beschrijft waar het bestand aan moet voldoen. U moet daarbij zelf bepalen of u uw systeem dat de CPT-gegevens genereert aanpast of dat u telkens handmatig het bestand aanpast. Middelen Voor het uitvoeren van deze stap is het volgende nodig: Handreiking conversie GEF voor IMBRO Verder zijn de GEF-definitie en de GEF-DISS-definitie praktisch. Pagina 11 van 19

12 Uitleg en acties 2.1 Formaat Via het innameloket kunnen CPT-gegevens aangeleverd worden in twee formaten, te weten een GEF en een XML formaat. De inhoud moet natuurlijk wel conform de regels zijn die de BRO daaraan stelt. 2.2 Inhoud De aangeboden CPT-gegevens moeten voldoen aan de eisen van de BRO. Hiervoor gelden twee kwaliteitsregiems: IMBRO IMBRO/A (voor archiefgegevens en tijdelijk ook toegestaan voor nieuwe gegevens) Voor de gegevens in het GEF formaat kunt u op basis van het document Handreiking conversie GEF voor IMBRO de inhoud van het GEF-bestand controleren en eventueel aanvullen. Voorlopig volstaat echter ook het kwaliteitsregiem IMBRO/A. Dat betekent dat het GEF-bestand op twee punten veranderd moet worden, zodat het bestand voldoet. Het gaat daarbij om een wijziging (KvK-nummer) en een toevoeging (bronhouder). Natuurlijk blijft het wenselijk om uw gegevens op te waarderen naar het IMBRO kwaliteitsregiem. KvK-nummer De btw-nummers moeten in het GEF-bestand worden vervangen door KvK-nummers, aangezien de BRO werkt op basis van de Kamer van Koophandel registratie. Het attribuut btw-nummer wordt dus KvK-nummer. Bronhouder In het GEF-bestand moet de bronhouder van de gegevens worden toegevoegd. Het betreft hier de instantie die vanuit de BRO-wet is aangemerkt als bronhouder voor dat object. Het attribuut bronhouder wordt dus toegevoegd in de vorm van het KvK-nummer van de betreffende bronhouder. Dit betreft in het GEF-bestand het attribuut #MESURMENTTEKST 101.! Tot de Algemene Maatregel van Bestuur van kracht wordt moet als bronhouder het KvK-nummer van het ministerie van Infrastructuur en Milieu ingevuld worden ofwel Algemene tips Wat alvast handig is om te weten, is dat u per levering alleen identieke bestanden kunt aanbieden. Dat wil zeggen, dat alle Pagina 12 van 19

13 bestanden gericht moeten zijn op registreren of corrigeren (niet beide). Bovendien moeten die bestanden allemaal hetzelfde kenmerk hebben: Gegevens van maximaal één type registratieobject, dus alleen CPT-gegevens. Gegevens van maximaal één bronhouder. Maximaal één bestandsformaat: GEF of IMBRO-XML Inhoud van het bestand moet voldoen aan één kwaliteitsregime: IMBRO of IMBRO/A 2.4 Dissipatietest Bij het aanbieden van de CPT-gegevens moeten ook de bijbehorende dissipatietesten worden aangeboden. Voor deze bestanden gelden ook de richtlijnen voor het formaat en inhoud, zoals die in dit hoofdstuk zijn beschreven. Resultaat Het bestand is nu gereed om aan te bieden bij de BRO via het innameloket. Nu kan verder gegaan worden met stap 3. Pagina 13 van 19

14 Stap 3: Het aanbieden van het bestand Start 1 Dataleverancier Stap 1: Toegang Basisregistratie Ondergrond (BRO) 2 Stap 2: Bestand klaarmaken 1. Registreren 3 Stap Stap 3: Aanbieden 3: Test Einde Systeem van de dataleverancier Innameloket Inleiding In deze stap wordt het bestand aangeboden bij de BRO. Bij het aanbieden van het bestand via het innameloket vindt al een aantal controles plaats. Het is dus mogelijk dat er nog enkele aanpassingen gedaan moeten worden. In dit hoofdstuk wordt beschreven waar u op moet letten. Middelen Voor het uitvoeren van deze stap zijn de volgende middelen nodig (zie stap 1): Rechten om gegevens aan te mogen leveren bij de BRO. Minimaal eherkenning niveau 2+ Uitleg en acties 3.1 Ga naar BROinname Ga naar Onderaan de pagina staat de button om in te loggen bij het innameloket voor Geotechnisch Sondeeronderzoek. Pagina 14 van 19

15 3.2 Log in met eherkenning Via de hyperlink komt u op het inlogscherm van eherkenning van het innameloket van TNO-GDN voor Geotechnisch Sondeeronderzoek. Bij Maak een keuze moet u de leverancier van uw eherkenningsmiddel kiezen. Vervolgens kunt u op het inlogscherm van uw eherkenningsleverancier met uw gebruikersnaam en wachtwoord inloggen, waarna wordt gevraagd om uw sms-code. Lukt het inloggen niet, dan is mogelijk een van deze situaties van toepassing: U heeft niet de juiste eherkenningsleverancier gekozen. Controleer uw eherkenningsgegevens. De combinatie van gebruikersnaam, wachtwoord en sms-code klopt niet. Controleer uw inloggegevens van eherkenning. Komt u er niet uit? Neemt u dan contact op met de leverancier van uw eherkenningsmiddel. Pagina 15 van 19

16 U bent nog niet aangemeld bij de BRO. Dit kunt u controleren door contact op te nemen met de BRO Servicedesk. Ook is het mogelijk dat u wel kunt inloggen met eherkenning, maar dat u de melding krijgt dat u niet de juiste rechten heeft om gegevens aan te bieden. Log in bij de BRO Selfservicedesk (support.gdnnet.nl) om dit te controleren en/of rechten aan te vragen. 3.3 Stap 1 bij het innameloket: Definiëren aanbieding Als het inloggen met eherkenning is gelukt, bent u op het innameloket van Geotechnisch Sondeeronderzoek bij stap 1 Definiëren aanbieding. In deze stap moet u de gegevens invullen die van toepassing zijn op de bestanden die u wilt aanbieden. Aanbiedingskenmerk Vul hier uw aanbiedingskenmerk in. Hoewel dit aanbiedingskenmerk is bedoeld voor uw eigen administratie, wordt dit ook bij de registratie van uw gegevens in de BRO opgenomen. Na het voltooien van de aanbieding van uw gegevens, ontvangt u een waarin dit aanbiedingskenmerk ook terugkomt. Bronhouder Dit is een keuzeveld. Is uw organisatie de bronhouder van de gegevens, dan kunt u uw organisatienaam kiezen. Levert u namens een bronhouder aan, kies dan de naam van de bronhouder waarvoor u gegevens aanlevert.! Tot de Algemene Maatregel van Bestuur van kracht wordt moet u hier Ministerie van Infrastructuur en Milieu kiezen. Andere opties zijn niet mogelijk. Pagina 16 van 19

17 ! U kunt maximaal voor één bronhouder tegelijk gegevens aanbieden. Aanbiedingstype Geef aan of u nieuwe gegevens wilt aanbieden of gegevens wilt corrigeren. Het corrigeren van gegevens kan overigens alleen gedaan worden door de leverancier of bronhouder die die gegevens in eerste instantie heeft aangeleverd.! U kunt per keer dat u gegevens aanbiedt bij het innameloket niet zowel nieuwe gegevens als te corrigeren gegevens aanbieden. Als u gekozen heeft voor correctie, vraagt het innameloket ook om de reden van correctie aan te geven. De reden kan bijvoorbeeld zijn dat u de registratiegegevens (naam bronhouder), de onderzoeksgegevens of het kwaliteitsregime (IMBRO of IMBRO/A) wilt aanpassen. Formaat Maak de keuze uit IMBRO-XML of GEF.! U kunt per keer dat u gegevens aanbiedt bij het innameloket niet zowel IMBRO-XML als GEF aanbieden. Kwaliteitsregime Kies vervolgens aan welk kwaliteitsregime de inhoud van het bestand voldoet: IMBRO of IMBRO/A. Zie voor meer informatie paragraaf 2.2 bij stap 2 het bestand klaarmaken.! U kunt per keer dat u gegevens aanbiedt bij het innameloket niet bestanden aanleveren die aan beide kwaliteitsregimes voldoen. 3.4 Stap 2 bij het innameloket: Toevoegen bestanden In deze stap voegt u de bestanden van Geotechnisch Sondeeronderzoek toe en de daarbij horende dissipatietesten. Allereerst ziet u rechts op het scherm bij Aanbieding een overzicht van de innamecriteria die u heeft ingevuld bij stap 1. Alle bestanden die u in deze stap selecteert moeten betrekking hebben op de in stap 1 gekozen innamecriteria. Wilt u uw innamecriteria wijzigen? Kies dan onderaan het scherm Terug naar stap 1. Kloppen de innamecriteria, dan kunt u de bestanden toevoegen. Pagina 17 van 19

18 Selecteer de bestanden die u wilt aanbieden bij de BRO. Als u bij stap 1 heeft aangegeven dat u een GEF-bestand wilt aanbieden, dan moet u hier ook de dissipatietesten toevoegen. Zijn alle bestanden toegevoegd, ga dan verder met stap 3. Zodra u Verder met stap 3 kiest, voert het innameloket twee procedures uit: controle en conversie. Allereerst controleert het innameloket uw bestanden. Zijn er geen foutmeldingen, dan converteert het innameloket uw bestand(en) naar IMBRO-XML. Wat te doen bij een foutmelding? Krijgt u echter een foutmelding, zie onderstaand voorbeeld, dan kunt u de foutmelding openen en/of bewaren om te bekijken wat de reden is van de foutmelding. Hierbij is het handig om te weten dat één sondering met drie dissipatietesten bij GEF gezien wordt als vier bestanden en één object. 3.5 Stap 3 bij het innameloket: Aanbieden verzoeken In deze stap controleert u het overzicht met alle gegevens, waarna u uw bestand(en) kunt aanbieden bij de BRO. Allereerst ziet u rechts op het scherm bij Aanbieding een overzicht van de innamecriteria die u heeft ingevuld bij stap 1. Wilt u uw innamecriteria wijzigen? Kies dan onderaan het scherm Terug naar stap 2 en ga daar Terug naar stap 1 om de criteria te wijzigen. U moet de bestanden dan opnieuw toevoegen in stap 2 en komt dan weer bij stap 3. Pagina 18 van 19

19 Overzicht bestanden Controleer vervolgens de bestanden die u heeft geselecteerd in stap 2. Wilt u bestanden toevoegen of verwijderen? Kies dan onderaan het scherm Terug naar stap 2. Voltooien Klopt het bestandsoverzicht en kloppen de criteria van de aanbieding, dan kunt u het aanbieden van gegevens aan de BRO definitief maken. Het BRO-systeem voert nog een controle uit en toont een samenvatting (zie onderstaand voorbeeld). Tot slot ontvangt u ook een met de details van uw aanbieding en de eventuele reden van afgewezen CPTgegevens. Resultaat De geaccepteerde CPT-gegevens zijn nu definitief geregistreerd in de BRO en hebben een identificatiecode gekregen: een BRO- ID. In het geval van een aangeboden correctie, volgt registratie na controle door de registratiebeheerder. Afgewezen CPTgegevens zijn niet geregistreerd en moeten opnieuw worden aangeboden. Pagina 19 van 19