FHIR hizmetinde Patient-everything kullanma

Patient-everything işlemi, hastayla ilgili tüm kaynakların bir görünümünü sağlamak için kullanılır. Bu işlem, hastaların tüm kayıtlarına erişmelerini sağlamak veya bir sağlayıcı ya da başka bir kullanıcının hastayla ilgili toplu veri indirme işlemi gerçekleştirmesi için yararlı olabilir. Fast Healthcare Birlikte Çalışabilirlik Kaynakları (FHIR®) belirtimine göre Patient-everything, bu işlemin çağrıldığı kaynakta veya bağlamda açıklanan bir veya daha fazla hastayla ilgili tüm bilgileri döndürür. Azure Health Veri Hizmetleri'ndeki FHIR hizmetinde (burada FHIR hizmeti olarak adlandırılır) patient-everything özelliği belirli bir hastayla ilgili verileri çekmek için kullanılabilir.

Patient-everything'i kullanma

Patient-everything çağrısı yapmak için aşağıdaki komutu kullanın:

GET {FHIRURL}/Patient/{ID}/$everything

Not

Belirli bir hasta için kimlik belirtmeniz gerekir. Tüm hastalar için tüm verilere ihtiyacınız varsa bkz. $export.

FHIR hizmeti, sağlanan hasta kimliğiyle eşleşen hastayı bulabileceğini doğrular. Bir sonuç bulunursa yanıt, aşağıdaki bilgileri içeren bir tür searchset paketi olacaktır:

• Hasta kaynağı.
• Hasta kaynağı tarafından doğrudan başvuruda bulunan kaynaklar, ayrıca bkz. olmayan bağlantı başvuruları dışında veya bağlantı bir RelatedPersonöğesine başvuruyorsaseealso.
• Diğer hastalara seealso bağlantı başvuruları varsa sonuçlar, listelenen hastalara karşı seealso Patient-everything işlemini içerir.
• Hasta Bölmesindeki kaynaklar.
• Hasta kaynağına başvuran cihaz kaynakları .

Not

Hastaya bağlı 100'den fazla cihaz varsa yalnızca 100 cihaz döndürülür.

Patient-everything parametreleri

FHIR hizmeti aşağıdaki sorgu parametrelerini destekler. Bu parametrelerin tümü isteğe bağlıdır:

Sorgu parametresi	Açıklama
_Türü	Yanıta hangi kaynak türlerinin dahil olacağını belirtmenize olanak tanır. Örneğin, _type=Encounter yalnızca Encounter hastayla ilişkili kaynakları döndürür.
_Beri	Yalnızca belirtilen süreden bu yana değiştirilmiş olan kaynakları döndürür.
start	Başlangıç tarihini belirtmek, klinik tarihlerinin belirtilen başlangıç tarihinden sonra olduğu kaynakları çeker. Başlangıç tarihi sağlanmazsa, bitiş tarihinden önceki tüm kayıtlar kapsamdadır.
end	Bitiş tarihini belirtmek, klinik tarihlerinin belirtilen bitiş tarihinden önce olduğu kaynakları çeker. Bitiş tarihi sağlanmazsa, başlangıç tarihinden sonraki tüm kayıtlar kapsamda olur.

Not

Patient-everything uygulamasının bu uygulaması _count parametresini desteklemez.

Hasta bağlantılarını işleme

Bir hasta kaynağında, bir hastayı diğer hastalara veya ilgili kişilere bağlayan link adlı bir öğe vardır. Bu bağlantılı hastalar, özgün hastanın bütünsel bir görünümünü sağlamaya yardımcı olur. Bağlantı başvurusu, bir hasta başka bir hastanın yerini alırken veya iki hasta kaynağında tamamlayıcı bilgiler olduğunda kullanılabilir. Bağlantılar için bir kullanım örneği, ADT 38 veya 39 HL7v2 iletisinin gelmesidir. Bir hastanın güncelleştirmesini açıklar. Bu güncelleştirme, bağlantı öğesindeki iki hasta arasında başvuru olarak depolanabilir.

FHIR belirtimi, farklı hasta bağlantıları türlerine ilişkin ayrıntılı bir genel bakış içerir, ancak üst düzey bir özet ekledik:

• replaces - Patient kaynağı farklı bir Patient öğesinin yerini alır.
• refer - Hasta geçerli, ancak ana bilgi kaynağı olarak kabul edilmez. Ek bilgi almak için başka bir hastaya işaret etti.
• seealso - Patient, eşit derecede geçerli olan başka bir hastanın bağlantısını içerir.
• replaced-by - Patient kaynağı farklı bir Patient öğesinin yerini alır.

Patient-everything hasta bağlantıları ayrıntıları

FHIR hizmetindeki Patient-everything operasyonu, hasta bağlantılarını farklı şekillerde işleyip size hastanın en bütünsel görünümünü sunar.

Not

Bağlantı bir öğesine de başvurabilir RelatedPerson. Şu anda RelatedPerson kaynaklar Patient-everything içinde işlenmez ve pakette döndürülmez.

Şu anda patient-everything işlemi tarafından bağlantıların yerini alır ve başvurur göz ardı edilir ve bağlantılı hasta pakette döndürülmüyor.

Açıklandığı gibi seealso bağlantıları, özgün hastayla eşit olarak geçerli kabul edilen başka bir hastaya başvurur. Patient-everything işlemi çalıştırıldıktan sonra, hastanın seealso diğer hastalara bağlantıları varsa, operasyon her seealso bağlantıda Patient-everything işlemini çalıştırır. Başka bir deyişle bir hasta, bir tür seealso bağlantısı olan beş hastayla daha bağlantı oluşturursa, bu beş hastanın her birinde Patient-everything komutunu çalıştıracağız.

Not

Bu, bağlantıları yalnızca bir katman derinlikte izleyecek seealso şekilde ayarlanır. Bir bağlantının seealso bağlantılarını işlemezseealso.

Son bağlantı türü ile değiştirilir. Bu durumda, asıl hasta kaynağı artık kullanılmıyor ve replaced-by bağlantı kullanılması gereken hastaya işaret ediliyor. bu uygulaması Patient-everything , varsayılan olarak paketin başında hastanın artık geçerli olmadığını belirten bir uyarı içeren bir işlem sonucu içerir. Üst bilgi olarak ayarlandığında handling=lenientda bu davranış Prefer olacaktır.

Buna ek olarak, bunun yerine üst bilgiyi hata oluşturacak şekilde handling=strict ayarlayabilirsinizPrefer. Bu durumda 301 MovedPermanently hata kodunun döndürülmesi, geçerli hastanın güncel olmadığını gösterir ve bağlantıda yer alan doğru hastanın kimliğini döndürür. ContentLocation Döndürülen hatanın üst bilgisi doğru ve güncel isteği gösterir.

Not

Bir replaced-by bağlantı varsa Prefer: handling=lenient ve sonuçlar birden çok pakette zaman uyumsuz olarak döndürülürse, tek bir pakette yalnızca bir işlem sonucu döndürülür.

Patient-everything yanıt sırası

Patient-everything işlemi sonuçları şu aşamalarda döndürür:

1. 1. Aşama, ve generalPractitionermanagingOrganization kaynakları ir başvurularına ek olarak kaynağın kendisini döndürürPatient.
2. 2. ve 3. aşama hasta bölmesindeki kaynakları geri döndürür. start veya end sorgu parametreleri belirtilirse, 2. Aşama klinik tarihlerine göre filtrelenebilen kaynakları bölmeden döndürür ve 3. Aşama, klinik tarihlerine göre filtrelenmeyecek kaynakları bölmeden döndürür. Bu parametrelerden hiçbiri belirtilmezse, 2. Aşama atlanır ve 3. Aşama tüm hasta bölmesi kaynaklarını döndürür.
3. 4. aşama, hastaya başvuran tüm cihazları döndürür.

Her aşama sonuçları bir paket halinde döndürür. Sonuçlar birden çok sayfaya yayılırsa, paketteki sonraki bağlantı bu aşama için sonuçların sonraki sayfasına işaret eder. Bir aşamadan gelen tüm sonuçlar döndürüldükten sonra, paketteki bir sonraki bağlantı sonraki aşamayı başlatmak için çağrısına işaret eder.

Orijinal hastanın herhangi bir seealso bağlantısı varsa, bu hastaların her biri için 1 ile 4 arasında faz tekrarlanır.

Patient-everything örnekleri

Patient-everything işleminin kullanımına bazı örnekler aşağıda verilmiştir. Bu örneklere ek olarak, ve replaced-by davranışının nasıl seealso çalıştığını gösteren bir rest dosyası örneğimiz vardır.

Bir hastanın 2010 ile 2020 arasındaki "her şeyi" sorgulamak için Patient-everything özelliğini kullanmak için aşağıdaki çağrıyı kullanın:

GET {FHIRURL}/Patient/{ID}/$everything?start=2010&end=2020

Hastanın Gözlemini ve Karşılaşmasını sorgulamak için Patient-everything özelliğini kullanmak için aşağıdaki çağrıyı kullanın:

GET {FHIRURL}/Patient/{ID}/$everything?_type=Observation,Encounter 

Bir hastanın 2021-05-27T05:00:00Z'den bu yana "her şeyi" sorgulamak için Patient-everything özelliğini kullanmak için aşağıdaki çağrıyı kullanın:

GET {FHIRURL}/Patient/{ID}/$everything?_since=2021-05-27T05:00:00Z 

Bu çağrıların her biri için bir hasta bulunursa ilgili kaynaklardan biriyle birlikte Bundle 200 yanıt alırsınız.

Sonraki adımlar

Patient-everything işlemini nasıl kullanacağınızı öğrendiğinize göre arama seçenekleri hakkında bilgi edinebilirsiniz. Daha fazla bilgi için bkz.

FHIR arama işlemine genel bakış

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