eHealth platform services connectors

Tout sur le service

Les « eHealth platform services connectors » sont des librairies locales (et légères) dont l’objectif est d’aider les développeurs de software à destination des prestataires de soins individuels et des pharmacies de soins à intégrer les services de base de la plate-forme eHealth qui sont proposés au travers d’interfaces « webservices ». Ces librairies visent également, plus généralement, à supporter les connexions aux services à valeur ajoutée accessibles via la plate-forme eHealth ou qui souscrivent aux standards ICT mis en place par la plate-forme eHealth (comme, par exemple, les « hubs »). Le développement de ces librairies s’inscrit donc dans une logique de standardisation et de support à l’utilisation des services de base de la plate-forme eHealth.
Ces connecteurs sont structurés en deux « couches »:

  • La première couche, dénommée « connecteur technique » offre une API générique de support à l’utilisation des services de base purement techniques (principalement afférents à la sécurité : authentification, cryptage, etc.).
  • La seconde couche, dénommée « connecteurs business », exploite le connecteur technique pour faciliter les connexions à un ensemble de services associés à un public cible donné au sein d’une même session.

Les connecteurs sont évidemment tributaires des interfaces des services qu’ils intègrent. Les mises à jour des connecteurs inhérentes aux changements de ces interfaces seront mises à disposition dans la mesure des possibilités de la plate-forme eHealth au travers de cette page web.

Ces connecteurs sont disponibles en JAVA et .NET mais sont uniquement développés en JAVA. Le code .NET n’est donc pas un code natif. Cette génération est effectuée via une version de l’outil IKVM ( wcag.label.externalLink) légèrement adaptée pour nos besoins. Si vous entendez développer vos propres librairies sur base des nôtres dans la même philosophie, nous vous recommandons d’utiliser cette même version de l’outil et de respecter les « directives d’intégration » proposées avec celle-ci.

Les connecteurs sont des librairies distribuées sous licence libre. Elles sont disponibles pour tous ceux qui souhaitent les utiliser. Pour bénéficier de support dans l’utilisation de ces librairies, il faut, par contre, avoir préalablement introduit une demande auprès de la plate-forme eHealth. Vous pouvez introduire cette demande via l’adresse mail info@ehealth.fgov.be ( wcag.label.externalLink) (avec la mention « eHealth platform services connectors » au niveau du sujet du mail).

Modification pour octobre 2021 par rapport aux versions précédentes

Dans les connecteurs business, la librairie de mapping MapStruct remplace Dozer. Dans certains cas, cela peut vous obliger à recompiler votre projet.

Les fonctionnalités suivantes ont été modifiées:

  • Ajout du connecteur pour le service synchrone eAttest V3
  • Modification du connecteur eAgreement: ajout d'un champ businessResponse pour récupérer plus simplement le contenu de la réponse
  • Mise à jour du schéma xsd du connecteur ConsultRN v2 afin de permettre une recherche phonétique sans préciser de prénoms (l'élément GivenName est optionnel).

Dans les connecteurs techniques, les points suivants ont été modifiés

  • Refactoring du code pour pouvoir gérer commons-eid (1.0.3)
  • Ajout du module de configuration ConfigurationModuleBeidNet pour instancier BeID NET. Ce module est chargé par défaut.
  • Refactoring des classes de base WSS4J pour gérer les certificats basés sur les courbes elliptiques ("Elliptic curve based")
  • Suppression du cache interne de la classe BeidCredential.

Les « Release notes » contiennent plus d’informations.

Services couverts au niveau des couches « business »

Compatibilité du connecteur technique

La compatibilité du connecteur technique version 4.0 avec les connecteurs Recip-e est validée.

Download

Les connecteurs « java » et un fichier d’archive aves les connecteurs « .net » sont disponibles par un maven repository ( repo.ehealth.fgov.be ( wcag.label.externalLink) ). La liste suivante contient des liens vers les connecteurs business des differentes catégories professionnelles et le connecteur technique.

Connector v4 : Manuel d’utilisation

Il s'agit d'un aperçu technique de l'utilisation du connecteur eHealth (version 4). L'objectif est de guider le développeur d'une application logicielle pour utilisateur final dans l'utilisation, la configuration, l'extension et l'intégration de son application avec le connecteur eHealth.

Version 1.9 (13/10/2021) - 1.39 MB Fichier PDF (Ce document est en anglais)

En raison de la migration vers une nouvelle technologie, il ne sera plus possible de télécharger les WSDL et XSD via l’UDDI. Vous trouverez dorénavant ces informations sur l’API Portal.

Le Registry est le catalogue des webservices offerts par la plate-forme eHealth et ses partenaires. Les informations sont structurées selon le standard UDDI.

Il s’agit d’informations :

  • techniques : URL, version, contrat formel (WSDL+XSD)
  • fonctionnelles : liens vers la documentation disponible, description des services en ligne