Übersicht über $convert-Daten

  • Artikel

Hinweis

Fast Healthcare Interoperability Resources (FHIR®) ist eine offene Spezifikation für das Gesundheitswesen.

Mithilfe des Vorgangs $convert-data im FHIR-Dienst können Sie Integritätsdaten aus verschiedenen Formaten in FHIR R4-Daten konvertieren. Der $convert-data Vorgang verwendet Liquid-Vorlagen aus dem FHIR Converter-Projekt für die FHIR-Datenkonvertierung. Diese Konvertierungsvorlagen können nach Bedarf angepasst werden. Derzeit unterstützt der $convert-data Vorgang vier Arten der Datenkonvertierung:

  • HL7v2 zu FHIR R4
  • C-CDA zu FHIR R4
  • JSON zu FHIR R4 (für benutzerdefinierte Konvertierungszuordnungen vorgesehen)
  • FHIR STU3 zu FHIR R4

Hinweis

Sie können den $convert-data Endpunkt als Komponente innerhalb einer ETL-Pipeline (Extrahieren, Transformieren und Laden) für die Konvertierung von Integritätsdaten aus verschiedenen Formaten (z. B. HL7v2, CCDA, JSON und FHIR STU3) in das FHIR-Format verwenden. Sie können eine ETL-Pipeline für einen vollständigen Workflow erstellen, während Sie Ihre Integritätsdaten konvertieren. Es wird empfohlen, eine ETL-Engine zu verwenden, die auf Azure Logic Apps oder Azure Data Factory basiert. Ein Workflow kann beispielsweise Folgendes umfassen: Datenerfassung, Ausführen von $convert-data Vorgängen, Validierung, Datenvor-/Nachbearbeitung, Datenanreicherung, Datendeduplizierung und Laden der Daten zur Persistenz im FHIR-Dienst.

Verwenden des Endpunkts „$convert-data“

Der $convert-data Vorgang ist als REST-API-Aktion in den FHIR-Dienst integriert. Sie können den $convert-data Endpunkt wie folgt aufrufen:

POST {{fhirurl}}/$convert-data

Die Integritätsdaten für die Konvertierung werden an den FHIR-Dienst im Text der $convert-data Anforderung übermittelt. Wenn die Anforderung erfolgreich ist, gibt der FHIR-Dienst eine FHIR-Bündelantwort mit den in FHIR R4 konvertierten Daten zurück.

Parameter

Ein $convert-data Vorgangsaufruf packt die Integritätsdaten für die Konvertierung innerhalb eines JSON-formatierten Parameters im Text der Anforderung. Die Parameter werden in der folgenden Tabelle beschrieben:

Parametername Beschreibung Zulässige Werte
inputData Datennutzlast, die in FHIR konvertiert werden soll. Für Hl7v2: Zeichenfolge
Für Ccda: XML
Für Json: JSON
Für FHIR STU3: JSON
inputDataType Typ der Dateneingabe. Hl7v2, Ccda, Json, Fhir
templateCollectionReference Verweis auf eine OCI-Bildvorlagensammlung in Azure Container Registry. Der Verweis ist auf ein Bild, das Liquid-Vorlagen enthält, die für die Konvertierung verwendet werden sollen. Sie kann entweder auf Standardvorlagen oder auf ein benutzerdefiniertes Vorlagenimage verweisen, das im FHIR-Dienst registriert ist. In den folgenden Abschnitten werden das Anpassen der Vorlagen, das Hosten auf Azure Container Registry und die Registrierung beim FHIR-Dienst behandelt. Für Standard-/Beispielvorlagen :
HL7v2-Vorlagen :
microsofthealth/fhirconverter:default
microsofthealth/hl7v2templates:default
C-CDA-Vorlagen :
microsofthealth/ccdatemplates:default
JSON-Vorlagen :
microsofthealth/jsontemplates:default
FHIR STU3-Vorlagen :
microsofthealth/stu3tor4templates:default

Für benutzerdefinierte Vorlagen:
<RegistryServer>/<imageName>@<imageDigest>, <RegistryServer>/<imageName>:<imageTag>
rootTemplate Die Stammvorlage, die beim Transformieren der Daten verwendet werden soll. Für HL7v2:
ADT_A01, ADT_A02, ADT_A03, ADT_A04, ADT_A05, ADT_A08, ADT_A11, ADT_A13, ADT_A14, ADT_A15, ADT_A16, ADT_A25, ADT_A26, ADT_A27, ADT_A28, ADT_A29, ADT_A31, ADT_A47, ADT_A60, OML_O21, ORU_R01, ORM_O01, VXU_V04, SIU_S12, SIU_S13, SIU_S14, SIU_S15, SIU_S16 SIU_S17, SIU_S26, MDM_T01, MDM_T02

Für C-CDA:
CCD, ConsultationNote, DischargeSummary, HistoryandPhysical, OperativeNote, ProcedureNote, ProgressNote, ReferralNote, TransferSummary

Für JSON:
ExamplePatient, Stu3ChargeItem

Für FHIR STU3:
FHIR STU3-Ressourcenname (z. B. Patient, Beobachtung, Organisation)

Hinweis

FHIR STU3- zu FHIR R4-Vorlagen sind Liquid-Vorlagen, die nur Zuordnungen von Feldunterschieden zwischen einer FHIR STU3-Ressource und ihrer entsprechenden Ressource in der FHIR R4-Spezifikation bereitstellen. Einige der FHIR STU3-Ressourcen werden umbenannt oder aus FHIR R4 entfernt. Weitere Informationen zu den Ressourcenunterschieden und -einschränkungen für die Konvertierung von FHIR STU3 zu FHIR R4 finden Sie unter Ressourcenunterschiede und Einschränkungen für die Konvertierung von FHIR STU3 in FHIR R4.

Hinweis

JSON-Vorlagen sind Beispielvorlagen für die Erstellung eigener Konvertierungszuordnungen. Es handelt sich nicht um Standardvorlagen, die vordefinierten Integritätsdatennachrichtentypen entsprechen. JSON selbst wird im Gegensatz zu HL7v2 oder C-CDA nicht als Integritätsdatenformat angegeben. Daher stellen wir anstelle von JSON-Standardvorlagen einige JSON-Beispielvorlagen bereit, die Sie als Ausgangspunkt für Ihre eigenen benutzerdefinierten Zuordnungen verwenden können.

Warnung

Standardvorlagen werden unter der MIT-Lizenz veröffentlicht und von Microsoft-Support nicht unterstützt.

Die Standardvorlagen werden nur bereitgestellt, um Ihnen den Einstieg in Ihren Datenkonvertierungsworkflow zu erleichtern. Diese Standardvorlagen sind nicht für die Produktion vorgesehen und können sich ändern, wenn Microsoft Updates für den FHIR-Dienst veröffentlicht. Um ein konsistentes Datenkonvertierungsverhalten für verschiedene Versionen des FHIR-Diensts zu erhalten, müssen Sie die folgenden Schritte ausführen:

  1. Hosten Sie Ihre eigene Kopie der Vorlagen in einem Azure Container Registry instance.
  2. Registrieren Sie die Vorlagen beim FHIR-Dienst.
  3. Verwenden Sie Ihre registrierten Vorlagen in Ihren API-Aufrufen.
  4. Überprüfen Sie, ob das Konvertierungsverhalten Ihre Anforderungen erfüllt.

Weitere Informationen zum Hosten eigener Vorlagen finden Sie unter Hosten eigener Vorlagen.

Beispiel für eine Anforderung

{
    "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": "batch",
    "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"
            }
        }
    ]
}

Das Ergebnis der FHIR-Konvertierung ist ein FHIR-Bündel als Batch.

  • Das FHIR-Bundle sollte den Erwartungen der FHIR R4-Spezifikation entsprechen – Bundle – FHIR v4.0.1.
  • Wenn Sie versuchen, die Überprüfung anhand eines bestimmten Profils durchzuführen, müssen Sie eine Nachbearbeitung durchführen, indem Sie den FHIR-Vorgang $validate verwenden.

Nächste Schritte

In diesem Artikel haben Sie mehr über den $convert-data Vorgang und die Verwendung des Endpunkts zum Konvertieren von Integritätsdaten in FHIR R4 mithilfe des FHIR-Diensts in Azure Health Data Service erfahren.

Informationen zum Konfigurieren von Einstellungen für $convert-data die Verwendung der Azure-Portal finden Sie unter

Konfigurieren von Einstellungen für $convert-Data mithilfe des Azure-Portal

Informationen zur Problembehandlung $convert-datafinden Sie unter

Problembehandlung bei $convert-Daten

Informationen zu den häufig gestellten Fragen (FAQs) zu $convert-datafinden Sie unter

Häufig gestellte Fragen zu $convert-Daten

FHIR® ist eine eingetragene Marke von Health Level Seven International, eingetragen im U.S. Trademark Office und wird mit deren Genehmigung verwendet.