Condividi tramite

Domande frequenti sul servizio FHIR

  • Articolo

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 dati di integrità 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 dati di Integrità 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 è supportato come provider di identità.

È 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. Il servizio FHIR di Servizi dati integrità di Azure supporta funzionalità aggiuntive, ad esempio:

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.

Qual è l'ordinamento predefinito durante la ricerca di risorse nel servizio FHIR?

È supportato l'ordinamento in base ai campi stringa e dateTime nel servizio FHIR. Per altre informazioni sugli altri parametri di ricerca supportati, vedere Panoramica della ricerca FHIR.

Il servizio FHIR supporta qualsiasi operazione terminologica?

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

Quali sono le differenze tra i tipi di eliminazione nel servizio FHIR?

Nel servizio FHIR sono supportati due tipi delete di base. Sono Elimina ed Elimina condizionale.

  • Con Elimina è possibile scegliere di eseguire un'eliminazione temporanea (tipo più comune) e di recuperare le versioni cronologie del record.
  • Con l'eliminazione condizionale è possibile passare i criteri di ricerca per eliminare una risorsa uno alla volta o più alla volta.
  • Se è stato passato il hardDelete parametro con Delete o Conditional Delete, tutti i record e la cronologia vengono eliminati e irreversibili.

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 e viene usato con l'autorizzazione di HL7.