$convert-adatok az FHIR szolgáltatásban

Cikk
05/17/2024

Feljegyzés

2024 májusában kiadtunk egy különálló FHIR konverter API-t, amely az FHIR szolgáltatástól független, és tárolórendszerképként (Docker) csomagolva lett előzetes verzióra. Amellett, hogy lehetővé teszi az adatok konvertálását a rekord forrásából FHIR R4-csomagokká, az FHIR konverter számos új nettó képességet kínál, például:

Kétirányú adatkonvertálás rekordforrásból FHIR R4-kötegekké és vissza. Az FHIR konverter például vissza tudja konvertálni az adatokat az FHIR R4 formátumból HL7v2 formátumba.
Továbbfejlesztett felhasználói élmény az alapértelmezett Liquid-sablonok testreszabásához.
Minták, amelyek bemutatják, hogyan hozható létre ETL-folyamat (kinyerés, átalakítás, betöltés) az Azure Data Factory (ADF) használatával.

Az FHIR konvertertároló lemezképének implementálásához tekintse meg az FHIR konverter GitHub-projektet.

Az $convert-data FHIR® szolgáltatásban végzett művelet lehetővé teszi az állapotadatok átalakítását különböző formátumokból FHIR R4-adatokká. A $convert-data művelet az FHIR-konverter projekt folyékony sablonjait használja az FHIR-adatkonvertáláshoz. Ezeket a konvertálási sablonokat igény szerint testre is szabhatja.

A $convert-data művelet négy adatkonvertálási típust támogat:

HL7v2–FHIR R4
C-CDA–FHIR R4
JSON–FHIR R4 (egyéni konverziós leképezésekhez)
FHIR STU3–FHIR R4

A $convert-data végpont használata

Használja a $convert-data végpontot összetevőként egy ETL-folyamaton belül (kinyerés, átalakítás és betöltés) az állapotadatok különböző formátumokból (például HL7v2, CCDA, JSON és FHIR STU3) való átalakításához FHIR formátumban. Hozzon létre egy ETL-folyamatot egy teljes munkafolyamathoz az állapotadatok konvertálása során. Javasoljuk, hogy az Azure Logic Apps vagy az Azure Data Factory alapján használjon ETL-motort. A munkafolyamatok közé tartozhat például az adatbetöltés, a műveletek végrehajtása$convert-data, az érvényesítés, az adatok elő- és utófeldolgozása, az adatnövelés, az adatdeduplikáció és az adatok betöltése az FHIR szolgáltatásban való adatmegőrzés céljából.

A $convert-data művelet REST API-műveletként integrálva van az FHIR szolgáltatásba. A végpontot az $convert-data alábbiak szerint hívhatja meg:

POST {{fhirurl}}/$convert-data

Az átalakítás állapotadatai a kérelem törzsében $convert-data található FHIR szolgáltatásnak lesznek kézbesítve. Ha a kérés sikeres, az FHIR szolgáltatás FHIR csomagválaszt ad vissza az FHIR R4-re konvertált adatokkal.

Paraméterek

Egy $convert-data műveleti hívás a kérelem törzsében lévő JSON-formátumú paramétereken belül csomagolja be az állapotadatokat az átalakításhoz. A paramétereket a következő táblázat ismerteti:

Paraméter neve	Leírás	Elfogadott értékek
inputData	Az FHIR-vé konvertálandó adattartalom.	A következőhöz `Hl7v2`: sztring A következőhöz `Ccda`: XML A következőhöz `Json`: JSON A következőhöz `FHIR STU3`: JSON
inputDataType	Adatbevitel típusa.	`Hl7v2`, `Ccda`, `JsonFhir`
templateCollectionReference	Hivatkozás egy OCI-rendszerképsablon-gyűjteményre az Azure Container Registryben. A hivatkozás egy olyan képre vonatkozik, amely az átalakításhoz használandó Folyékony sablonokat tartalmazza. Hivatkozhat alapértelmezett sablonokra vagy az FHIR szolgáltatásban regisztrált egyéni sablonrendszerképekre. Az alábbi szakaszok a sablonok testreszabását, az Azure Container Registryben való üzemeltetését és az FHIR szolgáltatásba való regisztrációt ismertetik.	Alapértelmezett/mintasablonok esetén: HL7v2-sablonok : `microsofthealth/fhirconverter:default` `microsofthealth/hl7v2templates:default` C-CDA-sablonok : `microsofthealth/ccdatemplates:default` JSON-sablonok : `microsofthealth/jsontemplates:default` FHIR STU3-sablonok : `microsofthealth/stu3tor4templates:default` Egyéni sablonok esetén: `<RegistryServer>/<imageName>@<imageDigest>`, `<RegistryServer>/<imageName>:<imageTag>`
rootTemplate	Az adatok átalakítása során használandó gyökérsablon.	HL7v2 esetén: 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 C-CDA esetén: CCD, ConsultationNote, DischargeSummary, HistoryandPhysical, OperativeNote, ProcedureNote, ProgressNote, ReferralNote, TransferSummary JSON esetén: ExamplePatient, Stu3ChargeItem FHIR STU3 esetén: FHIR STU3 erőforrás neve (például: Patient, Observation, Organization)

Megfontolások

Az FHIR STU3–FHIR R4 sablonok olyan folyékony sablonok , amelyek csak az FHIR STU3 erőforrás és az FHIR R4 specifikációban szereplő egyenértékű erőforrás közötti mezőkülönbségek leképezését biztosítják. Az FHIR STU3 egyes erőforrásait átnevezi vagy eltávolítja az FHIR R4-ből. Az FHIR STU3-ról FHIR R4-re való konvertálás erőforrás-eltéréseiről és korlátairól az FHIR STU3 és FHIR R4 közötti átalakítás erőforrás-eltéréseit és korlátait ismertető cikkben talál további információt.
A JSON-sablonok mintasablonok saját konverziós leképezések készítéséhez. Ezek nem alapértelmezett sablonok, amelyek megfelelnek az előre definiált állapotadat-üzenettípusoknak. Maga a JSON nincs megadva állapotadat-formátumként, ellentétben a HL7v2-vel vagy a C-CDA-vel. Ezért ahelyett, hogy alapértelmezett JSON-sablonokat adnánk meg, néhány JSON-sablont biztosítunk kiindulópontként a saját testreszabott leképezéseihez.

Figyelmeztetés

Az alapértelmezett sablonok az MIT-licenc alatt jelennek meg, és a Microsoft nem támogatja.

Az alapértelmezett sablonok csak az adatkonvertálási munkafolyamat első lépéseihez nyújtanak segítséget. Ezek az alapértelmezett sablonok nem éles használatra készültek, és változhatnak, amikor a Microsoft kiadja az FHIR szolgáltatás frissítéseit. Ha konzisztens adatkonvertálási viselkedést szeretne az FHIR szolgáltatás különböző verzióiban, tegye a következőket:

Saját példányt üzemeltet a sablonokról egy Azure Container Registry-példányban.
Regisztrálja a sablonokat az FHIR szolgáltatásban.
Használja a regisztrált sablonokat az API-hívásokban.
Ellenőrizze, hogy a konvertálási viselkedés megfelel-e a követelményeknek.

További információ a saját sablonok üzemeltetéséről: Saját sablonok üzemeltetése

Mintakérés

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

Mintaválasz

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

Az FHIR-átalakítás eredménye egy FHIR-csomag kötegként.

Az FHIR csomagnak összhangban kell lennie az FHIR R4 specifikáció elvárásaival – Bundle – FHIR v4.0.1.
Ha egy adott profilon próbál érvényesíteni, az FHIR $validate művelet használatával végre kell tennie néhány utólagos feldolgozást.

Következő lépések

$convert-adatok beállításainak konfigurálása az Azure Portal használatával

$convert-adatok hibaelhárítása

$convert adatokkal kapcsolatos gyakori kérdések