Přehled $convert dat

Článek
09/07/2023

Poznámka

Fast Healthcare Interoperability Resources (FHIR®) je otevřená specifikace zdravotní péče.

Pomocí $convert-data operace ve službě FHIR můžete převést data o stavu z různých formátů na data FHIR R4 . Operace $convert-data používá šablony Liquid z projektu FHIR Converter pro převod dat FHIR. Tyto šablony převodu si můžete podle potřeby přizpůsobit. $convert-data V současné době operace podporuje čtyři typy převodu dat:

HL7v2 až FHIR R4
C-CDA do FHIR R4
JSON na FHIR R4 (určené pro mapování vlastních převodů)
FHIR STU3 až FHIR R4

Poznámka

Koncový bod můžete použít $convert-data jako součást v rámci kanálu ETL (extrakce, transformace a načítání) pro převod dat o stavu z různých formátů (například HL7v2, CCDA, JSON a FHIR STU3) do formátu FHIR. Kanál ETL můžete vytvořit pro kompletní pracovní postup při převodu dat o stavu. Doporučujeme použít modul ETL, který je založený na Azure Logic Apps nebo Azure Data Factory. Pracovní postup může například zahrnovat: příjem dat, provádění $convert-data operací, ověřování, předběžné a následné zpracování dat, rozšiřování dat, odstranění duplicitních dat a načítání dat pro trvalost ve službě FHIR.

Použití koncového bodu $convert-data

Operace $convert-data je integrovaná do služby FHIR jako akce rozhraní REST API. Koncový bod můžete volat $convert-data následujícím způsobem:

POST {{fhirurl}}/$convert-data

Údaje o stavu pro převod se doručí službě FHIR v textu $convert-data žádosti. Pokud je požadavek úspěšný, vrátí služba FHIR odpověď sady FHIR s daty převedenými na FHIR R4.

Parametry

Volání $convert-data operace zabalí data o stavu pro převod uvnitř parametrů ve formátu JSON v textu požadavku. Parametry jsou popsané v následující tabulce:

Název parametru	Description	Přípustné hodnoty
inputData	Datová část, která se má převést na FHIR.	Pro `Hl7v2`: string Pro `Ccda`: XML Pro `Json`: JSON Pro `FHIR STU3`: JSON
inputDataType	Typ vstupu dat.	`Hl7v2`, `Ccda`, `Json`, `Fhir`
templateCollectionReference	Odkaz na kolekci šablon imagí OCI v Azure Container Registry. Odkaz je na obrázek, který obsahuje šablony Liquid, které se mají použít pro převod. Může odkazovat buď na výchozí šablony, nebo na vlastní image šablony, která je zaregistrovaná ve službě FHIR. Následující části se týkají přizpůsobení šablon, jejich hostování na Azure Container Registry a registrace ve službě FHIR.	Výchozí/ukázkové šablony: Šablony HL7v2: `microsofthealth/fhirconverter:default` `microsofthealth/hl7v2templates:default` Šablony C-CDA: `microsofthealth/ccdatemplates:default` Šablony JSON: `microsofthealth/jsontemplates:default` Šablony FHIR STU3 : `microsofthealth/stu3tor4templates:default` Pro vlastní šablony: `<RegistryServer>/<imageName>@<imageDigest>`, `<RegistryServer>/<imageName>:<imageTag>`
rootTemplate	Kořenová šablona, která se má použít při transformaci dat.	Pro 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 Pro C-CDA: CCD, ConsultationNote, DischargeSummary, HistoryandPhysical, OperativeNote, ProcedureNote, ProgressNote, ReferralNote, TransferSummary Pro JSON: ExamplePatient, Stu3ChargeItem Pro FHIR STU3: Název prostředku FHIR STU3 (například Pacient, Pozorování, Organizace)

Poznámka

Šablony FHIR STU3 až FHIR R4 jsou šablony Liquid, které poskytují mapování rozdílů v polích pouze mezi prostředkem FHIR STU3 a jeho ekvivalentním prostředkem ve specifikaci FHIR R4. Některé prostředky FHIR STU3 se přejmenují nebo odeberou z FHIR R4. Další informace o rozdílech mezi zdroji a omezeních pro převod FHIR STU3 na FHIR R4 najdete v tématu Rozdíly prostředků a omezení pro převod FHIR STU3 na FHIR R4.

Poznámka

Šablony JSON jsou ukázkové šablony, které se použijí při vytváření vlastních mapování převodů. Nejedná se o výchozí šablony, které dodržují předdefinované typy zpráv o stavu. Samotný JSON není určený jako formát dat stavu, na rozdíl od HL7v2 nebo C-CDA. Proto místo poskytování výchozích šablon JSON poskytujeme ukázkové šablony JSON, které můžete použít jako výchozí bod pro vlastní přizpůsobená mapování.

Upozornění

Výchozí šablony jsou vydávány v rámci licence MIT a podpora Microsoftu je nepodporuje.

Výchozí šablony jsou k dispozici jenom proto, aby vám pomohly začít s pracovním postupem převodu dat. Tyto výchozí šablony nejsou určené pro produkční prostředí a můžou se změnit, když Microsoft vydá aktualizace pro službu FHIR. Chcete-li mít konzistentní chování při převodu dat v různých verzích služby FHIR, musíte provést následující kroky:

Hostujte vlastní kopii šablon v instanci Azure Container Registry.
Zaregistrujte šablony ve službě FHIR.
Ve voláních rozhraní API používejte zaregistrované šablony.
Ověřte, že chování převodu splňuje vaše požadavky.

Další informace o hostování vlastních šablon najdete v tématu Hostování vlastních šablon.

Ukázkový požadavek

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

Ukázková odpověď

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

Výsledkem převodu FHIR je sada FHIR jako dávka.

Sada FHIR by měla odpovídat očekáváním specifikace FHIR R4 – Bundle – FHIR v4.0.1.
Pokud se pokoušíte ověřit u konkrétního profilu, musíte provést určité následné zpracování pomocí operace FHIR $validate .

Další kroky

V tomto článku jste se dozvěděli o $convert-data operaci a o tom, jak používat koncový bod pro převod dat o stavu na FHIR R4 pomocí služby FHIR ve službě Azure Health Data Service.

Informace o konfiguraci nastavení pro $convert-data použití Azure Portal najdete v tématu

Konfigurace nastavení pro $convert-data pomocí Azure Portal

Informace o řešení potíží $convert-datanajdete v tématu

Řešení potíží s $convert-data

Informace o nejčastějších dotazech k $convert-datatématu najdete v tématu

Nejčastější dotazy k $convert-data

FHIR® je registrovaná ochranná známka společnosti Health Level Seven International, registrovaná v U.S. Trademark Office a je používána s jejich svolením.

Přehled $convert dat

Použití koncového bodu $convert-data

Parametry

Ukázkový požadavek

Ukázková odpověď

Další kroky

Další materiály