Interface (Vlok.PubliceerMutatieNotificatie-02.01)
Informatie:
De CSV bestanden die via FTP beschikbaar worden gesteld aan MARGA dienen te voldoen aan de MAGDA richtlijnen. Zie hieronder voor meer info.
Algemeen
VLOK maakt 1 maal per dag een export aan in een CSV bestand van alle mutaties die gebeurd zijn op hun gegevens. Dit bestand wordt op de MAGDA FTP server geplaatst waar het door MAGDA wordt opgepikt en verwerkt.
Bestandsnaam
Opmerking:
De exacte bestandsnaam wordt pas meegedeeld tijdens het aansluitingsproces. De gegevens die u hier vindt kunnen dus mogelijk wijzigen.
De bestandsnaam is van de vorm prefix_publicatienaam_timestamp.extensie.
Voorbeeld | Vlok_wijzigingen_2018_08_24.csv |
---|
Mapping
Gedetailleerde uitleg over de XML structuur is te vinden op de Algemeen.PubliceerMutatieNotificatie-02.01 Interface pagina.
Deze lijst bevat de elementen in het MAGDA formaat die per bron variëren.
MAGDA Element | CSV veld | Verplicht | Omschrijving |
---|---|---|---|
Referte | WijzigingReferte | X | Referte van de notificatie, Verplicht element |
Subject/Type | ObjectType | X | Naam van de sleutel, Verplicht element |
Subject/Sleutel | Referte | X | Waarde van de sleutel, Verplicht element |
Soort | Type | Uitgevoerde bewerking op de gegevens gerelateerd aan de sleutel | |
Tijdstip/Datum | Date(Datum) | Datum van aanmaak of aanpassing. Formaat : jjjj-mm-dd | |
Tijdstip/Tijd | Time(Datum) | Tijdstip van aanmaak of aanpassing. Fomaat : HH:MM:SS.sss | |
Bron | Vaste waarde “rwo.vlaanderen.be/vlok” | ||
Informaties/Informatie |
| Extra informatie de relevant is voor de mutatie
De waarde van de parameter wordt voorafgegaan door de naam van de parameter, gevolgd door een underscore. Vb : “NisCode_11002” |
Parameter waarden
Subject/Type (Sleutels)
Pand
Entiteit
Onderzoek
ProcedureOo
ProcedureCa
DeelProcedureOo
DeelProcedureCa
Type
Het type element wordt door MAGDA gestandaardiseerd. Hieronder is de waarde te vinden die wordt opgegeven door de bron en de waarde die MAGDA doorgeeft aan de afnemer. Deze vertaling wordt gedaan door een Runtime mapping.
Type element bij de bron | Type element naar de afnemer |
---|---|
Created | 01 |
Deleted | 03 |
Updated | 02 |
Informatie
Drie extra parameters worden doorgegeven in het Informaties element.
Parameter | Notatie in Informatie element |
---|---|
NIS Code | “NisCode_” + waarde |
Organisatie | “Organisatie_” + waarde |
WijzigingType | “WijzigingType_” + waarde |
Bron
De naam van de bron is een cruciale sleutel in het verwerken van de gegevens en dient door alle partijen correct worden ingevoerd. De naam van de bron heeft de vorm van een domeinnaam en is steeds genoteerd in kleine letters.
De correcte bronnaam voor VLOK is : rwo.vlaanderen.be/vlok
Voorbeeld
Op deze pagina
- 1 Algemeen
- 2 Bestandsnaam
- 3 Mapping
- 4 Parameter waarden
- 4.1 Subject/Type (Sleutels)
- 4.2 Type
- 4.3 Informatie
- 4.4 Bron
- 4.5 Voorbeeld
Binnen deze handleiding
Met vragen kunt u steeds terecht bij de MAGDA Service Desk.
Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren
De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid
uitgegeven door Digitaal Vlaanderen