Domande frequenti sul servizio FHIR

Importante

L'API di Azure per FHIR verrà ritirata il 30 settembre 2026. Seguire le strategie di migrazione per passare al servizio FHIR di Servizi per i dati sanitari di Azure entro tale data. A causa del ritiro dell'API di Azure per FHIR, le nuove distribuzioni non saranno consentite a partire dal 1° aprile 2025. Il servizio FHIR di Servizi per i dati sanitari di Azure è la versione evoluta dell'API di Azure per FHIR che consente ai clienti di gestire i servizi FHIR, DICOM e MedTech con integrazioni in altri servizi di Azure.

Questa sezione illustra alcune delle domande frequenti sul servizio FHIR di Servizi di integrità di Azure (denominato servizio FHIR).

Servizio FHIR: nozioni di base

Che cos'è FHIR?

Fast Healthcare Interoperability Resources (FHIR) è uno standard di interoperabilità progettato per consentire lo scambio di dati sanitari tra diversi sistemi sanitari. Questo standard è stato sviluppato dall'organizzazione HL7 e viene adottato dalle organizzazioni sanitarie in tutto il mondo. La versione più recente di FHIR disponibile è R4 (versione 4). Il servizio FHIR supporta R4 e la versione precedente STU3 (Standard per l'uso della versione di valutazione 3). Per altre informazioni su FHIR, visitare HL7.org.

I dati dietro le API FHIR sono archiviati in Azure?

Sì, i dati vengono archiviati in database gestiti in Azure. Il servizio FHIR in Servizi dati di Integrità di Azure non fornisce l'accesso diretto all'archivio dati sottostante.

Come è possibile ottenere l'accesso ai dati sottostanti?

Nel servizio gestito non è possibile accedere ai dati sottostanti. Ciò consente di garantire che il servizio FHIR offra le certificazioni di privacy e conformità necessarie per i dati sanitari. Se è necessario accedere ai dati sottostanti, è possibile usare il server FHIR open source.

Quale provider di identità supporta?

Microsoft Entra ID e provider di identità di terze parti che supportano OpenID Connect.

È possibile usare Azure AD B2C con il servizio FHIR?

Sì. È possibile usare Azure Active Directory B2C (Azure AD B2C) con il servizio FHIR per concedere l'accesso alle applicazioni e agli utenti. Per altre informazioni, vedere Usare Azure Active Directory B2C per concedere l'accesso al servizio FHIR.

Quale versione di FHIR è supportata?

Sono supportate le versioni 4.0.0 e 3.0.1.

Per altre informazioni, vedere Funzionalità FHIR supportate. È anche possibile leggere le informazioni sulle modifiche apportate tra le versioni FHIR (DA STU3 a R4) nella cronologia delle versioni per HL7 FHIR.

Qual è la differenza tra l'API di Azure per FHIR e il servizio FHIR in Servizi dati di integrità di Azure?

L'API di Azure per FHIR è il prodotto disponibile a livello generale iniziale e viene ritirato a partire dal 30 settembre 2026. La tabella seguente illustra la differenza tra l'API di Azure per FHIR e Azure Health Data Services, il servizio FHIR

Funzionalità	API di Azure per FHIR	Servizi per i dati sanitari di Azure
Dati in ingresso	Strumenti disponibili nel software open source	$import'operazione. Per informazioni, vedere Operazione di importazione
Scalabilità automatica	Supporto su richiesta e a pagamento	Scalabilità automatica abilitata per impostazione predefinita senza costi aggiuntivi
Parametri di ricerca	Tipo di bundle supportato: batch • Includere e invertire l'inclusione, modificatore di iterazione non supportato • Ordinamento supportato per nome, cognome, data di nascita e appuntamento medico	Tipo di bundle supportato: batch e transazione • Parametri di ricerca selezionabili • Includere, invertire l'inclusione e modificatore di iterazione supportato • Ordinamento supportato per stringa e campi DateTime
Eventi	Non supportato	Supportato
Converti dati	Supporta l'abilitazione di "Consenti servizi attendibili" nel Registro Contenitori account	Si è verificato un problema noto: l'abilitazione del collegamento privato con Registro Azure Container può causare problemi di accesso quando si tenta di usare il registro contenitori dal servizio FHIR.
Continuità aziendale	Supportato: • DR tra aree (ripristino di emergenza)	Supportate: • PITR (ripristino temporizzato) • Supporto della zona di disponibilità

Per impostazione predefinita, ogni istanza di Servizi dati di integrità di Azure, FHIR è limitata alla capacità di archiviazione di 4 TB. Per effettuare il provisioning di un'istanza FHIR con capacità di archiviazione superiore a 4 TB, creare una richiesta di supporto con tipo di problema "Limite di servizio e sottoscrizione (quote)".

Qual è la differenza tra il servizio FHIR in Servizi dati di integrità di Azure e il server FHIR open source?

Il servizio FHIR in Servizi dati di integrità di Azure è una versione ospitata e gestita del server Microsoft FHIR open source per Azure. Nel servizio gestito Microsoft fornisce tutti gli aggiornamenti e la manutenzione.

Quando si esegue il server FHIR per Azure, si ha accesso diretto ai servizi sottostanti, ma si è responsabili della gestione e dell'aggiornamento del server e di tutte le operazioni di conformità necessarie se si archiviano i dati PHI.

In quali aree è disponibile il servizio FHIR?

Il servizio FHIR è disponibile in tutte le aree disponibili in Servizi dati di integrità di Azure. È possibile vedere che nella pagina Prodotti per area .

Dove è possibile vedere cosa sta rilasciando nel servizio FHIR?

La pagina note sulla versione offre una panoramica di tutti gli elementi forniti al servizio gestito nel mese precedente.

Per vedere cosa verrà rilasciato al servizio gestito, è possibile esaminare la pagina delle versioni del server FHIR open source. Si è lavorato per contrassegnare gli elementi con Servizi dati di integrità di Azure se verranno rilasciati al servizio gestito e saranno disponibili due settimane dopo che si trovano nella pagina di versione in open source. Sono state incluse anche istruzioni su come testare la compilazione se si vuole eseguire il test nel proprio ambiente. Stiamo valutando come condividere al meglio gli aggiornamenti aggiuntivi del servizio gestito.

Per visualizzare il pacchetto di versione attualmente presente nel servizio gestito, è possibile visualizzare l'istruzione di funzionalità per il servizio FHIR e nella software.version proprietà . Verrà visualizzato il pacchetto distribuito.

Dove è possibile trovare la versione di FHIR (R4/STU3) in esecuzione nel database?

È possibile trovare la versione FHIR esatta esposta nell'istruzione capability nella fhirVersion proprietà (URL/metadati FHIR).

È possibile cambiare il servizio FHIR da STU3 a R4?

No. Non è possibile modificare la versione di un database esistente. Sarà necessario creare un nuovo servizio FHIR e ricaricare i dati. È possibile sfruttare il convertitore JSON per FHIR come punto di partenza per convertire i dati STU3 in R4.

È possibile personalizzare l'URL per il servizio FHIR?

No. Non è possibile modificare l'URL per il servizio FHIR.

Implementazioni e specifiche di FHIR

Che cos'è SMART on FHIR?

SMART (Substitutable Medical Applications and Reusable Technology) in FHIR è un set di specifiche aperte per integrare le applicazioni partner con i server FHIR e altri sistemi IT sanitari, ad esempio i record sanitari elettronici e gli scambi di informazioni sanitarie. Creando un'applicazione SMART on FHIR, è possibile assicurarsi che l'applicazione possa essere accessibile e sfruttata da una pletora di sistemi diversi. Per altre informazioni su SMART, vedere SMART Health IT.

Il servizio FHIR supporta SMART on FHIR?

Sì, la funzionalità SMART on FHIR è supportata usando esempi AHDS. Questa operazione viene definita SMART on FHIR(Enhanced). SMART on FHIR(Enhanced) può essere considerato conforme ai requisiti con SMART on FHIR Implementation Guide (v 1.0.0) e §170.315(g)(10) API standardizzata per i servizi per pazienti e popolazione. Per altre informazioni, visitare la documentazione di SMART on FHIR(Enhanced).

È possibile creare una risorsa FHIR personalizzata?

Non sono consentite risorse FHIR personalizzate. Se è necessaria una risorsa FHIR personalizzata, è possibile creare una risorsa personalizzata sopra la risorsa Basic con le estensioni.

Le estensioni sono supportate nel servizio FHIR?

È possibile caricare nel server tutti i dati JSON FHIR validi. Se si desidera archiviare la definizione della struttura che definisce l'estensione, è possibile salvarla come risorsa di definizione della struttura. Per cercare le estensioni, è necessario definire i propri parametri di ricerca.

Ricerca per categorie vedere il servizio FHIR in XML?

Nel servizio gestito è supportato solo JSON. Il server FHIR open source supporta JSON e XML. Per visualizzare la versione XML in open source, usare _format= application/fhir+xml.

Qual è il limite per _count?

Il limite corrente per _count è 1000. Se si imposta _count su più di 1000, si riceverà un avviso nel bundle che verranno visualizzati solo 1000 record.

È possibile pubblicare un bundle nel servizio FHIR?

Attualmente è supportata la registrazione di bundle batch e la registrazione di bundle di transazioni nel servizio FHIR.

Come è possibile ottenere tutte le risorse per un singolo paziente nel servizio FHIR?

Supportiamo l'operazione $patient-tutto che consente di ottenere tutti i dati correlati a un singolo paziente.

Il servizio FHIR supporta qualsiasi operazione terminologica?

No, il servizio FHIR non supporta attualmente le operazioni di terminologia.

Uso del servizio FHIR

È possibile eseguire controlli di integrità nel servizio FHIR?

Per eseguire un controllo di integrità in un servizio FHIR, immettere {{fhirurl}}/health/check nella richiesta GET. Dovrebbe essere possibile visualizzare lo stato del servizio FHIR. Risposta al codice di stato HTTP con 200 e OverallStatus come Integro in risposta significa che il controllo integro ha esito positivo.

In caso di errori, è possibile ricevere una risposta di errore con codice di stato HTTP 404 (Non trovato) o codice di stato 500 (errore interno del server) e informazioni dettagliate nel corpo della risposta.

Passaggi successivi

In questo articolo sono state apprese le risposte alle domande frequenti sul servizio FHIR. Per visualizzare le domande frequenti sul servizio FHIR nell'API di Azure per FHIR, vedere

Domande frequenti sull'API di Azure per FHIR

FHIR® è un marchio registrato di HL7 ed è usato con l'autorizzazione di HL7.