Teilen über

Versionshinweise: Azure API for FHIR

  • Artikel

Wichtig

Azure API for FHIR wird am 30. September 2026 eingestellt. Befolgen Sie die Migrationsstrategien, um bis zu diesem Datum zum Azure Health Data Services-FHIR-Dienst zu wechseln. Aufgrund der Einstellung von Azure API for FHIR werden neue Bereitstellungen ab dem 1. April 2025 nicht zugelassen. Der Azure Health Data Services-FHIR-Dienst ist die weiterentwickelte Version der Azure-API für FHIR, mit der Kundschaft FHIR-, DICOM- und Medizintechnikdienste mit Integrationen in andere Azure-Dienste verwalten kann.

Azure API for FHIR bietet eine vollständig verwaltete Bereitstellung des Microsoft FHIR-Servers für Azure. Der Server ist eine Implementierung des FHIR-Standards. Dieses Dokument enthält Details zu den Features und Erweiterungen, die an der Azure API for FHIR vorgenommen wurden.

Mai 2024

FHIR-Dienst

Verbesserungen am Bereinigungsverlaufsvorgang Der Bereinigungsverlaufsvorgang ermöglicht es Ihnen, mithilfe des Abfrageparameters 'allowPartialSuccess' ein teilweises Löschen durchzuführen. Standardmäßig wartet der Löschvorgang auf den erfolgreichen Abschluss, bevor Ressourcen gelöscht werden. Wenn jedoch während der Ausführung ein Fehler auftritt, wird das Löschen von Ressourcen zurückgesetzt. Mithilfe des Abfrageparameters "allowPartialSuccess" können Sie verhindern, dass die Transaktion im Falle eines Fehlers zurückgesetzt wird.

Fehlerbehebungen

  • Behoben: HTTP-Statuscode für lange ausgeführte Anforderungen. FHIR-Anforderungen, die länger als 100 Sekunden dauern, um einen HTTP 408-Statuscode anstelle von HTTP 500 zurückzugeben.
  • Behoben: Verlaufsanforderung im Bundle. Vor dem Fix gibt eine Verlaufsanforderung in einem Bundle den HTTP-Statuscode 404 zurück.

März 2024

Batchbundle-Parallelisierungsbatches werden standardmäßig im FHIR-Dienst serial ausgeführt. Um den Durchsatz mit Bundleaufrufen zu verbessern, haben wir die parallele Verarbeitung von Batchpaketen aktiviert.

Weitere Informationen:

Fehlerkorrekturen

  • Behoben: Verbessern der Leistung für die Bündelverarbeitung. Aktualisierungen werden an der Aufgabenausführungsmethode vorgenommen, was zu einer Leistungsverbesserung bei der Verarbeitung führt. Siehe PR#3727.

Februar 2024

Ermöglicht das Zählen aller Versionen (verlaufs- und vorläufig gelöscht) von Ressourcen . Der Abfrageparameter _summary=count und _count=0 kann _history Endpunkt hinzugefügt werden, um die Anzahl aller versionsbasierten Ressourcen abzurufen. Diese Anzahl umfasst vorläufig gelöschte Ressourcen. Weitere Informationen finden Sie unter Verlaufsverwaltung.

Verbessern Des Durchsatzes für den Exportvorgang Der Abfrageparameter "_isparallel" kann dem Exportvorgang hinzugefügt werden, um den Durchsatz zu verbessern. Es ist wichtig zu beachten, dass die Verwendung dieses Parameters zu einer Erhöhung des Verbrauchs von Anforderungseinheiten über die Lebensdauer des Exports führen kann. Weitere Informationen finden Sie unter Export operation query parameters.

Hinweis

Es gibt ein bekanntes Problem mit dem $export-Vorgang, der zu unvollständigen Exporten mit Statuserfolg führen kann. Problem tritt auf, wenn das is_parallel Flag verwendet wurde. Exportaufträge, die mit _isparallel Abfrageparameter ab dem 13. Februar 2024 ausgeführt werden, sind mit diesem Problem betroffen.

Änderung der Namensklatur für exportierten Dateinamen und Standardspeicherkonto Bei dieser Änderung folgen exportierte Dateinamen dem Format '{FHIR Resource Name}-{Number}-{Number}.ndjson'. Die Reihenfolge der Dateien ist nicht garantiert, dass sie einer Sortierung der Ressourcen in der Datenbank entspricht. Der Standardname des Speicherkontos wird auf 'Export-{Number}' aktualisiert. Es gibt keine Änderung an der Anzahl der Ressourcen, die in einzelnen exportierten Dateien hinzugefügt wurden.

Leistungsverbesserung Parallele Optimierung für FHIR-Abfragen kann mithilfe des HTTP-Headers "x-ms-query-latency-over-efficiency" aktiviert werden. Dieser Wert muss auf "true" festgelegt werden, um während der Ausführung der Abfrage eine maximale Parallelität zu erzielen. Weitere Informationen finden Sie unter Batchbundle.

Januar 2024

Die gleichzeitige Ausführung von Abfragen mit bedingten Interaktionen kann komplex und leistungsintensiv sein. Um die Latenz von Abfragen mit bedingten Interaktionen zu verbessern, haben Sie die Möglichkeit, den Anforderungsheader x-conditionalquery-processing-logic zu verwenden. Weitere Informationen finden Sie unter Leistungsüberlegungen für bedingte API-Interaktionen.

Dezember 2023

Zusätzliche Funktionen, die dem Exportvorgang $export Vorgang hinzugefügt wurden, unterstützen jetzt das Exportieren von versionsbezogenen Ressourcen und vorläufig gelöschten Ressourcen. Weitere Informationen finden Sie unter Exportieren von Abfrageparametern.

November 2023

Die Massenlöschfunktion ist jetzt in der Vorschau "$bulk löschen" verfügbar, sodass Sie Ressourcen asynchron vom FHIR-Server löschen können. Massenlöschvorgang kann auf Systemebene oder für einzelne Ressourcentypen ausgeführt werden. Weitere Informationen finden Sie unter Massenlöschvorgang.

Der Massenlöschvorgang befindet sich derzeit in der öffentlichen Vorschau. Überprüfen Sie den Haftungsausschluss für Details. [! Haftungsausschluss für öffentliche Vorschau einschließen]

Fehlerkorrektur: FHIR-Abfragen mit Paginierung und Neuzurücksicht führten zu einem Fehler bei der Verwendung des nächsten Links.

Das Problem wurde jetzt behoben, und FHIR-Abfragen mit Fortsetzungstoken mit include/revinclude melden keine Ausnahme mehr. Ausführliche Informationen zum Fix finden Sie unter #3525.

Juni 2023

Fehlerbehebung: Die Metadatenendpunkt-URL in der Funktionsanweisung ist relative URL pro FHIR-Spezifikation, Metadatenendpunkt-URL in der Funktionsanweisung muss eine absolute URL sein. Ausführliche Informationen zur FHIR-Spezifikation finden Sie in der Capability Statement. Dieses Fanix behebt das Problem, für Details besuchen 3265.

Mai 2023

SMART on FHIR : Feste klinische Bereichszuordnung für Anwendungen

Dieser Fehlerkorrektur behebt das Problem mit dem klinischen Bereich, der für Back-End-Anwendungen nicht richtig interpretiert wurde. Weitere Details finden Sie unter #3250

April 2023

Es wurden vorübergehende Probleme behoben, die mit dem Laden benutzerdefinierter Suchparameter verbunden sind. Dieser Fehler behebt das Problem, bei dem der FHIR-Dienst den neuesten SearchParameter-Status im Falle eines Fehlers nicht laden würde. Weitere Details finden Sie unter #3222

November 2022

Fehler behoben, der generiert wurde, wenn die Ressource mithilfe des If-Match-Headers und PATCH aktualisiert wird

Der Fehler wurde jetzt behoben, und Die Ressource wird aktualisiert, wenn sie mit dem Etag-Header übereinstimmt. Weitere Informationen finden Sie unter #2877|.

Mai 2022

Erweiterung

Erweiterung Verwandte Informationen
Die Azure-API für FHIR erstellt keine neue Version der Ressource, wenn sich der Ressourceninhalt nicht geändert hat. Wenn ein Benutzer eine vorhandene Ressource aktualisiert und sich nur „meta.versionId“ oder „meta.lastUpdated“ geändert hat, geben wir „OK“ zusammen mit den vorhandenen Ressourceninformationen zurück, ohne „VersionId“ und „lastUpdated“ zu aktualisieren. Weitere Informationen finden Sie unter #2519.

April 2022

Erweiterungen

Erweiterungen Verwandte Informationen
FHIRPath-Patch Ein FHIRPath-Patch wurde beiden Azure APIs for FHIR als Feature hinzugefügt. Hierdurch wird der FHIRPath-Patch, wie auf der HL7-Website definiert, implementiert.
Bündelbenachrichtigung in Core verschieben Mit der Einführung des „Resource.Bundle“-Namespaces in Core mussten die Ressourcenverweise auf die Zeichenfolgenressourcen-Datei expliziter gestaltet werden. Weitere Informationen finden Sie unter PR #2478.
Behandelt ungültigen Header bei Update mit Versionsangabe Wenn die Versionsverwaltungsrichtlinie auf „versioned-update“ festgelegt ist, wird gefordert, dass die neueste Version der Ressource im „if-match“-Header der Anforderung bei einem Update bereitgestellt wird. Die angegebene Version muss im ETag-Format sein. Zuvor wäre ein 500-Fehler zurückgegeben werden, wenn die Version ungültig oder in einem falschen Format war. Dieses Update gibt jetzt „400 – ungültige Anforderung“ zurück. Weitere Informationen finden Sie unter PR #2467.

Fehlerbehebungen

Fehlerkorrekturen Verwandte Informationen
Fügt Core zum Ressourcenpfad hinzu Ein Teil des Pfads zu einer Zeichenfolgenressource wurde versehentlich in der Versionsverwaltungsrichtlinie entfernt. Dieser Fix fügt ihn wieder hinzu. Weitere Informationen finden Sie unter PR #2470.
SQL-Timeout gibt einen 500-Fehler zurück Ein Fehler wurde behoben, bei dem die Anforderung „500“ zurückgibt, wenn bei einer SQL-Anforderung ein Timeout auftritt. In den Protokollen ist dies ein Timeout von SQL im Vergleich zum Erhalten eines 429-Fehlers vom Front-End. Weitere Informationen finden Sie unter PR #2497.

März 2022

Funktionen

Funktion Verwandte Informationen
FHIRPath-Patch Mit diesem neuen Feature können Sie den FHIRPath-Patchvorgang für FHIR-Ressourcen verwenden. Weitere Informationen finden Sie unter FHIR-REST-API-Funktionen für Azure API for FHIR.

Fehlerbehebungen

Fehlerkorrekturen Verwandte Informationen
Doppelte Ressourcen in einer Suche mit _include Es wurde ein Problem behoben, bei dem eine einzelne Ressource zweimal in einer Suche zurückgegeben werden kann, die über _include verfügt. Weitere Informationen finden Sie unter PR #2448.
PUT-Erstellungen bei Update mit Versionsangabe Es wurde ein Problem behoben, das beim Konfigurieren versioned-updateder Versionsverwaltungsrichtlinie mit PUT zu einem Fehler führte. Weitere Informationen finden Sie unter PR #2457.
Ungültige Headerbehandlung bei Update mit Versionsangabe Ein Problem wurde behoben, bei dem ein ungültiger if-match-Header zu einem „HTTP 500“-Fehler führen würde. Nun wird stattdessen ein HTTP-Fehler „Ungültige Anforderung“ zurückgegeben. Weitere Informationen finden Sie unter PR #2467.

Februar 2022

Features und Erweiterungen

Erweiterungen Verwandte Informationen
Wiederholung bei 429-Fehler und Protokollierung in BundleHandler hinzugefügt Beim Verarbeiten eines Bündels treten manchmal 429-Fehler auf. Wenn der FHIR-Dienst einen 429-Fehler auf der BundleHandler-Ebene empfängt, wird die Verarbeitung des Bündels abgebrochen, und die verbleibenden Ressourcen werden übersprungen. Wir haben eine weitere Wiederholung hinzugefügt (zusätzlich zur Wiederholung, die auf Datenspeicherebene vorhanden ist), die einmal pro Ressource ausgeführt wird, bei der ein 429-Fehler auftritt. Weitere Informationen zu dieser Featureerweiterung finden Sie unter PR #2400.
Abrechnung für $convert-data und $de-id Die Azure-API für die Datenkonvertierung und die deidentifizierten Exportfunktionen von FHIR sind jetzt allgemein verfügbar. Die Abrechnung für $convert-data- und $de-id-Vorgänge in der Azure API for FHIR wurde ermöglicht. Verbrauchseinheiten für die Abrechnung wurden am 1. März 2022 ermöglicht.

Fehlerbehebungen

Fehlerkorrekturen Verwandte Informationen
Index der Depotsuche aktualisieren Es gab einen Grenzfall (Corner Case), bei dem der Depotsuchindex für Ressourcen nicht festgelegt wurde. Wir verwenden jetzt denselben Index wie die Hauptsuche für die Depotsuche, um sicherzustellen, dass alle Daten zurückgegeben werden. Weitere Informationen zu dem Codefix finden Sie unter PR #2430.

Dezember 2021

Features und Erweiterungen

Erweiterungen Verwandte Informationen
Herausgeber zu CapabiilityStatement.name hinzugefügt Sie finden den Herausgeber jetzt in der Funktionsbestätigung unter CapabilityStatement.name. #2319
Protokollieren von FhirOperation, der mit anonymen Aufrufen von Anforderungsmetriken verknüpft ist Wir haben Vorgänge nicht protokolliert, für die keine Authentifizierung erforderlich war. Wir haben die Möglichkeit zum Abrufen des FhirOperation-Typs in RequestMetrics für anonyme Aufrufe erweitert. #2295

Fehlerbehebungen

Fehlerkorrekturen Verwandte Informationen
500-Fehler behoben, wenn der SearchParameter-Code Null ist Es wurde ein Problem mit SearchParameter behoben, bei dem das Ergebnis ein 500-Fehler war, wenn der Code einen Nullwert hatte. Dies führt nun zu einer InvalidResourceException ähnlichen Vorgehensweise wie die anderen Werte. #2343
Rückgabe von BadRequestException mit einer gültigen Meldung, wenn der JSON-Eingabetext ungültig ist Bei ungültigen Anforderungen von JSON-Text gibt der FHIR-Server einen 500-Fehler zurück. Jetzt geben wir eine BadRequestException zusammen mit einer gültigen Meldung anstelle von 500 zurück. #2239
_sort kann dazu führen, dass ChainedSearch falsche Ergebnisse zurückgibt. Zuvor wurden die Sortieroptionen aus dem SearchOption-Objekt der verketteten Suche nicht gelöscht, wodurch die Sortieroptionen an die verkettete Untersuche übergeben werden, wo sie ungültig sind. Dies könnte dazu führen, dass keine Ergebnisse zurückgegeben werden, obwohl Ergebnisse vorhanden sein sollten. Dieser Fehler wurde jetzt behoben, #2347. GitHub-Fehler #2344 wird behoben.

November 2021

Features und Erweiterungen

Erweiterungen Verwandte Informationen
„Patient-everything“-Links verarbeiten Wir haben die „Patient-everything“-Funktionen so " erweitert, dass Patientenlinks verarbeitet werden, #2305. Weitere Informationen finden Sie unter „Patient-everything“ in der FHIR-Dokumentation.
Softwarename und Version wurden der Funktionsbestätigung hinzugefügt In der Funktionsbestätigung wird nun im Softwarenamen unterschieden, ob Sie Azure API for FHIR oder Azure Health Data Services verwenden. In der Softwareversion wird jetzt angegeben, welches Open-Source-Releasepaket in dem verwalteten Dienst live ist, #2294. Behebt: #1778 und #2241.
500-Fehler in RequestMetric protokollieren Zuvor wurden 500-Fehler oder alle unbekannten/unbehandelten Fehler nicht in RequestMetric protokolliert. Jetzt werden sie protokolliert, #2240. Weitere Informationen finden Sie unter Aktivieren von Diagnoseeinstellungen in Azure API for FHIR.
Fortsetzungstoken komprimieren In bestimmten Fällen war das Fortsetzungstoken zu lang, um dem nächsten Link in Suchvorgängen folgen zu können, und hätte zu einem 404-Fehler geführt. Um dies zu beheben, haben wir das Fortsetzungstoken komprimiert, um sicherzustellen, dass es unter dem Größenlimit bleibt, #2279. Behebt das Problem #2250.

Fehlerbehebungen

Fehlerkorrekturen Verwandte Informationen
500-Fehler bei Übergabe des Datums mit einer Zeitzone behoben. Dadurch wird ein 500-Fehler behoben, wenn ein Datum mit einer Zeitzone in ein datetime-Feld übergeben wurde, #2270.
Ein Problem wurde behoben, bei dem beim Bereitstellen eines Bündels mit falschem Medientyp ein 500-Fehler zurückgegeben wurde. Zuvor wurde beim Bereitstellen einer Suche mit einem Schlüssel, der bestimmte Zeichen enthält, ein 500-Fehler zurückgegeben. Dies behebt dieses Problem #2264 sowie das Problem #2148.

Oktober 2021

Fehlerbehebungen

Endlosschleifenfehler Verwandte Informationen
Hat das Problem behoben, bei dem bedingtes Löschen zu einer Endlosschleife führen konnte. #2269

September 2021

Features und Erweiterungen

Erweiterungen Verwandte Informationen
Unterstützung für bedingten Patch hinzugefügt Bedingter Patch
Bedingter Patch #2163
Überwachungsereignis für bedingten Patch hinzugefügt. #2213
JSON-Patch in Bündeln zulassen JSON-Patch in Bündeln
Lässt Suchverlaufsbündel mit Patchanforderungen zu. #2156
JSON-Patch in Bündeln, die Binärressourcen verwenden, wurde ermöglicht. #2143
Neue Untertypen von Überwachungsereignissen Verwandte Informationen
Neue OperationName-Untertypen der Überwachung hinzugefügt. #2170
Verbesserungen bei der Neuindizierung Verwandte Informationen
Grenzwerte für Neuindizierungsparameter (reindex) hinzugefügt. #2103
Aktualisieren der Fehlermeldung für Grenzwerte von Neuindizierungsparametern. #2109
Überprüfung der endgültigen Neuindizierungsanzahl wurde hinzugefügt. #2099

Fehlerbehebungen

Fehlerkorrekturen Verwandte Informationen
Breiteres Abfangen für Ausnahmen beim Anwenden eines Patchs. #2192
Behebt den Verlauf mit PATCH in STU3. #2177
Fehler bei der benutzerdefinierten Suche Verwandte Informationen
Behebt Fehler mit den benutzerdefinierten Suchparametern. #2133
Wiederholungslogik beim Löschen des Suchparameters hinzugefügt. #2121
Maximale Elementanzahl in Suchoptionen in SearchParameterDefinitionManager festlegen. #2141
Bietet eine bessere Ausnahme, wenn ein ungültiger Ausdruck im Suchparameter vorhanden ist. #2157
503-Fehler beim Wiederholen behoben Verwandte Informationen
503-Fehler beim von Azure Cosmos DB. #2106
Behebt die Verarbeitung von 429-Fehlern aus StoreProcedures. #2165
Geschlossene GitHub-Probleme Verwandte Informationen
Benutzerdefinierter Suchparameter für das CarePlan-Medizingerät kann nicht erstellt werden. #2146
Unklare Fehlermeldung für bedingtes Erstellen ohne ID. #2168

IoT-Connector für FHIR (Vorschau)

Fehlerkorrekturen Verwandte Informationen
Fehlerhafter Link behoben. Link zur Azure-Dokumentation für den IoT-Connector im Azure API for FHIR-Portal aktualisiert.

Nächste Schritte

Informationen zu den Features und Fehlerkorrekturen in Azure Health Data Services (FHIR-Dienst, DICOM-Dienst und Medizintechnikdienst) finden Sie unter

Versionshinweise: Azure Health Data Services.

FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.