Delen via

Releaseopmerkingen vóór 2025: Azure API for FHIR

  • Artikel

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.

Azure API for FHIR® biedt een volledig beheerde implementatie van de Microsoft FHIR-server voor Azure. De server is een implementatie van de FHIR-standaard . Dit document bevat informatie over de functies en verbeteringen die zijn aangebracht in Azure API for FHIR.

November 2024

FHIR-service

Foutoplossingen

  • Verbetering van exportvalidatie: er is een probleem gevonden waarbij de export is voortgezet ondanks ongeldige zoekparameters. Er wordt een nieuwe wijziging geïmplementeerd om export onder deze voorwaarden te voorkomen. Dit is het standaardgedrag. Klanten kunnen deze overschrijven met behulp van de lenient-vlag. Deze wijziging is vorige maand doorgegeven aan klanten.
  • Verbetering van bundelprestaties: het proces voor profielvernieuwing tijdens de uitvoering van de bundel is vereenvoudigd. Als een bundel wijzigingen bevat in ValueSet, StructureDefinitionen/of CodeSystem, worden er geen profielvernieuwingen uitgevoerd totdat de bundel volledig is voltooid. Deze wijziging verbetert de prestaties van bundels door vertragingen te verminderen die worden veroorzaakt door meerdere vernieuwingen bij het afhandelen van wijzigingen in deze resourcetypen.
  • Headerparsering van inhoudstype: er is een probleem met betrekking tot het parseren van de koptekst van het application/x-www-form-urlencoded inhoudstype opgelost.
  • Herindexeringsverbeteringen De herindexbewerking is verbeterd door een kunstmatige beperking te verwijderen die eerder de verwerking van grote historische gegevenssets beperkt, of gevallen waarin klanten een beperkte querygrootte hebben aangevraagd. Daarnaast zou het proces voor opnieuw indexeren onjuist rapporteren als 'voltooid' bij het verwerken van veel opeenvolgende historische of verwijderde resources met de standaardquerygrootte. Dit probleem is opgelost om ervoor te zorgen dat het herindexeringsproces correct wordt voltooid en de juiste status rapporteert.

Oktober 2024

FHIR-service

Foutoplossingen

  • Exportvalidatie: er is een probleem vastgesteld waarbij exports werden voortgezet ondanks ongeldige zoekparameters. We introduceren een wijziging die export onder deze voorwaarden voorkomt. Deze functie bevindt zich momenteel achter een strikte validatievlag en wordt het standaardgedrag op of na 30 oktober.
  • Insluiting van zoekparameter: Er is een probleem opgelost waarbij aanvullende zoekparameters (bijvoorbeeld _include, _has) niet alle verwachte resultaten hebben geretourneerd, waardoor de volgende koppeling soms wordt weggelaten.
  • Uitvoertaakuitvoering: Er is een zeldzame gebeurtenis van tijdens het voltooien van System.ObjectDisposedException de exporttaak opgelost door voortijdige afsluitingen te voorkomen.
  • HTTP-statuscode-update: de HTTP-statuscode voor ongeldige parameters tijdens $reindex het maken van de taak wordt nu bijgewerkt naar 400, waardoor er betere foutafhandeling mogelijk is.
  • Zoekparameter opschonen: er is een oplossing geïmplementeerd om ervoor te zorgen dat de zoekparameters in de database volledig worden opgeschoond wanneer deze worden geactiveerd met verwijder-API-aanroepen, waardoor problemen met betrekking tot onvolledige verwijderingen worden opgelost.

Augustus 2024

FHIR-service

Opgeloste fouten Er is een oplossing geïmplementeerd om problemen met grote exports onjuist op te lossen, waarbij de status Voltooid wordt weergegeven terwijl onderliggende taken nog steeds worden verwerkt. De oplossing bevat een vertraging om het optreden van deze statusfouten te beperken, waardoor de betrouwbaarheid van de export wordt verbeterd.

Juli 2024

FHIR-service

Insectenmoeilijke

Opgelost: Voor het exporteren van gegevens als SMART User Exporting Data as a SMART user zijn schrijfbereiken niet meer vereist. Voorheen moesten schrijfbevoegdheden worden verleend aan een SMART-gebruiker voor het exporteren van gegevens, wat hogere bevoegdheidsniveaus impliceerde. Als u een exporttaak als SMART-gebruiker wilt initiëren, moet u ervoor zorgen dat de gebruiker lid is van de FHIR-exportrol in RBAC en vraagt u het klinische bereik 'lezen' aan.

Opgelost: Statuscode bijwerken van HTTP 500 naar HTTP 400 Tijdens een patchbewerking werd er in eerste instantie een interne serverfout (HTTP 500) gegenereerd als de nettolading een update heeft aangevraagd voor een ander resourcetype dan parameter. Dit is bijgewerkt om in plaats daarvan een HTTP 400-fout te veroorzaken.

Mei 2024

FHIR-service

Verbeteringen in de bewerking purge-history Met de bewerking purge-history kunt u een gedeeltelijke verwijdering uitvoeren met behulp van de queryparameter allowPartialSuccess. De bewerking Geschiedenis opschonen wacht standaard op een geslaagde voltooiing voordat resources worden verwijderd. Als er echter een fout optreedt tijdens de uitvoering, wordt het verwijderen van resources teruggedraaid. Met behulp van de queryparameter allowPartialSuccess kunt u voorkomen dat de transactie wordt teruggedraaid in het geval van een fout.

Foutoplossingen

  • Opgelost: HTTP-statuscode voor langlopende aanvragen. FHIR-aanvragen die langer dan 100 seconden duren om een HTTP 408-statuscode uit te voeren in plaats van HTTP 500.
  • Opgelost: Geschiedenisaanvraag in bundel. Vóór de oplossing retourneerde een geschiedenisaanvraag in een bundel HTTP-statuscode 404.

Maart 2024

Batch-bundel parallellisatie Batch-bundels worden standaard serieel uitgevoerd in de FHIR-service. Om de doorvoer met bundeloproepen te verbeteren, hebben we parallelle verwerking van batchbundels ingeschakeld.

Meer informatie:

Insectenmoeilijke

  • Opgelost: Verbeter de prestaties voor bundelverwerking. Updates worden aangebracht in de taakuitvoeringsmethode, wat leidt tot een bundeling van de prestatieverbetering. Zie PR#3727.

Februari 2024

Hiermee kunt u alle versies (historisch en voorlopig verwijderd) van resources tellen. De queryparameter _summary=count en _count=0 kunnen worden toegevoegd aan _history eindpunt om het aantal versieresources op te halen. Dit aantal omvat voorlopig verwijderde resources. Zie geschiedenisbeheer voor meer informatie.

De doorvoer voor exportbewerking verbeteren De queryparameter '_isparallel' kan worden toegevoegd aan de exportbewerking om de doorvoer te verbeteren. Het is belangrijk te weten dat het gebruik van deze parameter kan leiden tot een toename van het verbruik van aanvraageenheden gedurende de levensduur van de export. Zie Queryparameters voor exportbewerkingen voor meer informatie.

Notitie

Er is een bekend probleem met de $export-bewerking die kan leiden tot onvolledige exports met de status geslaagd. Er treedt een probleem op wanneer de vlag is_parallel is gebruikt. Exporttaken die worden uitgevoerd met _isparallel queryparameter vanaf 13 februari 2024, worden beïnvloed door dit probleem.

Wijziging in naamnomenclatuur voor geëxporteerde bestandsnaam en standaardopslagaccount met deze wijziging, geëxporteerde bestandsnamen volgen de indeling {FHIR Resource Name}-{Number}-{Number}.ndjson. De volgorde van de bestanden komt niet gegarandeerd overeen met de volgorde van de resources in de database. De standaardnaam van het opslagaccount wordt bijgewerkt naar 'Export-{Number}'. Er is geen wijziging in het aantal resources dat is toegevoegd aan afzonderlijke geëxporteerde bestanden.

Parallelle optimalisatie van prestatieverbeteringen voor FHIR-query's kan worden ingeschakeld met behulp van http-header 'x-ms-query-latency-over-efficiency'. Deze waarde moet worden ingesteld op true om maximale gelijktijdigheid te bereiken tijdens het uitvoeren van de query. Zie Batch-bundels voor meer informatie.

Januari 2024

Gelijktijdige uitvoering van query's met voorwaardelijke interacties kan complexe en prestatie-intensieve interacties zijn. Om de latentie van query's met voorwaardelijke interacties te verbeteren, hebt u de mogelijkheid om de aanvraagheader x-conditionalquery-processing-logic te gebruiken. Zie Prestatieoverwegingen voor voorwaardelijke API-interacties voor meer informatie.

December 2023

Aanvullende mogelijkheden die zijn toegevoegd aan de exportbewerking $export bewerking ondersteunt nu het exporteren van geversiede resources en voorlopig verwijderde resources. Zie Queryparameters exporteren voor meer informatie.

November 2023

Met de mogelijkheid voor bulksgewijs verwijderen in preview '$bulk-delete' kunt u resources asynchroon van de FHIR-server verwijderen. Bulksgewijs verwijderen kan worden uitgevoerd op systeemniveau of voor afzonderlijk resourcetype. Zie de bewerking bulksgewijs verwijderen voor meer informatie.

Bewerking voor bulksgewijs verwijderen is momenteel beschikbaar als openbare preview. Bekijk de disclaimer voor meer informatie. [! Disclaimer voor openbare preview opnemen]

Opgeloste fout: FHIR-query's met behulp van paginering en revinclude hebben geleid tot een fout bij het gebruik van de volgende koppeling

Het probleem is nu opgelost en FHIR-query's die gebruikmaken van het vervolgtoken met include/revinclude, rapporteren geen uitzondering meer. Ga naar #3525 voor meer informatie over de oplossing.

Juni 2023

Opgeloste fout: de URL van het metagegevenseindpunt in de mogelijkheidsinstructie is relatieve URL per FHIR-specificatie, de URL van het metagegevenseindpunt in de mogelijkheidsinstructie moet een absolute URL zijn. Ga naar Capability Statement voor meer informatie over de FHIR-specificatie. Deze fanix lost het probleem op, voor meer informatie bezoek 3265.

mei 2023

SMART on FHIR : Toewijzing van klinische bereiken voor toepassingen opgelost

Met deze foutoplossing wordt het probleem opgelost waarbij het klinische bereik niet correct wordt geïnterpreteerd voor back-endtoepassingen. Ga naar #3250 voor meer informatie

April 2023

Er zijn tijdelijke problemen opgelost die zijn gekoppeld aan het laden van aangepaste zoekparameters . Deze bugoplossing lost het probleem op, waarbij de FHIR-service de meest recente SearchParameter-status niet zou laden in het geval van een fout. Ga naar #3222 voor meer informatie

November 2022

De fout opgelost die is gegenereerd wanneer de resource wordt bijgewerkt met behulp van if-matchheader en PATCH

Er is nu een fout opgelost en de resource wordt bijgewerkt als deze overeenkomt met de Etag-header. Zie #2877| voor meer informatie.

Mei 2022

Verbetering

Verbetering Gerelateerde informatie
Azure API for FHIR maakt geen nieuwe versie van de resource als de resource-inhoud niet is gewijzigd. Als een gebruiker een bestaande resource bijwerkt en alleen meta.versionId of meta.lastUpdated is gewijzigd, retourneren we OK met bestaande resourcegegevens zonder VersionId en lastUpdated bij te werken. Zie #2519 voor meer informatie.

April 2022

Verbeteringen

Verbeteringen Gerelateerde informatie
FHIRPath-patch FHIRPath Patch is toegevoegd als een functie aan zowel de Azure API for FHIR. Hiermee wordt FHIRPath Patch geïmplementeerd zoals gedefinieerd op de HL7-website .
Bundelmelding verplaatsen naar Core Met de introductie van de naamruimte Resource.Bundle naar Core moesten de resourceverwijzingen naar het tekenreeksresourcebestand explicieter worden gemaakt. Zie PR #2478 voor meer informatie.
Verwerkt ongeldige header in versieversie van update Wanneer het versiebeheerbeleid is ingesteld op 'versie-update', is vereist dat de meest recente versie van de resource wordt opgegeven in de if-matchheader van de aanvraag voor een update. De opgegeven versie moet de ETag-indeling hebben. Voorheen zou een 500 worden geretourneerd als de versie ongeldig of in een onjuiste indeling is. Deze update retourneert nu een 400 ongeldige aanvraag. Zie PR #2467 voor meer informatie.

Foutoplossingen

Bugfixes Gerelateerde informatie
Kern toevoegen aan resourcepad Een deel van het pad naar een tekenreeksresource is per ongeluk verwijderd in het versiebeheerbeleid. Met deze oplossing wordt deze weer toegevoegd. Zie PR #2470 voor meer informatie.
SQL-time-out retourneert een 500-fout Er is een fout opgelost wanneer een SQL-aanvraag een time-out bereikt en de aanvraag een 500 retourneert. In de logboeken is dit een time-out van SQL in vergelijking met het ophalen van een 429-fout van front-end. Zie PR #2497 voor meer informatie.

Maart 2022

Functies

Functie Gerelateerde informatie
FHIRPath-patch Met deze nieuwe functie kunt u de FHIRPath Patch-bewerking op FHIR-resources gebruiken. Zie FHIR REST API-mogelijkheden voor Azure API for FHIR voor meer informatie.

Foutoplossingen

Bugfixes Gerelateerde informatie
Resources dupliceren in zoekopdracht met _include Er is een probleem opgelost waarbij één resource tweemaal kan worden geretourneerd in een zoekopdracht die _include. Zie PR #2448 voor meer informatie.
PUT maakt op een versieversie van update Probleem opgelost: bij het maken met PUT is een fout opgetreden bij het configureren versioned-updatevan het versiebeheerbeleid. Zie PR #2457 voor meer informatie.
Ongeldige verwerking van headers voor versiebeheer Er is een probleem opgelost waarbij een ongeldige if-match header tot een HTTP 500-fout zou leiden. Er wordt nu een ongeldige HTTP-aanvraag geretourneerd. Zie PR #2467 voor meer informatie.

Februari 2022

Functies en verbeteringen

Verbeteringen Gerelateerde informatie
429 nieuwe pogingen en logboekregistratie toegevoegd in BundleHandler Er treden soms 429 fouten op bij het verwerken van een bundel. Als de FHIR-service een 429 ontvangt op de BundleHandler-laag, afbreken we de verwerking van de bundel en slaan we de resterende resources over. Er is nog een nieuwe poging toegevoegd (naast de nieuwe poging in de gegevensarchieflaag) die eenmalig wordt uitgevoerd per resource die een 429-fout tegenkomt. Zie PR #2400 voor meer informatie over deze functieverbetering.
Facturering voor $convert-data en $de-id De gegevensconversie- en de geïdentificeerde exportfuncties van Azure API for FHIR zijn nu algemeen beschikbaar. Facturering voor $convert-data en $de-id bewerkingen in Azure API for FHIR is ingeschakeld. Factureringsmeters zijn ingeschakeld op 1 maart 2022.

Foutoplossingen

Bugfixes Gerelateerde informatie
Zoekindex voor compartimenten bijwerken Er was een hoekcase waarin de zoekindex voor compartimenten niet werd ingesteld op resources. Nu gebruiken we dezelfde index als de belangrijkste zoekopdracht naar compartimenten om ervoor te zorgen dat alle gegevens worden geretourneerd. Zie PR #2430 voor meer informatie over de codeoplossing.

December 2021

Functies en verbeteringen

Verbeteringen Gerelateerde informatie
Publisher toegevoegd aan CapabilityStatement.name U kunt de uitgever nu vinden in de mogelijkheidsinstructie op CapabilityStatement.name. #2319
Logboek FhirOperation gekoppeld aan anonieme aanroepen naar metrische gegevens aanvragen Er zijn geen logboekregistratiebewerkingen waarvoor geen verificatie is vereist. We hebben de mogelijkheid uitgebreid om in RequestMetrics te voeren FhirOperation voor anonieme oproepen. #2295

Foutoplossingen

Bugfixes Gerelateerde informatie
500-fout opgelost wanneer SearchParameter code null is Er is een probleem opgelost waarbij SearchParameter een null-waarde voor Code werd gebruikt. Het resultaat zou een 500 zijn. Nu resulteert dit in een InvalidResourceException waarde die lijkt op de andere waarden. #2343
BadRequestException Geretourneerd met geldig bericht wanneer de JSON-hoofdtekst van de invoer ongeldig is Voor ongeldige JSON-hoofdaanvragen retourneert de FHIR-server een 500-fout. Nu retourneren we een BadRequestException met een geldig bericht in plaats van 500. #2239
_sort kan leiden tot ChainedSearch onjuiste resultaten Voorheen zijn de sorteeropties van het object van SearchOption het gekoppelde zoekobject niet gewist, waardoor de sorteeropties worden doorgegeven aan de gekoppelde subzoekopdrachten, die niet geldig zijn. Dit kan leiden tot geen resultaten wanneer er resultaten moeten zijn. Deze fout is nu opgelost #2347. GitHub-bug 2344 is opgelost.

November 2021

Functies en verbeteringen

Verbeteringen Gerelateerde informatie
Koppelingen patiënt-alles verwerken We hebben de mogelijkheden voor patiënt-alles uitgebreid om patiëntkoppelingen te verwerken #2305. Zie de documentatie over Patient-everything in FHIR voor meer informatie.
Softwarenaam en -versie toegevoegd aan mogelijkheidsinstructie In de mogelijkheidsinstructie maakt de softwarenaam nu onderscheid als u Azure API for FHIR of Azure Health Data Services gebruikt. De softwareversie geeft nu op welk opensource-releasepakket live is in de beheerde service #2294. Adressen: #1778 en #2241
Logboeken van 500 naar RequestMetric Voorheen werden 500 of onbekende/niet-verwerkte fouten niet aangemeld RequestMetric. Ze worden nu geregistreerd #2240. Zie Diagnostische instellingen inschakelen in Azure API for FHIR voor meer informatie
Vervolgtokens comprimeren In bepaalde gevallen was het vervolgtoken te lang om de volgende koppeling in zoekopdrachten te kunnen volgen en zou dit resulteren in 404. Om dit op te lossen, hebben we het vervolgtoken gecomprimeerd om ervoor te zorgen dat het onder de limiet van #2279 blijft. Hiermee wordt probleem 2250 opgelost.

Foutoplossingen

Bugfixes Gerelateerde informatie
500-fout opgelost toen de datum werd doorgegeven met een tijdzone. Hiermee wordt een 500-fout opgelost wanneer een datum met een tijdzone is doorgegeven aan een datum/tijd-veld #2270.
Probleem opgelost bij het plaatsen van een bundel met een onjuist mediatype heeft een 500-fout geretourneerd. Eerder bij het plaatsen van een zoekopdracht met een sleutel die bepaalde tekens bevat, werd een 500-fout geretourneerd. Hiermee wordt dit probleem opgelost #2264 en wordt #2148 opgelost.

Oktober 2021

Foutoplossingen

Oneindige lusfout Gerelateerde informatie
Er is een probleem opgelost waarbij voorwaardelijk verwijderen kan leiden tot een oneindige lus. #2269

September 2021

Functies en verbeteringen

Verbeteringen Gerelateerde informatie
Ondersteuning toegevoegd voor voorwaardelijke patch Voorwaardelijke patch
Voorwaardelijke patch #2163
Controlegebeurtenis voor voorwaardelijke patches toegevoegd. #2213
JSON-patch in bundels toestaan JSON-patch in bundels
Hiermee kunnen zoekgeschiedenisbundels met Patch-aanvragen worden gebruikt. #2156
JSON-patch is ingeschakeld in bundels met behulp van binaire resources. #2143
Nieuwe subtypen voor auditgebeurtenissen Gerelateerde informatie
Er zijn nieuwe subtypen voor audit OperationName toegevoegd. #2170
Verbeteringen opnieuw indexeren Gerelateerde informatie
Grenzen toegevoegd voor het opnieuw indexeren van parameters. #2103
Foutbericht bijwerken voor opnieuw indexeren van parametergrenzen. #2109
Laatste controle voor opnieuw indexeren toegevoegd. #2099

Foutoplossingen

Bugfixes Gerelateerde informatie
Bredere vangst voor uitzonderingen bij het toepassen van patches. #2192
Oplossingsgeschiedenis met PATCH in STU3. #2177
Fouten in aangepaste zoekopdrachten Gerelateerde informatie
Hiermee wordt een fout opgelost met de aangepaste zoekparameters. #2133
Er is logica voor opnieuw proberen toegevoegd tijdens het verwijderen van de zoekparameter. #2121
Stel het maximum aantal items in zoekopties in SearchParameterDefinitionManager in. #2141
Biedt een betere uitzondering als er een ongeldige expressie in de zoekparameter is. #2157
Fout met opnieuw proberen 503 opgelost Gerelateerde informatie
Voer de fout 503 van Azure Cosmos DB opnieuw uit. #2106
Oplossingen voor het verwerken van 429s van StoreProcedures. #2165
GitHub-problemen gesloten Gerelateerde informatie
Kan geen aangepaste zoekparameter maken voor het medische apparaat CarePlan. #2146
Onduidelijk foutbericht voor voorwaardelijk maken zonder id. #2168

IoT-connector voor FHIR (preview)

Bugfixes Gerelateerde informatie
Verbroken koppeling opgelost. De koppeling naar de Azure-documentatie voor de IoT-connector is bijgewerkt in de Azure API for FHIR-portal.

Volgende stappen

Zie voor informatie over de functies en oplossingen voor fouten in Azure Health Data Services (FHIR-service, DICOM-service en MedTech-service)

Opmerkingen bij de release: Azure Health Data Services

Notitie

FHIR® is een geregistreerd handelsmerk van HL7 en wordt gebruikt met de machtiging HL7.