Często zadawane pytania dotyczące usługi 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.

W tej sekcji opisano niektóre z często zadawanych pytań dotyczących usługi Azure Health Data Services FHIR (niniejszym nazywanej usługą FHIR).

Usługa FHIR: Podstawy

Co to jest FHIR?

Fast Healthcare Interoperability Resources (FHIR) to standard współdziałania umożliwiający wymianę danych opieki zdrowotnej między różnymi systemami opieki zdrowotnej. Ten standard został opracowany przez organizację HL7 i jest wdrażany przez organizacje opieki zdrowotnej na całym świecie. Najnowsza dostępna wersja FHIR to R4 (wersja 4). Usługa FHIR obsługuje język R4 i poprzednią wersję STU3 (Standard for Trial Use 3). Aby uzyskać więcej informacji na temat platformy FHIR, odwiedź HL7.org.

Czy dane za interfejsami API FHIR są przechowywane na platformie Azure?

Tak, dane są przechowywane w zarządzanych bazach danych na platformie Azure. Usługa FHIR w usługach Azure Health Data Services nie zapewnia bezpośredniego dostępu do bazowego magazynu danych.

Jak uzyskać dostęp do danych bazowych?

W usłudze zarządzanej nie można uzyskać dostępu do bazowych danych. Ma to na celu zapewnienie, że usługa FHIR oferuje certyfikaty dotyczące prywatności i zgodności wymagane dla danych opieki zdrowotnej. Jeśli potrzebujesz dostępu do danych bazowych, możesz użyć serwera FHIR typu open source.

Jakiego dostawcy tożsamości obsługujesz?

Obsługujemy identyfikator Entra firmy Microsoft jako dostawcę tożsamości.

Czy mogę używać usługi Azure AD B2C z usługą FHIR?

Tak. Możesz użyć usługi Azure Active Directory B2C (Azure AD B2C ) z usługą FHIR, aby udzielić dostępu do aplikacji i użytkowników. Aby uzyskać więcej informacji, zobacz Używanie usługi Azure Active Directory B2C do udzielania dostępu do usługi FHIR.

Jaka wersja FHIR jest obsługiwana?

Obsługujemy wersje 4.0.0 i 3.0.1.

Aby uzyskać więcej informacji, zobacz Obsługiwane funkcje FHIR. Możesz również przeczytać o tym, co zmieniło się między wersjami FHIR (STU3 do R4) w historii wersji HL7 FHIR.

Jaka jest różnica między usługą Azure API for FHIR i usługą FHIR w usługach Azure Health Data Services?

Interfejs API platformy Azure dla standardu FHIR był naszym początkowym ogólnie dostępnym produktem i jest wycofywany od 30 września 2026 r. Usługa FHIR usług Azure Health Data Services obsługuje dodatkowe możliwości, takie jak:

• Pakiety transakcji.
• Importowanie przyrostowe
• Skalowanie automatyczne jest domyślnie włączone

Domyślnie każde wystąpienie usługi Azure Health Data Services jest ograniczone do pojemności magazynu wynoszącej 4 TB. Aby aprowizować wystąpienie FHIR z pojemnością magazynu przekraczającą 4 TB, utwórz wniosek o pomoc techniczną z typem problemu "Limit usługi i subskrypcji (limity przydziału)".

Jaka jest różnica między usługą FHIR w usługach Azure Health Data Services i serwerem FHIR typu open source?

Usługa FHIR w usługach Azure Health Data Services jest hostowaną i zarządzaną wersją oprogramowania Microsoft FHIR Server typu open source dla platformy Azure. W usłudze zarządzanej firma Microsoft udostępnia wszystkie aktualizacje i konserwację.

Po uruchomieniu serwera FHIR dla platformy Azure masz bezpośredni dostęp do bazowych usług, ale jesteśmy odpowiedzialni za konserwowanie i aktualizowanie serwera oraz wszystkie wymagane działania związane z zgodnością, jeśli przechowujesz dane PHI.

W których regionach jest dostępna usługa FHIR?

Usługa FHIR jest dostępna we wszystkich regionach, w których są dostępne usługi Azure Health Data Services. Widać to na stronie Produkty według regionów .

Gdzie mogę zobaczyć, co jest zwalniane w usłudze FHIR?

Strona informacji o wersji zawiera omówienie wszystkich elementów, które zostały wysłane do usługi zarządzanej w poprzednim miesiącu.

Aby zobaczyć, co zostanie wydany w usłudze zarządzanej, możesz przejrzeć stronę wydań serwera FHIR typu open source. Pracowaliśmy nad tagowaniem elementów za pomocą usług Azure Health Data Services, jeśli zostaną one wydane w usłudze zarządzanej i będą dostępne dwa tygodnie po ich udostępnieniu na stronie wydania w środowisku open source. Dołączyliśmy również instrukcje dotyczące testowania kompilacji, jeśli chcesz przetestować je we własnym środowisku. Oceniamy, jak najlepiej udostępniać dodatkowe aktualizacje usługi zarządzanej.

Aby zobaczyć, jaki pakiet wydania znajduje się obecnie w usłudze zarządzanej, możesz wyświetlić instrukcję capability dla usługi FHIR i pod właściwością software.version . Zobaczysz, który pakiet został wdrożony.

Gdzie mogę znaleźć wersję FHIR (R4/STU3) uruchomioną w mojej bazie danych?

Dokładną wersję FHIR uwidocznioną w instrukcji capability można fhirVersion znaleźć we właściwości (FHIR URL/metadata).

Czy mogę przełączyć usługę FHIR z stu3 na R4?

L.p. Nie mamy możliwości zmiany wersji istniejącej bazy danych. Musisz utworzyć nową usługę FHIR i ponownie załadować dane. Możesz użyć konwertera JSON do FHIR jako miejsca, aby rozpocząć od konwertowania danych STU3 na R4.

Czy mogę dostosować adres URL usługi FHIR?

L.p. Nie można zmienić adresu URL usługi FHIR.

Implementacje i specyfikacje FHIR

Co to jest SMART on FHIR?

SMART (substitutable Medical Applications and Reusable Technology) on FHIR to zestaw otwartych specyfikacji integrowania aplikacji partnerskich z serwerami FHIR i innymi systemami IT zdrowia, takimi jak elektroniczne rekordy kondycji i wymiany informacji o kondycji. Tworząc aplikację SMART on FHIR, możesz mieć pewność, że aplikacja będzie mogła uzyskiwać dostęp do aplikacji i korzystać z nich w wielu różnych systemach. Aby uzyskać więcej informacji na temat funkcji SMART, zobacz SMART Health IT.

Czy usługa FHIR obsługuje usługę SMART on FHIR?

Tak, funkcja SMART on FHIR jest obsługiwana przy użyciu przykładów AHDS. Jest to nazywane SMART on FHIR(Enhanced). Smart on FHIR(Enhanced) można uznać za spełniające wymagania dotyczące standardowego interfejsu API SMART on FHIR Implementation Guide (wersja 1.0.0) i §170.315(g)(10) Standardized API dla kryterium usług pacjentów i populacji. Aby uzyskać więcej informacji, odwiedź stronę SMART w dokumentacji FHIR(Enhanced).

Czy mogę utworzyć niestandardowy zasób FHIR?

Nie zezwalamy na niestandardowe zasoby FHIR. Jeśli potrzebujesz niestandardowego zasobu FHIR, możesz utworzyć zasób niestandardowy w oparciu o zasób Podstawowy z rozszerzeniami.

Czy rozszerzenia są obsługiwane w usłudze FHIR?

Umożliwiamy załadowanie wszystkich prawidłowych danych FHIR JSON do serwera. Jeśli chcesz przechowywać definicję struktury definiującą rozszerzenie, możesz zapisać go jako zasób definicji struktury. Aby wyszukiwać rozszerzenia, należy zdefiniować własne parametry wyszukiwania.

Jak mogę zobaczyć usługę FHIR w formacie XML?

W usłudze zarządzanej obsługujemy tylko kod JSON. Serwer FHIR typu open source obsługuje format JSON i XML. Aby wyświetlić wersję XML w środowisku open source, użyj polecenia _format= application/fhir+xml.

Jaki jest limit _count?

Bieżący limit dla _count wynosi 1000. Jeśli ustawisz _count na więcej niż 1000, w pakiecie zostanie wyświetlone ostrzeżenie, że zostaną wyświetlone tylko 1000 rekordów.

Czy mogę opublikować pakiet w usłudze FHIR?

Obecnie obsługujemy publikowanie pakietów wsadowych i delegowanie pakietów transakcji w usłudze FHIR.

Jak mogę uzyskać wszystkie zasoby dla jednego pacjenta w usłudze FHIR?

Obsługujemy operację $patient wszystko, co spowoduje pobranie wszystkich danych związanych z pojedynczym pacjentem.

Jaki jest domyślny sortowanie podczas wyszukiwania zasobów w usłudze FHIR?

Obsługujemy sortowanie według ciągów i pól dateTime w usłudze FHIR. Aby uzyskać więcej informacji na temat innych obsługiwanych parametrów wyszukiwania, zobacz Omówienie wyszukiwania FHIR.

Czy usługa FHIR obsługuje jakiekolwiek operacje terminologii?

Nie, usługa FHIR nie obsługuje obecnie operacji terminologii.

Jakie są różnice między typami usuwania w usłudze FHIR?

Istnieją dwa podstawowe typy usuwania obsługiwane w usłudze FHIR. Są one usuwane i usuwane warunkowe.

• Za pomocą opcji Usuń możesz wybrać opcję usuwania nietrwałego (najczęściej używanego typu) i nadal można odzyskać historyczne wersje rekordu.
• Za pomocą usuwania warunkowego można przekazać kryteria wyszukiwania, aby usunąć zasób jeden element jednocześnie lub kilka naraz.
• Jeśli przekazano hardDelete parametr z poleceniem Usuń lub Usuń warunkowe, wszystkie rekordy i historia zostaną usunięte i nieodwracalne.

Korzystanie z usługi FHIR

Czy mogę przeprowadzić kontrole kondycji w usłudze FHIR?

Aby przeprowadzić kontrolę kondycji w usłudze FHIR, wprowadź {{fhirurl}}/health/check w żądaniu GET. Powinien być widoczny stan usługi FHIR. Odpowiedź kodu stanu HTTP z 200 i OverallStatus jako w dobrej kondycji w odpowiedzi oznacza, że sprawdzanie kondycji zakończy się pomyślnie.

W przypadku błędów może zostać zwrócona odpowiedź o błędzie z kodem stanu HTTP 404 (Nie znaleziono) lub kodem stanu 500 (wewnętrzny błąd serwera) oraz szczegółowymi informacjami w treści odpowiedzi.

Następne kroki

W tym artykule przedstawiono odpowiedzi na często zadawane pytania dotyczące usługi FHIR. Aby zapoznać się z często zadawanymi pytaniami dotyczącymi usługi FHIR w usłudze Azure API for FHIR, zobacz

Często zadawane pytania dotyczące usługi Azure API for FHIR

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