Documentatie voor klanten en partners van Digitaal Vlaanderen - bouwstenen Mijn Burgerprofiel, Verenigingsloket en e-loketondernemers
Test en validatie
Om uw DOSIS-opzet te testen en te valideren worden 2 omgevingen voorzien: een beta-omgeving en een testomgeving (op vraag). Het gebruik van testdata is bij elke omgeving anders.
Testomgeving
https://tni.frontend.burgerprofiel.dev-vlaanderen.be/
De DOSIS testomgeving is gelinkt met de Mijn Burgerprofiel testomgeving, en wordt beveiligd door ACM-IDM. U kunt er dus alleen aanmelden met sterkte authenticatie als gebruiker die is gekend bij ACM-IDM T&I.
Op de testomgeving kunt u wel persoonsgevoelige en “echte” data gebruiken. Als u in de DOSIS-aansluitingsflow koos voor een testomgeving, dan zet het team Aansluitingen hiervoor een TNI bron URI op. Dit gebeurt alleen op aanvraag.
Dossierstatussen opladen en testen met een CSV-bestand
Als afzender/bron kunt u dezelfde dossierstatus meerdere keren doorsturen, op voorwaarde dat er effectief een wijziging aan het dossier gebeurt. Bijv. een dossier in status “In uitvoering”, waar er nog een actie is vereist, moet een update krijgen na die actie. Het dossier kan daarna wel gewoon op “In uitvoering” blijven staan, zonder dat er nog een actie nodig is in diezelfde status.
Vormvoorschriften CSV-bestand
Om te testen met een CSV-bestand moet dat bestand voldoen aan de volgende vormvoorschriften:
Het is niet verplicht om optionele velden (zie tabel hieronder) in het CSV-bestand op te nemen, die waarden kunnen leeg blijven.
De velden moeten niet in een speciale volgorde meegegeven worden.
De waarden in het CSV-bestand zijn gescheiden door een puntkomma (;).
Waarden mogen tussen dubbele aanhalingstekens (") geplaatst worden, maar dat is niet verplicht. Door dubbele aanhalingstekens te gebruiken is het wel mogelijk om het scheidingsteken (;) te gebruiken in een waarde.
Bevat het bestand speciale karakters (vb. µùéèàê), sla het dan op in de UTF-8 codering. DOSIS ondersteunt enkel UTF-8 gecodeerde CSV-bestanden.
Velden CSV-bestand
Naam | Omschrijving | Type | Verplicht | Bijkomende informatie |
|---|---|---|---|---|
DossierNummer | Het nummer van het dossier | String (0-255) | Verplicht | Samen met Bron identificerend voor het dossier |
Bron | De bron (namespace) van het dossier, bijv. http://www.agentschap.vl/applicatie. Deze namespace wordt aangemaakt bij de aansluiting. | String (0-255) | Verplicht | Samen met DossierNummer identificerend voor het dossier |
TypeDossierCode | Het type dossier: een dossier met een status of een verwijzing naar een dossier of een cluster van dossiers, zonder status | Codelijst | Verplicht | Dit zijn de toegelaten codes:
|
Agenten | Lijst van identificatoren van ondernemingen of burgers die bij het dossier betrokken zijn. | String (0-255) | Verplicht | Er kunnen meerdere ondernemingsnummers met meerdere rollen doorgegeven worden. Rollen zijn gescheiden door een “,” en ondernemingsnummers zijn gescheiden door een “|”. Voorbeeld: Het is ook mogelijk om enkel ondernemingsnummers door te geven. In dit geval zal het dossier zichtbaar zijn voor gebruikers die de DOSIS Raadpleger ACM/IDM-rol hebben én die een werkrelatie hebben met het ondernemingsnummer. |
StatusVlaamsCode | De Vlaamse status - Code. Verplicht in geval van een dossier van het type DossierStatus. | Codelijst | Optioneel | |
StatusVlaamsFase | De Vlaamse status - Fase. Verplicht in geval van een dossier van het type DossierStatus. | Codelijst | Optioneel | |
StatusDetail1 | De detailstatus 1 | String (0-255) | Optioneel |
|
StatusWijzigingsDatum | Datum en tijdstip van de laatste statuswijziging | DateTime | Optioneel | Toegelaten formaten: Local CEST time
UTC time
|
ActieNodig | Aanduiding of de huidige status impliceert dat er actie van burger of onderneming nodig is | Boolean | Optioneel | Default false. Toegelaten waarden:
|
Actie | Omschrijving van de uit te voeren actie | String (0-255) | Optioneel |
|
Naam | De titel van een dossier | String (0-255) | Optioneel |
|
Producten | Een lijst van ID's van de producten en/of diensten waarop het dossier betrekking heeft. Maximaal 1 product is verplicht voor een dossier van het type DossierStatus. Alleen geldige IPDC codes zijn toegelaten. Zie https://productencatalogus-v3.vlaanderen.be/nl/start voor meer informatie. | String (0-255) | Optioneel | Een lijst van ID's, gescheiden door een komma Bijv. 100,200,300
|
DossierBeheerderNaam | De naam van de dossierbeheerder | String (0-255) | Optioneel |
|
DossierBeheerderDienst | De dienst van de dossierbeheerder | String (0-255) | Optioneel |
|
DossierBeheerderTelefoon | Het telefoonnummer van de dossierbeheerder | String (0-255) | Optioneel |
|
DossierBeheerderEmail | Het e-mailadres van de dossierbeheerder | String (0-255) | Optioneel |
|
DossierBeheerderWebsite | De website van de dossierbeheerder | String (0-255) | Optioneel |
|
DossierBeheerderAdresStraat | De straatnaam van het adres van de dossierbeheerder | String (0-255) | Optioneel |
|
DossierBeheerderAdresNummer | Het huisnummer (en eventueel busnummer) van het adres van de dossierbeheerder | String (0-255) | Optioneel |
|
DossierBeheerderAdresPostCode | De postcode van het adres van de dossier beheerder | String (0-255) | Optioneel |
|
DossierBeheerderAdresGemeente | De gemeentenaam van het adres van de dossierbeheerder | String (0-255) | Optioneel |
|
Doorverwijzing | Hyperlink naar een applicatie met meer informatie over het dossier
| String (0-255) | Optioneel |
|
WijzigingsDatum | Datum en tijdstip waarop het dossier gewijzigd werd Verplicht voor een dossier van het type DossierStatus | DateTime | Optioneel | Toegelaten formaten: Local CEST time ->
UTC time ->
|
Hieronder vindt u een voorbeeld van een CSV-testbestand
Dit is een officiële website van de Vlaamse overheid - Uitgegeven door Digitaal Vlaanderen: https://www.vlaanderen.be/digitaal-vlaanderen
DISCLAIMER: http://www.vlaanderen.be/nl/disclaimer
TOEGANKELIJKHEID:
http://www.vlaanderen.be/nl/toegankelijkheid