Erste Schritte mit dem FHIR-Dienst

Artikel
07/01/2024

In diesem Artikel werden die grundlegenden ersten Schritte für den FHIR®-Dienst in Azure Health Data Services beschrieben.

Als Voraussetzung benötigen Sie ein Azure-Abonnement und Berechtigungen zum Erstellen von Azure-Ressourcengruppen und zum Bereitstellen von Azure-Ressourcen. Sie können alle unten angegebenen Schritte befolgen oder einige Schritte überspringen, wenn Sie bereits über eine Umgebung verfügen. Außerdem können Sie alle Schritte kombinieren und in PowerShell-, Azure CLI- und REST-API-Skripts ausführen.

Erstellen eines Arbeitsbereichs in Ihrem Azure-Abonnement

Sie können einen Arbeitsbereich über das Azure-Portal oder mithilfe von PowerShell, Azure CLI und REST-API erstellen. Sie finden Skripts von den Beispielen für Azure Health Data Services.

Hinweis

Es gibt Grenzwerte für die Anzahl der Arbeitsbereiche und die Anzahl der FHIR-Dienstinstanzen, die Sie in jedem Azure-Abonnement erstellen können.

Erstellen eines FHIR-Diensts im Arbeitsbereich

Sie können eine FHIR-Dienstinstanz über das Azure-Portal oder mithilfe von PowerShell, Azure CLI und REST-API erstellen. Sie finden Skripts von den Beispielen für Azure Health Data Services.

Optional können Sie einen DICOM-Dienst und einen Medizintechnikdienst im Arbeitsbereich erstellen.

Zugreifen auf den FHIR-Dienst

Der FHIR-Dienst wird durch Microsoft Entra ID gesichert, die nicht deaktiviert werden kann. Um auf die Dienst-API zuzugreifen, müssen Sie eine Clientanwendung erstellen, die auch als Dienstprinzipal in Microsoft Entra ID bezeichnet wird, und sie mit den richtigen Berechtigungen ausstatten.

Registrieren einer Clientanwendung

Sie können eine Clientanwendung über das Azure-Portal oder mithilfe von PowerShell- und Azure CLI-Skripts erstellen oder registrieren. Diese Clientanwendung kann für eine oder mehrere FHIR-Dienstinstanzen verwendet werden. Sie kann auch für andere Dienste in Azure Health Data Services verwendet werden.

Wenn die Clientanwendung mit einem Zertifikat oder geheimen Clientschlüssel erstellt wird, stellen Sie sicher, dass Sie das Zertifikat oder den geheimen Clientschlüssel vor Ablauf erneuern und die Clientanmeldeinformationen in Ihren Anwendungen ersetzen.

Sie können eine Clientanwendung löschen. Bevor Sie eine Clientanwendung löschen, stellen Sie sicher, dass sie nicht in Produktions-, Entwicklungs-, Test- oder Qualitätssicherungs (QA)-Umgebungen verwendet wird.

Erteilen von Zugriffsberechtigungen

Sie können das Azure-Portal oder PowerShell- und Azure CLI-Skripts verwenden, um Zugriffsberechtigungen zu erteilen oder Rollen zuzuweisen.

Durchführen von Erstellungs-, Lese-, Aktualisierungs- und Löschtransaktionen (CRUD)

Sie können CRUD-Transaktionen (Create – Erstellen, Read – Lesen, Update – Aktualisieren, Delete – Löschen), mit dem FHIR-Dienst in Ihren Anwendungen oder mithilfe von Tools wie Postman, REST-Client und cURL durchführen. Da der FHIR-Dienst standardmäßig geschützt ist, müssen Sie ein Zugriffstoken abrufen und in Ihre Transaktionsanforderung einschließen.

Abrufen eines Zugriffstokens

Sie können ein Microsoft Entra-Zugriffstoken über PowerShell, über die Azure CLI, per REST CCI oder per .NET SDK abrufen. Weitere Informationen finden Sie unter Ein Zugriffstoken erhalten.

Zugriff mithilfe vorhandener Tools

Laden der Daten

Sie können Daten direkt laden, indem Sie die POST- oder PUT-Methode für den FHIR-Dienst verwenden. Zum Massenladen von Daten können Sieden $import-Vorgang verwenden. Informationen finden Sie unter Importvorgang.

CMS, Suche, Profilüberprüfung und Neuindizierung

Weitere Details zu Interoperabilität und Patientenzugriff, Suche, Profilüberprüfung und Neuindizierung finden Sie in der Dokumentation zum FHIR-Dienst.

Datenexport

Optional können Sie Daten in Azure Storage exportieren ($export) und in Ihren Analyse- oder Machine Learning-Projekten verwenden. Sie können die Daten im vorliegenden Zustand oder ohne ID (deID) im Format ndjson exportieren.

Konvertieren von Daten

Optional können Sie Daten vom Typ HL7 v2 sowie andere Formate in FHIR konvertieren.

Verwenden von FHIR-Daten im Power BI-Dashboard

Optional können Sie Power BI-Dashboardberichte mit FHIR-Daten erstellen.

Nächste Schritte

Bereitstellen eines FHIR-Diensts in Azure Health Data Services