A $convert-data áttekintése

Megjegyzés

A Fast Healthcare Interoperability Resources (FHIR®) egy nyílt egészségügyi specifikáció.

Az FHIR szolgáltatásban található művelettel $convert-data különböző formátumokból konvertálhatja az állapotadatokat 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 testreszabhatja. $convert-data A művelet jelenleg 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

Megjegyzés

A végpontot egy ETL-folyamat (kinyerés, átalakítás és betöltés) összetevőjeként használhatja $convert-data az állapotadatok különböző formátumokból (például HL7v2, CCDA, JSON és FHIR STU3) FHIR formátumban történő átalakításához. Az állapotadatok konvertálása során létrehozhat egy ETL-folyamatot egy teljes munkafolyamathoz. Javasoljuk, hogy olyan ETL-motort használjon, amely az Azure Logic Appsen vagy Azure Data Factory alapul. A munkafolyamatok közé tartozhat például az adatbetöltés, a műveletek végrehajtása $convert-data , az ellenőrzés, az adatok feldolgozás előtti/utáni feldolgozása, az adatdúsítá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 végpont használata

A $convert-data művelet REST API-műveletként van integrálva az FHIR szolgáltatásba. A végpontot a $convert-data következőképpen hívhatja meg:

POST {{fhirurl}}/$convert-data

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

Paraméterek

A $convert-data művelethívások a kérelem törzsében lévő JSON-formátumú paramétereken belüli átalakítás állapotadatait csomagolják be. 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, Json, Fhir
templateCollectionReference	Hivatkozás egy OCI-rendszerképsablon-gyűjteményreAzure Container Registry. A hivatkozás egy olyan képre vonatkozik, amely az átalakításhoz használandó Folyékony sablonokat tartalmazza. Az alapértelmezett sablonokra vagy az FHIR szolgáltatásban regisztrált egyéni sablonrendszerképekre hivatkozhat. Az alábbi szakaszok a sablonok testreszabását, a Azure Container Registry való üzemeltetést és a FHIR szolgáltatásban 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ásakor 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: Beteg, Megfigyelés, Szervezet)

Megjegyzés

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 történő konvertálás erőforrás-különbségeiről és korlátozásairól az Erőforrás-különbségek és korlátozások az FHIR STU3-ról FHIR R4-re való konvertáláshoz című témakörben talál további információt.

Megjegyzés

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-mintasablont biztosítunk, amelyeket kiindulási pontként használhat saját testreszabott leképezéseihez.

Figyelmeztetés

Az alapértelmezett sablonok az MIT-licenc alatt jelennek meg, és a Microsoft ügyfélszolgálata nem támogatják.

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

1. Saját sablonpéldányt üzemeltet egy Azure Container Registry-példányban.
2. Regisztrálja a sablonokat az FHIR szolgáltatásban.
3. Használja a regisztrált sablonokat az API-hívásokban.
4. Ellenőrizze, hogy az átalakítás viselkedése megfelel-e a követelményeknek.

A saját sablonok üzemeltetéséről további információt a Saját sablonok üzemeltetése című témakörben talál.

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-konverzió eredménye egy FHIR-csomag kötegként.

• Az FHIR csomagnak összhangban kell lennie az FHIR R4 specifikáció – Bundle – FHIR v4.0.1 elvárásaival.
• 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

Ebben a cikkben megismerhette a $convert-data műveletet, és azt, hogyan használhatja a végpontot az állapotadatok FHIR R4-re való konvertálásához az Azure Health Data Service FHIR szolgáltatásával.

A Azure Portal használatára vonatkozó beállítások konfigurálásáról $convert-data további információt a

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

A hibaelhárítással $convert-datakapcsolatos további információkért lásd:

$convert-data hibaelhárítása

A gyakori kérdésekről (GYIK) $convert-dataa következő témakörben olvashat:

Gyakori kérdések $convert-adatokkal kapcsolatban

Az FHIR® a Health Level Seven International bejegyzett védjegye, amely az Amerikai Egyesült Államok védjegyhivatalában van regisztrálva, és az engedélyükkel használják.