Sürüm oluşturma ilkesi ve geçmiş yönetimi

Azure Health Data Services FHIR hizmetindeki sürüm oluşturma ilkesi, kaynağa özgü yapılandırma seçeneğiyle her kaynak türü için geçmişin nasıl depolandığını belirleyen bir yapılandırmadır. Bu ilke, FHIR kaynakları için geçmişi yönetme kavramıyla doğrudan ilgilidir.

FHIR'de geçmiş

FHIR'deki geçmiş, bir kaynağın önceki tüm sürümlerini görmenizi sağlar. FHIR'deki geçmiş kaynak düzeyinde, tür düzeyinde veya sistem düzeyinde sorgulanabilir. HL7 FHIR belgelerinde geçmiş etkileşimi hakkında daha fazla bilgi bulunur. Geçmiş, FHIR'de bir kaynağın evrimini görmek istediğiniz veya bir kaynağın bilgilerini belirli bir zaman noktasında görmek istediğiniz senaryolarda yararlıdır.

Bir kaynağın tüm geçmiş sürümleri eski olarak kabul edilir ve bir kaynağın geçerli sürümü normal iş akışı işlemleri için kullanılmalıdır. Ancak, kaynağın durumunu geçmişteki bir kararın alındığı bir nokta olarak görmek yararlı olabilir.

Sürüm ilkesi

FHIR hizmetindeki sürüm oluşturma ilkesi, geçmişin FHIR hizmet düzeyinde veya belirli bir kaynak düzeyinde nasıl depolandığına karar vermenizi sağlar.

Sürüm oluşturma ilkesi için üç farklı düzey vardır:

• versioned: Geçmiş, kaynaklarda işlem için depolanır. Kaynak sürümü artırıldı. Bu varsayılan seçenektir.
• version-update: Geçmiş, kaynaklarda işlem için depolanır. Kaynak sürümü artırıldı. Güncelleştirmeler geçerli If-Match bir üst bilgi gerektirir. Daha fazla bilgi için bkz . VersionedUpdateExample.http.
• no-version: Kaynaklar için geçmiş oluşturulmaz. Kaynak sürümü artırıldı.

Sürüm oluşturma ilkesi, sistem genelinde bir ayar olarak yapılandırılabilir ve aynı zamanda kaynak düzeyinde geçersiz kılabilir. Sistem genelindeki ayar, belirli bir kaynak düzeyi sürüm oluşturma ilkesi eklenmediği sürece FHIR hizmetinizdeki tüm kaynaklar için kullanılır.

Sürüm oluşturma ilkesi karşılaştırması

İlke Değeri	Geçmiş Davranışı	meta.versionId Güncelleştirme Davranışı	Varsayılan
versioned	Geçmiş depolanır	If-Match gerekli değil	Yes
version-update	Geçmiş depolanır	If-Match gerekli	No
no-version	Geçmiş depolanmaz	If-Match gerekli değil	No

Not

Sürüm oluşturma ilkesini no-version olarak değiştirmenin mevcut kaynak geçmişi üzerinde hiçbir etkisi yoktur. Kaynaklar için geçmişin kaldırılması gerekiyorsa $purge geçmiş işlemini kullanın.

Sürüm oluşturma ilkesini yapılandırma

Sürüm oluşturma ilkesini yapılandırmak için FHIR hizmetinizin içindeki Sürüm Oluşturma İlkesi Yapılandırması dikey penceresini seçin.

Sürüm Oluşturma İlkesi Yapılandırması'na göz atdıktan sonra, ayarı hem sistem düzeyinde hem de kaynak düzeyinde yapılandırabilirsiniz (sistem düzeyinin geçersiz kılması olarak). Kaynağa özgü bir geçersiz kılma (2'de açıklama eklenmiştir) yapılandırılmadığı sürece sistem düzeyi yapılandırması (1 olarak ek açıklama eklenmiştir) FHIR hizmetinizdeki her kaynağa uygulanır.

Kaynak düzeyi yapılandırmasını yapılandırırken, bu kaynak için FHIR kaynak türünü (1 olarak ek açıklamalı) ve belirli sürüm oluşturma ilkesini (2 olarak ek açıklamalı) seçebilirsiniz. Bu ayarı kaydetmek üzere kuyruğa almak için Ekle düğmesini (3 olarak ek açıklamalı) seçtiğinizden emin olun.

Sürüm oluşturma ilkesi yapılandırmanızı tamamladıktan sonra Kaydet'i seçtiğinizden emin olun.

Geçmiş yönetimi

FHIR'deki geçmiş, son kullanıcıların bir kaynağın zaman içinde nasıl değiştiğini görmesi açısından önemlidir. Ayrıca, bir kaynağın kullanıcı tarafından değiştirilmeden önce ve değiştirildikten sonra durumunu görmek için denetim günlükleriyle eşgüdümlü olarak da yararlıdır. Genel olarak, geçmişin gerekli olmadığını bilmiyorsanız bir kaynağın geçmişini tutmanız önerilir. Kaynakların sık sık güncelleştirilerek büyük miktarda veri depolaması elde edilebilir ve bu da büyük miktarda veri içeren FHIR hizmetlerinde istenmeyen bir durum olabilir.

Sürüm oluşturma ilkesinin sistem düzeyinde veya kaynak düzeyinde değiştirilmesi, FHIR hizmetinizdeki kaynakların mevcut geçmişini kaldırmaz. FHIR hizmetinizdeki geçmiş veri boyutunu küçültmek istiyorsanız $purge geçmiş işlemini kullanmanız gerekir.

Sonraki adımlar

Bu makalede, FHIR hizmetindeki kaynakların geçmişini temizlemeyi öğrendiniz. Geçmişi devre dışı bırakma hakkında daha fazla bilgi ve geçmiş yönetimiyle ilgili bazı kavramlar için bkz.

Temizleme geçmişi işlemi

FHIR®, HL7'nin tescilli ticari markasıdır ve HL7 izniyle kullanılır.