Wprowadzenie do usługi FHIR

Artykuł
06/27/2024

W tym artykule opisano podstawowe kroki umożliwiające rozpoczęcie pracy z usługą FHIR® w usługach Azure Health Data Services.

W ramach wymagań wstępnych potrzebna jest subskrypcja platformy Azure oraz uprawnienia do tworzenia grup zasobów platformy Azure i wdrażania zasobów platformy Azure. Możesz wykonać wszystkie kroki lub pominąć niektóre, jeśli masz istniejące środowisko. Ponadto możesz połączyć wszystkie kroki i wykonać je w programie PowerShell, interfejsie wiersza polecenia platformy Azure lub w skryptach interfejsu API REST.

Tworzenie obszaru roboczego w subskrypcji platformy Azure

Obszar roboczy można utworzyć w witrynie Azure Portal lub przy użyciu programu PowerShell, interfejsu wiersza polecenia platformy Azure i interfejsu API REST. Skrypty można znaleźć w przykładach usług Azure Health Data Services.

Uwaga

Istnieją ograniczenia dotyczące liczby obszarów roboczych i liczby wystąpień usługi FHIR, które można utworzyć w każdej subskrypcji platformy Azure.

Tworzenie usługi FHIR w obszarze roboczym

Wystąpienie usługi FHIR można utworzyć w witrynie Azure Portal lub przy użyciu programu PowerShell, interfejsu wiersza polecenia platformy Azure i interfejsu API REST. Skrypty można znaleźć w przykładach usług Azure Health Data Services.

Opcjonalnie możesz utworzyć usługę DICOM i usługę MedTech w obszarze roboczym.

Uzyskiwanie dostępu do usługi FHIR

Usługa FHIR jest zabezpieczona przez identyfikator Entra firmy Microsoft, którego nie można wyłączyć. Aby uzyskać dostęp do interfejsu API usługi, należy utworzyć aplikację kliencką nazywaną również jednostką usługi w usłudze Microsoft Entra ID i przyznać jej odpowiednie uprawnienia.

Rejestrowanie aplikacji klienckiej

Aplikację kliencką można utworzyć lub zarejestrować w witrynie Azure Portal albo przy użyciu skryptów programu PowerShell i interfejsu wiersza polecenia platformy Azure. Ta aplikacja kliencka może być używana dla co najmniej jednego wystąpienia usługi FHIR. Można go również używać w przypadku innych usług w usługach Azure Health Data Services.

Jeśli aplikacja kliencka zostanie utworzona przy użyciu certyfikatu lub klucza tajnego klienta, upewnij się, że przed wygaśnięciem odnowisz certyfikat lub klucz tajny klienta i zastąp poświadczenia klienta w aplikacjach.

Aplikację kliencką można usunąć. Przed usunięciem aplikacji klienckiej upewnij się, że nie jest ona używana w środowiskach produkcyjnych, deweloperskich, testowych ani kontroli jakości (QA).

Udzielanie uprawnień dostępu

Możesz udzielić uprawnień dostępu lub przypisać role w witrynie Azure Portal lub przy użyciu skryptów programu PowerShell i interfejsu wiersza polecenia platformy Azure.

Wykonywanie transakcji tworzenia, odczytu, aktualizacji i usuwania (CRUD)

Transakcje Tworzenia, Odczytu (wyszukiwania), Aktualizacji i Usuwania (CRUD) można wykonywać względem usługi FHIR w aplikacjach lub za pomocą narzędzi, takich jak Postman, klient REST i cURL. Ponieważ usługa FHIR jest domyślnie zabezpieczona, musisz uzyskać token dostępu i dołączyć go do żądania transakcji.

Pobranie tokenu dostępu

Token dostępu firmy Microsoft można uzyskać przy użyciu programu PowerShell, interfejsu wiersza polecenia platformy Azure, interfejsu wiersza polecenia REST lub zestawu SDK platformy .NET. Aby dowiedzieć się więcej, zobacz Uzyskiwanie tokenu dostępu.

Dostęp przy użyciu istniejących narzędzi

Ładowanie danych

Dane można ładować bezpośrednio przy użyciu metody POST lub PUT względem usługi FHIR. Do zbiorczego ładowania danych można użyć operacji $import. Aby uzyskać informacje, odwiedź stronę operacja importowania.

CMS, wyszukiwanie, walidacja profilu i ponowne indeksowanie

Więcej szczegółów na temat współdziałania i dostępu pacjentów, wyszukiwania, walidacji profilu i ponownego indeksowania można znaleźć w dokumentacji usługi FHIR.

Eksportowanie danych

Opcjonalnie możesz wyeksportować ($export) dane do usługi Azure Storage i używać ich w projektach analitycznych lub uczenia maszynowego. Dane można wyeksportować w formacie "as-is" lub deIDndjson.

Konwertowanie danych

Opcjonalnie możesz przekonwertować dane HL7 v2 i inne formaty na FHIR.

Korzystanie z danych FHIR na pulpicie nawigacyjnym usługi Power BI

Opcjonalnie możesz tworzyć raporty pulpitu nawigacyjnego usługi Power BI przy użyciu danych FHIR.

Następne kroki

Wdrażanie usługi FHIR w usługach Azure Health Data Services