Udostępnij za pośrednictwem


Informacje o wersji sprzed 2025 r.: Azure API for FHIR

Ważne

Usługa Azure API for FHIR zostanie wycofana 30 września 2026 r. Postępuj zgodnie ze strategiami migracji, aby przejść do usługi Azure Health Data Services FHIR® do tej daty. Ze względu na wycofanie usługi Azure API for FHIR nowe wdrożenia nie będą możliwe od 1 kwietnia 2025 r. Usługa FHIR usług Azure Health Data Services to rozwinięta wersja usługi Azure API for FHIR, która umożliwia klientom zarządzanie usługami FHIR, DICOM i MedTech z integracją z innymi usługami platformy Azure.

Usługa Azure API for FHIR® zapewnia w pełni zarządzane wdrożenie serwera Microsoft FHIR dla platformy Azure. Serwer jest implementacją standardu FHIR . Ten dokument zawiera szczegółowe informacje na temat funkcji i ulepszeń wprowadzonych w usłudze Azure API for FHIR.

Listopad 2024 r.

Usługa FHIR

Poprawki błędów

  • Ulepszenie walidacji eksportu: znaleziono problem polegający na tym, że eksporty były kontynuowane pomimo nieprawidłowych parametrów wyszukiwania. Wprowadzono nową zmianę, aby zapobiec eksportom w tych warunkach. To jest zachowanie domyślne. Klienci mogą zastąpić ją przy użyciu łagodnej flagi. Ta zmiana została przekazana klientom w zeszłym miesiącu.
  • Ulepszenie wydajności pakietu: proces odświeżania profilu podczas wykonywania pakietu został uproszczony. Jeśli pakiet zawiera zmiany w ValueSetelementach , StructureDefinitioni/lub CodeSystem, żadne operacje odświeżania profilu nie będą wykonywane, dopóki pakiet nie zostanie w pełni ukończony. Ta zmiana zwiększa wydajność pakietów przez zmniejszenie opóźnień spowodowanych przez wiele odświeżeń podczas obsługi zmian w tych typach zasobów.
  • Analizowanie nagłówka typu zawartości: rozwiązano problem związany z analizowaniem nagłówka application/x-www-form-urlencoded typu zawartości.
  • Ulepszenia ponownego indeksowania Operacja ponownego indeksowania została ulepszona przez usunięcie sztucznego ograniczenia, które wcześniej ograniczało obsługę dużych historycznych zestawów danych lub przypadków, w których klienci zażądali ograniczonego rozmiaru zapytania. Ponadto proces ponownego indeksowania będzie niepoprawnie zgłaszany jako "ukończony" podczas obsługi wielu sekwencyjnych zasobów historycznych lub usuniętych z domyślnym rozmiarem zapytania. Ten problem został rozwiązany, aby upewnić się, że proces ponownego indeksowania zakończy się poprawnie i zgłosi odpowiedni stan.

Październik 2024 r.

Usługa FHIR

Poprawki błędów

  • Walidacja eksportu: zidentyfikowano problem polegający na tym, że eksporty były kontynuowane pomimo nieprawidłowych parametrów wyszukiwania. Wprowadzamy zmianę uniemożliwiającą eksporty w tych warunkach. Ta funkcja znajduje się obecnie za ścisłą flagą walidacji i stanie się domyślnym zachowaniem w dniu 30 października lub po 30 października.
  • Włączenie parametru wyszukiwania: rozwiązaliśmy problem polegający na tym, _includeże dodatkowe parametry wyszukiwania (na przykład , _has) nie zwróciły wszystkich oczekiwanych wyników, czasami pomijając następny link.
  • Wykonywanie zadania eksportu: rzadkie wystąpienie System.ObjectDisposedException podczas kończenia zadania eksportu zostało rozwiązane przez zapobieganie przedwczesnym wyjściom.
  • Aktualizacja kodu stanu HTTP: kod stanu HTTP dla nieprawidłowych parametrów podczas $reindex tworzenia zadania jest teraz aktualizowany do 400, zapewniając lepszą obsługę błędów.
  • Oczyszczanie parametrów wyszukiwania: zaimplementowano poprawkę w celu zapewnienia pełnego czyszczenia parametrów wyszukiwania w bazie danych po wyzwoleniu za pomocą wywołań interfejsu API usuwania, co rozwiązuje problemy związane z niekompletnymi usunięciami.

Sierpień 2024 r.

Usługa FHIR

Poprawki błędów Zaimplementowano poprawkę, aby rozwiązać problemy z dużymi eksportami niepoprawnie wyświetlającym stan "ukończone", gdy zadania podrzędne nadal są przetwarzane. Rozwiązanie zawiera opóźnienie w celu ograniczenia występowania tych błędów stanu, zwiększając niezawodność eksportu.

Lipiec 2024 r.

Usługa FHIR

Poprawki błędów

Naprawiono: Eksportowanie danych jako użytkownika INTELIGENTNEgo Eksportowanie danych jako użytkownika INTELIGENTNEgo nie wymaga już zakresów zapisu. Wcześniej konieczne było przyznanie użytkownikowi smart uprawnień do eksportowania danych, co oznaczało wyższe poziomy uprawnień. Aby zainicjować zadanie eksportu jako użytkownik SMART, upewnij się, że użytkownik jest członkiem roli eksportu FHIR w kontroli dostępu opartej na rolach i żąda "odczytu" zakresu klinicznego SMART.

Naprawiono: Zaktualizowanie kodu stanu z http 500 do HTTP 400 Podczas operacji poprawki, jeśli ładunek zażądał aktualizacji typu zasobu innego niż Parametr, początkowo został zgłoszony wewnętrzny błąd serwera (HTTP 500). Ta aktualizacja została zaktualizowana, aby zamiast tego zgłosić błąd HTTP 400.

Maj 2024 r.

Usługa FHIR

Ulepszenia operacji przeczyszczania historii przeczyszczania Operacja przeczyszczania historii umożliwia wykonanie częściowego usunięcia przy użyciu parametru zapytania "allowPartialSuccess". Domyślnie operacja przeczyszczania historii czeka na pomyślne zakończenie przed usunięciem zasobów. Jeśli jednak wystąpi błąd podczas wykonywania, usunięcie zasobów zostanie wycofane. Używając parametru zapytania "allowPartialSuccess", można zapobiec wycofaniu transakcji w przypadku błędu.

Poprawki błędów

  • Naprawiono: kod stanu HTTP dla długotrwałych żądań. Żądania FHIR, które mogą trwać dłużej niż 100 sekund, zwracają kod stanu HTTP 408 zamiast HTTP 500.
  • Naprawiono: Żądanie historii w pakiecie. Przed rozwiązaniem żądanie historii w pakiecie zwróciło kod stanu HTTP 404.

Marzec 2024 r.

Pakiety równoległe pakietu wsadowego są domyślnie wykonywane w usłudze FHIR. Aby zwiększyć przepływność za pomocą wywołań pakietów, włączyliśmy równoległe przetwarzanie pakietów wsadowych.

Więcej informacji:

Poprawki błędów

  • Naprawiono: Poprawianie wydajności przetwarzania pakietów. Aktualizacje są wprowadzane do metody wykonywania zadań, co prowadzi do poprawy wydajności przetwarzania pakietów. Zobacz Żądanie ściągnięcia nr 3727.

Luty 2024 r.

Włącza zliczanie wszystkich wersji (historycznych i nietrwałych) zasobów Parametr zapytania _summary=count i _count=0 można dodać do punktu końcowego _history w celu pobrania liczby wszystkich zasobów w wersji. Ta liczba obejmuje nietrwałe usunięte zasoby. Aby uzyskać więcej informacji, zobacz Zarządzanie historią.

Zwiększ przepływność operacji eksportowania Parametr zapytania "_isparallel" można dodać do operacji eksportowania w celu zwiększenia przepływności. Należy pamiętać, że użycie tego parametru może spowodować zwiększenie użycia jednostek żądań w czasie eksportu. Aby uzyskać więcej informacji, zobacz Eksportowanie parametrów zapytania operacji.

Uwaga

Istnieje znany problem z operacją $export, która może spowodować niekompletne eksporty z powodzeniem stanu. Problem występuje, gdy użyto flagi is_parallel. W przypadku tego problemu ma wpływ na zadania eksportu wykonywane przy użyciu parametru zapytania _isparallel od 13 lutego 2024 r.

Zmień nomenklaturę nazw dla wyeksportowanej nazwy pliku i domyślnego konta magazynu Dzięki tej zmianie wyeksportowane nazwy plików są zgodne z formatem {FHIR Resource Name}-{Number}-{Number}.ndjson". Kolejność plików nie ma gwarancji, że odpowiada żadnej kolejności zasobów w bazie danych. Domyślna nazwa konta magazynu jest aktualizowana do wartości "Export-{Number}". Nie ma żadnych zmian w liczbie zasobów dodanych w pojedynczych wyeksportowanych plikach.

Optymalizację równoległą ulepszenia wydajności zapytań FHIR można włączyć przy użyciu nagłówka HTTP "x-ms-query-latency-over-efficiency". Ta wartość musi być ustawiona na wartość true, aby osiągnąć maksymalną współbieżność podczas wykonywania zapytania. Aby uzyskać więcej informacji, zobacz Pakiety usługi Batch.

Styczeń 2024 r.

Współbieżne wykonywanie zapytań z interakcjami warunkowymi Interakcje warunkowe może być złożone i intensywnie obciążające wydajność. Aby zwiększyć opóźnienie zapytań dotyczących interakcji warunkowych, możesz użyć nagłówka żądania x-conditionalquery-processing-logic. Aby uzyskać więcej informacji, zobacz Zagadnienia dotyczące wydajności interakcji z interfejsem API warunkowego.

Grudzień 2023 r.

Dodatkowe możliwości dodane do operacji Eksportowanie $export operacji obsługują teraz eksportowanie zasobów z wersjami i nietrwałych zasobów. Aby uzyskać więcej informacji, zobacz Eksportowanie parametrów zapytania.

Listopad 2023 r.

Funkcja usuwania zbiorczego jest teraz dostępna w wersji zapoznawczej "$bulk-delete" umożliwia asynchroniczne usuwanie zasobów z serwera FHIR. Operację usuwania zbiorczego można wykonać na poziomie systemu lub dla pojedynczego typu zasobu. Aby uzyskać więcej informacji, zobacz operację usuwania zbiorczego.

Operacja usuwania zbiorczego jest obecnie dostępna w publicznej wersji zapoznawczej. Przejrzyj zastrzeżenie, aby uzyskać szczegółowe informacje. [! UWZGLĘDNIJ publiczne zastrzeżenie o wersji zapoznawczej]

Poprawka usterek: zapytania FHIR używające stronicowania i ponownego łączenia spowodowały błąd podczas korzystania z następnego linku

Problem został rozwiązany, a zapytania FHIR korzystające z tokenu kontynuacji z dołączania/ponownego tworzenia, nie zgłaszają już wyjątku. Aby uzyskać szczegółowe informacje na temat poprawki, odwiedź stronę #3525.

Czerwiec 2023 r.

Poprawka błędów: adres URL punktu końcowego metadanych w instrukcji możliwości to względny adres URL specyfikacji FHIR, adres URL punktu końcowego metadanych w instrukcji capability musi być bezwzględnym adresem URL. Aby uzyskać szczegółowe informacje na temat specyfikacji FHIR, odwiedź stronę Capability Statement (Instrukcja możliwości). Ten fanix rozwiązuje problem, aby uzyskać szczegółowe informacje na stronie 3265.

Maj 2023 r.

SMART on FHIR : Stałe mapowanie zakresu klinicznego dla aplikacji

Ta usterka rozwiązuje problem z nieprawidłowym zakresem klinicznym dla aplikacji zaplecza. Aby uzyskać więcej informacji, odwiedź stronę #3250

Kwiecień 2023 r.

Rozwiązano przejściowe problemy związane z ładowaniem niestandardowych parametrów wyszukiwania Ta poprawka błędu rozwiązuje problem, który polegał na tym, że usługa FHIR nie ładowała najnowszego stanu Parametru wyszukiwania w przypadku awarii. Aby uzyskać więcej informacji, odwiedź stronę #3222

Listopad 2022 r.

Naprawiono błąd wygenerowany podczas aktualizowania zasobu przy użyciu nagłówka if-match i patch

Usterka jest teraz naprawiona, a zasób zostanie zaktualizowany, jeśli pasuje do nagłówka Etag. Aby uzyskać szczegółowe informacje, zobacz #2877|.

Maj 2022

Poprawa

Poprawa Informacje pokrewne
Interfejs API platformy Azure dla standardu FHIR nie tworzy nowej wersji zasobu, jeśli zawartość zasobu nie została zmieniona. Jeśli użytkownik aktualizuje istniejący zasób i zmieniliśmy tylko meta.versionId lub meta.lastUpdated, zwracamy przycisk OK z istniejącymi informacjami o zasobie bez aktualizowania identyfikatora VersionId i lastUpdated. Aby uzyskać więcej informacji, zobacz #2519.

2022 kwietnia

Ulepszenia

Ulepszenia Informacje pokrewne
Poprawka FHIRPath Poprawka FHIRPath została dodana jako funkcja zarówno do interfejsu API platformy Azure for FHIR. Spowoduje to zaimplementowanie poprawki FHIRPath zgodnie z definicją na stronie internetowej HL7 .
Przenieś powiadomienie o pakiecie do rdzenia Wraz z wprowadzeniem przestrzeni nazw Resource.Bundle do rdzenia, odwołania do pliku zasobów ciągów musiały być bardziej jawne. Aby uzyskać więcej informacji, zobacz Żądanie ściągnięcia nr 2478.
Obsługuje nieprawidłowy nagłówek w aktualizacji wersji Gdy zasady przechowywania wersji są ustawione na "versioned-update", wymagane jest, aby najnowsza wersja zasobu została podana w nagłówku żądania if-match w aktualizacji. Określona wersja musi być w formacie ETag. Wcześniej zwracany jest błąd 500, jeśli wersja jest nieprawidłowa lub w nieprawidłowym formacie. Ta aktualizacja zwraca teraz 400 nieprawidłowych żądań. Aby uzyskać więcej informacji, zobacz Żądanie ściągnięcia nr 2467.

Poprawki błędów

Poprawki błędów Informacje pokrewne
Dodaje rdzeń do ścieżki zasobu Część ścieżki do zasobu ciągu została przypadkowo usunięta w zasadach przechowywania wersji. Ta poprawka dodaje ją ponownie. Aby uzyskać więcej informacji, zobacz Żądanie ściągnięcia nr 2470.
Limit czasu SQL zwraca błąd 500 Usunięto usterkę, gdy żądanie SQL osiąga limit czasu, a żądanie zwraca wartość 500. W dziennikach jest to przekroczenie limitu czasu z programu SQL w porównaniu do błędu 429 z frontonu. Aby uzyskać więcej informacji, zobacz Żądanie ściągnięcia nr 2497.

Marzec 2022 r.

Funkcje

Funkcja Informacje pokrewne
Poprawka FHIRPath Ta nowa funkcja umożliwia korzystanie z operacji FHIRPath Patch w zasobach FHIR. Aby uzyskać więcej informacji, zobacz FHIR REST API capabilities for Azure API for FHIR (Możliwości interfejsu API REST FHIR dla usługi Azure API for FHIR).

Poprawki błędów

Poprawki błędów Informacje pokrewne
Zduplikowane zasoby w wyszukiwaniu za pomocą polecenia _include Rozwiązano problem polegający na tym, że pojedynczy zasób można zwrócić dwa razy w wyszukiwaniu zawierającym _includeelement . Aby uzyskać więcej informacji, zobacz Żądanie ściągnięcia nr 2448.
Metoda PUT tworzy w aktualizacji wersji Rozwiązano problem: tworzenie za pomocą funkcji PUT spowodowało błąd podczas konfigurowania zasad przechowywania wersji na wartość versioned-update. Aby uzyskać więcej informacji, zobacz Żądanie ściągnięcia nr 2457.
Nieprawidłowa obsługa nagłówka w aktualizacji wersji Rozwiązano problem polegający na tym, że nieprawidłowy if-match nagłówek powodował błąd HTTP 500. Teraz zwracane jest nieprawidłowe żądanie HTTP. Aby uzyskać więcej informacji, zobacz Żądanie ściągnięcia nr 2467.

Luty 2022 r.

Funkcje i ulepszenia

Ulepszenia Informacje pokrewne
Dodano 429 ponownych prób i logowania w programie BundleHandler Czasami występują błędy 429 podczas przetwarzania pakietu. Jeśli usługa FHIR odbiera błąd 429 w warstwie BundleHandler, przerywamy przetwarzanie pakietu i pomijamy pozostałe zasoby. Dodaliśmy kolejną ponowną próbę (oprócz ponawiania próby obecnej w warstwie magazynu danych), która będzie wykonywana jednorazowo na zasób, który napotka błąd 429. Aby uzyskać więcej informacji na temat tego rozszerzenia funkcji, zobacz Żądanie ściągnięcia nr 2400.
Rozliczenia dla i $convert-data$de-id Funkcja konwersji danych interfejsu API platformy Azure for FHIR i funkcji eksportowania jest teraz ogólnie dostępna. Włączono rozliczenia dla $convert-data operacji i $de-id w usłudze Azure API for FHIR. Mierniki rozliczeniowe zostały włączone 1 marca 2022 r.

Poprawki błędów

Poprawki błędów Informacje pokrewne
Aktualizuj indeks wyszukiwania przedziałów Wystąpił przypadek narożny, w którym indeks wyszukiwania przedziału nie był ustawiany na zasoby. Teraz użyjemy tego samego indeksu co główne wyszukiwanie przedziałów, aby upewnić się, że zwracane są wszystkie dane. Aby uzyskać więcej informacji na temat poprawki kodu, zobacz Żądanie ściągnięcia nr 2430.

Grudzień 2021

Funkcje i ulepszenia

Ulepszenia Informacje pokrewne
Dodano program Publisher do CapabilityStatement.name Wydawcę można teraz znaleźć w instrukcji capability pod adresem CapabilityStatement.name. #2319
Dziennik FhirOperation połączony z anonimowych wywołań do metryk żądania Nie byliśmy operacjami rejestrowania, które nie wymagały uwierzytelniania. Rozszerzyliśmy możliwość pobierania FhirOperation typu dla RequestMetrics wywołań anonimowych. #2295

Poprawki błędów

Poprawki błędów Informacje pokrewne
Naprawiono błąd 500, gdy SearchParameter kod ma wartość null Rozwiązano problem polegający na SearchParameter tym, że jeśli miał wartość null dla wartości Code, wynik to 500. Teraz wyniki są InvalidResourceException podobne do innych wartości. #2343
Zwracany BadRequestException z prawidłowym komunikatem, gdy treść danych wejściowych JSON jest nieprawidłowa W przypadku nieprawidłowych żądań treści JSON serwer FHIR zwrócił błąd 500. Teraz zwracamy BadRequestException wartość z prawidłowym komunikatem zamiast 500. #2239
_sort może spowodować ChainedSearch zwrócenie nieprawidłowych wyników Wcześniej opcje sortowania z obiektu wyszukiwania SearchOption łańcuchowego nie zostały wyczyszczone, co powoduje przekazanie opcji sortowania do podwyszukiwania łańcuchowego, które nie są prawidłowe. Może to spowodować brak wyników, gdy powinny istnieć wyniki. Ta usterka została usunięta #2347. Rozwiązano usterkę usługi GitHub #2344.

Listopad 2021

Funkcje i ulepszenia

Ulepszenia Informacje pokrewne
Przetwarzanie łączy wszystko przez pacjenta Rozszerzyliśmy możliwości "Wszystko dla pacjenta", aby przetwarzać linki pacjentów #2305. Aby uzyskać więcej informacji, zobacz dokumentację Patient-everything in FHIR (Wszystko cierpliwie w środowisku FHIR ).
Dodano nazwę oprogramowania i wersję do instrukcji capability W instrukcji capability nazwa oprogramowania rozróżnia teraz, jeśli używasz usługi Azure API for FHIR lub Azure Health Data Services. Wersja oprogramowania określi teraz, który pakiet wydania typu open source jest na żywo w usłudze zarządzanej #2294. Adresy: #1778 i #2241
Rejestrowanie 500-tych do RequestMetric Wcześniej błędy 500 lub nieznane/nieobsługiwane nie były rejestrowane.RequestMetric Są one teraz rejestrowane #2240. Aby uzyskać więcej informacji, zobacz Włączanie ustawień diagnostycznych w usłudze Azure API for FHIR
Kompresuj tokeny kontynuacji W niektórych przypadkach token kontynuacji był zbyt długi, aby móc śledzić następny link w wyszukiwaniach i spowodować 404. Aby rozwiązać ten problem, skompresowaliśmy token kontynuacji, aby upewnić się, że pozostaje on poniżej limitu rozmiaru #2279. Rozwiązuje problem nr 2250.

Poprawki błędów

Poprawki błędów Informacje pokrewne
Usunięto błąd 500, gdy data została przekazana ze strefą czasową. Spowoduje to usunięcie błędu 500, gdy data ze strefą czasową została przekazana do pola daty/godziny 2270.
Rozwiązano problem podczas publikowania pakietu z nieprawidłowym typem nośnika zwrócił błąd 500. Wcześniej podczas publikowania wyszukiwania z kluczem zawierającym określone znaki zwracany był błąd 500. Rozwiązano ten problem nr 2264 i rozwiązano problem nr 2148.

Październik 2021

Poprawki błędów

Błąd pętli nieskończonej Informacje pokrewne
Rozwiązano problem polegający na tym, że usuwanie warunkowe mogło spowodować nieskończoną pętlę. #2269

Wrzesień 2021

Funkcje i ulepszenia

Ulepszenia Informacje pokrewne
Dodano obsługę poprawki warunkowej Poprawka warunkowa
Poprawka warunkowa #2163
Dodano zdarzenie inspekcji poprawek warunkowych. #2213
Zezwalaj na stosowanie poprawek JSON w pakietach Poprawka JSON w pakietach
Umożliwia wyszukiwanie pakietów historii z żądaniami poprawek. #2156
Włączono poprawkę JSON w pakietach przy użyciu zasobów binarnych. #2143
Nowe podtypy zdarzeń inspekcji Informacje pokrewne
Dodano nowe podtypy operationname inspekcji. #2170
Ulepszenia ponownego indeksu Informacje pokrewne
Dodano granice dla parametrów ponownego indeksu . #2103
Zaktualizuj komunikat o błędzie dla granic parametrów ponownego indeksowania. #2109
Dodano ostatnią kontrolę liczby ponownego indeksu. #2099

Poprawki błędów

Poprawki błędów Informacje pokrewne
Szersze przechwytywanie wyjątków podczas stosowania poprawki. #2192
Poprawki historii z poprawką PATCH w stu3. #2177
Usterki wyszukiwania niestandardowego Informacje pokrewne
Rozwiązuje problem z parametrami wyszukiwania niestandardowego. #2133
Dodano logikę ponawiania próby podczas usuwania parametru wyszukiwania. #2121
Ustaw maksymalną liczbę elementów w opcjach wyszukiwania w elemencie SearchParameterDefinitionManager. #2141
Zapewnia lepszy wyjątek, jeśli w parametrze wyszukiwania występuje nieprawidłowe wyrażenie. #2157
Usunięto błąd ponawiania próby 503 Informacje pokrewne
Ponów próbę błędu 503 z usługi Azure Cosmos DB. #2106
Poprawki przetwarzania 429s z storeProcedures. #2165
Problemy z usługą GitHub zostały zamknięte Informacje pokrewne
Nie można utworzyć niestandardowego parametru wyszukiwania dla urządzenia medycznego CarePlan. #2146
Niejasny komunikat o błędzie dotyczący tworzenia warunkowego bez identyfikatora. #2168

Łącznik IoT dla standardu FHIR (wersja zapoznawcza)

Poprawki błędów Informacje pokrewne
Naprawiono przerwane łącze. Zaktualizowano link do dokumentacji platformy Azure łącznika IoT w portalu usługi Azure API for FHIR.

Następne kroki

Aby uzyskać informacje o funkcjach i poprawkach błędów w usługach Azure Health Data Services (usługa FHIR, usługa DICOM i usługa MedTech), zobacz

Uwaga

FHIR® jest zastrzeżonym znakiem towarowym HL7 i jest używany z uprawnieniem HL7.