Häufig gestellte Fragen zum FHIR-Dienst

Wichtig

Azure API for FHIR wird am 30. September 2026 eingestellt. Folgen Sie den 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.

In diesem Abschnitt werden einige der häufig gestellten Fragen zum Azure Health Data Services-FHIR-Dienst® behandelt.

FHIR-Service: Die Grundlagen

Was ist FHIR?

Die Fast Healthcare Interoperability Resources (FHIR) ist ein Interoperabilitätsstandard, der den Austausch von Gesundheitsdaten zwischen verschiedenen Gesundheitssystemen ermöglicht. Dieser Standard wurde von der HL7-Organisation entwickelt und wird von Gesundheitsorganisationen auf der ganzen Welt übernommen. Die aktuelle Version von FHIR ist R4 (Release 4). Der FHIR-Dienst unterstützt R4 und die vorherige Version STU3 (Standard for Trial Use 3). Weitere Informationen zu FHIR finden Sie auf HL7.org.

Werden die Daten hinter den FHIR-APIs in Azure gespeichert?

Ja. Die Daten werden in verwalteten Datenbanken in Azure gespeichert. Der FHIR-Dienst in Azure Health Data Services bietet keinen direkten Zugriff auf den zugrunde liegenden Datenspeicher.

Wie erhalte ich Zugriff auf die zugrunde liegenden Daten?

Im verwalteten Dienst können Sie nicht auf die zugrunde liegenden Daten zugreifen. Dies ist die Sicherstellung, dass der FHIR-Dienst die Datenschutz- und Compliance-Zertifizierungen bietet, die für Gesundheitsdaten erforderlich sind. Wenn Sie Zugriff auf die zugrunde liegenden Daten benötigen, können Sie den Open-Source-FHIR-Server verwenden.

Welcher Identitätsanbieter wird unterstützt?

Wir unterstützen Microsoft Entra ID und Identitätsanbieter von Drittanbietern, die OpenID Connect unterstützen.

Kann ich Azure AD B2C mit dem FHIR-Dienst verwenden?

Ja. Sie können Azure Active Directory B2C (Azure AD B2C) mit dem FHIR-Dienst verwenden, um Zugriff auf Ihre Anwendungen und Benutzer zu gewähren. Weitere Informationen finden Sie unter Verwenden von Azure Active Directory B2C, um Zugriff auf den FHIR-Dienst zu gewähren.

Welche FHIR-Version wird unterstützt?

Wir unterstützen die Versionen 4.0.0 und 3.0.1.

Weitere Informationen finden Sie unter Unterstützte FHIR-Features. Informationen zu den Änderungen zwischen FHIR-Versionen (zwischen STU3 und R4) finden Sie auch im Versionsverlauf für HL7 FHIR.

Was ist der Unterschied zwischen der Azure-API für FHIR und dem FHIR-Dienst in azure Health Data Services?

Die Azure-API für FHIR war unser erstes allgemein verfügbares Produkt und wird ab dem 30. September 2026 eingestellt. In der folgenden Tabelle werden die Unterschiede zwischen der Azure-API für FHIR und Azure Health Data Services, dem FHIR-Dienst, beschrieben.

Capabilities	Azure API for FHIR	Azure Health Data Services
Dateneingang	In OSS verfügbare Tools	$import Vorgang. Informationen finden Sie unter Importvorgang
Automatische Skalierung	Wird auf Anfrage unterstützt, Gebühren fallen an	Automatische Skalierung ist standardmäßig ohne Aufpreis aktiviert
Suchparameter	Unterstützter Pakettyp: Batch • Include und revinclude, Iterieren des Modifizierers nicht unterstützt • Sortierung unterstützt durch Vorname, Nachname, Geburtsdatum und klinisches Datum	Unterstützter Pakettyp: Batch und Transaktion • Auswählbare Suchparameter • Include, revinclude und Iterieren des Modifizierers wird unterstützt • Sortierung wird von Zeichenfolgen- und dateTime-Feldern unterstützt
Ereignisse	Nicht unterstützt	Unterstützt
Konvertieren von Daten	Unterstützt das Aktivieren von "vertrauenswürdige Dienste zulassen" in der Kontocontainerregistrierung	Es gibt ein bekanntes Problem: Das Aktivieren eines privaten Links mit der Azure-Containerregistrierung kann zu Zugriffsproblemen führen, wenn Sie versuchen, die Containerregistrierung vom FHIR-Dienst zu verwenden.
Geschäftskontinuität	Unterstützt: • Regionsübergreifende Notfallwiederherstellung (DR)	Unterstützt: • Zeitpunktwiederherstellung (Point-in-Time-Recovery, PITR) • Unterstützung von Verfügbarkeitszonen

Standardmäßig ist jede Azure Health Data Services-Instanz auf die Speicherkapazität von 4 TB beschränkt. Um eine FHIR-Instanz mit Speicherkapazität außerhalb von 4 TB bereitzustellen, erstellen Sie eine Supportanfrage mit dem Problemtyp "Service- und Abonnementlimit (Kontingente)".

Was ist der Unterschied zwischen dem FHIR-Dienst in Azure Health Data Services und dem Open-Source-FHIR-Server?

Der FHIR-Dienst in Azure Health Data Services ist eine gehostete und verwaltete Version des Open-Source-Microsoft FHIR-Servers für Azure. Im verwalteten Dienst stellt Microsoft die gesamte Wartung und alle Updates zur Verfügung.

Bei Verwendung des FHIR-Servers für Azure haben Sie direkten Zugriff auf die zugrunde liegenden Dienste, aber wir sind für die Wartung und Aktualisierung des Servers sowie für alle erforderlichen Complianceaufgaben zuständig, wenn Sie PHI-Daten speichern.

In welchen Regionen ist der FHIR-Dienst verfügbar?

Der FHIR-Dienst ist in allen Regionen verfügbar, in denen Azure Health Data Services verfügbar ist. Auf der Seite " Produkte nach Region " werden unterstützte Regionen angezeigt.

Wo kann ich sehen, was im FHIR-Dienst veröffentlicht wird?

Auf der Seite Versionshinweise finden Sie eine Übersicht über alles, was im vorherigen Monat an den verwalteten Dienst geliefert wurde.

Um zu sehen, was für den verwalteten Dienst veröffentlicht wird, können Sie die Seite "Releases" des Open-Source-FHIR-Servers überprüfen. Wir haben daran gearbeitet, Elemente mit Azure Health Data Services zu kategorisieren, wenn sie für den verwalteten Dienst freigegeben werden und zwei Wochen nach ihrer Bereitstellung auf der Open Source-Versionsseite verfügbar sind. Außerdem haben wir Anweisungen zum Testen des Builds enthalten, wenn Sie in Ihrer eigenen Umgebung testen möchten. Wir bewerten, wie sie am besten zusätzliche verwaltete Dienstupdates freigeben.

Um zu sehen, welches Releasepaket derzeit im verwalteten Dienst enthalten ist, können Sie die Funktionsdeklaration für den FHIR-Dienst und unter der software.version Eigenschaft anzeigen. Es wird angezeigt, welches Paket bereitgestellt ist.

Wo finde ich, welche Version von FHIR (R4/STU3) in meiner Datenbank ausgeführt wird?

Die genaue FHIR-Version, die in der Funktionsanweisung unter der fhirVersion Eigenschaft (FHIR URL/Metadata) verfügbar gemacht wird, finden Sie.

Kann ich meinen FHIR-Dienst von STU3 zu R4 wechseln?

Nein Wir haben keine Möglichkeit, die Version einer vorhandenen Datenbank zu ändern. Sie müssen einen neuen FHIR-Dienst erstellen und die Daten neu laden. Sie können den JSON-zu-FHIR-Konverter als Ausgangspunkt nutzen, um mit der Konvertierung von STU3-Daten in R4 zu beginnen.

Kann ich die URL für meinen FHIR-Dienst anpassen?

Nein Sie können die URL für den FHIR-Dienst nicht ändern.

Welche Grenzwerte gelten für den FHIR-Dienst in Azure Health Data Services?

Weitere Informationen finden Sie im Abschnitt "Dienstbeschränkungen" in Azure FHIR-Dienstbeschränkungen.

FHIR-Implementierungen and -Spezifikationen

Was ist SMART on FHIR?

Bei SMART (Substitutable Medical Applications and Reusable Technology) on FHIR handelt es sich um eine Reihe offener Spezifikationen für die Integration von Partneranwendungen in FHIR-Server und andere IT-Systeme im Gesundheitswesen, wie elektronische Patientenakten und den Austausch von Gesundheitsinformationen. Durch die Erstellung einer SMART on FHIR-Anwendung können Sie sicherstellen, dass Ihre Anwendung von vielen verschiedenen Systemen aufgerufen und verwendet werden kann. Weitere Informationen zu SMART finden Sie unter SMART Health IT.

Unterstützt der FHIR-Dienst SMART auf FHIR?

Ja, SMART on FHIR-Funktion wird mit AHDS-Beispielen unterstützt. Dies wird als SMART on FHIR(Enhanced) bezeichnet. SMART on FHIR (erweitert) kann als Erfüllung der Anforderungen des SMART on FHIR-Implementierungsleitfaden (v 1.0.0) und des Kriteriums „§170.315(g)(10) Standardized API for patient and population services“ angesehen werden. Weitere Informationen finden Sie in der SMART on FHIR(Enhanced) Documentation.

Kann ich eine benutzerdefinierte FHIR-Ressource erstellen?

Benutzerdefinierte FHIR-Ressourcen werden nicht zugelassen. Wenn Sie eine benutzerdefinierte FHIR-Ressource benötigen, können Sie eine benutzerdefinierte Ressource auf Grundlage der Basisressource mit Erweiterungen erstellen.

Werden Erweiterungen für den FHIR-Dienst unterstützt?

Ja. Wir erlauben Ihnen, alle gültigen FHIR-JSON-Daten in den Server zu laden. Wenn Sie die Strukturdefinition speichern möchten, die Erweiterungen definiert, können Sie dies als Strukturdefinitionsressource speichern. Um nach Erweiterungen zu suchen, müssen Sie Ihre eigenen Suchparameter definieren.

Gewusst wie den FHIR-Dienst in XML anzeigen?

Im verwalteten Dienst unterstützen wir nur JSON. Der Open-Source-FHIR-Server unterstützt JSON und XML. Verwenden Sie _format= application/fhir+xml, um die XML-Version in Open Source anzuzeigen.

Welcher Grenzwert gilt für _count?

Der aktuelle Grenzwert für „_count“ liegt bei 1000. Wenn Sie _count auf mehr als 1000 festlegen, erhalten Sie eine Warnung im Bundle, dass nur 1.000 Datensätze angezeigt werden.

Kann ich ein Bündel an den FHIR-Dienst senden?

Derzeit unterstützen wir das Posten von Batchpaketen und das Posten von Transaktionspaketen im FHIR-Dienst.

Wie erhalte ich alle Ressourcen für einen einzelnen Patienten im FHIR-Dienst?

Wir unterstützen den $patient-alles-Vorgang , der Ihnen alle Daten im Zusammenhang mit einem einzelnen Patienten abruft.

Unterstützt der FHIR-Dienst Terminologievorgänge?

Nein, der FHIR-Dienst unterstützt derzeit keine Terminologievorgänge.

Verwenden des FHIR-Diensts

Kann ich Integritätsprüfungen für den FHIR-Dienst durchführen?

Um eine Integritätsprüfung für einen FHIR-Dienst durchzuführen, geben Sie {{fhirurl}}/health/check die GET-Anforderung ein. Sie sollten in der Lage sein, den Status des FHIR-Diensts anzuzeigen. Eine HTTP-Statuscodeantwort mit 200 und OverallStatus als fehlerfrei bedeutet, dass die Integritätsprüfung erfolgreich ist.

Wenn Fehler auftreten, erhalten Sie möglicherweise eine Fehlerantwort mit HTTP-Statuscode 404 (Nicht gefunden) oder Statuscode 500 (Interner Serverfehler) und detaillierte Informationen im Antworttext.

Welche empfohlenen Methoden zum Synchronisieren von Daten zwischen dem FHIR-Dienst und Dataverse sind empfohlen?

Informationen zu Dataverse Healthcare APIs finden Sie in der Dokumentation

Nächste Schritte

In diesem Artikel haben Sie die Antworten auf häufig gestellte Fragen zum FHIR-Dienst kennengelernt. Die häufig gestellten Fragen zum FHIR-Dienst in der Azure-API für FHIR finden Sie unter

Häufig gestellte Fragen zur Azure-API für FHIR

Hinweis

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