$convert-adatok az FHIR szolgáltatásban

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 szükség szerint testre is szabhatja.

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

• „HL7v2”-ből „FHIR R4”-be
• „C-CDA”-ból „FHIR R4”-be
• „JSON”-ból „FHIR R4”-be (egyéni konvertálási leképezésekhez)
• „FHIR STU3”-ból „FHIR R4”-be

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 az alábbi táblázat ismerteti.

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. Ennek eredményeképpen ahelyett, hogy alapértelmezett JSON-sablonokat adnánk meg, néhány minta JSON-sablont biztosítunk kiindulópontként a saját testreszabott leképezéseihez.

Mintakérelem

{
    "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-data hibaelhárítása

$convert-data GYIK