Viktig information: Azure API för FHIR

  • Artikel

Viktigt!

Azure API för FHIR dras tillbaka den 30 september 2026. Följ migreringsstrategierna för att övergå till Azure Health Data Services FHIR-tjänsten senast det datumet. På grund av tillbakadragandet av Azure API för FHIR tillåts inte nya distributioner från och med den 1 april 2025. Azure Health Data Services FHIR-tjänsten är den utvecklade versionen av Azure API för FHIR som gör det möjligt för kunder att hantera FHIR-, DICOM- och MedTech-tjänster med integreringar i andra Azure-tjänster.

Azure API för FHIR tillhandahåller en fullständigt hanterad distribution av Microsoft FHIR Server för Azure. Servern är en implementering av FHIR-standarden. Det här dokumentet innehåller information om de funktioner och förbättringar som gjorts i Azure API för FHIR.

Mars 2024

Batch-bundle parallelization Batch-paket körs som standard seriellt i FHIR-tjänsten. För att förbättra dataflödet med paketanrop har vi aktiverat parallell bearbetning av batchpaket.

Läs mer:

Felkorrigeringar

  • Åtgärdat: Förbättra prestanda för paketbearbetning. Uppdateringar görs till aktivitetskörningsmetoden, vilket leder till prestandaförbättring för paketbearbetning. Se PR#3727.

Februari 2024

Aktiverar inventering av alla versioner (historiska och mjuka borttagna) av resurser Frågeparametern _summary=count och _count=0 kan läggas till i _history slutpunkt för att få antal av alla versionsbaserade resurser. Det här antalet innehåller mjukt borttagna resurser. Mer information finns i historikhantering.

Förbättra dataflödet för exportåtgärden Frågeparametern "_isparallel" kan läggas till i exportåtgärden för att förbättra dataflödet. Det är viktigt att observera att användning av den här parametern kan leda till en ökning av förbrukningen av enheter för begäranden under exportens livslängd. Mer information finns i Exportera frågeparametrar för åtgärden.

Kommentar

Det finns ett känt problem med åtgärden $export som kan resultera i ofullständig export med status lyckades. Problemet uppstår när flaggan is_parallel användes. Exportjobb som körs med _isparallel frågeparameter från och med den 13 februari 2024 påverkas av det här problemet.

Ändra namnnod för exporterat filnamn och standardlagringskonto Med den här ändringen följer exporterade filnamn formatet {FHIR Resource Name}-{Number}-{Number}.ndjson. Ordningen på filerna är inte garanterad att motsvara någon ordning på resurserna i databasen. Standardnamnet för lagringskontot uppdateras till "Export-{Number}". Antalet resurser som läggs till i enskilda exporterade filer ändras inte.

Prestandaförbättring Parallell optimering för FHIR-frågor kan aktiveras med HTTP-rubriken "x-ms-query-latency-over-efficiency" . Det här värdet måste anges till true för att uppnå maximal samtidighet under körningen av frågan. Mer information finns i Batch-paket.

Januari 2024

Samtidig körning av frågor med villkorsstyrda interaktioner Villkorsinteraktioner kan vara komplexa och prestandaintensiva. För att förbättra svarstiden för frågor som involverar villkorsstyrda interaktioner kan du använda begärandehuvudet x-conditionalquery-processing-logic. Mer information finns i Prestandaöverväganden för villkorsstyrda API-interaktioner.

December 2023

Ytterligare funktioner som lagts till i exportåtgärden $export åtgärden stöder nu export av versionshanterade resurser och mjuka borttagna resurser. Mer information finns i Exportera frågeparametrar.

November 2023

Funktionen massborttagning är nu tillgänglig i förhandsversionen "$bulk-delete" så att du kan ta bort resurser från FHIR-servern asynkront. Massborttagningsåtgärden kan köras på systemnivå eller för enskilda resurstyper. Mer information finns i massborttagning.

Massborttagningsåtgärden är för närvarande i offentlig förhandsversion. Mer information finns i ansvarsfriskrivningen. [! INKLUDERA ansvarsfriskrivning för offentlig förhandsversion]

Felkorrigering: FHIR-frågor med hjälp av sidnumrering och revinclude resulterade i ett fel vid användning av nästa länk

Problemet har nu åtgärdats och FHIR-frågor med hjälp av fortsättningstoken med include/revinclude rapporterar inte längre ett undantag. Mer information om korrigering finns på #3525.

Juni 2023

Felkorrigering: Url för metadataslutpunkt i funktionsuttryck är relativ URL per FHIR-specifikation, metadataslutpunkts-URL i funktionsinstruktor måste vara en absolut URL. Mer information om FHIR-specifikation finns i Funktionsinstruktor. Det här fanixet åtgärdar problemet för mer information besök 3265.

maj 2023

SMART på FHIR: Mappning av fast klinisk omfattning för program

Den här felkorrigeringen åtgärdar problem med kliniskt omfång som inte tolkas korrekt för serverdelsprogram. Mer information finns i #3250

April 2023

Åtgärdade tillfälliga problem som är kopplade till inläsning av anpassade sökparametrar Den här felkorrigeringen åtgärdar problemet, där FHIR-tjänsten inte skulle läsa in den senaste SearchParameter-statusen i händelse av fel. Mer information finns i #3222

November 2022

Åtgärdat felet som genererades när resursen uppdaterades med if-match-huvudet och PATCH

Buggen har nu åtgärdats och resursen uppdateras om den matchar Etag-huvudet. Mer information finns i #2877|.

Maj 2022

Förbättring

Förbättring Relaterad information
Azure API för FHIR skapar ingen ny version av resursen om resursinnehållet inte har ändrats. Om en användare uppdaterar en befintlig resurs och endast meta.versionId eller meta.lastUpdated har ändrats returnerar vi OK med befintlig resursinformation utan att uppdatera VersionId och lastUpdated. Mer information finns i #2519.

April 2022

Förbättringar

Förbättringar Relaterad information
FHIRPath-korrigering FHIRPath Patch lades till som en funktion i både Azure API för FHIR. Detta implementerar FHIRPath Patch enligt definitionen på HL7-webbplatsen.
Flytta paketmeddelande till Core Med introduktionen av Resource.Bundle-namnområdet till Core måste resursreferenserna till strängresursfilen göras mer explicita. Mer information finns i PR #2478.
Hanterar ogiltigt sidhuvud vid versionsuppdatering När versionsprincipen är inställd på "versioned-update" måste den senaste versionen av resursen anges i begärans if-match-huvud i en uppdatering. Den angivna versionen måste vara i ETag-format. Tidigare skulle en 500 returneras om versionen var ogiltig eller i ett felaktigt format. Den här uppdateringen returnerar nu en 400 felaktig begäran. Mer information finns i PR #2467.

Felkorrigeringar

Felkorrigeringar Relaterad information
Lägger till kärnor i resurssökvägen En del av sökvägen till en strängresurs togs bort av misstag i versionsprincipen. Den här korrigeringen lägger till den igen. Mer information finns i PR #2470.
SQL-timeout returnerar ett 500-fel En bugg har åtgärdats när en SQL-begäran når en tidsgräns och begäran returnerar 500. I loggarna är detta en timeout från SQL jämfört med att få ett 429-fel från klientdelen. Mer information finns i PR #2497.

Mars 2022

Funktioner

Funktion Relaterad information
FHIRPath-korrigering Med den här nya funktionen kan du använda FHIRPath Patch-åtgärden på FHIR-resurser. Mer information finns i FHIR REST API-funktioner för Azure API för FHIR.

Felkorrigeringar

Felkorrigeringar Relaterad information
Duplicera resurser i sökning med _include Ett problem har åtgärdats där en enskild resurs kan returneras två gånger i en sökning som har _include. Mer information finns i PR #2448.
PUT skapar vid versionsuppdatering Åtgärdat problem uppstod med PUT resulterade i ett fel när versionsprincipen har konfigurerats till versioned-update. Mer information finns i PR #2457.
Ogiltig sidhuvudhantering vid versionsuppdatering Ett problem har åtgärdats där ett ogiltigt if-match huvud skulle resultera i ett HTTP 500-fel. Nu returneras en FELAKTIG HTTP-begäran i stället. Mer information finns i PR #2467.

Februari 2022

Funktioner och förbättringar

Förbättringar Relaterad information
Lade till 429 återförsök och loggning i BundleHandler Ibland uppstår 429 fel vid bearbetning av ett paket. Om FHIR-tjänsten tar emot en 429 på BundleHandler-lagret avbryter vi bearbetningen av paketet och hoppar över de återstående resurserna. Vi har lagt till ytterligare ett nytt försök (utöver det återförsök som finns i datalagerskiktet) som körs en gång per resurs som påträffar en 429-fil. Mer information om den här funktionsförbättringen finns i PR #2400.
Fakturering för $convert-data och $de-id Azure API för FHIR:s datakonvertering och avidentifierade exportfunktioner är nu allmänt tillgängliga. Fakturering för $convert-data och $de-id åtgärder i Azure API för FHIR har aktiverats. Faktureringsmätare aktiverades den 1 mars 2022.

Felkorrigeringar

Felkorrigeringar Relaterad information
Uppdatera facksökningsindex Det fanns ett hörnfall där facksökningsindexet inte angavs för resurser. Nu använder vi samma index som huvudsökningen efter facksökning för att säkerställa att alla data returneras. Mer information om kodkorrigeringen finns i PR #2430.

December 2021

Funktioner och förbättringar

Förbättringar Relaterad information
Publisher har lagts till i CapabiilityStatement.name Nu kan du hitta utgivaren i funktionsutdraget på CapabilityStatement.name. #2319
Logga FhirOperation länkad till anonyma anrop till mått för begäran Vi var inte loggningsåtgärder som inte krävde autentisering. Vi utökade möjligheten att få FhirOperation in typen RequestMetrics för anonyma samtal. #2295

Felkorrigeringar

Felkorrigeringar Relaterad information
500-fel har åtgärdats när SearchParameter koden är null Åtgärdat ett problem med SearchParameter om det hade ett null-värde för Kod, skulle resultatet bli 500. Nu resulterar det i en InvalidResourceException som de andra värdena gör. #2343
Returneras BadRequestException med giltigt meddelande när indata-JSON-brödtexten är ogiltig För ogiltiga JSON-brödtextbegäranden returnerade FHIR-servern ett 500-fel. Nu returnerar vi ett BadRequestException med ett giltigt meddelande i stället för 500. #2239
_sort kan orsaka ChainedSearch att felaktiga resultat returneras Tidigare rensades inte sorteringsalternativen från den länkade sökningens SearchOption objekt, vilket gjorde att sorteringsalternativen skickades vidare till den länkade undersökningen, som inte är giltiga. Detta kan inte resultera i några resultat när det ska finnas resultat. Den här buggen har nu åtgärdats #2347. Den åtgärdade GitHub-bugg #2344.

November 2021

Funktioner och förbättringar

Förbättringar Relaterad information
Bearbeta patient-allt-länkar Vi har utökat patient-allt-funktionerna för att bearbeta patientlänkar #2305. Mer information finns i Dokumentation om patient-allt i FHIR .
Programnamn och version har lagts till i funktionsinstruktor I funktionsöversikten skiljer sig programvarunamnet nu åt om du använder Azure API för FHIR eller Azure Health Data Services. Programvaruversionen anger nu vilket versionspaket med öppen källkod som är live i den hanterade tjänsten #2294. Adresser: #1778 och #2241
Logga 500's till RequestMetric Tidigare loggades inte 500-talet eller okända/ohanterade fel i RequestMetric. De loggas nu #2240. Mer information finns i Aktivera diagnostikinställningar i Azure API för FHIR
Komprimera fortsättningstoken I vissa fall var fortsättningstoken för lång för att kunna följa nästa länk i sökningar och skulle resultera i en 404. För att lösa detta komprimerade vi fortsättningstoken för att säkerställa att den ligger under storleksgränsen #2279. Åtgärdar problem #2250.

Felkorrigeringar

Felkorrigeringar Relaterad information
Löste 500-fel när datumet skickades med en tidszon. Detta åtgärdar ett 500-fel när ett datum med en tidszon skickades till ett datetime-fält #2270.
Löst problem vid publicering av ett paket med felaktig medietyp returnerade ett 500-fel. Tidigare när du publicerade en sökning med en nyckel som innehåller vissa tecken returnerades ett 500-fel. Detta åtgärdar det här problemet #2264 och åtgärdar #2148.

Oktober 2021

Felkorrigeringar

Oändlig loopbugg Relaterad information
Ett problem har åtgärdats där villkorsstyrd borttagning kan resultera i en oändlig loop. #2269

September 2021

Funktioner och förbättringar

Förbättringar Relaterad information
Stöd för villkorsstyrd korrigering har lagts till Villkorsstyrd korrigering
Villkorsstyrd korrigering #2163
En granskningshändelse för villkorlig korrigering har lagts till. #2213
Tillåt JSON-korrigering i paket JSON-korrigering i paket
Tillåter paket med sökhistorik med Patch-begäranden. #2156
Aktiverad JSON-korrigering i paket med binära resurser. #2143
Nya granskningshändelseundertyper Relaterad information
Nya operationName-undertyper för granskning har lagts till. #2170
Indexera om förbättringar Relaterad information
Gränser har lagts till för omindexeringsparametrar . #2103
Uppdatera felmeddelandet för omindexering av parametergränser. #2109
Den slutliga kontrollen av antalet index har lagts till. #2099

Felkorrigeringar

Felkorrigeringar Relaterad information
Bredare fångst för undantag vid tillämpning av korrigering. #2192
Korrigerar historiken med PATCH i STU3. #2177
Anpassade sökbuggar Relaterad information
Åtgärdar fel med anpassade sökparametrar. #2133
Logik för återförsök har lagts till när sökparametern tas bort. #2121
Ange maximalt antal objekt i sökalternativ i SearchParameterDefinitionManager. #2141
Ger bättre undantag om det finns ett felaktigt uttryck i sökparametern. #2157
Åtgärdat nytt försök 503-fel Relaterad information
Försök igen med 503-fel från Azure Cosmos DB. #2106
Åtgärdar bearbetning av 429-fel från StoreProcedures. #2165
GitHub-problem stängda Relaterad information
Det går inte att skapa en anpassad sökparameter för den medicinska CarePlan-enheten. #2146
Oklart felmeddelande för villkorsstyrd skapande utan ID. #2168

IoT-anslutningsprogram för FHIR (förhandsversion)

Felkorrigeringar Relaterad information
En bruten länk har åtgärdats. Uppdaterad länk till Azure-dokumentationen för IoT-anslutningsappen i Azure API för FHIR-portalen.

Nästa steg

Information om funktioner och felkorrigeringar i Azure Health Data Services (FHIR-tjänsten, DICOM-tjänsten och MedTech-tjänsten) finns i

Viktig information: Azure Health Data Services

FHIR® är ett registrerat varumärke som tillhör HL7 och används med tillstånd av HL7.