Documentatie voor klanten en partners van Digitaal Vlaanderen - bouwstenen Mijn Burgerprofiel, Verenigingsloket en e-loketondernemers">Documentatie voor klanten en partners van Digitaal Vlaanderen - bouwstenen Mijn Burgerprofiel, Verenigingsloket en e-loketondernemers


Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 21 Next »

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 aansluitingflow (https://dynamicforms.crmiv.vlaanderen.be/DynamicForms/MBPBackend ) 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:

  • DossierStatus: Dossier met een status

  • Verwijzing: Verwijzing naar een dossier of een cluster van dossiers, zonder status

Agenten

Lijst van identificatoren van ondernemingen of burgers die bij het dossier betrokken zijn.

Een identificator bevat optioneel een lijst van rollen waartoe een gebruiker moet behoren om het dossier te mogen raadplegen. In deze fase van DOSIS is de identificator een ondernemingsnummer.

String (0-255)

Verplicht

Er kunnen meerdere ondernemingsnummers met meerdere rollen doorgegeven worden. Rollen zijn gescheiden door een , en ondernemingsnummers zijn gescheiden door een |.
DOSIS verwacht de volgende syntax:
[ondernemingsnummer]:[rol],[rol]|[ondernemingsnummer]:[rol],[rol]

Voorbeeld:
0404621642:EA_IntEnt_LokaleBeheerderDomein,EA_IntEnt_HelpdeskMedewerker|2123961191:EA_IntEnt_AdministratiefBeheerder|0524660132:EA_IntEnt_HelpdeskMedewerker

Het is ook mogelijk om enkel ondernemingsnummers door te geven.
DOSIS verwacht volgende syntax:
[ondernemingsnummer]|[ondernemingsnummer]
Voorbeeld:
0404621642|2123961191

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

Zie lijst met toegelaten codes

StatusVlaamsFase

De Vlaamse status - Fase. Verplicht in geval van een dossier van het type DossierStatus.

Codelijst

Optioneel

Zie lijst met toegelaten codes

StatusDetail1

De detailstatus 1

String (0-255)

Optioneel

StatusWijzigingsDatum

Datum en tijdstip van de laatste statuswijziging

DateTime

Optioneel

Toegelaten formaten:

Local CEST time

  • yyyy-MM-dd HH:mm:ss.fff

  • yyyy-MM-dd HH:mm:ss

  • yyyy-MM-dd HH:mm

  • yyyy/MM/dd HH:mm:ss.fff

  • yyyy/MM/dd HH:mm:ss

  • yyyy/MM/dd HH:mm

  • yyyy-MM-ddTHH:mm:ss.fff

  • yyyy-MM-ddTHH:mm:ss

  • dd/MM/yyyy HH:mm:ss.fff

  • dd/MM/yyyy HH:mm:ss

  • dd/MM/yyyy HH:mm

  • dd-MM-yyyy HH:mm:ss.fff

  • dd-MM-yyyy HH:mm:ss

  • dd-MM-yyyy HH:mm

UTC time

  • yyyy-MM-ddTHH:mm:ss.fffZ

  • yyyy-MM-ddTHH:mm:ssZ

ActieNodig

Aanduiding of de huidige status impliceert dat er actie van burger of onderneming nodig is

Boolean

Optioneel

Default false.

Toegelaten waarden:

  • on - off

  • true - false

  • 0 -1

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 ->

  • yyyy-MM-dd HH:mm:ss.fff

  • yyyy-MM-dd HH:mm:ss

  • yyyy-MM-dd HH:mm

  • yyyy/MM/dd HH:mm:ss.fff

  • yyyy/MM/dd HH:mm:ss

  • yyyy/MM/dd HH:mm

  • yyyy-MM-ddTHH:mm:ss.fff

  • yyyy-MM-ddTHH:mm:ss

  • dd/MM/yyyy HH:mm:ss.fff

  • dd/MM/yyyy HH:mm:ss

  • dd/MM/yyyy HH:mm

  • dd-MM-yyyy HH:mm:ss.fff

  • dd-MM-yyyy HH:mm:ss

  • dd-MM-yyyy HH:mm

UTC time ->

  • yyyy-MM-ddTHH:mm:ss.fffZ

  • yyyy-MM-ddTHH:mm:ssZ

Hieronder vindt u een voorbeeld van een CSV-testbestand

  • No labels