Dela via

Viktig information före 2025: Azure API för FHIR

  • Artikel

Viktigt!

Azure API för FHIR avvecklas 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.

November 2024

FHIR-tjänsten

Felkorrigeringar

  • Exportverifieringsförbättring: Ett problem hittades där exporten fortsatte trots ogiltiga sökparametrar. En ny ändring implementeras för att förhindra export under dessa förhållanden. Det här är standardbeteendet. Kunder kan åsidosätta den med hjälp av den överseende flaggan. Den här ändringen kommunicerades till kunderna förra månaden.
  • Prestandaförbättring för paket: Processen för profiluppdatering under paketkörningen har förenklats. Om ett paket innehåller ändringar i ValueSet, StructureDefinitionoch/eller CodeSystem, sker inga profiluppdateringar förrän paketet har slutförts helt. Den här ändringen förbättrar prestandan för paket genom att minska fördröjningar som orsakas av flera uppdateringar vid hantering av ändringar i dessa resurstyper.
  • Parsning av innehållstyprubrik: Ett problem som rör parsning av innehållstyprubriken application/x-www-form-urlencoded har åtgärdats och lösts.
  • Omindexering av förbättringar Omindexeringsåtgärden har förbättrats genom att ta bort en artificiell begränsning som tidigare begränsade hanteringen av stora historiska datamängder eller fall där kunderna begärde en begränsad frågestorlek. Dessutom skulle omindexeringsprocessen felaktigt rapportera som "slutförd" när du hanterar många sekventiella historiska eller borttagna resurser med standardstorleken för frågan. Det här problemet har åtgärdats för att säkerställa att omindexeringsprocessen slutförs korrekt och rapporterar lämplig status.

Oktober 2024

FHIR-tjänsten

Felkorrigeringar

  • Exportverifiering: Ett problem identifierades där exporten fortsatte trots ogiltiga sökparametrar. Vi inför en ändring som förhindrar export under dessa villkor. Den här funktionen ligger för närvarande bakom en strikt valideringsflagga och blir standardbeteendet den 30 oktober eller senare.
  • Inkludering av sökparameter: Vi löste ett problem där ytterligare sökparametrar (till exempel _include, _has) inte returnerade alla förväntade resultat, och ibland utelämnade nästa länk.
  • Körning av exportjobb: En sällsynt förekomst av System.ObjectDisposedException när exportjobbet slutfördes har åtgärdats genom att förtida avslut förhindras.
  • Uppdatering av HTTP-statuskod: HTTP-statuskoden för ogiltiga parametrar när $reindex jobbet skapas uppdateras nu till 400, vilket säkerställer bättre felhantering.
  • Rensning av sökparameter: En korrigering har implementerats för att säkerställa fullständig rensning av sökparametrar i databasen när den utlöses med borttagning av API-anrop, vilket åtgärdar problem som rör ofullständiga borttagningar.

Augusti 2024

FHIR-tjänsten

Felkorrigeringar En korrigering implementerades för att åtgärda problem med stora exporter som felaktigt visar statusen "slutförd" medan underordnade uppgifter fortfarande bearbetas. Lösningen innehåller en fördröjning för att minimera förekomsten av dessa statusfel, vilket förbättrar exporttillförlitligheten.

Juli 2024

FHIR-tjänsten

Felkorrigeringar

Åtgärdat: Export av data som SMART-användare Exportera data som SMART-användare kräver inte längre skrivomfattningar. Tidigare var det nödvändigt att bevilja "skrivbehörighet" till en SMART-användare för att exportera data, vilket innebar högre behörighetsnivåer. Om du vill initiera ett exportjobb som SMART-användare kontrollerar du att användaren är medlem i FHIR-exportrollen i RBAC och begär det "lästa" smarta kliniska omfånget.

Åtgärdat: Uppdatering av statuskod från HTTP 500 till HTTP 400 Under en korrigeringsåtgärd utlöstes ett internt serverfel (HTTP 500) om nyttolasten begärde en uppdatering för en annan resurstyp än Parameter. Detta har uppdaterats för att utlösa ett HTTP 400-fel i stället.

Maj 2024

FHIR-tjänsten

Förbättringar av rensningshistorikåtgärden Rensningshistoriken gör att du kan utföra en partiell borttagning med hjälp av frågeparametern "allowPartialSuccess". Som standard väntar rensningshistoriken på att slutföras innan resurserna tas bort. Men om ett fel uppstår under körningen återställs borttagningen av resurser. Genom att använda frågeparametern allowPartialSuccess kan du förhindra att transaktionen återställs i händelse av ett fel.

Felkorrigeringar

  • Åtgärdat: HTTP-statuskod för långvariga begäranden. FHIR-begäranden som tar längre tid än 100 sekunder att köra returnerar en HTTP 408-statuskod i stället för HTTP 500.
  • Åtgärdat: Historikbegäran i paket. Före korrigeringen returnerade en historikbegäran i ett paket HTTP-statuskod 404.

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 av aktivitetskörningsmetoden, vilket leder till prestandaförbättringar 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ärandeenheter 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-huvudet "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: Att skapa 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 CapabilityStatement.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-talet 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

Kommentar

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