Freigeben über


CARIN-Implementierungsleitfaden für Blue Button® (CARIN Implementation Guide for Blue Button®, C4BB IG) für Azure API for FHIR

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 Tutorial wird das Einrichten von Azure API for FHIR® zum Bestehen der Touchstone-Tests für den CARIN-Implementierungsleitfaden für Blue Button (CARIN Implementation Guide for Blue Button, C4BB IG) erläutert.

Touchstone Capability-Anweisung

Der erste Test, auf den wir uns konzentrieren werden, besteht darin, Azure API for FHIR mit der C4BB IG-Funktionserklärung zu testen. Wenn Sie diesen Test ohne Aktualisierungen für Azure API for FHIR ausführen, schlägt der Test aufgrund fehlender Suchparameter und Profile fehl.

Suchparameter definieren

Als Teil des CARIN-Implementierungsleitfadens für Blue Button (C4BB IG) müssen Sie drei neue Suchparameter für die Ressource ExplanationOfBenefit definieren. Zwei dieser Suchparameter (type und service-date) werden in der Funktionsanweisung getestet, und ein Suchparameter (insurer) ist für _include-Suchvorgänge erforderlich.

Hinweis

Im unformatierten JSON für diese Suchparameter wird der Name auf ExplanationOfBenefit_<SearchParameter Name> gesetzt. Der Touchstone-Test erwartet, dass die Namen für diese Suchparameter type, service-date und insurer lauten.

Die restlichen Suchparameter, die für den CARIN-Implementierungsleitfaden für Blue Button (C4BB IG) erforderlich sind, werden durch die Basisspezifikation definiert und sind bereits Azure API for FHIR ohne zusätzliche Updates verfügbar.

Speichern von Profilen

Das andere Update, das Sie außerhalb der Definition von Suchparametern vornehmen müssen, um diesen Test zu bestehen, besteht darin, die erforderlichen Profile zu laden. Es gibt acht Profile, die innerhalb des CARIN-Implementierungsleitfadens für Blue Button (C4BB IG) definiert sind.

Beispiel-REST-Datei

Zur Unterstützung bei der Erstellung dieser Suchparameter und Profile verfügen wir über eine HTTP-Beispieldatei, die alle in diesem Tutorial beschriebenen Schritte in einer einzelnen Datei enthält. Nachdem Sie alle erforderlichen Profile und Suchparameter hochgeladen haben, können Sie den Funktionsaufweisungstest in Touchstone ausführen.

Ergebnisse der Ausführung des Funktionstestkripts.

Touchstone-Test der Lesefunktionen

Nach dem Testen der Funktionsanweisung testen wir die Lesefunktionen in Azure API for FHIR mit dem CARIN-Implementierungsleitfaden für Blue Button (C4BB IG). Dies ist ein Test der Konformität mit den acht Profilen, die Sie im ersten Test geladen haben. Sie müssen Ressourcen geladen haben, die den Profilen entsprechen. Sie sollten mit Ressourcen testen, die sich bereits in Ihrer Datenbank befinden, aber wir haben auch eine HTTP-Datei mit Beispielressourcen zur Verfügung gestellt. Diese werden aus den Beispielen im Implementierungsleitfaden gepullt, mit denen Sie die Ressourcen erstellen und diese testen können.

Ergebnisse der Ausführung des Touchstone-Tests der Lesefunktionen.

Touchstone-Test der EOB-Abfrage

Der nächste Test, den wir uns ansehen, ist der EOB-Abfragetest. Wenn Sie den Test der Lesefunktionen bereits abgeschlossen haben, verfügen Sie bereits über alle Daten, die Sie geladen haben müssen. Dieser Test überprüft, ob Sie mithilfe verschiedener Parameter nach bestimmten Patient- und ExplanationOfBenefit-Ressourcen suchen können.

Ergebnisse der Ausführung des Touchstone-Tests der EOB-Abfrage.

Test zur Touchstone-Fehlerbehandlung

Der letzte Test, den wir durchgehen, ist das Testen der Fehlerbehandlung. Der einzige Schritt, den Sie ausführen müssen, ist das Löschen einer ExplanationOfBenefit-Ressource aus Ihrer Datenbank und die Verwendung der ID der gelöschten ExplanationOfBenefit-Ressource im Test.

Ergebnisse des Touchstone-Tests der EOB-Fehlerbehandlung.

Nächste Schritte

In diesem Tutorial wurde erläutert, wie Sie den C4BB IG-Test (CARIN-Implementierungsleitfaden für Blue Button) in Touchstone bestehen. Als Nächstes können Sie sich ansehen, wie Sie den Test der Da Vinci-Arzneimittelliste (Da Vinci Drug Formulary) bestehen.

Hinweis

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