Introduzione al servizio FHIR
Questo articolo illustra i passaggi di base per iniziare a usare il servizio FHIR in Servizi dati di integrità di Azure.
Come prerequisito, è necessaria una sottoscrizione di Azure e sono state concesse le autorizzazioni appropriate 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
È possibile creare un'area di lavoro dalla portale di Azure o usando PowerShell, l'interfaccia della riga di comando di Azure e l'API REST. Gli script sono disponibili negli esempi di Servizi dati di Integrità di Azure.
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 dalla portale di Azure o usando PowerShell, l'interfaccia della riga di comando di Azure e l'API REST. Gli script sono disponibili negli esempi di Servizi dati di Integrità di Azure.
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 nota anche come entità servizio in Microsoft Entra ID e concederla con 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 qualità (QA).
Concedere le autorizzazioni di accesso
È possibile concedere autorizzazioni di accesso o assegnare ruoli dall'portale di Azure o usando gli script di PowerShell e dell'interfaccia della riga di comando di Azure.
Eseguire transazioni di creazione, lettura, aggiornamento ed eliminazione (CRUD)
È possibile eseguire transazioni di creazione, lettura (ricerca), aggiornamento ed eliminazione (CRUD) sul servizio FHIR nelle applicazioni o tramite strumenti come Postman, CLIENT REST 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 il 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-id in ndjson formato .
Conversione di dati
Facoltativamente, è possibile convertire i dati di formato HL7 v2 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
Questo articolo descrive i passaggi di base per iniziare a usare il servizio FHIR. Per informazioni sulla distribuzione del servizio FHIR nell'area di lavoro Di Azure Health Data Services, vedere
FHIR® è un marchio registrato di HL7 e viene usato con l'autorizzazione di HL7.