Adatok átalakítása FHIR for Azure API for FHIR-be
Fontos
Az Azure API for FHIR 2026. szeptember 30-án megszűnik. A migrálási stratégiákat követve válthat az Azure Health Data Services FHIR szolgáltatásra ezen a napon. Az Azure API for FHIR megszűnése miatt 2025. április 1-től nem lesz lehetőség új üzembe helyezéseket végezni. Az Azure Health Data Services FHIR szolgáltatás az Azure API for FHIR továbbfejlesztett verziója, amely lehetővé teszi az ügyfelek számára az FHIR, a DICOM és a MedTech szolgáltatások kezelését más Azure-szolgáltatásokba való integrációval.
Az $convert-data FHIR szolgáltatás egyéni végpontja a különböző adattípusokból FHIR-be történő adatkonvertálásra szolgál. A Liquid sablonmotort és az FHIR Konverter projekt sablonjait használja alapértelmezett sablonként. Ezeket a konvertálási sablonokat igény szerint testre is szabhatja.
Az $convert-data egyéni végpont jelenleg az adatkonvertálás típusait támogatja four :
| Forrásadatok formátuma | Céladat-formátum |
|---|---|
| C-CDA | FHIR |
| HL7v2 | FHIR |
| JSON | FHIR |
| FHIR STU3 | FHIR R4 |
Feljegyzés
$convert-data végpont használható összetevőként egy ETL-folyamaton belül a nyers egészségügyi adatok régi formátumokból FHIR formátumúvá alakításához. Ez azonban önmagában nem ETL-folyamat. Javasoljuk, hogy használjon egy ETL-motort, például a Logic Appst vagy az Azure Data Factoryt egy teljes munkafolyamathoz az FHIR-adatok FHIR-kiszolgálón való megőrzésének előkészítéséhez. A munkafolyamat többek között a következők lehetnek: adatolvasás és -betöltés, adatérvényesítés, $convert-data API-hívások kezdeményezése, adatok elő-/utófeldolgozása, adatdúsítás és adatismétlés.
A $convert-data végpont használata
A $convert-data művelet integrálva van az FHIR szolgáltatásba, hogy a szolgáltatás részeként fusson. Miután engedélyezte $convert-data a kiszolgálót, API-hívásokat indíthat a kiszolgálóra az adatok FHIR-vé alakításához: https://<<FHIR service base URL>>/$convert-data
Paramétererőforrás
$convert-data egy paramétererőforrást vesz fel a kérelem törzsében az alábbi táblázatban leírtak szerint. Az API híváskérési törzsében a következő paramétereket kell megadnia:
| Paraméter neve | Leírás | Elfogadott értékek |
|---|---|---|
| inputData | Konvertálandó adatok. | 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 | A bemenet adattípusa. | HL7v2, Ccda, JsonFhir |
| templateCollectionReference | Hivatkozás az Azure Container Registry (ACR) OCI-rendszerképsablon-gyűjteményére . Ez az a kép, amely folyékony sablonokat tartalmaz az átalakításhoz. Hivatkozás lehet az alapértelmezett sablonokra vagy az FHIR szolgáltatásban regisztrált egyéni sablonrendszerképre. Az alábbiakban megismerheti a sablonok testreszabását, az ACR-en való üzemeltetést és a regisztrációt az FHIR szolgáltatásban. | Alapértelmezett/mintasablonok esetén: HL7v2-sablonok : microsofthealth/fhirconverter:default microsofthealth/hl7v2templates:defaultC-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": STU3-erőforrás neve, pl. "Patient", "Observation", "Organization". |
Feljegyzés
Az FHIR STU3–R4 sablonok "diff" folyékony sablonok, amelyek csak a STU3 erőforrás és az azzal egyenértékű erőforrás közötti mezőkülönbségek leképezését biztosítják az FHIR R4 szabványban. A STU3-erőforrások némelyikét átnevezi vagy eltávolítja az R4-ből. Tekintse meg a STU3-ról R4-re való konvertálás erőforrás-különbségeit és korlátait.
Feljegyzés
A JSON-sablonok mintasablonok használatra, nem pedig "alapértelmezett" sablonok, amelyek megfelelnek az előre definiált JSON-üzenettípusoknak. A JSON nem rendelkezik szabványosított üzenettípusokkal, ellentétben a HL7v2-üzenetekkel vagy a C-CDA-dokumentumokkal. Ezért az alapértelmezett sablonok helyett néhány mintasablont biztosítunk, amelyeket kiindulási útmutatóként használhat saját testreszabott sablonjaihoz.
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 a gyors kezdéshez nyújtanak segítséget. Előfordulhat, hogy az FHIR-hez készült Azure API verzióinak frissítésekor frissülnek. Ezért ellenőriznie kell a konvertálási viselkedést, és saját sablonpéldányt kell üzemeltetnie egy Azure Container Registryben, regisztrálnia kell azokat az Azure API for FHIR-ben, és az API-hívásokban kell használnia, hogy konzisztens adatkonvertálási viselkedést biztosíthasson az Azure API for FHIR különböző verzióiban.
Kérésminta
{
"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": "transaction",
"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"
}
}
]
}
Sablonok testreszabása
A Visual Studio Code FHIR Converter bővítményével igény szerint testre szabhatja a sablonokat. A bővítmény interaktív szerkesztési élményt nyújt, és megkönnyíti a Microsoft által közzétett sablonok és mintaadatok letöltését. További részletekért tekintse meg a bővítmény dokumentációját.
Feljegyzés
A Visual Studio Code FHIR Converter bővítménye HL7v2, C-CDA és JSON Liquid sablonokhoz érhető el. Az FHIR STU3–R4 Liquid sablonok jelenleg nem támogatottak.
Sablonok tárolása és használata
Javasoljuk, hogy saját sablonpéldányt tároljon az ACR-en. A sablonok saját példányának üzemeltetéséhez és a $convert-data művelethez tartozók használatának négy lépése van:
- Küldje el a sablonokat az Azure Container Registrybe.
- Engedélyezze a felügyelt identitást az Azure API for FHIR-példányon.
- Az ACR hozzáférésének biztosítása az Azure API for FHIR felügyelt identitáshoz.
- Regisztrálja az ACR-kiszolgálókat az Azure API for FHIR-ben.
- Igény szerint konfigurálja az ACR-tűzfalat a biztonságos hozzáférés érdekében.
Sablonok leküldése az Azure Container Registrybe
Az ACR-példány létrehozása után az FHIR Converter: Push Templates paranccsal az FHIR Converter bővítményben leküldheti a testre szabott sablonokat az ACR-be. Másik lehetőségként a Sablonkezelési parancssori felület eszközt is használhatja erre a célra.
Felügyelt identitás engedélyezése az Azure API for FHIR-ben
Keresse meg az Azure API for FHIR szolgáltatás példányát az Azure Portalon, majd válassza az Identitás panelt. Módosítsa az állapotot Be állapotra a felügyelt identitás engedélyezéséhez az Azure API for FHIR-ben.
Az ACR hozzáférésének biztosítása az Azure API for FHIR-hez
Keresse meg a Hozzáférés-vezérlés (IAM) panelt.
Válassza a Hozzáadás, majd a Szerepkör-hozzárendelés hozzáadása lehetőséget a Szerepkör-hozzárendelés hozzáadása lap megnyitásához.
Rendelje hozzá az AcrPull szerepkört.
A szerepkörök Azure Portalon való hozzárendeléséről további információt az Azure beépített szerepköreivel kapcsolatban talál.
Az ACR-kiszolgálók regisztrálása az Azure API for FHIR-ben
Az ACR-kiszolgálót az Azure Portalon vagy a parancssori felület használatával regisztrálhatja.
Az ACR-kiszolgáló regisztrálása az Azure Portalon
Keresse meg az Artifacts panelt az Adatátalakítás alatt az Azure API for FHIR-példányban. Megjelenik az aktuálisan regisztrált ACR-kiszolgálók listája. Válassza a Hozzáadás lehetőséget, majd válassza ki a beállításjegyzék-kiszolgálót a legördülő menüből. A regisztráció érvénybe lépéséhez a Mentés lehetőséget kell választania. A módosítás alkalmazása és a példány újraindítása eltarthat néhány percig.
Az ACR-kiszolgáló regisztrálása parancssori felülettel
Legfeljebb 20 ACR-kiszolgáló regisztrálható az Azure API for FHIR-ben.
Szükség esetén telepítse az Azure Health Data Services parancssori felületét az Azure PowerShellből:
az extension add -n healthcareapis
Regisztrálja az acr-kiszolgálókat az Azure API for FHIR-be az alábbi példákat követve:
Egyetlen ACR-kiszolgáló regisztrálása
az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021
Több ACR-kiszolgáló regisztrálása
az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io fhiracr2020.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021
ACR-tűzfal konfigurálása
Válassza az Azure Storage-fiók hálózatkezelését a portálon.
Válassza a Kijelölt hálózatok lehetőséget.
A Tűzfal szakaszban adja meg az IP-címet a Címtartomány mezőben. Adjon hozzá IP-tartományokat az internetről vagy a helyszíni hálózatokról való hozzáférés engedélyezéséhez.
Az alábbi táblázatban annak az Azure-régiónak az IP-címét találja, ahol az Azure API for FHIR szolgáltatás ki van építve.
| Azure-régió | Nyilvános IP-cím |
|---|---|
| Kelet-Ausztrália | 20.53.47.210 |
| Dél-Brazília | 191.238.72.227 |
| Közép-Kanada | 20.48.197.161 |
| Közép-India | 20.192.47.66 |
| USA keleti régiója | 20.62.134.242, 20.62.134.244, 20.62.134.245 |
| USA 2. keleti régiója | 20.62.60.115, 20.62.60.116, 20.62.60.117 |
| Közép-Franciaország | 51.138.211.19 |
| Észak-Németország | 51.116.60.240 |
| Középnyugat-Németország | 20.52.88.224 |
| Kelet-Japán | 20.191.167.146 |
| Nyugat-Japán | 20.189.228.225 |
| Dél-Korea középső régiója | 20.194.75.193 |
| USA északi középső régiója | 52.162.111.130, 20.51.0.209 |
| Észak-Európa | 52.146.137.179 |
| Közép-Katar | 20.21.36.225 |
| Dél-Afrika északi régiója | 102.133.220.199 |
| USA déli középső régiója | 20.65.134.83 |
| Délkelet-Ázsia | 20.195.67.208 |
| Közép-Svédország | 51.12.28.100 |
| Észak-Svájc | 51.107.247.97 |
| Az Egyesült Királyság déli régiója | 51.143.213.211 |
| Az Egyesült Királyság nyugati régiója | 51.140.210.86 |
| USA nyugati középső régiója | 13.71.199.119 |
| Nyugat-Európa | 20.61.103.243, 20.61.103.244 |
| USA 2. nyugati régiója | 20.51.13.80, 20.51.13.84, 20.51.13.85 |
| USA 3. nyugati régiója | 20.150.245.165 |
Feljegyzés
A fenti lépések hasonlóak az FHIR-adatok exportálása című dokumentumban leírt konfigurációs lépésekhez. További információ: Biztonságos exportálás az Azure Storage-ba
Ellenőrzés
Hívja meg a $convert-data API-t, amely megadja a sablonreferenciát a templateCollectionReference paraméterben.
<RegistryServer>/<imageName>@<imageDigest>
Következő lépések
Ebben a cikkben megismerhette az Azure API for FHIR adatkonvertálását. Az FHIR-hez készült Azure API-hoz készült kapcsolódó GitHub-projektekkel kapcsolatos további információkért lásd:
Az FHIR® a HL7 bejegyzett védjegye, amelyet a HL7 engedélyével használnak.