FHIRlink-connector instellen
De gezondheidszorgsector is in snel tempo bezig met het invoeren van de opkomende HL7 FHIR®-standaard. De FHIR-standaard (Fast Healthcare Interoperability Resources) definieert een uitbreidbaar gegevensmodel met gestandaardiseerde semantiek en gegevensuitwisseling die interoperabiliteit en een snelle uitwisseling van gegevens in toepassingen mogelijk maakt. De FHIR-connector van Microsoft Health is een eigen Power Platform FHIR-connector waarmee Power App-ontwikkelaars toepassingen met weinig of geen code kunnen bouwen die rechtstreeks communiceren met FHIR-gegevens. De connector ondersteunt meerdere verificatiemethoden voor verbeterde beveiliging. De connector vereenvoudigt de FHIR-serviceverificatie, het samenstellen van query's en het verwerken van FHIR-gegevens, waardoor de noodzaak van op maat gemaakte integratieoplossingen voor eenmalig gebruik wordt geëlimineerd.
De functie biedt de volgende belangrijke voordelen:
- Biedt een aangepaste connector die is ontworpen voor gebruik met Power Platform-canvas-apps, Power Automate-stromen en Azure Logic Apps.
- Maakt directe toegang tot FHIR-services van Power Platform en Azure mogelijk.
- Ondersteunt verificatie voor de FHIR-service voor Azure Health Data Services en Google™ FHIR-services.
- Vermindert de complexiteit van het werken met FHIR-service-API's en de resulterende FHIR-gegevens.
Dit artikel geeft een overzicht en instructies voor het verkrijgen en instellen van uw verbindingen voor FHIRlink. Zie Overzicht van connectorverwijzingen voor meer informatie over andere eigen connectors die u kunt gebruiken met FHIRlink wanneer u complexe zorgtoepassingen op Power Platform bouwt.
Vereisten
Controleer of aan de volgende vereisten is voldaan:
- Actieve Power Apps-licentie.
- Actieve Power Automate Premium-licentie.
- Actieve FHIR-serverinstallatie met voorbeeldgegevens, zoals een actieve configuratie van de FHIR-service voor Azure Health Data Services.
- Machtigingen om gegevens op uw FHIR-service te maken en bij te werken.
Een verbinding maken
De connector ondersteunt de volgende verificatiemethoden:
- Standaard door Azure gedeelde toepassing gebruiken
- Uw eigen Google™-toepassing meenemen
- Uw eigen EPIC® on FHIR®-toepassing meenemen
Nadat u de verbinding hebt gemaakt, kunt u deze gebruiken in een of meer van uw canvas-apps, Power Automate-stromen of Azure Logic Apps.
Notitie
FHIR® (eigendom van Health Level Seven International), Google™ (eigendom van Google LLC) en EPIC® (eigendom van Epic Systems Corporation) zijn gedeponeerde handelsmerken. Het gebruik van deze handelsmerken op deze pagina houdt geen goedkeuring in van Health Level Seven International, Google of Epic Systems.
Standaard door Azure gedeelde toepassing gebruiken
Deze optie kan worden gebruikt wanneer u verbinding maakt met Azure Health Data Services Azure API for FHIR. De verificatiemethode heeft de volgende twee waarden nodig:
- URL van Azure FHIR-service-eindpunt: de eindpunt-URL van de Azure FHIR-service. Bijvoorbeeld:
https://{{fhirservicename}}.fhir.azurehealthcareapis.com
. - Resource-URI van Azure FHIR Services: de id die wordt gebruikt in Microsoft Entra ID om de doel-FHIR-serviceresource te identificeren. Voor Azure FHIR-services volgt de URI doorgaans de indeling
https://{{fhirservicename}}.fhir.azurehealthcareapis.com
.
Deze connectiviteit moet als volgt worden geconfigureerd:
Microsoft Entra-gebruikersaccount.
De juiste rolmachtigingen die aan het gebruikersaccount zijn verleend via de FHIR-service voor Azure Health Data Services. Dit kan bijvoorbeeld de rol Lezer van FHIR-gegevens zijn.
Zie Azure RBAC voor FHIR configureren voor meer informatie over toegangsconfiguratie.
Notitie
Volgende releases van de FHIRlink-connector omvatten de mogelijkheid om verbinding te maken met de FHIR-service voor Azure Health Data Services met behulp van geregistreerde serviceclienttoepassingen en OAuth, ter ondersteuning van een gedeelde verbinding.
Uw eigen Google™-toepassing meenemen
Deze optie kan worden gebruikt wanneer u verbinding maakt met Google™ Cloud Healthcare API. De verificatie heeft de volgende drie waarden nodig:
- Google™ FHIR-service-eindpunt: de eindpunt-URL van de Google™ FHIR-service. Bijvoorbeeld:
https://healthcare.googleapis.com/{{fhirservicepath}}/fhir
. - Client-id: de client-id of de toepassings-id van uw Google™-toepassing.
- Clientgeheim: het clientgeheim van uw Google™-toepassing.
Uw eigen EPIC® on FHIR®-toepassing meenemen
Deze optie kan worden gebruikt wanneer u verbinding maakt met FHIR-API's voor EPIC® on FHIR®. Voor de verificatie moeten de volgende waarden worden opgegeven:
- URL van eindpunt voor Epic op FHIR-service: de URL voor het FHIR-service-eindpunt voor uw app-registratie. Bijvoorbeeld:
https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
. - Client-id: de client-id of de toepassings-id van uw registratie van de Epic-app.
- Clientgeheim: het clientgeheim van uw registratie van de Epic-app.
- Autorisatie-URL: de autorisatie-URL van uw registratie van de Epic-app.
- Token-URL: de token-URL van uw registratie van de Epic-app.
- Vernieuwings-URL: de vernieuwings-URL van uw registratie van de Epic-app.
Notitie
De huidige release van de FHIRlink-connector ondersteunt EPIC® on FHIR®-toepassingsregistraties die zijn geconfigureerd met een toepassingsdoelgroep van het type Patiënt, Artsen of Beheerders. We hebben nog geen ondersteuning geïmplementeerd voor de toepassingsdoelgroepen van het type Back-endsystemen.
De EPIC® on FHIR®-API's ondersteunen toegang tot een beperkt aantal FHIR-resources. Elke FHIR-resource kan echter verschillende bewerkingen en FHIR-versies ondersteunen. Sommige FHIR-resources ondersteunen bijvoorbeeld lees- en zoekbewerkingen terwijl andere resources mogelijk lees-, zoek- en maakbewerkingen ondersteunen.
Het aanroepen van niet-ondersteunde bewerkingen resulteert in fouten van de EPIC® on FHIR®-services, waarbij de bijbehorende waarden voor OperationOutcome worden geretourneerd die door de aanroeper kunnen worden afgehandeld.
Voor een volledige lijst met ondersteunde FHIR-resources, -versies en -bewerkingen kunt u EPIC® on FHIR® verkennen.
Wanneer u uw EPIC® op FHIR®-appregistratie aanmaakt, moet u de volgende Omleidings-URI-vermelding opnemen:
https://global.consent.azure-apim.net/redirect/fhirlink
Voor uitgebreide hulp bij het instellen van een EPIC® on FHIR®-app-registratie en de beschikbare opties raadpleegt u het onderwerp Proces van het maken en aanvragen van apps.
Volgende releases van de FHIRlink-connector omvatten uitgebreide ondersteuning voor EPIC® on FHIR®-connectiviteit.
Connectorbewerkingen
Zie voor meer informatie over de connectorreferentie en het gebruik hiervan het onderwerp FHIRlink-connector. Voor een lijst met ondersteunde bewerkingen, gaat u naar FHIRlink-connectoracties.
Voorbeelden
De release van de FHIRlink-connector biedt voorbeelden van het gebruik van de connector in een eenvoudige Power Platform-canvas-app. Deze voorbeelden die stap voor stap worden uitgelegd, zijn bedoeld om voort te bouwen op elk vorig voorbeeld. U kunt ze echter indien nodig ook afzonderlijk gebruiken.
Elk voorbeeld biedt een downloadbare voltooide oplossing. Als u de voorbeelden wilt bekijken, gaat u naar:
- Voorbeeld 1: FHIRlink instellen en hiermee verbinding maken
- Voorbeeld 2: FHIR-gegevens binden in uw canvas-app
- Voorbeeld 3: Methoden combineren voor het weergeven van FHIR-gegevens
Aannames voor voorbeeldgebruik
Bij de verstrekte voorbeelden wordt ervan uitgegaan dat de volgende stappen zijn voltooid:
- Bekijk de secties Overzicht en Vereisten om de juiste configuratie in te stellen.
- Zorg ervoor dat alle benodigde Power Platform-licenties beschikbaar zijn als dat nodig is.
- Implementeer een omgeving die alle benodigde licenties bevat.
- Maak een verbinding met behulp van de richtlijnen in Een verbinding maken.