Condividi tramite

Note sulla versione: API di Azure per 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 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.

L'API di Azure per FHIR® offre una distribuzione completamente gestita del server Microsoft FHIR per Azure. Il server è un'implementazione dello standard FHIR . Questo documento fornisce informazioni dettagliate sulle funzionalità e i miglioramenti apportati all'API di Azure per FHIR.

Ottobre 2024

Servizio FHIR

Correzioni di bug

  • Convalida dell'esportazione: è stato identificato un problema per cui le esportazioni sono state eseguite nonostante i parametri di ricerca non validi. Stiamo introducendo una modifica che impedisce le esportazioni in queste condizioni. Questa funzionalità è attualmente dietro un flag di convalida rigoroso e diventerà il comportamento predefinito il 30 ottobre o dopo il 30 ottobre.
  • Inclusione di parametri di ricerca: è stato risolto un problema per cui altri parametri di ricerca (ad esempio, _include, _has) non restituivano tutti i risultati previsti, a volte omettendo il collegamento successivo.
  • Esportazione dell'esecuzione del processo: una rara occorrenza di System.ObjectDisposedException durante il completamento del processo di esportazione è stata risolta impedendo le uscite premature.
  • Aggiornamento del codice di stato HTTP: il codice di stato HTTP per i parametri non validi durante $reindex la creazione del processo viene ora aggiornato a 400, garantendo una migliore gestione degli errori.
  • Pulizia dei parametri di ricerca: è stata implementata una correzione per garantire la pulizia completa dei parametri di ricerca nel database quando viene attivata con chiamate API di eliminazione, risolvendo i problemi relativi alle eliminazioni incomplete.

Agosto 2024

Servizio FHIR

Correzioni di bug È stata implementata una correzione per risolvere i problemi relativi alle esportazioni di grandi dimensioni che visualizzano erroneamente uno stato "completato" mentre le attività figlio sono ancora in elaborazione. La soluzione incorpora un ritardo per attenuare l'occorrenza di questi errori di stato, migliorando l'affidabilità dell'esportazione.

Luglio 2024

Servizio FHIR

Correzioni di bug

Correzione: l'esportazione dei dati come smart user export data as a SMART user non richiede più ambiti di scrittura. In precedenza, era necessario concedere privilegi di "scrittura" a un utente SMART per l'esportazione dei dati, che implicavano livelli di privilegi più elevati. Per avviare un processo di esportazione come utente SMART, assicurarsi che l'utente sia membro del ruolo di esportazione FHIR nel controllo degli accessi in base al ruolo e richieda l'ambito clinico SMART "read".

Correzione: aggiornamento del codice di stato da HTTP 500 a HTTP 400 Durante un'operazione di patch, se il payload ha richiesto un aggiornamento per un tipo di risorsa diverso da Parameter, inizialmente è stato generato un errore interno del server (HTTP 500). È stato aggiornato per generare invece un errore HTTP 400.

Maggio 2024

Servizio FHIR

Miglioramenti all'operazione di ripulitura della cronologia L'operazione di ripulitura della cronologia consente di eseguire un'eliminazione parziale usando il parametro di query 'allowPartialSuccess'. Per impostazione predefinita, l'operazione di eliminazione della cronologia attende il completamento corretto prima di eliminare le risorse. Tuttavia, se si verifica un errore durante l'esecuzione, viene eseguito il rollback dell'eliminazione delle risorse. Usando il parametro di query 'allowPartialSuccess', è possibile impedire il rollback della transazione in caso di errore.

Correzioni di bug

  • Correzione: codice di stato HTTP per le richieste con esecuzione prolungata. Le richieste FHIR che richiedono più di 100 secondi per l'esecuzione restituiscono un codice di stato HTTP 408 anziché HTTP 500.
  • Correzione: richiesta di cronologia nel bundle. Prima della correzione, una richiesta di cronologia in un bundle restituiva il codice di stato HTTP 404.

Marzo 2024

Per impostazione predefinita, i bundle batch di parallelizzazione batch vengono eseguiti in modo seriale nel servizio FHIR. Per migliorare la velocità effettiva con le chiamate bundle, è stata abilitata l'elaborazione parallela dei bundle batch.

Altre informazioni:

Correzioni di bug

  • Correzione: migliorare le prestazioni per l'elaborazione del bundle. Gli aggiornamenti vengono eseguiti nel metodo di esecuzione dell'attività, con conseguente miglioramento delle prestazioni di elaborazione del bundle. Vedere PR#3727.

Febbraio 2024

Abilita il conteggio di tutte le versioni (cronologia e eliminazione temporanea) delle risorse Il parametro di query _summary=count e _count=0 può essere aggiunto a _history endpoint per ottenere il conteggio di tutte le risorse con controllo delle versioni. Questo conteggio include risorse eliminate soft. Per altre informazioni, vedere Gestione della cronologia.

Migliorare la velocità effettiva per l'operazione di esportazione Il parametro di query "_isparallel" può essere aggiunto all'operazione di esportazione per migliorare la velocità effettiva. È importante notare che l'uso di questo parametro può comportare un aumento del consumo di unità richiesta nel corso della durata dell'esportazione. Per altre informazioni, vedere Esportare i parametri di query dell'operazione.

Nota

Si è verificato un problema noto con l'operazione di $export che potrebbe causare esportazioni incomplete con esito positivo dello stato. Il problema si verifica quando è stato usato il flag is_parallel. I processi di esportazione eseguiti con _isparallel parametro di query a partire dal 13 febbraio 2024 sono interessati da questo problema.

Modificare la classificazione dei nomi per il nome del file esportato e l'account di archiviazione predefinito Con questa modifica, i nomi di file esportati seguono il formato '{Nome risorsa FHIR}-{Number}.ndjson'. L'ordine dei file non è garantito che corrisponda ad alcun ordinamento delle risorse nel database. Il nome dell'account di archiviazione predefinito viene aggiornato a 'Export-{Number}'. Non viene apportata alcuna modifica al numero di risorse aggiunte nei singoli file esportati.

L'ottimizzazione parallela del miglioramento delle prestazioni per le query FHIR può essere abilitata usando l'intestazione HTTP "x-ms-query-latency-over-efficiency". Questo valore deve essere impostato su true per ottenere la concorrenza massima durante l'esecuzione della query. Per altre informazioni, vedere Aggregazioni batch.

Gennaio 2024

L'esecuzione simultanea di query con interazioni condizionali Le interazioni condizionali possono essere complesse e a elevato utilizzo di prestazioni. Per migliorare la latenza delle query che coinvolgono interazioni condizionali, è possibile usare l'intestazione della richiesta x-conditionalquery-processing-logic. Per altre informazioni, vedere Considerazioni sulle prestazioni per le interazioni api condizionali.

Dicembre 2023

Le funzionalità aggiuntive aggiunte all'operazione di esportazione $export ora supportano l'esportazione di risorse con controllo delle versioni e risorse eliminate soft. Per altre informazioni, vedere Esportare i parametri di query.

Novembre 2023

La funzionalità di eliminazione in blocco ora disponibile in anteprima '$bulk-delete' consente di eliminare le risorse dal server FHIR in modo asincrono. L'operazione di eliminazione bulk può essere eseguita a livello di sistema o per un singolo tipo di risorsa. Per altre informazioni, vedere Operazione di eliminazione bulk.

L'operazione di eliminazione bulk è attualmente in anteprima pubblica. Per informazioni dettagliate, vedere la dichiarazione di non responsabilità. [! INCLUDI dichiarazione di non responsabilità per l'anteprima pubblica]

Correzione di bug: le query FHIR che usano la paginazione e revinclude hanno generato un errore durante l'uso del collegamento successivo

Il problema viene ora risolto e le query FHIR che usano il token di continuazione con inclusione/rivinclude, non segnalano più un'eccezione. Per informazioni dettagliate sulla correzione, vedere #3525.

Giugno 2023

Correzione di bug: l'URL dell'endpoint dei metadati nell'istruzione capability è relativo alla specifica URL per FHIR, l'URL dell'endpoint dei metadati nell'istruzione capability deve essere un URL assoluto. Per informazioni dettagliate sulla specifica FHIR, visitare l'istruzione Capability. Questo fanix risolve il problema, per informazioni dettagliate visita 3265.

magg. 2023

SMART on FHIR: mapping dell'ambito clinico fisso per le applicazioni

Questa correzione di bug risolve il problema relativo all'ambito clinico non interpretato correttamente per le applicazioni back-end. Per altri dettagli, vedere #3250

Aprile 2023

Correzione di problemi temporanei associati al caricamento dei parametri di ricerca personalizzati Questo bug risolve il problema, in cui il servizio FHIR non carica lo stato searchParameter più recente in caso di errore. Per altri dettagli, vedere #3222

Novembre 2022

Correzione dell'errore generato quando la risorsa viene aggiornata usando l'intestazione if-match e PATCH

Il bug è stato corretto e la risorsa verrà aggiornata se corrisponde all'intestazione Etag. Per informazioni dettagliate, vedere #2877|.

Maggio 2022

Miglioramento

Funzionalità avanzata Informazioni correlate
L'API di Azure per FHIR non crea una nuova versione della risorsa se il contenuto della risorsa non è stato modificato. Se un utente aggiorna una risorsa esistente e solo meta.versionId o meta.lastUpdated è stato modificato, viene restituito OK con le informazioni sulle risorse esistenti senza aggiornare VersionId e lastUpdated. Per altre informazioni, vedere #2519.

Aprile 2022

Miglioramenti

Miglioramenti Informazioni correlate
FHIRPath Patch FHIRPath Patch è stata aggiunta come funzionalità a entrambe le API di Azure per FHIR. Ciò implementa FHIRPath Patch come definito nel sito Web HL7 .
Spostare la notifica bundle in Core Con l'introduzione dello spazio dei nomi Resource.Bundle a Core, i riferimenti alle risorse della risorsa al file di risorse stringa devono essere resi più espliciti. Per altre informazioni, vedere richiesta pull #2478.
Gestisce l'intestazione non valida nell'aggiornamento con versione Quando i criteri di controllo delle versioni sono impostati su "versioned-update", è necessario che la versione più recente della risorsa venga fornita nell'intestazione if-match della richiesta in un aggiornamento. La versione specificata deve essere in formato ETag. In precedenza, verrebbe restituito un valore 500 se la versione non è valida o in un formato non corretto. Questo aggiornamento restituisce ora una richiesta non valida 400. Per altre informazioni, vedere RICHIESTA pull #2467.

Correzioni di bug

Correzioni di bug Informazioni correlate
Aggiunge core al percorso della risorsa Parte del percorso di una risorsa stringa è stata rimossa accidentalmente nei criteri di controllo delle versioni. Questa correzione lo aggiunge di nuovo. Per altre informazioni, vedere RICHIESTA pull #2470.
Il timeout di SQL restituisce un errore 500 Correzione di un bug quando una richiesta SQL raggiunge un timeout e la richiesta restituisce 500. Nei log si tratta di un timeout di SQL rispetto al recupero di un errore 429 dal front-end. Per altre informazioni, vedere Richiesta pull n. 2497.

Marzo 2022

Funzionalità

Funzionalità Informazioni correlate
FHIRPath Patch Questa nuova funzionalità consente di usare l'operazione FHIRPath Patch sulle risorse FHIR. Per altre informazioni, vedere Funzionalità dell'API REST FHIR per l'API di Azure per FHIR.

Correzioni di bug

Correzioni di bug Informazioni correlate
Duplicare le risorse nella ricerca con _include È stato risolto un problema per cui una singola risorsa può essere restituita due volte in una ricerca con _include. Per altre informazioni, vedere RICHIESTA pull n. 2448.
PUT crea in caso di aggiornamento con controllo delle versioni Problema risolto: la creazione con PUT generava un errore quando il criterio di controllo delle versioni è configurato su versioned-update. Per altre informazioni, vedere RICHIESTA pull n. 2457.
Gestione dell'intestazione non valida nell'aggiornamento con controllo delle versioni È stato risolto un problema per cui l'intestazione non valida if-match generava un errore HTTP 500. Viene ora restituita una richiesta HTTP non valida. Per altre informazioni, vedere RICHIESTA pull #2467.

Febbraio 2022

Funzionalità e miglioramenti

Miglioramenti Informazioni correlate
Aggiunta di 429 tentativi e registrazione in BundleHandler Talvolta si verificano errori 429 durante l'elaborazione di un bundle. Se il servizio FHIR riceve un valore 429 a livello BundleHandler, l'elaborazione del bundle viene interrotta e le risorse rimanenti vengono ignorate. È stato aggiunto un altro tentativo (oltre al nuovo tentativo presente nel livello dell'archivio dati) che verrà eseguito una volta per risorsa che rileva un valore 429. Per altre informazioni su questo miglioramento della funzionalità, vedere Richiesta pull #2400.
Fatturazione per $convert-data e $de-id L'API di Azure per la conversione dei dati di FHIR e le funzionalità di esportazione de-identificate sono ora disponibili a livello generale. La fatturazione per $convert-data le operazioni e $de-id nell'API di Azure per FHIR è stata abilitata. I contatori di fatturazione sono stati attivati il 1° marzo 2022.

Correzioni di bug

Correzioni di bug Informazioni correlate
Aggiornare l'indice di ricerca raggruppamento Si è verificato un caso di angolo in cui l'indice di ricerca raggruppamento non è stato impostato sulle risorse. A questo punto si usa lo stesso indice della ricerca principale per la ricerca raggruppamento per assicurarsi che vengano restituiti tutti i dati. Per altre informazioni sulla correzione del codice, vedere richiesta pull #2430.

Dicembre 2021

Funzionalità e miglioramenti

Miglioramenti Informazioni correlate
Aggiunta del server di pubblicazione a CapabiilityStatement.name È ora possibile trovare l'autore nell'istruzione capability all'indirizzo CapabilityStatement.name. #2319
Registrare FhirOperation le chiamate anonime alle metriche di richiesta Non erano state registrate operazioni che non richiedevano l'autenticazione. È stata estesa la possibilità di ottenere FhirOperation il tipo in RequestMetrics per le chiamate anonime. #2295

Correzioni di bug

Correzioni di bug Informazioni correlate
Correzione dell'errore 500 quando SearchParameter Code è null È stato risolto un problema con SearchParameter se fosse un valore Null per Code, il risultato sarebbe 500. Ora genera un risultato InvalidResourceException simile agli altri valori. #2343
Restituito BadRequestException con messaggio valido quando il corpo JSON di input non è valido Per le richieste di corpo JSON non valide, il server FHIR ha restituito un errore 500. Viene ora restituito un oggetto BadRequestException con un messaggio valido anziché 500. #2239
_sort può causare ChainedSearch la restituzione di risultati non corretti In precedenza, le opzioni di ordinamento dell'oggetto della SearchOption ricerca concatenato non erano cancellate, causando il passaggio delle opzioni di ordinamento alla sottosearch concatenato, che non sono valide. Questo potrebbe non produrre risultati quando dovrebbero essere presenti risultati. Questo bug è stato risolto #2347. È stato risolto il bug gitHub n. 2344.

Novembre 2021

Funzionalità e miglioramenti

Miglioramenti Informazioni correlate
Elaborare i collegamenti Patient-everything Sono state estese le funzionalità patient-everything per elaborare i collegamenti ai pazienti #2305. Per altre informazioni, vedere La documentazione di Patient-everything (Paziente-everything) nella documentazione di FHIR .
Aggiunta del nome software e della versione all'istruzione capability Nell'istruzione capability il nome software ora distingue se si usa l'API di Azure per FHIR o Azure Health Data Services. La versione del software ora specifica il pacchetto di versione open source attivo nel servizio gestito #2294. Indirizzi: #1778 e #2241
Log da 500 a RequestMetric In precedenza, 500 o eventuali errori sconosciuti/non gestiti non venivano registrati in RequestMetric. Ora vengono registrati #2240. Per altre informazioni, vedere Abilitare le impostazioni di diagnostica nell'API di Azure per FHIR
Comprimere i token di continuazione In alcuni casi, il token di continuazione era troppo lungo per poter seguire il collegamento successivo nelle ricerche e produrrebbe un risultato 404. Per risolvere questo problema, il token di continuazione è stato compresso per assicurarsi che rimanga al di sotto del limite di dimensioni #2279. Risolve il problema 2250.

Correzioni di bug

Correzioni di bug Informazioni correlate
È stato risolto l'errore 500 quando la data è stata passata con un fuso orario. Questo consente di correggere un errore 500 quando una data con un fuso orario è stata passata in un campo datetime #2270.
Problema risolto quando si pubblica un bundle con tipo di supporto non corretto, è stato restituito un errore 500. In precedenza, durante la pubblicazione di una ricerca con una chiave contenente determinati caratteri, veniva restituito un errore 500. Questo problema viene risolto #2264 e risolve il problema 2148.

Ottobre 2021

Correzioni di bug

Bug ciclo infinito Informazioni correlate
È stato risolto un problema per cui l'eliminazione condizionale poteva causare un ciclo infinito. #2269

Settembre 2021

Funzionalità e miglioramenti

Miglioramenti Informazioni correlate
Aggiunta del supporto per la patch condizionale Patch condizionale
Patch condizionale #2163
Aggiunta dell'evento di controllo delle patch condizionale. #2213
Consenti patch JSON nei bundle Patch JSON nei bundle
Consente di creare bundle della cronologia di ricerca con richieste patch. #2156
Patch JSON abilitata nei bundle con risorse binarie. #2143
Nuovi sottotipi di evento di controllo Informazioni correlate
Aggiunta di nuovi sottotipi OperationName di controllo. #2170
Miglioramenti della reindicizzazione Informazioni correlate
Aggiunta dei limiti per i parametri di reindicizzazione . #2103
Aggiornare il messaggio di errore per i limiti dei parametri reindicizzazione. #2109
Aggiunta del controllo del conteggio dei reindicizzazione finale. #2099

Correzioni di bug

Correzioni di bug Informazioni correlate
Catch più ampio per le eccezioni durante l'applicazione di patch. #2192
Corregge la cronologia con PATCH in STU3. #2177
Bug di ricerca personalizzati Informazioni correlate
Risolve l'errore con i parametri di ricerca personalizzati. #2133
Aggiunta della logica di ripetizione dei tentativi durante l'eliminazione del parametro di ricerca. #2121
Impostare il numero massimo di elementi nelle opzioni di ricerca in SearchParameterDefinitionManager. #2141
Fornisce un'eccezione migliore se è presente un'espressione non valida nel parametro di ricerca. #2157
Errore di ripetizione dei tentativi 503 risolto Informazioni correlate
Ripetere l'errore 503 da Azure Cosmos DB. #2106
Correzione dell'elaborazione 429s da StoreProcedures. #2165
Problemi di GitHub chiusi Informazioni correlate
Impossibile creare un parametro di ricerca personalizzato per il dispositivo medico CarePlan. #2146
Messaggio di errore non chiaro per la creazione condizionale senza ID. #2168

Connettore IoT per FHIR (anteprima)

Correzioni di bug Informazioni correlate
Correzione del collegamento interrotto. Collegamento aggiornato alla documentazione di Azure del connettore IoT nel portale dell'API di Azure per FHIR.

Passaggi successivi

Per informazioni sulle funzionalità e sulle correzioni di bug in Servizi dati di integrità di Azure (servizio FHIR, servizio DICOM e servizio MedTech), vedere

Note sulla versione: Servizi dati di integrità di Azure

Nota

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