Introductie

Welkom op de BROSTAR documentatie!

De BROSTAR is een applicatie die is ontwikkeld door Nelen & Schuurmans om het aanleverproces van data naar de Basis Registratie Ondergrond (BRO) aanzienlijk makkelijker te maken.

Voor de app ga je naar https://www.brostar.nl/ - hier kan je direct aan de gang met je leveringen. Heb je nog bedenkingen, of weet je niet goed wat BROSTAR exact is. De website biedt ook wat meer uitleg over welke rol de applicatie speelt in het beheer proces. Als laatste vind je daar ook de Frequently Asked Questions. Staat jou vraag er niet tussen? Neem contact met ons op via de mail.

Het aanleveren van data naar de BRO is een technisch proces, waarbij kennis van o.a. XML bestanden, scripting en API's vereist is bij de leverancier. Daarom wordt dit proces vaak uitbesteed door bronhouders. In de praktijk bleek dat hierbij de mate van maatwerk enorm hoog was in verband met eigen manieren van dataopslag, datamodellen, applicaties en data governance. De BROSTAR is een applicatie die door elke organisatie op meerdere manieren ingezet kan worden.

De BROSTAR bestaat uit een open-source API en een closed-source frontend.

API

Note

Klik hier voor de technische documentatie van de BROSTAR API.

De basis van de BROSTAR is de API. De API heeft 2 belangrijke hoofdfunctionaliteiten:

• Import taken:

  Importeer data vanuit de BRO in de database van de BROSTAR. Het gaat hierbij om actuele metadata van de objecten, en niet de gehele geschiedenis. In de filosofie van de BROSTAR is de BRO zelf de waarheid en altijd het meest up-to-date. Na een import is het mogelijk om deze gegevens op te vragen en in te zien.

  Note

  Het is mogelijk om openbare data van andere organisaties vanuit de BRO te importeren

• Upload taken:

  Stuur data naar het bronhouderportaal van de BRO. Alle mogelijke berichten worden ondersteund vanuit de API. Het idee van deze functionaliteit is dat je als scripter slechts 1 stap hoeft uit te voeren: het opstellen van een JSON met daarin alle relevante informatie voor het specifieke bericht dat opgestuurd moet worden. De BROSTAR handelt vervolgens de aanlevering naar de BRO API af. Dit omvat het opstellen van een XML bestand, de validatie, de daadwerkelijke levering, en de voortgang van de levering. De voortgang wordt als status bijgehouden, met eventueel belangrijke logging vanuit de BRO.

De API van de BROSTAR is dus een krachtig hulpmiddel bij zowel beheren van bestaande data in de BRO als het aanleveren van nieuwe data. Door de BROSTAR te gebruiken wordt een groot deel van het aanleverproces afgevangen en kan er relatief makkelijk een scripting connectie met de BRO gemaakt worden.

Frontend

Note

Klik hier voor een uitgebreidere functionele documentatie van de frontend.

De frontend is de visuele component van de BROSTAR. Deze is ontwikkeld zodat ook personen zonder scripting ervaring laagdrempelig data kunnen aanleveren. Dit maakt het mogelijk voor bronhouders om het databeheer zelf in handen te nemen.

Als organisatie heb je een eigen omgeving, en kun je eigen data importeren. Net als in de API is het ook mogelijk om data van andere organisaties te importeren. Deze data is op een kaart of in een tabel in te zien, en voor sommige type objecten zelfs al gemakkelijk aan te passen:

BROSTAR homepagina (voorbeeld: Provincie Gelderland)

Het aanleveren van data via de frontend gebeurt achter de schermen via de API. Na het eenmalig instellen van API-tokens voor de BRO, kan de gebruiker databeheer doen middels gebruiksvriendelijke formulieren of bulk uploads doen met Excel bestanden. Hieronder is een voorbeeld te zien waarin de startregistratie van een GMN geregeld wordt via een invulformulier. Als gebruiker kun je bovenin metadata van het GMN invullen. Onderin kunnen GMW's op de kaart geselecteerd worden, om vervolgens de relevante filters te selecteren die als Meetpunt aangeleverd worden.

GMN startregistratie invulformulier

De status van een levering wordt bijgehouden. Als een levering niet geslaagd is, kunnen de foutmeldingen vanuit de BRO ingezien worden, om vervolgens de levering te corrigeren. Hiermee wordt de gebruiker teruggestuurd naar het ingevulde formulier, waardoor een aanpassing gemakkelijk gemaakt kan worden voordat een nieuwe poging tot levering gedaan wordt:

Voorbeeld van de foutmeldingen bij een gefaalde taak. Op de achtergrond zijn succesvolle taken te zien.

Tip

Weet je niet welke berichten je moet gebruiken om tot het gewenste eindresultaat te komen? De BROSTAR-berichtenhulp helpt je verder!

Info

De frontend is nog vol in ontwikkeling. Momenteel zijn de type berichten die mogelijk zijn vanuit de frontend beperkt. Als er vanuit meerdere gebruikers wensen tot uitbreiding zijn, worden deze gerealiseerd.

Productie vs Demo

Net zoals de BRO zelf, heeft de BROSTAR een productie en een staging omgeving. De productie van de BROSTAR is op de productie van de BRO gekoppeld en de staging is op de demo van de BRO gekoppeld.

Met een licensie op de BROSTAR krijgt een organisatie een eigen omgeving op beide omgevingen. Daarmee is het mogelijk om eerst te testen en te ontwikkelen met dummy data via de demo omgeving.

Frequently Asked Questions [FAQ]

Ik begrijp de foutmelding die geschreven wordt niet, hoe lees ik een foutmelding vanuit de basisregistratie ondergrond?

Het is altijd vervelend als je niet helemaal begrijpt wat er misgaat. Bij BROSTAR proberen we veel voorkomende fouten te vertalen naar een begrijpbaardere taal, maar er zijn simpelweg te veel mogelijkheden om alles af te vangen.

In veel gevallen zal het er om gaan dat:

• Een gegeven niet gebruikt mag worden.
• Een bericht-type niet volstaat voor de gewenste wijziging (bijv. omdat er al een gebeurtenis is geregistreerd na dit onderhoud).
• De machtigingen zijn niet goed geregeld.

Er wordt aangegeven dat de bronhouder uit mijn bericht niet overeenkomt met de basisregistratie, wat gaat er mis?

Bij de foutmelding '' komt het project wat wordt gebruikt voor de levering niet overeen met de bronhouder van het registratie object. Als bronhouder van een registratie object heb je zeggenschap over wie er wel en niet wijzigingen mag doen aan jou objecten. Deze rechten worden verleend via projecten in het bronhoudersportaal. Een bronhouder machtigd je binnen een project, en jij kan dan dat projectnummer gebruiken voor je levering.

De BRO controleert dan bij de levering onder het project of het token wat gebruikt is voor de levering (wat weer bewijst van welke organisatie jij bent) de juiste rechten heeft onder dit project.

Is dit het geval? Mooi dan mag je leveren. Anders wordt de levering afgekeurd.

De genoemde foutmelding treed dus op wanneer je een levering probeert voor een registratie vanuit bronhouder A onder een project van bronhouder B.

Interesse of vragen?

Benieuwd naar wat BROSTAR voor jou organisatie kan betekenen? Neem contact met ons op via info@nelen-schuurmans.nl. Ook voor vragen of ondersteuning met zaken rondom de Basisregistratie Ondergrond (BRO) kan je met onze servicedesk contact opnemen.