Condividi tramite

Configurare il connettore FHIRlink

  • Articolo

Il settore sanitario si sta muovendo rapidamente per adottare lo standard emergente HL7 FHIR®. Lo standard Fast Healthcare Interoperability Resources (FHIR) definisce un modello di dati estendibile con semantica e scambio di dati standardizzati che consente l'interoperabilità e il rapido scambio di dati nelle applicazioni. Il connettore FHIRlink di Microsoft Health and Life Science è un connettore FHIR Power Platform di prima parte che consente agli sviluppatori di Power App di creare applicazioni con poco codice e senza codice che interagiscono direttamente con i dati FHIR. Il connettore supporta più metodi di autenticazione per una maggiore sicurezza. Semplifica l'autenticazione del servizio FHIR, la creazione di query e la gestione di dati FHIR, eliminando la necessità di soluzioni di integrazione monouso personalizzate.

La funzionalità include i seguenti vantaggi chiave:

  • Offre un connettore personalizzato progettato per l'uso con app canvas Power Platform, flussi Power Automate e App per la logica di Azure.
  • Consente l'accesso diretto ai servizi FHIR da Power Platform e Azure.
  • Supporta l'autenticazione per il servizio FHIR di Azure Health Data Services e i servizi FHIR di Google™.
  • Riduce la complessità dell'utilizzo delle API dei servizi FHIR e dei dati FHIR risultanti.

Questo articolo fornisce una panoramica e istruzioni per l'accesso e la configurazione delle connessioni per FHIRlink. Per ulteriori informazioni su altri connettori proprietari che puoi utilizzare con FHIRlink durante la creazione di applicazioni sanitarie complesse in Power Platform, consulta Panoramica di riferimento sui connettori.

Prerequisiti

Assicurati che vengano soddisfatti i seguenti prerequisiti:

Crea una connessione

Il connettore supporta i seguenti metodi di autenticazione:

Dopo aver creato la connessione, puoi usarla in uno o più app xanvas, flussi Power Automate o app per la logica di Azure.

Nota

FHIR® (di proprietà di Health Level Seven International), Google™ (di proprietà di Google LLC) ed EPIC® (di proprietà di Epic Systems Corporation) sono marchi registrati. L'utilizzo di questi marchi in questa pagina non costituisce approvazione da parte di Health Level Seven International, Google o Epic Systems.

Utilizzare l'applicazione condivisa predefinita di Azure

Questa opzione può essere usata quando ci si connette ai Servizi per i dati sanitari di Azure API di Azure per FHIR. Il metodo di autenticazione necessita dei due valori seguenti:

  • URL dell'endpoint del servizio FHIR di Azure: l'URL dell'endpoint del servizio FHIR di Azure. Ad esempio: https://{{fhirservicename}}.fhir.azurehealthcareapis.com.
  • URI della risorsa dei servizi FHIR di Azure: l'identificatore utilizzato in Microsoft Entra ID per identificare la risorsa del servizio FHIR di destinazione. Per i servizi FHIR di Azure, l'URI in genere è nel formato https://{{fhirservicename}}.fhir.azurehealthcareapis.com.

Screenshot che mostra come configurare una connessione a un servizio FHIR di Azure.

Questa opzione di connettività richiede la configurazione seguente:

  • Account utente di Microsoft Entra.

  • Autorizzazioni di ruolo appropriate concesse all'account utente tramite il servizio FHIR di Servizi di dati sanitari di Azure. Ad esempio, il ruolo Lettore di dati FHIR.

    Per ulteriori informazioni sulla configurazione dell'accesso, vedi Configurare Azure RBAC per FHIR.

Nota

Le versioni successive del connettore FHIRlink includeranno la possibilità di connettersi al servizio FHIR di Servizi per i dati sanitari di Azure utilizzando applicazioni client di servizio registrate e OAuth, con il supporto di una connessione condivisa.

Importare la propria applicazione Google™

Questa opzione può essere utilizzata quando ti connetti all'API Cloud Healthcare di Google™. L'autenticazione necessita dei tre valori seguenti:

  • URL dell'endpoint del servizio FHIR di Google™: l'URL dell'endpoint del servizio FHIR di Google™. Ad esempio: https://healthcare.googleapis.com/{{fhirservicepath}}/fhir.
  • ID client: l'ID client o l'ID applicazione dell'applicazione Google™.
  • Segreto client: il segreto client dell'applicazione Google™.

Screenshot che mostra come configurare una connessione a Cloud Health Services di Google™.

Per ulteriori informazioni sulla configurazione di OAuth in Google™ Healthcare Cloud, consulta Creare un'applicazione client OAuth in Google™.

Importare la propria applicazione EPIC® on FHIR®

Questa opzione può essere utilizzata quando ti connetti all'API FHRI di EPIC® on FHIR®. L'autenticazione richiede i seguenti valori:

  • Epic in URL dell'endpoint del servizio FHIR: l'URL dell'endpoint del servizio FHIR per la registrazione dell'app. Ad esempio: https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4.
  • ID client: l'ID client o l'ID applicazione della registrazione dell'app Epic.
  • Segreto client: il segreto client della registrazione dell'app Epic.
  • URL autorizzazione: l'URL di autorizzazione della registrazione dell'app Epic.
  • URL token: l'URL del token della registrazione dell'app Epic.
  • URL aggiornamento: l'URL di aggiornamento della registrazione dell'app Epic.

Screenshot che mostra come configurare le API FHIR di EPIC® on FHIR®.

Nota

  • L'attuale versione del connettore FHIRlink supporta le registrazioni dell'applicazione EPIC® on FHIR® configurate con un gruppo di destinatari dell'applicazione di tipo Paziente, Medici o Utenti amministrativi. Non abbiamo ancora implementato il supporto per i gruppi di destinatari dell'applicazione di tipo Sistemi backend.

  • Le API di EPIC® on FHIR® supportano l'accesso a un insieme selezionato di risorse FHIR. Tuttavia, ciascuna risorsa FHIR può supportare operazioni e versioni FHIR diverse. Ad esempio, alcune risorse FHIR possono supportare operazioni di lettura e ricerca, mentre altre possono supportare operazioni di lettura, ricerca e creazione.

  • Il richiamo di operazioni non supportate genera errori nei servizi EPIC® on FHIR®, con i valori OperationOutcome appropriati restituiti che possono essere gestiti dal chiamante.

  • Per un elenco completo delle risorse, delle versioni e delle operazioni FHIR supportate, puoi esplorare EPIC® on FHIR®.

  • Quando crei la tua registrazione dell'app EPIC® su FHIR®, includi la seguente voce URI di reindirizzamento: https://global.consent.azure-apim.net/redirect/fhirlink

  • Per informazioni dettagliate sulla configurazione di una registrazione dell'app EPIC® on FHIR® e sulle opzioni disponibili, vedi Processo di creazione e di richiesta di app.

  • Le versioni successive del connettore FHIRlink includeranno il supporto esteso per la connettività di EPIC® on FHIR®.

Operazioni del connettore

Per ulteriori informazioni sul riferimento del connettore e su come utilizzarlo, vedere Connettore FHIRlink. Per un elenco delle operazioni supportate, vai a Azioni del connettore FHIRlink.

Esempi

La versione del connettore FHIRlink fornisce esempi su come utilizzare il connettore in una semplice app canvas Power Platform. Ognuno di questi esempi descritti dettagliatamente si basa sull'esempio precedente. Puoi però utilizzarli anche singolarmente come necessario.

Ogni esempio fornisce una soluzione completa scaricabile. Per esaminare gli esempi, vedi:

Presupposti per l'utilizzo degli esempi

Per gli esempi forniti, devi:

  • Leggere le sezioni Panoramica e Prerequisiti per impostare la configurazione corretta.
  • Assicurarti che tutte le licenze Power Platform richieste siano disponibili come necessario.
  • Distribuire un ambiente che includa tutte le licenze necessarie.
  • Creare una connessione utilizzando le linee guida in Creare una connessione.