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 Hl7v2ciągu :
Dla Ccdaelementu : XML
Dla Json: JSON
Dla 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:

  1. Hostowanie własnej kopii szablonów w wystąpieniu Azure Container Registry.
  2. Zarejestruj szablony w usłudze FHIR.
  3. Użyj zarejestrowanych szablonów w wywołaniach interfejsu API.
  4. 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-datazobacz

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.