Doel: Met dit sjabloon kan u eenvoudig een nieuwe diensthandleiding aanmaken in Confluence. Gebruik de onderstaande knoppen om nieuwe componenten binnen de handleiding aan te maken. To do: - Vul de onderstaande handleidingsparagrafen in - Maak o.b.v. de specificaties van de dienst relevante subpagina's aan - Verwijder lege of niet-gebruikte paragrafen & pagina's - Let op: Gebruik de volledige naam van de dienst (Domein.DienstNaam-Versie).

De Excerpt bevat de tekst die wordt weergegeven in de overzichtspagina op domein niveau. De tekst die in dit kader staat wordt niet weergegeven in de handleiding zelf (deze pagina) en dient een korte omschrijving van de dienst te bevatten.

Situering

Het doel van deze publicatie op het MAGDA-platform is het beschikbaar stellen van de veranderingen in de gegevens van bepaalde personen. Deze gegevens zijn afkomstig van het Rijksregister en/of KSZ en worden verdeeld via KSZ naar diens partners.

Verwante diensten

1. De afnemer registreert een INSZ nummer in het MAGDA inschrijvingsrepertorium via de /wiki/spaces/MP/pages/600506958 dienst

2. De /wiki/spaces/MDI/pages/163316854 dienst geeft een notificatie met het INSZ nummer van de persoon waarvoor de gegevens gewijzigd zijn.

3. Via de /wiki/spaces/MDI/pages/174030851 dienst worden alle gegevens opgevraagd over de persoon waarvan het INSZ nummer gepubliceerd is

/wiki/spaces/MP/pages/600506958 en RegistreerUitschrijving :

Deze diensten worden gebruikt voor het aanmaken en wissen van een inschrijving in het MAGDA inschrijvingsrepertorium. Op basis van deze inschrijvingen worden de PubliceerMutatiePersoon ontvangen en verdeeld.

Voordat publicaties kunnen ontvangen worden dienen de INSZ worden geregistreerd in het MAGDA inschrijvingsrepertorium. Dit gebeurt via de RegistreerInschrijving dienst.

Indien publicaties voor een bepaalde INSZ niet meer ontvangen moeten worden dient deze INSZ uitgeschreven te worden uit het inschrijvingsrepertorium via de RegistreerUitschrijving dienst. Meer informatie over deze diensten is te vinden in de MAGDA gebruikersgroep site.

/wiki/spaces/MP/pages/95486115 :

Sommige gegevens die door de KSZ worden gepubliceerd via deze service komen van het RijksRegister.

Gegevensbronnen

De gegevens worden aangeboden door de (authentieke) gegevensbron KSZ.

Gebruiksvoorwaarden

Om gebruik te kunnen maken van deze dienst dient men een machtiging te hebben die toegang geeft tot deze gegevens en een aansluitingsprocedure te doorlopen.

Batch

Geef de volledige structuur op van de naam van de bestanden die klaar gezet worden voor de gebruiker. Prefixen zijn steeds in de form [domein].[ServiceNaam]-[Versie]_[timestamp].xml. Pas zeker de bestandsnamen aan in onderstaand voorbeeld als je het hergebruikt. Gebruik geen punt in de versie. Zet de vier cijfers van de versie achter mekaar. Gebruik Camel-case! De lengte van het deel voor de _timestamp mag maximaal 48 karakters lang zijn.

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.

Functionaliteiten

KSZ ontvangt de wijzigingen in de persoonsgegevens van het Rijksregister.

1. KSZ stelt deze wijzigingen beschikbaar aan diens partners op zijn FTP server

2. De FTP-Scheduler haalt dit bestand op bij de KSZ en stelt deze ter beschikking aan de File to File

3. De File to File valideert de voucher en stelt de eigenlijke mutatiebestanden ter beschikking aan de File to DB

4. De File to DB zal instaan voor de correcte transformatie van het KSZ-formaat naar het MAGDA-formaat

5. PubMut pusht de gegevens naar de publicatiegateway

6. De publicatiegateway stelt de gegevens beschikbaar aan de afnemers

Werking

Opties

Volgende afleveropties zijn mogelijk welke bij de aansluitingsprocedure gedefinieerd worden :

• Compressie van het bestand (.zip)

• Melding via mail van aflevering bestand. (Optioneel)

• uitzonderingsbestand / leeg bestand (indien er geen gegevens te publiceren zijn, verkrijgt men toch een bestand)

Logging

De gegevens in het bestand worden bewaard zoals beschreven in het document “MAGDA logging”.

Bestanden worden gedurende een beperkte tijd aangeboden op de FTP folder zoals beschreven in de FTP richtlijnen.

Ondersteunde talen

De afnemer verwacht vanuit een MAGDA-dienst een Nederlanstalig antwoord. Wanneer een antwoord mogelijk anderstalige informatie bevat is het relevant om dit hier mee te geven.

MAGDA ondersteunt de Nederlandse taal.

Indien in de brongegevens de Nederlandse tekst niet beschikbaar is voor een bepaald element zal de eerste vertaling van de tekst in de brongegevens gebruikt worden, onafhankelijk van de taal waarin dit gegeven beschikbaar is.