Verschilbestanden GRB
Voor de geografische entiteiten van een aantal productdatasets worden verschilbestanden ter beschikking gesteld en/of kan je historische versies downloaden. De verschilbestanden (het delete-bestand en het add-bestand) van een productentiteit bevatten de gegevens die tussen 2 versies van een productdataset verwijderd, gewijzigd of toegevoegd werden.
Je kan verschilbestanden gebruiken om:
- een vorige, gebiedsdekkende versie van een productentiteit van een dataset te actualiseren door alleen de wijzigingen t.o.v. de vorige versie door te voeren.
- te onderzoeken waar een(actuele)versie van de dataset verschilt t.o.v. de vorige(welke exemplaren of versies van exemplarenzijn er toegevoegd, verwijderd of zijn er gewijzigd t.o.v. de vorige versie)Een historische versie bevat de gegevens van een datum uit het verleden.
Op exemplaarniveau kunnen zich drie gevallen van “verschil” voordoen:
- Gewijzigde exemplaren (nieuwe verschijningsvorm)
Exemplaren met een OIDN die zowel voorkomt in het add-bestand als in het delete-bestand, zijn gewijzigde exemplaren (exemplaren met een nieuwe verschijningsvorm). Hun identificerende kenmerken zijn ongewijzigd gebleven, maar de waarde van één of meer eigenschappen (= waarden van attributen) is gewijzigd. Dergelijke exemplaren worden als “vervangen” beschouwd. - Afgeschafte, verwijderde objectexemplaren
Objectexemplaren met een OIDN-waarde die enkel voorkomt in het delete-bestand zijn verwijderd (levensloop van het exemplaar is afgesloten) uit de nieuwe dataset-versie. - Nieuwe objectexemplaren
Objectexemplaren met een OIDN-waarde die enkel voorkomt in het add-bestand zijn toegevoegd, hun levensloop is gestart in de nieuwe versie.
De twee verschilbestanden zijn het delete-bestand en het add-bestand. Deze bestanden bevatten verschijningsvormen van exemplaren die zijn verdwenen of toegevoegd in de periode tussen twee versies van een productentiteit van een dataset.
Een vorige versie actualiseren gebeurt in drie stappen en moet voor elke entiteit van een productdataset toegepast worden:
Stap 1: Ga na of je over het juiste verschilbestand beschikt Verifieer welke de vorige dataset-versie is waarop dit verschilbestand verder gaat. De versie-informatie kan men steeds terugvinden in de naam van de folder of map waarin het bestand zit of in bij de bestanden aanwezig artikel metadata. Indien je niet de juiste verschilbestanden hanteert om een dataset-versie te actualiseren, kan dit tot foute resultaten leiden.
Stap 2: Verwijderen van records:
- Koppel de records van de entiteit van de vorige dataset-versie met het delete-bestand, via het veld UIDN;
- Selecteer de exemplaren die gekoppeld zijn;
- Verwijder de geselecteerde exemplaren. Nu blijven in de lokale databank, de ongewijzigde exemplaren over.
Stap 3: Toevoegen van records (append, merge…)
Voeg alle records opgenomen in het add-bestand toe aan de productentiteit van de vorige dataset-versie waaruit in stap 2 de te verwijderen records zijn verwijderd. De entiteit van de vorige dataset-versie is nu geactualiseerd tot de actuele situatie.
Opmerkingen:
- Het is belangrijk dat eerst de records worden verwijderd aan de hand van het delete-bestand, voordat records van het add-bestand worden toegevoegd. Exemplaren met een nieuwe verschijningsvorm zijn nl. zowel opgenomen in het delete- als in het add-bestand. De oude verschijningsvorm moet eerst verwijderd worden (stap 2 hierboven), alvorens de nieuwe verschijningvormen in stap 3 wordt toegevoegd.
- Verschilbestanden zijn niet bedoeld voor het lokaal historiseren (op inactief zetten (i.e. een einddatum toekennen) van exemplaren of versies van exemplaren zonder ze te verwijderen) van gegevens.