FHIR Hasta kaynağı: kimlikler, isimler, demografik bilgiler ve bağlantılar, geçerli bir örnekle anlatıldı

Kısa cevap: Patient (Hasta), bakım alan bir kişiyi tanımlayan FHIR kaynağıdır: idari olarak kim olduklarını belirtir, neyin yanlış olduğunu değil. Tanımlayıcılar (tıbbi kayıt numaraları, ulusal kimlikler), isimler, iletişim bilgileri, idari cinsiyet, doğum tarihi, adres, medeni durum, iletişim (diller), bir aile hekimi, bir yönetici organizasyon ve aynı kişi için diğer Hasta kayıtlarına bağlantılar içerir. Her Gözlem (Observation), Durum (Condition), Karşılaşma (Encounter) veya İlaç Beyanı (MedicationStatement) subject veya patient aracılığıyla ona atıfta bulunur. Klinik gerçekler asla Hasta'da yaşamaz; ona işaret eden kaynaklarda yaşar.

Geçerli bir FHIR R4 örneği

Geçerli bir FHIR R4 Patient kaynağı yalnızca resourceType gerektirir, ancak pratikte en az bir identifier (sistem ve değer ile), bir name (aile ve verilen kısımlarıyla), bir administrativeGender ve bir birthDate içerir. Aşağıdaki örnek, meta.profile'da IPS Patient profilini de iddia eder ve iletişim bilgilerini, adresi, tercih edilen dili, genel pratisyeni ve yönetici kuruluşu ekler.

{
  "resourceType": "Patient",
  "id": "example",
  "meta": {"profile": ["http://hl7.org/fhir/uv/ips/StructureDefinition/Patient-uv-ips"]},
  "identifier": [{
    "use": "usual",
    "type": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v2-0203", "code": "MR"}]},
    "system": "https://hospital.example.org/mrn",
    "value": "MRN-00012345"
  }],
  "active": true,
  "name": [{"use": "official", "family": "Doe", "given": ["Jane", "Marie"], "prefix": ["Ms"]}],
  "telecom": [{"system": "email", "value": "[email protected]", "use": "home"}],
  "gender": "female",
  "birthDate": "1980-05-23",
  "address": [{"use": "home", "line": ["12 High Street"], "city": "Leeds", "postalCode": "LS1 4AB", "country": "GB"}],
  "communication": [{"language": {"coding": [{"system": "urn:ietf:bcp:47", "code": "en-GB"}]}, "preferred": true}],
  "generalPractitioner": [{"reference": "Practitioner/gp-42"}],
  "managingOrganization": {"reference": "Organization/hospital"}
}

Önemli öğeler

Birlikte çalışabilirlik için en önemli Patient öğeleri şunlardır: identifier (sistem, değer ve tür ile), name (kullanım, aile ve verilen ile), administrativeGender, birthDate, deceased, active, contact ve link. Tanımlayıcılar ve adlar sistemler arasındaki eşleştirmeyi yönlendirir, cinsiyet ve doğum tarihi idari gerçeklerdir ve link bir ana hasta dizininin bir kişinin yinelenen kayıtlarını nasıl bağladığını kaydeder.

• identifier (tanımlayıcı), her biri system (kimin çıkardığı) ve value (değer) içeren bir listedir. type (tip) ne olduğunu söyler: MR tıbbi kayıt numarası, NI ulusal kimlik, PPN pasaport, SS sosyal güvenlik numarası, HL7 tablo 0203'ten. Bir hastanın genellikle birkaç tane vardır; bir hastanenin MRN'si ve ulusal kimlik geçerlidir ve sistemler bunları eşleştirir.
• name (isim) de use (kullanım) ile bir listedir: official (resmi), usual (olağan), nickname (takma ad), maiden (bekarlık soyadı), old (eski). family (soyadı) tek bir dizedir; given (ad) bir listedir. Yazım sistemleri, transkripsiyonlar ve isim sırası ülkenin uygulama kılavuzuna bırakılır.
• gender (cinsiyet) dört değerle idari cinsiyettir: male (erkek), female (kadın), other (diğer), unknown (bilinmiyor). Kaydın ne dediğidir, eşleştirme ve formlar için kullanılır. Klinik cinsiyet, cinsiyet kimliği ve zamirler uzantılarda veya Gözlemlerde (Observations) yer alır, ki bunlar FHIR R5 ve Cinsiyet Uyumu (Gender Harmony) projesi tarafından resmileştirilmiştir.
• birthDate (doğum tarihi) bir tarihtir, tam tarih bilinmiyorsa isteğe bağlı olarak yalnızca yıl veya yıl-ay olabilir. Bir patient-birthTime uzantısı yenidoğanlar için saati ekler.
• deceased[x] (vefat etmiş) bir boolean veya tarih-saattir. active (aktif) false, bir kaydın silinmeden artık kullanılmaması gerektiğini (kopya, taşınmış) işaretler.
• contact (iletişim), bir ilişki koduyla (yakın akraba, vasi) iletişim kurulacak kişileri listeler; bunlar kendileri Hasta kaynakları değildir. Aynı zamanda hasta olan bir ebeveyn, her ikisine de işaret eden bir RelatedPerson'dur.
• link (bağlantı), aynı kişi olan Hasta kayıtlarını bağlar: birleştirme sonrası replaced-by (yerine geçti) ve replaces (yerini aldı), yetkili kayda refer (işaret et), başka bir sistemdeki kayıt için seealso (ayrıca bak). Bir ana hasta indeksi (master patient index) kararlarını FHIR'da bu şekilde ifade eder; bkz. Hasta eşleştirme.

Ulusal profiller ne ekler

Ulusal ve uluslararası FHIR profilleri, öğeleri zorunlu kılarak ve ülkeye özgü uzantılar ekleyerek gevşek tanımlanmış temel Patient kaynağını kullanılabilir bir şeye dönüştürür. US Core, identifier, name ve gender gerektirir ve ırk, etnik köken ve doğum cinsiyeti uzantıları ekler; IPS Patient profili name, gender ve birthDate gerektirir; ulusal profiller identifier sistemlerini ve adres biçimlerini tanımlar.

Temel kaynak neredeyse her şeyi isteğe bağlı yapar. Profiller onu kullanılabilir hale getirir:

Sınırları aşacak bir kayıt, pratikte hem ulusal kimliği hem de bir MRN'yi, tam resmi bir adı ve eksiksiz bir doğum tarihini taşıması anlamına gelen her iki taraftaki profili karşılamalıdır. Bkz. FHIR uygulama kılavuzları.

Kullanacağınız işlemler

Patient ile en çok kullanılan FHIR işlemleri, tanımlayıcıya veya demografiye göre arama (GET /Patient?identifier=... veya family=... veya birthdate=...), hastayı ve onlara başvuran her kaynağı döndüren $everything işlemi ve sunucunun olası yinelenenleri bulma algoritmasına soran $match işlemidir. R5 sürümünde bir $merge işlemi standartlaştırılmaktadır.

• GET /Patient?identifier=https://hospital.example.org/mrn|MRN-00012345 bir hastayı tanımlayıcıya göre bulur; ?family=doe&birthdate=1980-05-23 demografiye göre bulur.
• GET /Patient/{id}/$everything hastayı ve ona atıfta bulunan her kaynağı sayfalayarak döndürür, bu da tüm kaydın nasıl dışa aktarıldığıdır.
• $match (desteklendiği yerlerde) sunucunun eşleştirme algoritmasından olası kopyaları ister; $merge R5'te standartlaştırılmaktadır.

Hasta kayıtlarını bozan hatalar

FHIR Patient kayıtlarını en sık bozan hatalar şunlardır: ulusal kimliği identifier yerine resource id olarak saklamak, farklı hastanelerden gelen değerlerin çakışmasını önlemek için identifier.system'ı atlamak, tüm adı aile ve verilen kısımları olmadan text alanına koymak, klinik cinsiyet için idari cinsiyeti kullanmak ve birleştirilmiş bir kaydı bağlayıp devre dışı bırakmak yerine yerinde düzenlemek.

• Ulusal kimliği id içine koymak. Kaynak id sunucuya aittir ve içe aktarma sırasında değişebilir; tanımlayıcılar identifier içine aittir.
• Her şeyin text içinde olduğu ve family/given olmadığı tek bir name, bu da soyadına göre aramaların başarısız olmasına neden olur.
• gender'ın klinik cinsiyet için kullanılması veya formda alan olmadığı için unknown olarak ayarlanması.
• identifier.system eksikliği, bu da iki hastanenin MRN-1 değerlerinin çakışmasına neden olur.
• Birleştirme gerçekleştiğinde bir Hasta'yı yerinde düzenlemek, bağlantı kurup devre dışı bırakmak yerine.

Anpheros'ta

Anpheros, her kişiyi, hesap sahibini ve her aile profilini Anpheros Platform'da bir FHIR Patient kaynağı olarak temsil eder ve bir kliniğin API aracılığıyla eklediği her kayıt bu Patient'a başvurur. Klinik tanımlayıcıları, kliniğin kendi sistemine sahip ek tanımlayıcılar olarak tutulur ve bir kişinin girdiği demografik bilgiler, klinik olarak hiçbir şeyin çıkarılmadığı idari veriler olarak kalır.

Bir klinik kendi tanımlayıcısını gönderdiğinde, kliniğin sistemine sahip ek bir identifier olarak saklanır, böylece aynı kişi her iki taraftan da bulunabilir. Kişinin uygulamada girdiği demografik bilgiler usual adı ve idari verilerdir; kayıt asla bunlardan klinik bir çıkarım yapmaz.

İlgili sayfalar

• Hasta eşleştirme ve ana hasta indeksi
• FHIR uygulama kılavuzları
• FHIR Encounter açıklandı
• FHIR Condition açıklandı
• FHIR arama açıklandı
• Geliştirici sitesinde Hasta örneği

Kaynaklar

• HL7 FHIR R4: Patient
• HL7 FHIR R4: Patient $everything
• HL7 Terminoloji: tanımlayıcı tür kodları (v2-0203)
• HL7 US Core: Patient profili
• HL7 IPS: Patient profili

Sık sorulan sorular

Patient, FHIR'daki Person ile aynı mı?

Hayır. Person, aynı insanı roller arasında (burada bir Hasta, orada bir Uygulayıcı, başka bir yerde bir RelatedPerson) bağlayan idari bir kaynaktır. Klinik kaynaklar Person'a değil, Patient'a atıfta bulunur.

Alerjiler ve durumlar nereye gider?

Patient'a atıfta bulunan AllergyIntolerance ve Condition kaynaklarına. Patient'ın kendisi yalnızca idari verileri içerir.

İsmi olmayan bir yenidoğanı nasıl kaydederim?

Kullanımı temporary (geçici) veya boş olan bir isimle, patient-birthTime uzantılı bir birthDate ile ve ulusal profillerin belirttiği gibi, RelatedPerson aracılığıyla annenin kaydına bir link veya patient-mothersMaidenName uzantısıyla.

Bir Hasta kaynağı iki hastane tarafından paylaşılabilir mi?

Her sistem kendi kimliğine sahip kendi Hasta kaynağını tutar; tanımlayıcıları (ulusal bir kimlik) paylaşırlar ve kayıtları bağlayabilirler. Sistemler arası eşleştirme, kaynakların değil, bir ana hasta indeksinin işidir.

Anpheros Platform

Sandbox'ta ücretsiz deneyin

İlk FHIR çağrınız 5 dakikada. Hasta izniyle yerleşik HL7 FHIR R4 API: sandbox'ta deneyin, ardından kendi uygulamanızı veya klinik sisteminizi bağlayın.

Ücretsiz sandbox oluşturunGeliştirici kılavuzlarını okuyun →

Ücretsiz · 30 sentetik hasta · kart gerekmez

Yazan

Anpheros Ekibi

Anpheros, hasta kontrolünde olan ve herhangi bir klinik ile paylaşılabilecek, AB merkezli bir HL7 FHIR R4 platformu üzerinde tıbbi kayıtlar oluşturur. Bu rehberler, sağlığınızı anlamanıza ve düzenlemenize yardımcı olur; doktorunuzun yerini tutmaz.

Anpheros Hakkında →