Omówienie danych $convert
Uwaga
Fast Healthcare Interoperability Resources (FHIR®) to otwarta specyfikacja opieki zdrowotnej.
Za pomocą $convert-data
operacji w usłudze FHIR można przekonwertować dane kondycji z różnych formatów na dane FHIR R4 . Operacja $convert-data
używa szablonów Liquid z projektu konwertera FHIR na potrzeby konwersji danych FHIR. Te szablony konwersji można dostosować zgodnie z potrzebami. $convert-data
Obecnie operacja obsługuje cztery typy konwersji danych:
- HL7v2 do FHIR R4
- C-CDA do FHIR R4
- JSON do FHIR R4 (przeznaczone do mapowań konwersji niestandardowych)
- FHIR STU3 do FHIR R4
Uwaga
Punkt końcowy można użyć $convert-data
jako składnika w potoku ETL (wyodrębnianie, przekształcanie i ładowanie) do konwersji danych kondycji z różnych formatów (na przykład: HL7v2, CCDA, JSON i FHIR STU3) do formatu FHIR. Potok ETL można utworzyć dla kompletnego przepływu pracy podczas konwertowania danych kondycji. Zalecamy użycie aparatu ETL opartego na usłudze Azure Logic Apps lub Azure Data Factory. Na przykład przepływ pracy może obejmować: pozyskiwanie danych, wykonywanie $convert-data
operacji, walidację, przetwarzanie wstępne/przetwarzanie danych, wzbogacanie danych, deduplikację danych i ładowanie danych do trwałości w usłudze FHIR.
Korzystanie z punktu końcowego $convert-data
Operacja jest zintegrowana $convert-data
z usługą FHIR jako akcją interfejsu API REST. Punkt końcowy można wywołać $convert-data
w następujący sposób:
POST {{fhirurl}}/$convert-data
Dane kondycji konwersji są dostarczane do usługi FHIR w treści $convert-data
żądania. Jeśli żądanie zakończy się pomyślnie, usługa FHIR zwróci odpowiedź pakietu FHIR z danymi przekonwertowanymi na FHIR R4.
Parametry
Wywołanie $convert-data
operacji pakuje dane kondycji do konwersji wewnątrz parametrów sformatowanych w formacie JSON w treści żądania. Parametry opisano w poniższej tabeli:
Nazwa parametru | Opis | Dopuszczalne wartości |
---|---|---|
inputData | Ładunek danych, który ma zostać przekonwertowany na FHIR. | Dla Hl7v2 ciągu :Dla Ccda elementu : XMLDla Json : JSONDla FHIR STU3 : JSON |
inputDataType | Typ danych wejściowych. | Hl7v2 , Ccda , Json , Fhir |
templateCollectionReference | Odwołanie do kolekcji szablonów obrazów OCI w Azure Container Registry. Odwołanie dotyczy obrazu zawierającego szablony Liquid do użycia do konwersji. Może odwoływać się do szablonów domyślnych lub do niestandardowego obrazu szablonu zarejestrowanego w usłudze FHIR. W poniższych sekcjach omówiono dostosowywanie szablonów, hostowanie ich w Azure Container Registry i rejestrowanie się w usłudze FHIR. | W przypadku szablonów domyślnych/przykładowych : Szablony HL7v2: microsofthealth/fhirconverter:default microsofthealth/hl7v2templates:default Szablony C-CDA: microsofthealth/ccdatemplates:default Szablony JSON: microsofthealth/jsontemplates:default Szablony FHIR STU3 : microsofthealth/stu3tor4templates:default W przypadku szablonów niestandardowych : <RegistryServer>/<imageName>@<imageDigest> , <RegistryServer>/<imageName>:<imageTag> |
rootTemplate | Szablon główny do użycia podczas przekształcania danych. | Dla 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 W przypadku C-CDA: CCD, ConsultationNote, DischargeSummary, HistoryandPhysical, OperativeNote, ProcedureNote, ProgressNote, ReferralNote, TransferSummary Dla formatu JSON: ExamplePatient, Stu3ChargeItem Dla FHIR STU3: Nazwa zasobu FHIR STU3 (na przykład: Pacjent, Obserwacja, Organizacja) |
Uwaga
Szablony FHIR STU3 do FHIR R4 to szablony Liquid, które zapewniają mapowania różnic pól tylko między zasobem FHIR STU3 a jego równoważnym zasobem w specyfikacji FHIR R4. Niektóre zasoby FHIR STU3 zostały zmienione lub usunięte z FHIR R4. Aby uzyskać więcej informacji na temat różnic zasobów i ograniczeń konwersji FHIR STU3 na FHIR R4, zobacz Różnice zasobów i ograniczenia konwersji FHIR STU3 na FHIR R4.
Uwaga
Szablony JSON to przykładowe szablony do użycia podczas tworzenia własnych mapowań konwersji. Nie są to domyślne szablony, które są zgodne z żadnymi wstępnie zdefiniowanymi typami komunikatów o kondycji. Sam kod JSON nie jest określony jako format danych kondycji, w przeciwieństwie do formatu HL7v2 lub C-CDA. W związku z tym zamiast udostępniać domyślne szablony JSON, udostępniamy przykładowe szablony JSON, których można użyć jako punktu wyjścia dla własnych dostosowanych mapowań.
Ostrzeżenie
Szablony domyślne są wydawane w ramach licencji MIT i nie są obsługiwane przez pomoc techniczna firmy Microsoft.
Szablony domyślne są udostępniane tylko w celu ułatwienia rozpoczęcia pracy z przepływem pracy konwersji danych. Te szablony domyślne nie są przeznaczone dla środowiska produkcyjnego i mogą ulec zmianie, gdy firma Microsoft publikuje aktualizacje usługi FHIR. Aby zapewnić spójne zachowanie konwersji danych w różnych wersjach usługi FHIR, należy wykonać następujące czynności:
- Hostowanie własnej kopii szablonów w wystąpieniu Azure Container Registry.
- Zarejestruj szablony w usłudze FHIR.
- Użyj zarejestrowanych szablonów w wywołaniach interfejsu API.
- Sprawdź, czy zachowanie konwersji spełnia twoje wymagania.
Aby uzyskać więcej informacji na temat hostowania własnych szablonów, zobacz Hostowanie własnych szablonów
Przykładowe żądanie
{
"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"
}
]
}
Przykładowa odpowiedź
{
"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"
}
}
]
}
Wynikiem konwersji FHIR jest pakiet FHIR jako partia.
- Pakiet FHIR powinien być zgodny z oczekiwaniami specyfikacji FHIR R4 — Bundle - FHIR v4.0.1.
- Jeśli próbujesz zweryfikować określony profil, musisz wykonać pewne czynności po przetworzeniu, korzystając z operacji FHIR
$validate
.
Następne kroki
W tym artykule omówiono operację $convert-data
i sposób używania punktu końcowego do konwertowania danych kondycji na FHIR R4 przy użyciu usługi FHIR w usłudze Azure Health Data Service.
Aby dowiedzieć się, jak skonfigurować ustawienia na potrzeby $convert-data
korzystania z Azure Portal, zobacz
Aby dowiedzieć się, jak rozwiązywać problemy $convert-data
, zobacz
Aby dowiedzieć się więcej o często zadawanych pytaniach dotyczących usługi , $convert-data
zobacz
FHIR® jest zastrzeżonym znakiem towarowym Health Level Seven International, zarejestrowanym w Amerykańskim Biurze Znaków Towarowych i jest używany z ich pozwoleniem.