Übersicht über $convert-Daten
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 : ZeichenfolgeFür Ccda : XMLFür Json : JSONFü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:
- Hosten Sie Ihre eigene Kopie der Vorlagen in einem Azure Container Registry instance.
- Registrieren Sie die Vorlagen beim FHIR-Dienst.
- Verwenden Sie Ihre registrierten Vorlagen in Ihren API-Aufrufen.
- Ü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
Informationen zur Problembehandlung $convert-data
finden Sie unter
Informationen zu den häufig gestellten Fragen (FAQs) zu $convert-data
finden Sie unter
FHIR® ist eine eingetragene Marke von Health Level Seven International, eingetragen im U.S. Trademark Office und wird mit deren Genehmigung verwendet.