Zarządzanie zasadami przechowywania wersji i historią

Zasady przechowywania wersji w usłudze Azure Health Data Services FHIR to konfiguracja, która określa sposób przechowywania historii dla każdego typu zasobu z opcją konfiguracji specyficznej dla zasobu. Te zasady są bezpośrednio związane z koncepcją zarządzania historią zasobów FHIR.

Historia w FHIR

Historia w środowisku FHIR umożliwia wyświetlanie wszystkich poprzednich wersji zasobu. Historia w standardzie FHIR może być odpytywane na poziomie zasobu, na poziomie typu lub na poziomie systemu. Dokumentacja HL7 FHIR zawiera więcej informacji na temat interakcji z historią. Historia jest przydatna w scenariuszach, w których chcesz zobaczyć ewolucję zasobu w technologii FHIR lub jeśli chcesz wyświetlić informacje o zasobie w określonym punkcie w czasie.

Wszystkie wcześniejsze wersje zasobu są uważane za przestarzałe, a bieżąca wersja zasobu powinna być używana do normalnych operacji przepływu pracy firmy. Jednak może być przydatne, aby zobaczyć stan zasobu jako punkt w czasie, gdy podjęto poprzednią decyzję.

Zasady wersji

Zasady przechowywania wersji w usłudze FHIR umożliwiają określenie, w jaki sposób historia jest przechowywana na poziomie usługi FHIR lub na określonym poziomie zasobów.

Istnieją trzy różne poziomy zasad przechowywania wersji:

• versioned: Historia jest przechowywana na potrzeby operacji na zasobach. Wersja zasobu jest zwiększana. Jest to opcja domyślna.
• version-update: Historia jest przechowywana na potrzeby operacji na zasobach. Wersja zasobu jest zwiększana. Aktualizacje wymagają prawidłowego If-Match nagłówka. Aby uzyskać więcej informacji, zobacz VersionedUpdateExample.http.
• no-version: Historia nie jest tworzona dla zasobów. Wersja zasobu jest zwiększana.

Dostępne zasady przechowywania wersji, które można skonfigurować jako ustawienie dla całego systemu, a także przesłonięcia na poziomie zasobu. Ustawienie całego systemu jest używane dla wszystkich zasobów w usłudze FHIR, chyba że dodano określone zasady przechowywania wersji na poziomie zasobu.

Porównanie zasad przechowywania wersji

Wartość zasad	Zachowanie historii	meta.versionId Zachowanie aktualizacji	Domyślny
versioned	Historia jest przechowywana	If-Match nie jest wymagane	Tak
version-update	Historia jest przechowywana	If-Match wymagane	Nie
no-version	Historia nie jest przechowywana	If-Match nie jest wymagane	Nie

Uwaga

Zmiana zasad no-version przechowywania wersji na nie ma wpływu na istniejącą historię zasobów. Jeśli historia musi zostać usunięta dla zasobów, użyj operacji $purge historii .

Konfigurowanie zasad przechowywania wersji

Aby skonfigurować zasady przechowywania wersji, wybierz blok Konfiguracja zasad przechowywania wersji w usłudze FHIR.

Po przejściu do konfiguracji zasad przechowywania wersji będzie można skonfigurować ustawienie zarówno na poziomie systemu, jak i na poziomie zasobu (jako zastąpienie poziomu systemu). Konfiguracja poziomu systemu (oznaczona jako 1) będzie stosowana do każdego zasobu w usłudze FHIR, chyba że skonfigurowano przesłonięcia specyficzne dla zasobu (adnotacje o wartości 2).

Podczas konfigurowania konfiguracji poziomu zasobów będzie można wybrać typ zasobu FHIR (oznaczony jako 1) i określone zasady przechowywania wersji dla tego konkretnego zasobu (oznaczone jako 2). Pamiętaj, aby wybrać przycisk Dodaj (oznaczony jako 3), aby utworzyć kolejkę tego ustawienia na potrzeby zapisywania.

Upewnij się, że po zakończeniu konfiguracji zasad przechowywania wersji wybierz pozycję Zapisz .

Zarządzanie historią

Historia w środowisku FHIR jest ważna dla użytkowników końcowych, aby zobaczyć, jak zasób zmienił się wraz z upływem czasu. Jest to również przydatne w koordynacji z dziennikami inspekcji, aby zobaczyć stan zasobu przed i po zmodyfikowaniu go przez użytkownika. Ogólnie rzecz biorąc, zaleca się przechowywanie historii zasobu, chyba że wiadomo, że historia nie jest potrzebna. Częste aktualizacje zasobów mogą spowodować dużą ilość magazynu danych, co może być niepożądane w usługach FHIR z dużą ilością danych.

Zmiana zasad przechowywania wersji na poziomie systemu lub na poziomie zasobu nie spowoduje usunięcia istniejącej historii dla żadnych zasobów w usłudze FHIR. Jeśli chcesz zmniejszyć rozmiar danych historii w usłudze FHIR, musisz użyć operacji $purge historii .

Następne kroki

W tym artykule przedstawiono sposób przeczyszczenia historii zasobów w usłudze FHIR. Aby uzyskać więcej informacji na temat wyłączania historii i niektórych pojęć dotyczących zarządzania historią, zobacz

Operacja przeczyszczania historii

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