DOSIS

Inleiding

DOSIS staat voor DOssier Status Informatie Systeem. DOSIS verzamelt en ontsluit informatie over de aanwezigheid en status van een dossier bij een Vlaamse of lokale overheidsdienst. Het is mogelijk om je dienstverlening aan te sluiten op DOSIS en statusupdates voor concrete dossiers door te geven via API. De dossierstatus wordt dan zichtbaar op platformen als Mijn Burgerprofiel, het Verenigingsloket of het eLoket voor ondernemingen.

Protocol

Onboardingprocedure gebeurt per dienstverlening die je met DOSIS wil koppelen en staat beschreven op de documentatiesite van de Digitaal Vlaanderen. Grosso modo doorloop je onderstaande stappen.

Vul het aansluitingsformulier in bij elke nieuwe aansluiting.
DOSIS zet de testomgeving op en bezorgt je een OAuth clientId voor toegang tot de testomgeving.
Log in bij het beheerdersportaal om de OAuth clientID te beheren en er een gevalideerde public key (certificaat onder de vorm van .jwks-bestand) op te laden.
Koppelen met testomgeving en valideren van de connectie.
DOSIS zet de productieomgeving op en bezorgt je een OAuth clientId voor toegang tot de productieomgeving.
Log in bij het beheerdersportaal om de OAuth clientID te beheren en er een gevalideerde public key (certificaat onder de vorm van .jwks-bestand) op te laden.
Koppelen met productieomgeving en verder operationaliseren.

Deze stappen zijn in grote lijnen dezelfde als voor aansluiting met MAGDA.

Applicatie eigenschappen

Specifiek voor DOSIS (los van de eigenschappen die de toegang regelen).

Eigenschap	Default	Beschrijving
DosisTechnicalConnectorConfig
`skryv.connectors.dosis.esb`	`false`	Use ESB endpoint
`skryv.connectors.dosis.esb.basicAuth.username`	null	ESB basic auth username
`skryv.connectors.dosis.esb.basicAuth.password`	null	ESB basic auth password
`skryv.connectors.dosis.esb.privateKey`	null	ESB private key
`skryv.connectors.dosis.esb.privateKeyPassword`	null	ESB private key password
`skryv.connectors.dosis.esb.certificate`	null	ESB certificate
`skryv.connectors.dosis.oauth2.client.*`	null	OAuth2 client credentials properties
DosisBusinessConnector
`skryv.connectors.dosis.status.update.url`	null	DOSIS status update URL
`skryv.connectors.dosis.status.delete.url`	null	DOSIS status delete URL
`skryv.connectors.dosis.bron`	null	Aanduiding van de bron van waaruit je applicatie statusupdates doorstuurt. Uitleg over het begrip ‘bron’.
`skryv.connectors.dosis.productId`	null	Productcode voor je dienstverlening. Uitleg over ProductId of IDPC.
DosisCredentialsTokenFetcher
`skryv.connectors.geosecure.dosis.scope`	`dv_dosis_import`	GeoSecure OAuth scope. Scope van je machtiging binnen DOSIS. Dit bepaalt welke acties je mag uitvoeren.
`skryv.connectors.geosecure.dosis.request-path`	`https://authenticatie-ti.vlaanderen.be/op/v1/token`	Url waar de applicatie op inlogt om vervolgens een token te verkrijgen waarmee de veilige communicatie tot stand gebracht kan worden.
`skryv.connectors.geosecure.dosis.appnumber`	null	GeoSecure app number. Client Id voor je applicatie. Hiermee moet je inloggen op het beheerdersportaal.
`skryv.connectors.geosecure.dosis.aws.keypath`	null	GeoSecure keypath. Pad naar private key in AWS Secrets Manager.
`skryv.connectors.geosecure.dosis.aws.seed.enabled`	`false`	Waarde: boolean. Indien `true` worden authenticatiegegevens opgehaald uit AWS Secrets Manager. Indien `false`, dan worden de lokaal opgeslagen authenticatiegegevens gebruikt.
`skryv.connectors.geosecure.dosis.keypath`	null	Pad naar lokale opslag van je key pair.
`skryv.connectors.geosecure.jwks`	null	GeoSecure JWKS URL.

Services en functies

sendDosisStatusUpdate

Functie gebruikt om een statusupdate door te sturen naar DOSIS. Alle parameters zijn instelbaar via de Studio service taak template ‘DOSIS - Verzend statusupdate’.

Workflow expressie

${dosis.sendDosisStatusUpdate(agentIdentificatie, agentToegangsrecht, statusVlaamseFase, statusVlaamseCode, statusDetail1, statusActie, dossierLabel, dossierNaam, doorverwijzing, contactNaam, contactDepartement, contactTelefoon, contactEmail, contactWebsite, productId)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
agentIdentificatie	String	-	Zie template
agentToegangsrecht	String	-	Zie template
statusVlaamseFase	String	-	Zie template
statusVlaamseCode	String	-	Zie template
statusDetail1	String	-	Zie template
statusActie	String	-	Zie template
dossierLabel	String	-	Zie template
dossierNaam	String	-	Zie template
doorverwijzing	String	-	Zie template
contactNaam	String	-	Zie template
contactDepartement	String	-	Zie template
contactTelefoon	String	-	Zie template
contactEmail	String	-	Zie template
contactWebsite	String	-	Zie template
productId	String	-	Zie template

Output

Geen output.

deleteDossier

Functie gebruikt om een in DOSIS gekend dossier te schrappen.

Workflow expressie

${dosis.deleteDossier(String bron, String dossierNummer)}

Input

Inputparameters	Data type	Voorbeeld	Uitleg
bron	String	-	Bron (info die je ontvangt tijdens het onboardingproces)
dossierNummer	String	-	Nummer (dossierId die je doorgegeven hebt aan DOSIS)

Output

Geen output.