Управление политикой управления версиями и журналом

  • Статья

Политика управления версиями в службе FHIR служб работоспособности Azure — это конфигурация, которая определяет способ хранения журнала для каждого типа ресурсов с параметром для конкретной конфигурации ресурса. Эта политика напрямую связана с концепцией управления журналом для ресурсов FHIR.

История в FHIR

Журнал в FHIR позволяет просматривать все предыдущие версии ресурса. Журнал в FHIR можно запрашивать на уровне ресурсов, типа или системном уровне. В документации по HL7 FHIR содержатся дополнительные сведения о взаимодействии с журналом. Журнал полезен в сценариях, когда требуется просмотреть эволюцию ресурса в FHIR или если вы хотите просмотреть сведения о ресурсе в определенный момент времени.

Все предыдущие версии ресурса считаются устаревшими, а текущую версию ресурса следует использовать для обычных операций бизнес-процессов. Однако может быть полезно увидеть состояние ресурса как момент времени, когда было принято предыдущее решение.

Политика управления версиями

Политика управления версиями в службе FHIR позволяет решить, как хранится журнал либо на уровне службы FHIR, либо на определенном уровне ресурсов.

Существует три разных уровня для политики управления версиями:

  • versioned: журнал хранится для операций с ресурсами. Версия ресурса увеличивается. Это значение по умолчанию.
  • version-update: журнал хранится для операций с ресурсами. Версия ресурса увеличивается. Обновления требуется допустимый If-Match заголовок. Дополнительные сведения см. в разделе VersionedUpdateExample.http.
  • no-version: журнал не создается для ресурсов. Версия ресурса увеличивается.

Политика управления версиями, доступная для настройки в качестве параметра для всей системы, а также для переопределения на уровне ресурсов. Параметр для всей системы используется для всех ресурсов в службе FHIR, если не добавлена определенная политика управления версиями на уровне ресурсов.

Сравнение политик управления версиями

Значение политики Поведение журнала meta.versionId Поведение обновления Значение по умолчанию
versioned Журнал хранится If-Match не требуется Да
version-update Журнал хранится требуется If-Match Нет
no-version Журнал не хранится If-Match не требуется Нет

Примечание

Изменение политики управления версиями на no-version не влияет на существующий журнал ресурсов. Если необходимо удалить журнал для ресурсов, используйте операцию $purge журнала .

Настройка политики управления версиями

Чтобы настроить политику управления версиями, выберите колонку Конфигурация политики управления версиями в службе FHIR.

Снимок экрана: конфигурация политики управления версиями портал Azure.

Перейдя в раздел Конфигурация политики управления версиями, вы сможете настроить параметр как на уровне системы, так и на уровне ресурсов (в качестве переопределения системного уровня). Конфигурация системного уровня (помеченная как 1) будет применяться к каждому ресурсу в службе FHIR, если не настроено переопределение конкретного ресурса (с заметкой 2).

Снимок экрана: конфигурация политики управления версиями портал Azure, показывающая конфигурацию на уровне системы и уровне ресурсов.

При настройке конфигурации на уровне ресурсов вы сможете выбрать тип ресурса FHIR (с заметкой 1) и конкретную политику управления версиями для этого конкретного ресурса (с заметкой 2). Не забудьте нажать кнопку Добавить (с примечанием 3), чтобы поместить этот параметр в очередь для сохранения.

Снимок экрана: портал Azure конфигурации политики управления версиями, показывающая конфигурацию на уровне ресурсов.

После завершения настройки политики управления версиями выберите Сохранить .

Снимок экрана: конфигурация конфигурации политики управления версиями портал Azure с кнопкой

Управление журналами

Журнал в FHIR важен для конечных пользователей, чтобы увидеть, как ресурс изменился с течением времени. Это также полезно для координации с журналами аудита для просмотра состояния ресурса до и после его изменения пользователем. Как правило, рекомендуется хранить журнал для ресурса, если вы не знаете, что журнал не требуется. Частое обновление ресурсов может привести к большому объему хранилища данных, что может быть нежелательно в службах FHIR с большим объемом данных.

Изменение политики управления версиями на уровне системы или на уровне ресурсов не приведет к удалению существующего журнала для каких-либо ресурсов в службе FHIR. Если вы хотите уменьшить размер данных журнала в службе FHIR, необходимо использовать операцию $purge журнала .

Дальнейшие действия

Из этой статьи вы узнали, как очистить журнал для ресурсов в службе FHIR. Дополнительные сведения об отключении журнала и некоторых понятиях об управлении журналами см. в разделе.

Операция очистки журнала

FHIR® является зарегистрированным товарным знаком HL7 и используется с разрешения HL7.