Konvertieren von Daten in FHIR für die Azure-API für FHIR

Der benutzerdefinierter Endpunkt $convert-data im FHIR®-Dienst ist für die Konvertierung verschiedener Datentypen in FHIR vorgesehen. Er verwendet die Liquid-Vorlagen-Engine und die Vorlagen aus dem Projekt FHIR Converter als Standardvorlagen. Diese Konvertierungsvorlagen können nach Bedarf angepasst werden.

Derzeit unterstützt der benutzerdefinierte Endpunkt $convert-data vier Typen der Datenkonvertierung:

Verwenden des Endpunkts „$convert-data“

Der $convert-data-Vorgang ist in den FHIR-Dienst integriert und wird als Teil des Diensts ausgeführt. Nach der Aktivierung von $convert-data auf Ihrem Server können Sie mit https://<<FHIR service base URL>>/$convert-data API-Aufrufe an den Server senden, um Ihre Daten in FHIR zu konvertieren.

Parameterressource

$convert-data akzeptiert eine Parameter-Ressource im Anforderungstext, wie in der folgenden Tabelle beschrieben. Fügen Sie folgende Parameter in den Anforderungstext für den API-Aufruf ein:

Beispiel-Anfrage

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "inputData",
            "valueString": "MSH|^~\\&|SIMHOSP|SFAC|RAPP|RFAC|20200508131015||ADT^A01|517|T|2.3|||AL||44|ASCII\nEVN|A01|20200508131015|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|\nPID|1|3735064194^^^SIMULATOR MRN^MRN|3735064194^^^SIMULATOR MRN^MRN~2021051528^^^NHSNBR^NHSNMBR||Kinmonth^Joanna^Chelsea^^Ms^^D||19870624000000|F|||89 Transaction House^Handmaiden Street^Wembley^^FV75 4GJ^GBR^HOME||020 3614 5541^PRN|||||||||C^White - Other^^^||||||||\nPD1|||FAMILY PRACTICE^^12345|\nPV1|1|I|OtherWard^MainRoom^Bed 183^Simulated Hospital^^BED^Main Building^4|28b|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|||CAR|||||||||16094728916771313876^^^^visitid||||||||||||||||||||||ARRIVED|||20200508131015||"
        },
        {
            "name": "inputDataType",
            "valueString": "Hl7v2"
        },
        {
            "name": "templateCollectionReference",
            "valueString": "microsofthealth/fhirconverter:default"
        },
        {
            "name": "rootTemplate",
            "valueString": "ADT_A01"
        }
    ]
}

Beispiel für eine Antwort

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "fullUrl": "urn:uuid:9d697ec3-48c3-3e17-db6a-29a1765e22c6",
      "resource": {
        "resourceType": "Patient",
        "id": "9d697ec3-48c3-3e17-db6a-29a1765e22c6",
        ...
        ...
      "request": {
        "method": "PUT",
        "url": "Location/50becdb5-ff56-56c6-40a1-6d554dca80f0"
      }
    }
  ]
}

Anpassen von Projekt- und Elementvorlagen

Sie können die Erweiterung „FHIR Converter“ für Visual Studio Code verwenden, um die Vorlagen gemäß Ihren Anforderungen anzupassen. Die Erweiterung bietet eine interaktive Bearbeitungsumgebung und ermöglicht das mühelose Herunterladen von Vorlagen und Beispieldaten, die von Microsoft veröffentlicht wurden. Weitere Details finden Sie in der Dokumentation zur Erweiterung.

Hosten und Verwenden von Vorlagen

Es wird empfohlen, Ihre eigene Vorlagenkopien in ACR zu hosten. Führen Sie die vier folgenden Schritte aus, um Ihre eigenen Vorlagenkopien zu hosten und im Vorgang $convert-data zu verwenden:

1. Pushen Sie die Vorlagen in Ihre Azure Container Registry-Instanz.
2. Aktivieren Sie die verwaltete Identität für Ihre Azure API for FHIR-Instanz.
3. Gewähren Sie ACR-Zugriff auf die verwaltete Identität von Azure API for FHIR.
4. Registrieren Sie die ACR-Server in Azure API for FHIR.
5. Optional können Sie die ACR-Firewall für den sicheren Zugriff konfigurieren.

Pushen von Vorlagen an Azure Container Registry

Nach dem Erstellen einer ACR-Instanz, können Sie den Befehl FHIR Converter: Push Templates in der Erweiterung „FHIR Converter“ verwenden, um die angepassten Vorlagen an ACR zu pushen. Alternativ können Sie auch das CLI-Tool für die Vorlagenverwaltung verwenden.

Aktivieren der verwalteten Identität für Azure API for FHIR

Navigieren Sie im Azure-Portal zu Ihrer Instanz des Azure API for FHIR-Diensts, und wählen Sie dann das Blatt Identität aus. Ändern Sie den Status in Ein, um die verwaltete Identität in Azure API for FHIR zu aktivieren.

Gewähren von ACR-Zugriff auf Azure API for FHIR

1. Navigieren Sie zum Blatt Zugriffssteuerung (IAM).

2. Wählen Sie Hinzufügen und dann Rollenzuweisung hinzufügen aus, um die Seite „Rollenzuweisung hinzufügen“ zu öffnen.

3. Weisen Sie die Rolle AcrPull zu.

   

Weitere Informationen zum Zuweisen von Rollen im Azure-Portal finden Sie unter Integrierte Rollen für die rollenbasierte Zugriffssteuerung in Azure.

Registrieren der ACR-Server in Azure API for FHIR

Sie können den ACR-Server über das Azure-Portal oder die CLI registrieren.

Registrieren des ACR-Servers mithilfe des Azure-Portals

Navigieren Sie zum Blatt Artefakte unter Datentransformation in Ihrer Azure-API for FHIR-Instanz. Die Liste der aktuell registrierten ACR-Server wird angezeigt. Wählen Sie Hinzufügen aus, und wählen Sie dann im Dropdownmenü Ihren Registrierungsserver aus. Sie müssen Speichern auswählen, damit die Registrierung wirksam wird. Es kann einige Minuten dauern, bis die Änderung angewendet und die Instanz neu gestartet wird.

Registrieren des ACR-Servers mithilfe der CLI

In Azure API for FHIR können bis zu 20 ACR-Server registriert werden.

Installieren Sie bei Bedarf die Azure Health Data Services-CLI über Azure PowerShell, falls erforderlich:

az extension add -n healthcareapis

Registrieren Sie die ACR-Server bei Azure API for FHIR, wie in diesen Beispielen gezeigt:

Registrieren eines einzelnen ACR-Servers

az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021

Registrieren mehrerer ACR-Server

az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io fhiracr2020.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021

Konfigurieren einer ACR-Firewall

Wählen Sie im Portal Netzwerk für das Azure Storage-Konto aus.

Klicken Sie auf Ausgewählte Netzwerke.

Geben Sie im Abschnitt Firewall die IP-Adresse im Feld Adressbereich an. Hiermit werden IP-Adressbereiche hinzugefügt, um Zugriff vom Internet oder von Ihren lokalen Netzwerken aus zu gewähren.

Die IP-Adresse für die Azure-Region, in der der Dienst Azure API for FHIR bereitgestellt wird, können Sie der folgenden Tabelle entnehmen.

Verifizieren

Rufen Sie die $convert-data-API auf, und geben Sie dabei im templateCollectionReference-Parameter Ihren Vorlagenverweis an.

<RegistryServer>/<imageName>@<imageDigest>

Nächste Schritte

In diesem Artikel haben Sie mehr über Datenkonvertierung für die Azure API for FHIR erfahren. Weitere Informationen zu verwandten GitHub-Projekten für Azure-API for FHIR finden Sie unter