ECAD Diplomaservice

Inleiding

eCad is de webtoepassing van de FOD Volksgezondheid voor het beheren van visa en erkenningen van gezondheidszorgbeoefenaars (artsen, tandartsen, apothekers ...). De Skryv eCad connector laat toe om diplomagerelateerde gegevens over zorgverleners via een XML-bestand door te geven aan dit federale kadaster.

Setup

Onboarding

Neem contact op met de FOD Volksgezondheid voor concrete informatie en instructies.

Maven dependency in pom.xml

Voeg onderstaande maven dependency toe in je pom.xml. Dit zorgt ervoor dat de connector code binnengehaald en meegenomen wordt in de build van je applicatie.

CODE

<dependency>
   <groupId>com.skryv.connectors</groupId>
   <artifactId>ecad</artifactId>
   <version>${skryv.version}</version>
</dependency>

Applicatie eigenschappen

ECAD Diplomaservice-specifieke applicatie eigenschappen.

Eigenschap	Default	Beschrijving
EcadBusinessConnector
`skryv.connectors.ecad.service-url`	-	De URL (endpoint) van de externe ECAD‑service waarmee de connector communiceert.
AwsSSLProperties
`aws.ecad.client.ssl.trust-store-path`	-	Het bestandssysteem-pad (of URI) naar de trust-store die de vertrouwde CA-certificaten bevat voor het valideren van de server.
`aws.ecad.client.ssl.private-key-path`	-	Het pad of URI naar het private key bestand (indien buiten de keystore opgeslagen, bv. als PEM-bestand).
`aws.ecad.client.ssl.private-key-password-path`	-	Pad of resource waar het wachtwoord staat voor de private key (verwijst naar een bestand met het wachtwoord, niet het wachtwoord zelf).
`aws.ecad.client.ssl.keystore-jks`	-	Pad of resource-referentie naar het Java KeyStore (JKS) bestand dat de client-identiteit bevat (private key + certificaat); gebruikt voor mutual TLS (mTLS) authenticatie richting de ECAD-service.
`aws.ecad.client.ssl.trustore-jks`	-	Pad of resource‑referentie naar het Java TrustStore (JKS) bestand dat de vertrouwde certificaten bevat.
`aws.ecad.client.ssl.username`	`admin`	Gebruikersnaam voor SSL/WS-Security authenticatie bij de ECAD-service.
`aws.ecad.client.ssl.password`	`admin`	Wachtwoord voor SSL/WS-Security authenticatie bij de ECAD-service.
`aws.ecad.client.ssl.security`	`sign`	SSL/WS-Security modus; `sign` betekent dat berichten cryptografisch ondertekend worden voor integriteitsgarantie.
`aws.ecad.client.ssl.use-mocks`	`false`	Wanneer `true`, worden echte ECAD-aanroepen vervangen door nep-antwoorden (mockgedrag); nuttig voor lokale ontwikkeling en testen zonder verbinding met de federale service.
`aws.ecad.client.ssl.kong-api-key`	-	API-sleutel voor authenticatie via de Kong API Gateway die voor de ECAD-service staat.

Services en functies

uploadFileToEcad

XML-bestand opladen naar Ecad.

Voorbeeld workflow expression

${ecad.uploadFileToEcad(byte[] file, HashMap <String, String> data)}

Input

In de hashmap moet volgende info opgenomen zijn.

Key	Data type	Voorbeeld	Uitleg
title	String	-	Titel
language	String	-	Taal
date	String	-	Datum
profession	String	-	Beroep
school	String	-	Onderwijsinstelling

Output

Je krijgt een object UploadStudentFileResponse terug.