LV BAG - Digilevering Informatieproduct en koppelvlakomschrijving

Transcriptie

1 LV BAG - Digilevering Informatieproduct en koppelvlakomschrijving Datum 2 juli 2014 Versie 1.0 DefinitiefICT Services Keten RZDirectie IT Versie juli / 20

2 Versiehistorie Versie datum locatie omschrijving /04/ /05/ /05/ /05/ /6/ /07/ /07/2014 Initieel Informatieproducten Koppelvlak beschrijving toegevoegd Review verwerkt Review verwerkt Voorbeeld bericht toegevoegd Review verwerkt Review verwerkt Definitieve versie Versie juli / 20

3 Inhoudsopgave 1 Inleiding Achtergrond Dienst BAG Digilevering van de landelijke voorziening BAG Abonnement in de Digilevering voorziening Referentie documentatie Actueel ondersteunde koppelvlakken Algemeen Ketenperspectief Digilevering, toegepast voor BAG Inhoud Digilevering bericht in relatie tot de gebeurtenis bij de BAG bronhouder Informatieproduct BAG Digilevering Uitgangspunten productbeschrijving Productbeschrijving Digilevering BT-2 Gebeurtenis afnemer Informatieproduct en mutatieproduct Verwerkingsvolgorde Mutatieproducten Koppelvlak BAG Digilevering Verschijningsvorm Digilevering bericht Implementatie aspecten Robuust tegen meerdere koppelvlakken door filtering bij Afnemer Verwerkingsvolgorde in relatie tot berichten van Digilevering Handreiking en maatregelen voor verwerkingsvolgorde Aansluiten op een initieel Extract voor het bijhouden van een kopie Gebeurtenissen destilleren Gebeurtenissen uit het processenhandboek Eigen gebeurtenissen Bijlagen Informatie model IMBAG V0.70 ( ) Voorbeeld XML regel van een mutatiebericht Known issues Versie juli / 20

4 1 Inleiding 1.1 Achtergrond Het BAG BAO heeft op 2 mei 2010 besloten dat de Landelijke Voorziening BAG(LV BAG) moet aansluiten op de stelselvoorziening Digilevering. Deze stelselvoorziening is bedoeld om afnemers actief en op generieke wijze te informeren over wijzigingen die zich voordoen in basisregistraties. Hiertoe moeten alle mutaties die zich voordoen in de BAGLV, worden doorgegeven aan Digilevering, zodat Digilevering ze kan doorsturen naar geabonneerde afnemers. 1.2 Dienst BAG Digilevering van de landelijke voorziening BAG De dienst BAG digilevering levert anno 2014 berichten, met daarin mutaties die optreden in de LV BAG. Dit document beschrijft de mutaties c.q. de functionele inhoud van de berichten die door Digilevering, namens de LV BAG, aan Afnemers worden geleverd. Voor het technisch aansluiten op Digilevering dient u zicht aan te melden bij Logius. Verder zullen bijzonderheden worden beschreven die relevant zijn voor Afnemers die een applicatie maken om de berichten van de Digilevering, met daarin de gegevens van de BAG, te verwerken. 1.3 Abonnement in de Digilevering voorziening Na de technische aansluiting op Digilevering bij Logius dient u zich aan te melden bij het Kadaster. Dit kunt u doen door het formulier hiervoor op onze website in te vullen: Vervolgens zullen we gezamenlijk uw wensen bekijken en deze vertalen naar een abonnement in de Digilevering en/of eventuele andere LV BAG producten. 1.4 Referentie documentatie [1] Koppelvlakkenbeschrijving Digilevering R2 v1.2.pdf [2] Informatieproducten BAG Extract. [3] Koppelvlak BAG Extract c194f3b0-19df-4560-aabe-b037cee475c0 [4] BAG Processenhandboek [5[ BAG Catalogus Actueel ondersteunde koppelvlakken Bag-digilevering kent één koppelvlak dat in productie staat: Releasedatum Services Versie Uitfaseerdatum Bijzonderheden Zie hoofdstuk Nog niet bepaald Ingebed in koppelvlak Digilevering, versie 0.6. Versie juli / 20

5 2 Algemeen Ketenperspectief Digilevering, toegepast voor BAG BAG Bronhouders sturen kennisgevingsberichten naar de LV BAG. LV BAG levert deze gegevens door aan Afnemers. Dit laatste gebeurd onder andere via het kanaal Digilevering. De LV levert hiertoe gegevens aan Digilevering en deze levert deze gegevens door aan geabonneeerde Afnemers. De blauwe pijlen tussen de LV en Afnemers worden, voor wat betreft Digilevering, geïmplementeerd via de koppelvlakken Digilevering BT-1 én BT-2. Deze laatste is voor Afnemers. Documentatie van Digilevering [DGL]: een landelijke voorziening stuurt gebeurtenissen aan digilevering. Digilevering bepaalt vervolgens op basis van de geldende abonnementen aan welke afnemers deze gebeurtenis moet worden doorverstrekt, waarbij alleen gegevens worden doorgegeven zoals in het abonnement is vastgelegd. Protocol BT-2: ebms. ebms-service: dgl:verwerken, ebms-action: verstrekkingdoorlv, bericht-naam: dgl:verstrekkingdoorlv Toelichting LV BAG: dit document beschrijft een handreiking voor implementaties bij Afnemers, met als scope de blauwe cirkel. Als Afnemer ontvangt u een digilevering bericht (een envelop), maar daarin de functionele inhoud (de brief) die uit de LVBAG komt. Strict genomen beschrijft BT-2 het deel van de pijl tot en met de ontvangst van het bericht (envelop). Dit document geeft informatie over de verdere verwerking van de functionele inhoud (brief) en over de velden uit Digilevering BT-2: Gebeurtenis afnemer, die door de LV BAG gevuld worden met eigen Versie juli / 20

6 waardes. De gegevens uit BT-2 komen grotendeels overeen met gegevens uit Digilevering BT-1: Gebeurtenis LV, deze zijn overgenomen naar BT-2. Voor de velden die Digilevering zelf toevoegt aan BT-2 wordt verwezen naar de documentatie van Digilevering zelf. 2.1 Inhoud Digilevering bericht in relatie tot de gebeurtenis bij de BAG bronhouder De stelselvoorziening Digilevering beoogt gebeurtenissen door te leveren aan Afnemers. De LV BAG probeert dit principe te volgen. Echter, de gebeurtenis die bij de bronhouder wordt verwerkt wordt nog niet als zodanig door de bronhouder doorgeleverd aan de LV BAG. Naar aanleiding van een gebeurtenis ontstaan mutaties bij de bronhouder en deze worden via kennisgevingsberichten doorgestuurd naar de LV BAG. Hierdoor ontstaan mutaties in de LV BAG en het zijn deze mutaties die via Digilevering worden doorgeleverd aan Afnemers. De LV BAG zorgt ervoor dat één kennisgevingsbericht vanuit een bronhouder ook als één bericht via Digilevering naar afnemers wordt verstuurd. Daarnaast komt heel soms voor dat er een herstelactie plaatsvindt in de LV BAG. Een dergelijke mutatie wordt ook via Digilevering aan Afnemers gestuurd. Versie juli / 20

7 3 Informatieproduct BAG Digilevering Indien u een abonnement heeft op Digilevering voor de BAG, dan ontvangt u een stroom van berichten, met in elk bericht één informatieproduct van de LV BAG. Dit hoofdstuk beschrijft in detail de inhoud van het informatieproduct. Dit hoofdstuk beschrijft niet het bericht zelf, dat wordt beschreven in de documentatie van Digilevering zelf of in hoofdstuk Uitgangspunten productbeschrijving Onderwerp Gebruik van het product door Afnemers Uitgangspunten Extracten Het product kan op twee manieren worden gebruikt: 1. Het ontvangen van een bij elkaar behorende set aan mutaties, om een bedrijfsproces in gang te zetten. 2. Het bijhouden van een lokale kopie. Inhoud van het product Aansluiting Mutatieleveringen (t.b.v. lokale kopie) Frequentie van mutatieleveringen Mutatie formaat XML Compleet gegevensmodel in mutaties Aantallen Eén bericht van de LV BAG bevat één informatieproduct. Dit informatieproduct betreft dezelfde scope en gegevens als wat de bronhouder via één kennisgeving heeft aangeleverd aan de LV. De gegevens zijn gebaseerd op IMBAG (zie bijlage). De structuur is exact dezelfde als het Mutatieproduct van BAG Extract. De eerste levering en de daaropvolgende leveringen van mutaties sluiten naadloos aaneen en vormen in zijn geheel een volledig beeld. Uitgezonderd grote verstoringen wordt een informatieproduct maar één keer (gegarandeerd) geleverd. Mutaties worden geleverd zodra mogelijk. Dit is binnen een uur dat een kennisgeving van een bronhouder in de LV BAG is verwerkt. Het informatiesysteem levert mutaties in XML-formaat. Het systeem levert binnen het XML-formaat, de geometrische gegevens in GML-formaat. Het informatiesysteem levert in een mutatie alle bag objecten en hiervan alle gegevens (attributen). Er worden geen gegevens weggelaten. Hiervoor wordt verwezen naar de SLA van Digilevering. In algemeenheid kan hierover worden gezegd: - Doorgaans worden berichten gedurende werkdagen verstuurd, overdag. In het weekend en in de avond uren kunnen wel berichten verstuurd worden. - In bepaalde situaties, denk hierbij aan verstoringen of onderhoud, worden mutaties in de LV BAG, of elders in de keten, opgespaard. Hierna kan er tijdelijk een grotere stroom van berichten ontstaan. Verwerkingsvolgorde De volgorde is terug te herkennen in de gegevens die meegeleverd worden. Versie juli / 20

8 3.2 Productbeschrijving Het product bestaat uit twee componenten: 1. de envelop : Gebeurtenis Afnemer, conform Digilevering BT-2: Gebeurtenis afnemer. Zie de functionele inhoud. Het mutatie product zelf, bestaande uit 1 of meer bij elkaar behorende mutaties. Dit zijn mutaties op de voorkomens van een BAG object (of BAG objecten). Zie Digilevering BT-2 Gebeurtenis afnemer Via Digilevering wordt een bericht met type BT-2 gestuurd met daarin een aantal gegevens t.b.v. Digilevering. De dikgedrukte velden worden door LV BAG gevuld, de cursieve door Digilevering. Element Datumtijdstempel Digilevering Datumtijdstempel LV Kenmerk Digilevering Kenmerk LV Versie berichttype Abonnement Basisregistratie Gebeurtenissoort Filterinhoud Gebeurtenisinhoud Betekenis Wordt gevuld door Digilevering. Zie Koppelvlakdocumentatie Digilevering BT-2. Door de landelijke voorziening aangebrachte datum + tijdstip waarop de gebeurtenis is verstuurd. Wordt gevuld door Digilevering. Zie Koppelvlakdocumentatie Digilevering BT-2. Door de landelijke voorziening aangebracht kenmerk van het gebeurtenisbericht. Aanduiding van de versie van het berichttype (versie van de berichtdefinitie waarop het bericht Digilevering.xsd is gedefinieerd). Wordt gevuld door Digilevering. Zie Koppelvlakdocumentatie Digilevering BT-2. Aanduiding van de basisregistratie waarvan de gebeurtenis afkomstig is. Aanduiding van de gebeurtenissoort (naam en versie) waarop de gebeurtenis betrekking heeft. Lijst met gemeentecode welke aanwezig in het bericht Specificatie van de inhoud van de gebeurtenis. Inhoud is afhankelijk van de gebeurtenissoort. De inhoud kan, maar hoeft geen, StuF compliant bericht te zijn. Attribuut Toelichting LV BAG Voorbeeld waarde(s) Datumtijdstempel LV Kenmerk LV Versie berichttype Variabele waarde. Elk bericht bevat dit tijdstip en dit tijdstip is uniek (t/m millisec). Het is het tijdstip waarop de gegevens in de LV BAG, voor verstrekking aan Afnemers, beschikbaar zijn geworden (in de database zijn verwerkt) Uniek identificerend volgnummer Vaste waarde T11:05:30.999Z Basisregistratie Vaste waarde. LV BAG Gebeurtenissoort Vaste waarde. De LV BAG levert alleen mutaties, Mutatiebericht 01 zonder gebeurtenissoort uit het processenhandboek. Er wordt geen onderscheidt gemaakt tussen verschillende soorten mutaties. Filterinhoud Bevat informatie over welke gemeentes er in het <filterinhoud> Versie juli / 20

9 bericht aanwezig zijn. Wanneer er geen gemeente gevonden kan worden wordt de code 0000 gebruikt. 1> 1> <filter1>0000</filter <filter1>1234</filter Gebeurtenisinhoud Variabele waarde. Het BAG specifieke informatieproduct zelf. </filterinhoud> Zie volgende paragraaf Informatieproduct en mutatieproduct Product ProductInhoud Opmerking Een informatieproduct bestaat uit alle mutaties in de LV BAG die als gevolg van één kennisgeving bij de bronhouder zijn ontstaan. Deze mutaties hebben betrekking op één of meer voorkomens van één of meer bag objecten. Om de mutaties eenvoudig en eenduidig te kunnen verwerken zijn mutaties gegroepeerd per voorkomen van één bag object. Dit wordt een Mutatieproduct genoemd. Deze bevat de verschijningsvorm van een voorkomen voorafgaande aan een mutatie en na de mutatie. - Origineel: verschijningsvorm voorafgaande aan de mutatie, voor een bestaand voorkomen. - Wijziging: verschijningsvorm na een de mutatie, voor een bestaand voorkomen. Hierin kunnen alleen de volgende velden anders zijn dan in het origineel: datum einde geldigheid, indicatieinaktief, indicatierecordcorrectie. - Nieuw: een nieuw voorkomen. Deze geeft de nieuwe verschijningsvorm van het object weer. Een informatieproduct bestaat dus uit 1 of meer Mutatieproducten. - De verschillende Mutatieproducten die bij elkaar horen zijn herkenbaar aan Tijdstipverwerking. Tijdstipverwerking is namelijk uniek per informatieproduct en kan (is vaak) bij meerdere Mutatieproducten hetzelfde zijn. - Meerdere Mutatieproducten met dezelfde Tijdstipverwerking worden gezien als een consistente set die allemaal wel, of allemaal niet, verwerkt worden (transactioneel). - Binnen een informatieproduct is de volgorde voor verwerking aangegeven in het veld volgnrverwerking. Deze start bij 0. Het verschil tussen een Extract mutatiebestand en een Digilevering bericht is dat een Extract mutatiebestand een informatieproduct is met daarin alle mutaties van alle kennisgevingen in een periode en het Digilevering bericht is Versie juli / 20

10 een informatieproduct met daarin alleen alle mutaties behorende bij één kennisgeving. Het mutatieproduct is voor beide exact gelijk en is beschreven in het informatieproduct BAG Extract [2] Verwerkingsvolgorde Mutatieproducten Voor het bijhouden van een lokale kopie is er een strikte volgorde waarin informatieproducten verwerkt moeten worden. Dit is helder beschreven in het koppelvlak BAG Extract [3] en werkt op basis van het TijdstipVerwerking in het Mutatieproduct, en daarbinnen op basis van een volgnummer. Zie ook en voor informatie hoe hiermee in een implementatie omgegaan kan worden. Versie juli / 20

11 4 Koppelvlak BAG Digilevering Dit hoofdstuk biedt informatie t.b.v. implementaties bij Afnemers. Er worden een aantal belangrijke implementatie aspecten beschreven en daarnaast worden de schema s toegelicht. De technische informatie omtrent het ebms protocol is te vinden in [1] en wordt daarom niet in dit document herhaald. 4.1 Verschijningsvorm Digilevering bericht Het digilevering bericht kent als XSD: digilevering.xsd. Deze is generiek van opzet. Hierin zit een veld gebeurtenisinhoud en hierin bevinden zich de gegevens van de LV BAG. Het schema dat deze bag gegevens beschrijft is bag-gebeurtenis-0.1.xsd. Zie onderstaande plaatje. bag-gebeurtenis-0.1.xsd Dit schema is gepubliceerd op Attribuut Toelichting LV BAG Voorbeeld waarde(s) Schemanaam Schemaversie Woonplaatscode XSD schema wat gebruikt wordt in gebeurtenisinhoud in digilevering.xsd uit BT-2 Versie bij schema uit schemanaam. Tevens koppelvlak versie. Niet geïmplementeerd. bag-gebeurtenis-0.1.xsd 1.0 Inhoud Eén groepje van bij elkaar behorende mutatieproducten met dezelfde Tijdstipverwerking en verschillende volgnummers. Zie koppelvlak BAG Extract [3] Bij meerdere koppelvlakken kan er op basis van schemanaam en schemaversie geselecteerd worden zodat mutatieproducten niet dubbel ontvangen worden. Versie juli / 20

12 Mutatieproduct Schema: BagvsExtractProductenLvc-0.71.xsd Beschrijving: zie [3]. Versie juli / 20

13 4.2 Implementatie aspecten Om rekening mee te houden bij het maken van een implementatie bij Afnemers Robuust tegen meerdere koppelvlakken door filtering bij Afnemer Het is aan te raden om in de software in te bouwen: ALS schemaversie (uit 4.1) = 1.0 DAN ga door en ANDERS negeer (of log een waarschuwing). Ter kennisname: het is in deze versie van het koppelvlak niet mogelijk om gebruik te maken van filtermogelijkheden van/bij Digilevering Verwerkingsvolgorde in relatie tot berichten van Digilevering Aanvullend op In één bericht zit altijd maar één informatieproduct. Er ontstaan dagelijks enkele 1000-en berichten en deze moeten in de juiste volgorde verwerkt worden. Het is hiervoor niet toegestaan om Datumtijdstempel Digilevering hiervoor te gebruiken. Het is daarnaast ook niet aan te raden om hier Datumtijdstempel LV voor te gebruiken. De functionele verwerkingsvolgorde is maar op één manier gedefinieerd en dat is op Tijdstipverwerking en daarbinnen op volgnummer. Om de goede functionele verwerkingsvolgorde exact goed te krijgen moeten bepaalde maatregelen genomen worden bij een afnemer. Dit is vooral relevant voor het bijhouden van een kopie. Voor het in gang zetten van een bedrijfsproces zal het genoemde verschil meestal niet veel verschil maken. Maar strikt genomen kan dit wel relevant zijn. Voor het in gang zetten van een bedrijfsproces dezelfde maatregelen als voor het bijhouden van een kopie Handreiking en maatregelen voor verwerkingsvolgorde Om de berichten in de juiste volgorde te verwerken is het van belang dat de berichten opgespaard worden. Een implementatie kan zijn om de berichten in te laden in een database tabel, waarbij tijdstipverwerking als metagegeven wordt geregistreerd. Doorgaans zijn binnen enkele minuten berichten die niet in volgorde zijn aangekomen alsnog binnengekomen. Als vanuit digilevering geen signaal is gekomen van achterstand kunnen de berichten op basis van tijdstipverwerking alsnog worden verwerkt. De verwerking betreft dan Tijdstipverwerkingen die bijvoorbeeld ouder zijn dan een uur. Alternatief is om de mutatieproducten zelf op te slaan in een database tabel, en deze daarna per bulk te verwerken Aansluiten op een initieel Extract voor het bijhouden van een kopie Het Extract dat besteld kan worden is een Extract Levenscyclus. Het is ook mogelijk om een implementatie die gebaseerd is op mutatie bestanden om te zetten naar een Digilevering implementatie. Het Extract bestand (of het laatste mutatiebestand) bevat een standtechnischedatum (of een mutatiedatumtot). Alle berichten met een Tijdstipverwerking eerder (of gelijk) aan deze standtechnischedatum moeten niet verwerkt worden, want deze zitten al in het Extract bestand verwerkt (of het laatste mutatiebestand). Aangezien u geen mutaties wilt missen zult u eerder moeten starten met het ontvangen van berichten. Deze berichten kunnen genegeerd worden als ze voor de standtechnischedatum (of mutatiedatumtot) liggen en zullen opgespaard moeten worden als ze erna liggen. Nadat het Extract is ingeladen kunnen de opgespaarde berichten alsnog verwerkt worden. Versie juli / 20

14 4.3 Gebeurtenissen destilleren Op dit moment levert de LV BAG nog geen BAG gebeurtenissen. De gebeurtenisinformatie die geleverd wordt is dat er een bericht van de bronhouder is verwerkt bij de LV BAG. Dit bericht heeft betrekking op een (of meer) nieuw, gewijzigd of ingetrokken bag object(en), waarbij de verschillende objecttypen en de bijbehorende gegevens zijn opgenomen in IMBAG (zie bijlage). De betrokken objecttypen zijn de woonplaatsen, openbare ruimten, nummeraanduidingen, verblijfsobjecten, standplaatsen, ligplaatsen of panden, waarover in de betrokken gemeente beslissingen zijn genomen. Deze beslissingen hebben uiteraard te maken met verschillende gebeurtenissen, die zijn opgenomen in het processenhandboek [4]. Uit de inhoud van het bericht kan de gebeurtenis door de afnemer zelf gedestilleerd worden. Let wel,dit is niet altijd eenvoudig en eenduidig Gebeurtenissen uit het processenhandboek Bijvoorbeeld de gebeurtenis: een pand is gesloopt op een bepaalde datum Mutatiebericht: wijziging van een pand, waarbij de pandstatus gewijzigd wordt in pand gesloopt met een bepaalde begindatumtijdvakgeldigheid. Het bericht bevat in dit geval twee mutatieproducten. 1. de eerste: origineel en wijziging, dit betreft een bestaand voorkomen van een object. In het onderdeel origineel is de datum einde geldigheid leeg. In het onderdeel wijziging is de datum einde geldigheid gevuld. 2. de tweede: nieuw. Dit betreft altijd een nieuw voorkomen van een object. Dit kan zijn het 1 e voorkomen, maar is meestal een nieuw voorkomen wat ontstaan als gevolg van een gewone wijziging. In dit onderdeel nieuw is in het nieuw ontstane voorkomen het genoemde begindatumtijdvakgeldigheid gevuld met een actuele datum en de pandstatus is pand gesloopt. Door origineel en nieuw te vergelijken is te zien dat de status van iets naar pand gesloopt is gewijzigd. Het betreft hier dus de gebeurtenis pand gesloopt. NB: De status pand gesloopt wordt bijvoorbeeld ook toegekend aan panden die onterecht zijn opgevoerd. Er is dus niet altijd sprake van een pand dat ook feitelijk gesloopt is Eigen gebeurtenissen Het is mogelijk om zelf gebeurtenissen te herkennen op basis van bepaalde statuswijzigingen. Hierbij een aantal voorbeelden. De afleiding werkt analoog aan het voorbeeld in vorige paragraaf. 1. Een verblijfsobject had als gebruiksdoel woonfunctie en heeft als gebruiksdoel kantoorfunctie gekregen. 2. Het pand en het verblijfsobject kunnen in de LV BAG een status hebben blijkt dat deze objecten nog niet feitelijk/werkelijk bestaan, zoals bouw gestart en verblijfsobject gevormd. Het kan zijn dat de gereedmelding van de bouw wel als heeft plaatsgevonden, maar nog in de LV BAG moet worden doorgevoerd. In dit geval kan het nuttig zijn om even te wachten en te kijken of in de komende dagen de volgende gebeurtenis vanuit Digilevering geleverd wordt: - Een pand gaat van status bouw gestart (de bouw is gestart) naar in gebruik, niet ingemeten (betreft de oplevering van een pand). Tegelijkertijd zal (voor zover aanwezig) het VBO in dit pand van status gevormd (vergunning verleend) naar in gebruik, niet ingemeten. Er zijn situaties denkbaar waarbij de status bouw gestart wordt overgeslagen. Het is daarom niet mogelijk alle gereedmeldingen op deze manier te destilleren. 3. Voor bepaalde situaties kan van belang om wijzigingen in de geometrie van panden of adresseerbare objecten te destileren als gebeurtenis. Dit kan door de geometrie in origineel te vergelijken met de Versie juli / 20

15 geometrie in nieuw. Let wel, er zijn meer mutaties die kunnen horen bij deze gebeurtenis. Een andere manier waarop een geometrie kan wijzigen is als van een actueel gegeven het attribuut indicatie Inactief van Nee naar Ja gaat. Dit betekent immers dat een gegeven niet meer geldig is. En dus dat er voor het desbetreffende tijdvak een nieuw gegeven geldig wordt, bijvoorbeeld doordat het voorliggende voorkomen weer actief wordt. Deze geometrie kan hetzelfde zijn, maar ook anders, zonder dat dit in het bericht zelf terug te herkennen is. Daarvoor zijn aanvullende gegevens nodig, die bijvoorbeeld via de webservices van de LVBAG opgehaald kunnen worden. Let wel, het is niet eenvoudig om gebeurtenissen helemaal sluitend te destilleren. In de BAG kunnen heel veel varianten van mutaties optreden, met verschillende uitgangssituaties in het origineel en verschillende eindtoestanden in nieuw. Het is raadzaam om bij een gedestilleerde gebeurtenis eerst te beoordelen of deze zeker is opgetreden of dat deze waarschijnlijk is opgetreden, maar dat er mogelijk meer aan de hand is, omdat er ook andere attributen mee zijn gewijzigd. Denk bijvoorbeeld aan een pand geometrie die niet is gewijzigd, terwijl de pand grootte wel is gewijzigd. Of de status gaat van gesloopt naar in gebruik. Is dit nou wel of niet een pand geometrie wijziging? Of nog beter gezegd, betreft dit nou wel of niet een situatie waarin u geïnteresseerd bent? Versie juli / 20

16 5 Bijlagen 5.1 Informatie model IMBAG V0.70 ( ) Onderstaand figuur toont het gegevensmodel van BAG Extract in de vorm van XML-tags. IMBAG is het XML schema definitie (XSD) model van het logische gegevensmodel, zoals gedefinieerd in de BAG catalogus [5]. Dit XSD model is de basis voor alle XML producten die vanuit de LVBAG worden geleverd. Alle attributen van de bag objecten zijn beschreven in IMBAG. Deze velden zijn 1 op 1 overgenomen in het Digilevering product (identieke namen en betekenis). Versie juli / 20

17 5.2 Voorbeeld XML regel van een mutatiebericht De exacte XML is op basis van een digilevering bericht en een digilevering.xsd uit BT-2. De XML van het Digilevering.xsd deel is cursief, de inhoud van bag-gebeurtenis-0.1.xsd is bold. <?xml version="1.0" encoding="utf-8"?> <ns10:verstrekkingaanafnemer xmlns:ns10=" xmlns:xsi=" xsi:schemalocation=" digilevering.xsd"> <datumtijdstempeldigilevering> t07:17:02.787z</datumtijdstempeldigilevering> <datumtijdstempellv> t16:06:39.000z</datumtijdstempellv> <kenmerklv> </kenmerklv> <versieberichttype>1.0</versieberichttype> <abonnement> <naam>bag_perftest_skp</naam> <versie>0.1</versie> </abonnement> <basisregistratie>lv BAG</basisregistratie> <gebeurtenissoort> <naam>mutatiebericht</naam> <versie>01</versie> </gebeurtenissoort> <gebeurtenisinhoud> <ns9:bag-gebeurtenis xmlns:ns9=" <ns2:gebeurtenisselectie xmlns:ns2=" <Schemanaam>digilevering.xsd</Schemanaam> <Schemaversie>0.4</Schemaversie> </ns2:gebeurtenisselectie> <inhoud> <ns3:mutatie-product xmlns:ns3=" <ns3:verwerking> <ns3:tijdstipverwerking> t16:04: </ns3:tijdstipverwerking> <ns3:objecttype>pnd</ns3:objecttype> <ns3:volgnrverwerking>0</ns3:volgnrverwerking> </ns3:verwerking> <ns3:nieuw> <ns4:pand xmlns:ns4=" <ns4:identificatie> </ns4:identificatie> <ns4:aanduidingrecordinactief>n</ns4:aanduidingrecordinactief> <ns4:aanduidingrecordcorrectie>0</ns4:aanduidingrecordcorrectie> <ns4:officieel>n</ns4:officieel> <ns4:pandgeometrie> <ns5:polygon xmlns:ns5=" srsname="urn:ogc:def:crs:epsg::28992"> <ns5:exterior> <ns5:linearring> <ns5:poslist srsdimension="2"> </ns5:posList> </ns5:linearring> </ns5:exterior> </ns5:polygon> </ns4:pandgeometrie> <ns4:bouwjaar>1920</ns4:bouwjaar> <ns4:pandstatus>pand in gebruik</ns4:pandstatus> Versie juli / 20

18 <ns4:tijdvakgeldigheid> <ns7:begindatumtijdvakgeldigheid xmlns:ns7=" </ns4:tijdvakgeldigheid> <ns4:inonderzoek>n</ns4:inonderzoek> <ns4:bron> <ns7:documentdatum xmlns:ns7=" <ns7:documentnummer xmlns:ns7=" B M</ns7:documentnummer> </ns4:bron> </ns4:pand> </ns3:nieuw> </ns3:mutatie-product> <ns3:mutatie-product xmlns:ns3=" <ns3:verwerking> <ns3:tijdstipverwerking> t16:04: </ns3:tijdstipverwerking> <ns3:objecttype>pnd</ns3:objecttype> <ns3:volgnrverwerking>1</ns3:volgnrverwerking> </ns3:verwerking> <ns3:origineel> <ns4:pand xmlns:ns4=" <ns4:identificatie> </ns4:identificatie> <ns4:aanduidingrecordinactief>n</ns4:aanduidingrecordinactief> <ns4:aanduidingrecordcorrectie>0</ns4:aanduidingrecordcorrectie> <ns4:officieel>n</ns4:officieel> <ns4:pandgeometrie> <ns5:polygon xmlns:ns5=" srsname="urn:ogc:def:crs:epsg::28992"> <ns5:exterior> <ns5:linearring> <ns5:poslist srsdimension="2"> </ns5:posList> </ns5:linearring> </ns5:exterior> </ns5:polygon> </ns4:pandgeometrie> <ns4:bouwjaar>1920</ns4:bouwjaar> <ns4:pandstatus>pand in gebruik</ns4:pandstatus> <ns4:tijdvakgeldigheid> <ns7:begindatumtijdvakgeldigheid xmlns:ns7=" </ns4:tijdvakgeldigheid> <ns4:inonderzoek>n</ns4:inonderzoek> <ns4:bron> <ns7:documentdatum xmlns:ns7=" <ns7:documentnummer xmlns:ns7=" </ns4:bron> </ns4:pand> </ns3:origineel> <ns3:wijziging> <ns4:pand xmlns:ns4=" <ns4:identificatie> </ns4:identificatie> Versie juli / 20

19 <ns4:aanduidingrecordinactief>n</ns4:aanduidingrecordinactief> <ns4:aanduidingrecordcorrectie>0</ns4:aanduidingrecordcorrectie> <ns4:officieel>n</ns4:officieel> <ns4:pandgeometrie> <ns5:polygon xmlns:ns5=" srsname="urn:ogc:def:crs:epsg::28992"> <ns5:exterior> <ns5:linearring> <ns5:poslist srsdimension="2"> </ns5:posList> </ns5:linearring> </ns5:exterior> </ns5:polygon> </ns4:pandgeometrie> <ns4:bouwjaar>1920</ns4:bouwjaar> <ns4:pandstatus>pand in gebruik</ns4:pandstatus> <ns4:tijdvakgeldigheid> <ns7:begindatumtijdvakgeldigheid xmlns:ns7=" <ns7:einddatumtijdvakgeldigheid xmlns:ns7=" </ns4:tijdvakgeldigheid> <ns4:inonderzoek>n</ns4:inonderzoek> <ns4:bron> <ns7:documentdatum xmlns:ns7=" <ns7:documentnummer xmlns:ns7=" </ns4:bron> </ns4:pand> </ns3:wijziging> </ns3:mutatie-product> </inhoud> </ns9:bag-gebeurtenis> </gebeurtenisinhoud> </ns10:verstrekkingaanafnemer> Versie juli / 20

20 5.3 Known issues Deze paragraaf beschrijft openstaande bevindingen waarmee rekening gehouden moet worden. Zodra deze opgelost worden zal dit document worden bijgewerkt. Er is één kennisgeving die onbedoeld toch leidt tot twee berichten naar digilevering. Dit betreft de samengestelde kennisgeving. - het aanmelden van een nummeraanduiding en een adresseerbaar object worden afzonderlijk verstuurd. De nummeraanduiding heeft de vroegste tijdstipverwerking. Het adresseerbaar object heeft een tijdstip wat hier vlak na ligt. - het afmelden van een nummeraanduiding en een adresseerbaar object worden afzonderlijk verstuurd. Het adresseerbaar object heeft de vroegste tijdstipverwerking. De nummeraanduiding heeft een tijdstip wat hier vlak na ligt. Woonplaatscode uit bag-gebeurtenis-0.1.xsd is niet geïmplementeerd. Dit was bedoeld als filtering voor Afnemers die alleen een bepaald registratie gebied willen ontvangen. De LV BAG levert echter sinds 2013 producten die op gemeentes gebaseerd zijn. Deze xsd is daar nog niet op aangepast. Advies is om dit element te negeren. Het wordt ook niet meegeleverd in de XML. De digilevering.xsd die door Digilevering in BT-2 gebruikt wordt heeft versie 0.6. Het koppelvlak BT-1 gebruikt echter versie 0.4 en bevat een import van bag-gebeurtenis-0.1.xsd in BT-1. In BT-2 is deze import er niet. Er wordt gebruik gemaakt van: <xsd:element name="verstrekkingaanafnemer"> en daarbinnen <xsd:element name="gebeurtenisinhoud" type="xsd:anytype"/> Hierin zit XML die van de LV BAG komt. Welke XSD bij deze XML hoort is niet te herkennen aan een veld binnen de digilevering.xsd. De XSD is voorlopig alleen bag-gebeurtenis-0.1.xsd. Dit kan echter veranderen als het bericht van de LV verandert. Hoe hiermee omgegaan moet worden is nog niet uitgewerkt. Uitgangspunt is dat als het schema van de LV verandert, dat de LV de bestaande berichten en de nieuwe berichten allebei zal sturen. Waarschijnlijk zal Digilevering dan de oude blijven doorsturen, totdat Afnemers aangeven dat ze de nieuwe wensen te ontvangen. Daarnaast is anytype niet altijd out of the box goed door tools en applicaties zoals Java te verwerken. Er zijn dan workarounds die overwogen kunnen worden. Er worden er drie gegeven: 1. Eerste alternatief is om te werken met Xpath of XSLT technologie. Deze kan de XML uitlezen, zonder dat de XSD aangepast hoeft te worden. 2. De XML in het anytype kan op een enterprise service bus uit de XML worden gehaald en losstaand, conform bag-gebeurtenis-0.1.xsd worden doorgeleverd aan de applicatie die deze verwerkt. 3. Voor Java applicaties is het handig om digilevering.xsd aan te passen. Om het XML bericht van BT-2 goed te kunnen verwerken is het handig om het element gebeurtenisinhoud aan te passen. Dit kan door anytype te vervangen door een import van bag-gebeurtenis-0.1.xsd, als: <xsd:element name="gebeurtenisinhoud"> <xsd:complextype><xsd:sequence> <xsd:element ref="bdg:bag-gebeurtenis"/> </xsd:sequence></xsd:complextype> </xsd:element> De LVBAG heeft dit al gedaan, downloadbaar vanuit BAG-afnemers op De XSD s zitten in: _LVBAG_bag-digilevering_BT-2.zip. Als u deze verandering niet wilt, kunt u de aangepaste digilevering.xsd verwijderen uit de ZIP en vervangen door de originele digilevering.xsd Versie juli / 20