eHealth platform services connectors

Alles over deze dienst

De “eHealth platform services connectors” zijn lokale (en lichte) bibliotheken met de bedoeling om de ontwikkelaars van software voor individuele zorgverleners en apotheken te helpen bij de integratie van de basisdiensten van het eHealth-platform die worden aangeboden via “web service”-interfaces. Deze bibliotheken dienen meer algemeen eveneens ter ondersteuning van de verbindingen met de diensten met toegevoegde waarde die via het eHealth-platform beschikbaar zijn of die gebruik maken van de ICTstandaarden die door het eHealth platform werden vastgesteld (zoals de "hubs" bijvoorbeeld). De ontwikkeling van deze bibliotheken kadert dus in de standaardisering en de ondersteuning bij het gebruik van de basisdiensten van het eHealth-platform. Deze connectoren zijn opgebouwd uit twee "lagen".

  • De eerste laag of “technische connector” biedt een algemene API ter ondersteuning van het gebruik van louter technische basisdiensten (hoofdzakelijk in het domein van de beveiliging: authenticatie, vercijfering, …)
  • De tweede laag of “businessconnector” maakt gebruik van de technische connector om de verbinding met een reeks diensten voor een bepaalde doelgroep binnen éénzelfde sessie te vergemakkelijken.

De connectoren zijn uiteraard afhankelijk van de interfaces van de diensten die zij integreren. De updates van de connectoren ingevolge de wijzigingen aan deze interfaces worden in de mate van het mogelijke ter beschikking gesteld via deze webpagina.

Deze connectoren zijn beschikbaar in JAVA en .NET, maar worden uitsluitend ontwikkeld in JAVA. De .NETcode is dus geen ‘native code’. Deze connectoren worden gegenereerd aan de hand van een versie van de tool IKVM die licht werd aangepast aan onze behoeften. Als u van plan bent om vanuit dezelfde filosofie uw eigen library’s te ontwikkelen op basis van de onze, raden we u aan om diezelfde versie van de tool te gebruiken en de richtlijnen voor de integratie ervan na te leven.
De connectoren zijn bibliotheken die verdeeld worden onder vrije licentie. Ze zijn beschikbaar voor iedereen die ze wil gebruiken. Voor ondersteuning bij het gebruik van deze bibliotheken dient er op voorhand een aanvraag te worden ingediend bij het eHealth-platform via het e-mailadres info@ehealth.fgov.be ( wcag.label.externalLink) (met als onderwerp "eHealth platform service connectors").

Wijzigingen van oktober 2022 ten opzichte van vorige versies

In de businessconnectoren wordt Dozer vervangen door de mapping library MapStruct. In sommige gevallen zal u hierdoor uw project moeten hercompileren.

De volgende functionaliteiten werden gewijzigd:

Release 4.2.0

  • eHealthBox V3: afstemming van het genereren van berichten (zie Cookbook eHealthBox WS Publication v 3.12)
  • Verwijdering van de ConsultRN V1 business connector
  • Bijwerking van de KMEHR XSD-versie 1.36.

In de technische connectoren is het volgende punt aangepast: gebruik van de laatste versie van de DAASattributen (xsd versie 1.1.4)

Om redenen van performantie wordt de gebruikers van de .NET toepassingen geadviseerd om de 3.x versies van de connector te gebruiken. De hierboven opgesomde functies van de versie 4.x zijn toegepast op versie 3.23.0 van de business connector, evenals de volgende zakelijke functies (reeds opgenomen vanaf versie 4.1)

  • VSB async: kleine update van XSD MOHM waarbij de statussen voor ZKC_melding toegevoegd werden aan ApplicationStatusType
  • TherLink: verwijdering van het bewijstype SISREADING
  • Dics v5: kleine XSD-update (versie 5.1.4)
  • Intrahub V3: standaard gebruik van SHA1 bij het aanroepen van de Hub Diensten

De « Release notes » bevatten meer informatie hieromtrent.

Betrokken diensten op het vlak van de "business"-lagen

Compatibiliteit van de technische connector

De compatibiliteit van de technische connector versie 4.1 met de Recip-e connectors is gevalideerd

Download

De java-connectoren en een archief-bestand met de “.net”-connectoren zijn beschikbaar via een maven repository ( repo.ehealth.fgov.be ( wcag.label.externalLink) ). De volgende lijst bevat links naar de business connectoren van de diverse beroepsgroepen en de technische connector.

Connector v4: Inleidende gids

Dit is een technisch overzicht over het gebruik van de eHealth connector (versie 4). Het doel is om een ontwikkelaar van een softwareapplicatie voor eindgebruikers te begeleiden bij het gebruik, de configuratie, de uitbreiding en de integratie van zijn applicatie met de eHealth-connector.

Versie 1.9 (13/10/2021) - 1.39 MB Bestand PDF (Dit document is in het Engels)

Omwille van de migratie naar een nieuwe technologie, hierdoor zal het niet meer mogelijk zijn om WSDL’s en XSD’s te downloaden via de UDDI. In het vervolg kan u deze informatie terugvinden op de API Portal.

Om de eHealth Service Bus (ESB) niet te overbelasten, zullen de WSDL's en XSD's vanaf 11 mei 2014 alleen via UDDI-downloads beschikbaar zijn.

De "Registry" is de catalogus van webservices die aangeboden worden door het eHealth-platform en zijn partners. De informatie is gestructureerd volgens de UDDI-standaard.
Het gaat om de volgende informatie:

  • technisch : URL, versie, WSDL en XSD
  • functioneel : link naar de beschikbare documentatie, beschrijving van de online diensten

 

U vindt de laatste versie van de .jks-bestanden telkens in de nieuwste connector versie die u via de Maven-repository kan downloaden. Raadpleeg een voorbeeld op de pagina Index of maven2 van de eHealth-website. De .jks bestanden zitten in de map ‘config/P12’.

U vindt de verschillende keystores ook bij het onderdeel ‘Keystore’ op de pagina eHealth-certificaten van de eHealth-website.
 

U vindt voorbeelden/voorbeeldcodes?? in de generische connector van de repository. Ze bevat voorbeelden voor zowel java als net. Download het package, en bekijk de voorbeelden in het mapje ‘examples’.

De connector vindt u op de pagina Index of maven2 van de eHealth-website.