Uw gegevens converteren naar FHIR voor Azure API for FHIR
Belangrijk
Azure API for FHIR wordt op 30 september 2026 buiten gebruik gesteld. Volg de migratiestrategieën om op die datum over te stappen naar de FHIR-service van Azure Health Data Services. Vanwege de buitengebruikstelling van Azure API for FHIR zijn nieuwe implementaties vanaf 1 april 2025 niet toegestaan. De FHIR-service van Azure Health Data Services is de ontwikkelde versie van Azure API for FHIR waarmee klanten FHIR-, DICOM- en MedTech-services kunnen beheren met integraties in andere Azure-services.
Het $convert-data aangepaste eindpunt in de FHIR-service is bedoeld voor gegevensconversie van verschillende gegevenstypen naar FHIR. Het maakt gebruik van de Liquid-sjabloonengine en de sjablonen uit het FHIR Converter-project als de standaardsjablonen. U kunt deze conversiesjablonen zo nodig aanpassen.
Momenteel ondersteunt four het $convert-data aangepaste eindpunt typen gegevensconversie:
| Oorspronkelijke gegevensindeling | Doelgegevensindeling |
|---|---|
| C-CDA | FHIR |
| HL7v2 | FHIR |
| JSON | FHIR |
| FHIR STU3 | FHIR R4 |
Notitie
$convert-data eindpunt kan worden gebruikt als onderdeel binnen een ETL-pijplijn voor de conversie van onbewerkte gezondheidszorggegevens van verouderde indelingen naar FHIR-indeling. Het is echter geen ETL-pijplijn op zichzelf. U wordt aangeraden een ETL-engine zoals Logic Apps of Azure Data Factory te gebruiken voor een volledige werkstroom bij het voorbereiden van uw FHIR-gegevens die op de FHIR-server moeten worden bewaard. De werkstroom kan bestaan uit: gegevens lezen en opnemen, gegevensvalidatie, het maken van $convert-gegevens-API-aanroepen, gegevens vooraf/na verwerking, gegevensverrijking en gegevensontdubbeling.
Het eindpunt $convert-data gebruiken
De $convert-data bewerking is geïntegreerd in de FHIR-service die wordt uitgevoerd als onderdeel van de service. Nadat u de server hebt ingeschakeld $convert-data , kunt u API-aanroepen naar de server uitvoeren om uw gegevens te converteren naar FHIR: https://<<FHIR service base URL>>/$convert-data
Parameterresource
$convert-data neemt een parameterresource in de aanvraagbody, zoals beschreven in de onderstaande tabel. In de aanvraagtekst van de API-aanroep neemt u de volgende parameters op:
| Parameternaam | Beschrijving | Geaccepteerde waarden |
|---|---|---|
| inputData | Gegevens die moeten worden geconverteerd. | Voor Hl7v2: tekenreeks Voor Ccda: XML Voor Json: JSON Voor FHIR STU3: JSON |
| inputDataType | Gegevenstype invoer. | HL7v2, , , CcdaJsonFhir |
| templateCollectionReference | Verwijzing naar een verzameling OCI-installatiekopieënsjabloon in Azure Container Registry (ACR). Het is de afbeelding met Liquid-sjablonen die moeten worden gebruikt voor conversie. Dit kan een verwijzing zijn naar de standaardsjablonen of een aangepaste sjablooninstallatiekopieën die zijn geregistreerd in de FHIR-service. Zie hieronder voor meer informatie over het aanpassen van de sjablonen, het hosten van sjablonen op ACR en het registreren bij de FHIR-service. | Voor standaard-/voorbeeldsjablonen: HL7v2-sjablonen : microsofthealth/fhirconverter:default microsofthealth/hl7v2templates:defaultC-CDA-sjablonen : microsofthealth/ccdatemplates:default JSON-sjablonen : microsofthealth/jsontemplates:default FHIR STU3-sjablonen : microsofthealth/stu3tor4templates:default Voor aangepaste sjablonen: <RegistryServer>/<imageName>@<imageDigest>, <RegistryServer>/<imageName>:<imageTag> |
| rootTemplate | De hoofdsjabloon die moet worden gebruikt tijdens het transformeren van de gegevens. | Voor 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" Voor C-CDA: "CCD", "ConsultationNote", "DischargeSummary", "HistoryandPhysical", "OperativeNote", "ProcedureNote", "ProgressNote", "ReferralNote", "TransferSummary" Voor JSON: "ExamplePatient", "Stu3ChargeItem" FHIR STU3": STU3 Resource Name, bijvoorbeeld 'Patient', 'Observation', 'Organization'. |
Notitie
FHIR STU3 naar R4-sjablonen zijn 'diff' Liquid-sjablonen die alleen toewijzingen bieden van veldverschillen tussen STU3-resource en de bijbehorende resource in FHIR R4-standaard. Sommige STU3-resources worden hernoemd of verwijderd uit R4. Raadpleeg resourceverschillen en -beperkingen voor stu3-naar-R4-conversie.
Notitie
JSON-sjablonen zijn voorbeeldsjablonen voor gebruik, niet standaardsjablonen die voldoen aan vooraf gedefinieerde JSON-berichttypen. JSON heeft geen gestandaardiseerde berichttypen, in tegenstelling tot HL7v2-berichten of C-CDA-documenten. Daarom bieden we u in plaats van standaardsjablonen enkele voorbeeldsjablonen die u als uitgangspunt kunt gebruiken voor uw eigen aangepaste sjablonen.
Waarschuwing
Standaardsjablonen worden uitgebracht onder MIT-licentie en worden niet ondersteund door Microsoft Ondersteuning.
Standaardsjablonen zijn alleen beschikbaar om snel aan de slag te gaan. Ze worden mogelijk bijgewerkt wanneer we versies van de Azure API for FHIR bijwerken. Daarom moet u het conversiegedrag controleren en uw eigen kopie van sjablonen in een Azure Container Registry hosten, deze registreren bij de Azure API for FHIR en gebruiken in uw API-aanroepen om consistent gedrag voor gegevensconversie te hebben in de verschillende versies van Azure API for FHIR.
Voorbeeldaanvraag
{
"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"
}
]
}
Voorbeeldantwoord
{
"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"
}
}
]
}
Sjablonen aanpassen
U kunt de FHIR Converter-extensie voor Visual Studio Code gebruiken om de sjablonen aan te passen op basis van uw behoeften. De extensie biedt een interactieve bewerkingservaring en maakt het eenvoudig om door Microsoft gepubliceerde sjablonen en voorbeeldgegevens te downloaden. Raadpleeg de documentatie in de extensie voor meer informatie.
Notitie
De FHIR Converter-extensie voor Visual Studio Code is beschikbaar voor HL7v2-, C-CDA- en JSON Liquid-sjablonen. FHIR STU3 naar R4 Liquid-sjablonen worden momenteel niet ondersteund.
Sjablonen hosten en gebruiken
Het is raadzaam om uw eigen exemplaar van sjablonen op ACR te hosten. Er zijn vier stappen betrokken bij het hosten van uw eigen kopie van sjablonen en het gebruik van sjablonen in de $convert-gegevensbewerking:
- Push de sjablonen naar uw Azure Container Registry.
- Schakel Beheerde identiteit in op uw Azure API for FHIR-exemplaar.
- Geef toegang tot de ACR voor de Beheerde identiteit van Azure API for FHIR.
- Registreer de ACR-servers in de Azure API for FHIR.
- Configureer eventueel ACR-firewall voor beveiligde toegang.
Sjablonen pushen naar Azure Container Registry
Nadat u een ACR-exemplaar hebt gemaakt, kunt u de opdracht FHIR Converter: Push Templates in de FHIR Converter-extensie gebruiken om de aangepaste sjablonen naar de ACR te pushen. U kunt ook het CLI-hulpprogramma sjabloonbeheer gebruiken voor dit doel.
Beheerde identiteit inschakelen in Azure API for FHIR
Blader naar uw exemplaar van de Azure API for FHIR-service in Azure Portal en selecteer vervolgens de blade Identiteit . Wijzig de status in Aan om beheerde identiteit in te schakelen in Azure API for FHIR.
Toegang bieden tot de ACR naar Azure API for FHIR
Blader naar de blade Toegangsbeheer (IAM).
Selecteer Toevoegen en selecteer vervolgens Roltoewijzing toevoegen om de pagina Roltoewijzing toevoegen te openen.
Wijs de rol AcrPull toe.
Zie ingebouwde Azure-rollen voor meer informatie over het toewijzen van rollen in Azure Portal.
De ACR-servers registreren in Azure API for FHIR
U kunt de ACR-server registreren met behulp van Azure Portal of cli.
De ACR-server registreren met behulp van Azure Portal
Blader naar de blade Artefacten onder Gegevenstransformatie in uw Azure API for FHIR-exemplaar. U ziet de lijst met momenteel geregistreerde ACR-servers. Selecteer Toevoegen en selecteer vervolgens uw registerserver in de vervolgkeuzelijst. U moet Opslaan selecteren om de registratie van kracht te laten worden. Het kan enkele minuten duren om de wijziging toe te passen en uw exemplaar opnieuw op te starten.
De ACR-server registreren met behulp van CLI
U kunt maximaal 20 ACR-servers registreren in de Azure API for FHIR.
Installeer indien nodig azure Health Data Services CLI vanuit Azure PowerShell:
az extension add -n healthcareapis
Registreer de acr-servers bij Azure API for FHIR volgens de onderstaande voorbeelden:
Eén ACR-server registreren
az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021
Meerdere ACR-servers registreren
az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io fhiracr2020.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021
ACR-firewall configureren
Selecteer Netwerken van het Azure-opslagaccount in de portal.
Selecteer Geselecteerde netwerken.
Geef onder de sectie Firewall het IP-adres op in het vak Adresbereik . Voeg IP-bereiken toe om toegang vanaf internet of uw on-premises netwerken toe te staan.
In de onderstaande tabel vindt u het IP-adres voor de Azure-regio waarin de Azure API for FHIR-service is ingericht.
| Azure-regio | Openbaar IP-adres |
|---|---|
| Australië - oost | 20.53.47.210 |
| Brazilië - zuid | 191.238.72.227 |
| Canada - midden | 20.48.197.161 |
| India - centraal | 20.192.47.66 |
| VS - oost | 20.62.134.242, 20.62.134.244, 20.62.134.245 |
| VS - oost 2 | 20.62.60.115, 20.62.60.116, 20.62.60.117 |
| Frankrijk - centraal | 51.138.211.19 |
| Duitsland - noord | 51.116.60.240 |
| Duitsland - west-centraal | 20.52.88.224 |
| Japan East | 20.191.167.146 |
| Japan - west | 20.189.228.225 |
| Korea - centraal | 20.194.75.193 |
| VS - noord-centraal | 52.162.111.130, 20.51.0.209 |
| Europa - noord | 52.146.137.179 |
| Qatar - centraal | 20.21.36.225 |
| Zuid-Afrika - noord | 102.133.220.199 |
| VS - zuid-centraal | 20.65.134.83 |
| Azië - zuidoost | 20.195.67.208 |
| Zweden - centraal | 51.12.28.100 |
| Zwitserland - noord | 51.107.247.97 |
| Verenigd Koninkrijk Zuid | 51.143.213.211 |
| Verenigd Koninkrijk West | 51.140.210.86 |
| VS - west-centraal | 13.71.199.119 |
| Europa -west | 20.61.103.243, 20.61.103.244 |
| VS - west 2 | 20.51.13.80, 20.51.13.84, 20.51.13.85 |
| US - west 3 | 20.150.245.165 |
Notitie
De bovenstaande stappen zijn vergelijkbaar met de configuratiestappen die worden beschreven in het document FHIR-gegevens exporteren. Zie Secure Export naar Azure Storage voor meer informatie
Verifiëren
Maak een aanroep naar de $convert-gegevens-API die uw sjabloonverwijzing opgeeft in de parameter templateCollectionReference.
<RegistryServer>/<imageName>@<imageDigest>
Volgende stappen
In dit artikel hebt u geleerd over gegevensconversie voor Azure API for FHIR. Zie voor meer informatie over gerelateerde GitHub Projects for Azure API for FHIR
FHIR® is een geregistreerd handelsmerk van HL7 en wordt gebruikt met de machtiging HL7.
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor