Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Dossier.GeefUitzonderingenRegistraties-02.00

Informatie:

Voor de ontsluiting van een MAGDA 2.0 webservice, alsook het generieke proces binnen een 2.0 webservice, wordt verwezen naar Werking en gebruik MAGDA 2.0 Webservices.

Situering

De dienst GeefUitzonderingenRegistraties maakt deel uit van het DOSIS project binnen het programma Vlaanderen Radicaal Digitaal.

DOSIS centraliseert informatie over dossiers die binnen de entiteiten van de Vlaamse overheid bestaan over personen en ondernemingen. De DOSIS databank moet o.a. projecten zoals Mijn Burgerprofiel voeden en zal het mogelijk maken dat burgers of ondernemingen dossiers die over hen bestaan kunnen consulteren en opvolgen. Projecten als Mijn Burgerprofiel zullen het ook toelaten dat vanuit een overzicht de bron van een dossier (overheidsdienst/dossierbeheerder) kan worden gecontacteerd.

Binnen het DOSIS project laat de dienst GeefUitzonderingenRegistraties toe dat een afnemer (een dossierbeheerder) nagaat of eerdere aanleveringen van dossiergegevens via de dienst RegistreerDossier fouten hebben veroorzaakt en dus niet zijn verwerkt.

Verwante diensten

Gegevensbronnen

De gegevens die door deze dienst worden verwerkt, worden door MAGDA doorgestuurd naar de authentieke bron DOSIS, waar de feitelijke verwerking gebeurt. Na verwerking verkrijgt MAGDA het resultaat en stuurt dit terug naar de Afnemer.

Opmerking:

Agentschap Digitaal Vlaanderen is afhankelijk van deze externe bron voor de verwerking van de gegevens en het terugkoppelen van informatie en notificaties. Ze is dus ook afhankelijk van deze externe bron voor de kwaliteit en de aanlevering van de gegevens. 

Gebruiksvoorwaarden

Vooraleer een afnemer MAGDA diensten kan gebruiken moet die het MAGDA aansluitingsproces doorlopen. Dit proces zorgt ervoor dat de afnemer wordt geregistreerd als gerechtigd gebruiker van één of meerdere MAGDA diensten. De afnemer krijgt daarbij de nodige codes en richtlijnen voor het aanroepen van de diensten, waaronder een URI (unieke identificatie van de afnemer) en hoedanigheidscode (identificeert in welke context de afnemer een dienst wenst te gebruiken).

Specifiek voor de DOSIS diensten, zullen als deel van deze toelatingsprocedure ook één of meerdere Bron URIs worden toegekend – samen met het dossiernummer is de Bron identificerend voor het dossier dat wordt aangeleverd of verwijderd via de DOSIS diensten.

Een entiteit kan beheerder/eigenaar zijn van één of meerdere toepassingen/producten (=overheidsdienstverlening) waarvoor dossier-data kan worden overgemaakt aan DOSIS. Binnen DOSIS wordt elke entiteit/toepassing waarvoor dossier-gegevens worden verwerkt geïdentificeerd als een Bron. Heb je bv. twee toepassingen waarin dossiers beheerd worden en zijn de dossiernummers enkel uniek binnen de toepassing, maar niet over beide toepassingen heen, dan moet je twee bronnen registreren in DOSIS. DOSIS zal voor elke bron een namespace toekennen, bv. http://www.agentschap.be/app1 en http://www.agentschap.be/app2. Op deze manier kunnen twee verschillende dossiers met hetzelfde dossiernummer bv. BE123 uniek geïdentificeerd worden. De id van het dossier is dan immers http://www.agentschap.be/app1/BE123 en http://www.agentschap.be/app2/BE123

Informatie:

Meer informatie over deze voorwaarden is terug te vinden op de pagina “Machtigingen en toelatingen”.

Batch

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

Prefix

Dossier.GeefUitzonderingenRegistraties-02.00

Voorbeeld

Dossier.GeefUitzonderingenRegistraties-02.00_20131103115553530.

Functionaliteiten

In principe zal een leverancier (dossierbeheerder) de GeefUitzonderingenRegistraties-dienst enkel gebruiken wanneer het voor die leverancier niet opportuun is om elke DOSIS dossierregistratie individueel te valideren via de GeefResultaatRegistratie dienst.

In een omgeving met veel en snel evoluerende dossiers kan men er voor kiezen om meerdere DOSIS dossierregistraties te doen (online of batch) zonder zich onmiddellijk te bekommeren over de verwerking ervan, en pas later in een apart proces na te gaan of er registraties waren die niet konden verwerkt worden, en deze dan verbeterd opnieuw door te sturen.

De GeefUitzonderingenRegistraties-dienst rapporteert voor de opgegeven Bron een lijst van al haar eerdere dossierregistraties waarvan de verwerking faalde, met vermelding van de reden(en) waarom. Naast de reden(en) waarom de registratie faalde wordt ook de dossier-identificatie (bron + dossiernummer) meegegeven en het tijdstip van verwerking.

De lijst van dossier-registraties waarvoor uitzonderingen werden gegenereerd is volgens verwerkingstijdstip aflopend gesorteerd.

Werking

Opties

Gebruik van RegistreerDossier in combinatie met GeefResultaatRegistratie

Een afnemer/bron die de aangeleverde registraties wenst te valideren via de GeefResultaatRegistratie moet dit doen voor elke RegistreerDossier, vooraleer een volgende registratie voor hetzelfde dossier, en daarbij rekening houdend met het feit dat het resultaat van een registratie niet onmiddellijk beschikbaar is. In het slechtste geval zal men dus een volgende registratie moeten uitstellen tot bevestiging is verkregen van de vorige registratie. Het risico bestaat namelijk dat wanneer een afnemer meerdere opeenvolgende registraties doorgeeft voor eenzelfde dossier, en het resultaat pas opvraagt op een later tijdstip, dat die dan niet wordt geïnformeerd over mogelijke problemen met één of meerdere van de doorgestuurde registraties – de GeefResultaatRegistratie dienst geeft slechts uitsluitsel over de verwerking van de laatste in de rij. Deze werkwijze kan dus leiden tot een onvolledige status-historiek in de DOSIS databank.

Gebruik van RegistreerDossier in combinatie met GeefUitzonderingenRegistraties

In principe biedt de GeefUitzonderingenRegistraties webservice de mogelijkheid om voor snel evoluerende dossiers meerdere registraties te doen zonder zich te bekommeren over de verwerking ervan, en pas later in een apart proces na te gaan of er registraties waren die niet konden worden verwerkt, en die dan verbeterd opnieuw door te sturen. Probleem hier is echter dat de teruggekoppelde uitzonderingen wel aangeven aan welk dossier zij zijn gerelateerd, maar niet aan welke specifieke registratie. Een bron die de aangeleverde registraties wenst te valideren via deze GeefUitzonderingenRegistraties moet dus zelf een systeem voorzien dat in staat is om teruggekoppelde uitzonderingen te koppelen aan individuele registraties binnen een dossier (bvb. op basis van de gerapporteerde tijdstippen).

Logging

De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".

Ondersteunde talen

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.

Op deze pagina


Binnen deze handleiding


Omgevingsinformatie

Domein

Dossier

Classificatie

Persoonsgegevens


Verwante diensten



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