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.
Beta-omgeving
https://beta.frontend.burgerprofiel.dev-vlaanderen.be/
De DOSIS beta-omgeving is gelinkt met de Mijn Burgerprofiel beta-omgeving, en zit achter een mock Open ID Connect (OIDC-) implementatie. Dit zorgt voor een laagdrempelige en snelle manier van testen. U kunt hier gemakkelijk aanmelden met uw eigen RRN bijvoorbeeld.
Gebruik voor uw testen en integratie met de beta-omgeving geen persoonsgevoelige informatie of echte data.
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
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 http://productencatalogus.vlaanderen.be/ 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