Introduzione al servizio FHIR
Questo articolo illustra i passaggi di base per iniziare a usare il servizio FHIR® in Azure Health Data Services.
Come prerequisito, sono necessari una sottoscrizione di Azure e le autorizzazioni per creare gruppi di risorse di Azure e distribuire le risorse di Azure. È possibile seguire tutti i passaggi oppure ignorare alcuni se si dispone di un ambiente esistente. È anche possibile combinare tutti i passaggi e completarli in PowerShell, nell'interfaccia della riga di comando di Azure e negli script dell'API REST.
Creare un'area di lavoro nella sottoscrizione di Azure
Creare un'area di lavoro dal portale di Azure oppure usando PowerShell, l'interfaccia della riga di comando di Azure e l'API REST. Gli script sono disponibili negli esempi di API di Azure per FHIR.
Nota
Esistono limiti al numero di aree di lavoro e al numero di istanze del servizio FHIR che è possibile creare in ogni sottoscrizione di Azure.
Creare un servizio FHIR nell'area di lavoro
È possibile creare un'istanza del servizio FHIR dal portale di Azure oppure usando PowerShell, l'interfaccia della riga di comando di Azure e l'API REST. Gli script sono disponibili negli esempi di API di Azure per FHIR.
Facoltativamente, è possibile creare un servizio DICOM e un servizio MedTech nell'area di lavoro.
Accedere al servizio FHIR
Il servizio FHIR è protetto da Microsoft Entra ID che non può essere disabilitato. Per accedere all'API del servizio, è necessario creare un'applicazione client, denominata anche entità servizio in Microsoft Entra ID, e concederle le autorizzazioni appropriate.
Registrare l'applicazione client
È possibile creare o registrare un'applicazione client dal portale di Azure oppure usando PowerShell e gli script dell'interfaccia della riga di comando di Azure. Questa applicazione client può essere usata per una o più istanze del servizio FHIR. Può essere usato anche per altri servizi in Servizi dati di integrità di Azure.
Se l'applicazione client viene creata con un certificato o un segreto client, assicurarsi di rinnovare il certificato o il segreto client prima della scadenza e sostituire le credenziali client nelle applicazioni.
È possibile eliminare un'applicazione client. Prima di eliminare un'applicazione client, assicurarsi che non venga usata negli ambienti di produzione, sviluppo, test o controllo di qualità (QA).
Concedere le autorizzazioni di accesso
È possibile concedere autorizzazioni di accesso o assegnare ruoli nel portale di Azure oppure usando PowerShell e script dell'interfaccia della riga di comando di Azure.
Eseguire transazioni di creazione, lettura, aggiornamento ed eliminazione (CRUD)
È possibile eseguire transazioni CRUD (Create, Read (search), Update and Delete) sul servizio FHIR nelle applicazioni o usando strumenti come Postman, REST Client e cURL. Poiché il servizio FHIR è protetto per impostazione predefinita, è necessario ottenere un token di accesso e includerlo nella richiesta di transazione.
Ottenere un token di accesso
È possibile ottenere un token di accesso Di Microsoft Entra usando PowerShell, l'interfaccia della riga di comando di Azure, REST CCI o .NET SDK. Per altre informazioni, vedere Ottenere un token di accesso.
Accedere con gli strumenti esistenti
Caricare i dati
È possibile caricare i dati direttamente usando il metodo POST o PUT sul servizio FHIR. Per caricare in blocco i dati, è possibile usare $import operazione. Per informazioni, visitare l'operazione di importazione.
CMS, ricerca, convalida del profilo e reindicizzazione
Per altre informazioni sull'interoperabilità e l'accesso ai pazienti, la ricerca, la convalida del profilo e la reindicizzazione, vedere la documentazione del servizio FHIR.
Esportare dati
Facoltativamente, è possibile esportare ($export) i dati in Archiviazione di Azure e usarli nei progetti di analisi o machine learning. È possibile esportare i dati "così come sono" o de-identificati in formato ndjson.
Convertire i dati
Facoltativamente, è possibile convertire i dati HL7 v2 e altri formati in FHIR.
Uso dei dati FHIR nel dashboard di Power BI
Facoltativamente, è possibile creare report del dashboard di Power BI con i dati FHIR.
Passaggi successivi
Distribuire un servizio FHIR in Azure Health Data Services
Nota
FHIR® è un marchio registrato di HL7 ed è usato con l'autorizzazione di HL7.