PHR veri biçimi

Kişisel Sağlık Kayıtları (PHR) verileri HL7 FHIR biçiminde saklanır.

PHR, aşağıdaki Hızlı Sağlık Hizmeti Birlikte Çalışabilirlik Kaynakları (FHIR) sürümlerini destekler:

Tıbbi Kaynak Türleri

FHIR, kaynaklar adı verilen modüler bileşenlerden oluşur. Desteklenen FHIR kaynak grubu ve ilgili kategoriler, kabaca Uluslararası Hasta Özeti bölümlerine dayanır.

Bu kaynaklar, Health Connect'teki veri kategorileriyle eşlenir. Bu kategorilere API'de Tıbbi Kaynak Türleri adı verilir. Gözlem kaynakları, mantıksal gözlem tanımlayıcı adları ve kodları (LOINC) kodları ve FHIR kategorileri gibi içeriklere göre eşlenir.

Bu kategorilerin hiçbirine ait olmayan gözlemler Health Connect'e yazılmaz.

Tablo 1: Health Connect Tıbbi Kaynak Türleri
Health Connect Tıbbi Kaynak Türü FHIR kaynakları
Alerjiler AllergyIntolerance
Rahatsızlıklar Koşul
Laboratuvar

Gözlem

  • laboratory FHIR kategorisi
İlaçlar Medication, MedicationRequest, MedicationStatement
Kişisel bilgiler Hasta
Uzman bilgileri Practitioner, PractitionerRole
Hamilelik

Gözlem

  • Hamilelik LOINC kodları
Müdahaleler Prosedür
Sosyal geçmiş

Gözlem

  • Sosyal Geçmiş LOINC kodları
  • social-history FHIR kategorisi
Aşılar Aşı
Doktor randevuları Karşılaşma, Konum, Kuruluş
Hayati bulgular

Gözlem

  • Yaşamsal bulgular LOINC kodları
  • vital-signs FHIR kategorisi

Hasta kaynakları

Health Connect'in şu anda tek bir kullanıcıya ait PHR verilerini saklaması amaçlanmıştır. Bu nedenle, yazılan tüm FHIR kaynakları aynı kişiye ait olmalıdır.

Bir sistemde tek bir kişi için birden fazla FHIR hasta kaynağının bulunması yaygın bir durumdur. Uygulamaların verileri uyumlu hale getirmesi ve Health Connect'e tek bir hasta kaynağı yazması tercih edilir. Ancak bu, mevcut olabilecek farklı kuruluş yapılarına uyum sağlamak için zorunlu kılınmaz.

Veri doğrulama

PHR API'leri, desteklenen sürümlerdeki geçerli FHIR kaynaklarını kabul eder ve Health Connect, desteklenen her sürüm için FHIR spesifikasyonuna uyulduğunu onaylamak üzere bazı doğrulamalar gerçekleştirir.

Yakında olarak işaretlenen doğrulama kontrolleri henüz zorunlu kılınmadı ancak gelecekteki bir sürümde zorunlu kılınacaktır. Gelecekteki sürümlerle uyumluluğu korumak için listelenen tüm doğrulama kontrollerini dikkate alarak geliştirme yapmanızı öneririz.

Tablo 2: FHIR verilerinin Health Connect doğrulaması
Seviye Doğrulama Kontrolü
Geçerli JSON Veriler JSON biçimiyle uyumludur.
Desteklenen FHIR

Yazma uygulaması tarafından beyan edilen FHIR sürümü desteklenir. Aşağıdaki FHIR sürümleri Health Connect tarafından desteklenir:

  • 4.0.1
  • 4.3.0
Desteklenen FHIR

Kaynak örneğine kaydedilen FHIR kaynak türü desteklenir. Health Connect, aşağıdaki FHIR kaynak türlerini destekler:

  • AllergyIntolerance
  • Koşul
  • Encounter
  • Aşı
  • Konum
  • İlaç
  • MedicationRequest
  • MedicationStatement
  • Gözlem
  • Kuruluş
  • Hasta
  • Pratisyen hekim
  • PractitionerRole
  • Prosedür
Benzersiz kaynak kimliği Kaynak, normal ifade şartlarını karşılayan bir değere sahip bir kimlik alanına sahiptir.
Benzersiz kaynak kimliği Kaynak, aynı MedicalDataSource kaynağından aynı kaynak türünde başka bir FHIR kaynağıyla kimlik paylaşmıyor.
İşletme Kuralları İçerilen FHIR kaynağı içermez. İçerilen kaynaklar, bir "üst" kaynağa yerleştirilmiş FHIR kaynaklarıdır. Bunlar, üst kaynağın başka bir kaynağı referans göstermesi gerektiğinde ancak sistemin bunu bağımsız varlığa sahip bağımsız bir kaynak olarak oluşturmak için yeterli bilgiye sahip olmadığında kullanılır.
Geçerli Temel FHIR FHIR JSON'undaki üst düzey alanlar, belirli bir kaynak türü için FHIR spesifikasyonunda mevcut olmalıdır.
Geçerli Temel FHIR Üst düzey alanlarda JSON null değerleri yoktur.
Geçerli Temel FHIR Üst düzey zorunlu alanların tümü mevcuttur.
Geçerli Temel FHIR FHIR'de yinelenen öğeler olarak tanımlanan üst düzey alanların veri türü JSON array'dir.
Geçerli Temel FHIR FHIR'de Karmaşık türler olarak tanımlanan üst düzey alanların (JSON array içindeki öğeler dahil) JSON object veri türü vardır.
Geçerli Temel FHIR FHIR'de ilkel türler olarak tanımlanan üst düzey alanlar (JSON array'lerindeki öğeler dahil) doğru JSON veri türüne sahiptir.
FHIR veri türü JSON veri türü
integer, unsignedInt, positiveInt, decimal numara
boole boole
anlık, saat, tarih, tarih saati, dize, kod, markdown, kimlik URI'si, URL, oid, uuid, standart, tam sayı64, base64Binary numara
Çok yakında
Geçerli Temel FHIR FHIR'de ilkel türler olarak tanımlanan üst düzey alanlar normal ifade koşullarını karşılar. Çok yakında
Geçerli Temel FHIR Temel türlere yönelik uzantılar, FHIR spesifikasyonunda bulunur ve JSON object veri türüne sahiptir.
Geçerli Temel FHIR Seçim alanları (fieldname[x]) için birden fazla alan kaydedilmez. Örneğin, aynı kaynak örneğinde hem effectiveDateTime hem de effectivePeriod bulunamaz.
Geçerli Temel FHIR Karmaşık veri türleri, FHIR spesifikasyonuyla eşleşen alanları ve veri türlerini içerir. Çok yakında
Geçerli Temel FHIR Ana hat öğeleri (ve karmaşık türlerdeki öğeler) FHIR spesifikasyonuyla eşleşen alanları ve veri türlerini içerir. Çok yakında
Geçerli Temel FHIR Uzantılar öğesi value[x] alanları geçerli bir türdür ve bu veri türüne göre içerikler içerir. Uzatma öğeleri, temel spesifikasyonun parçası olmayan ek bilgileri temsil etmek için herhangi bir kaynağa dahil edilebilir. Bunlar, uzantının tanımına bağlantı veren bir url alanı ve uzantı değerini içeren bir value[x] alanı içerir. value[x], kabul edilen veri türlerinin listelenmiş listesinden olmalıdır. Çok yakında

Dönüştürülmüş FHIR verileri

Bazı uygulamalar, FHIR verilerini kendi koşullarını karşılayacak şekilde dönüştürür. Örnek:

  • Farklı kaynaklardan (genellikle FHIR API'leri) gelen verileri birleştirme.
  • Kodları küresel terminolojilerle (ör. SNOMED, LOINC, ICD) eşleme ve birimleri standartlaştırma.
  • Verileri birleştirme ve tekilleştirme.
  • Biçimlendirme veya diğer veri kalitesi sorunlarını düzeltme
  • Uygulamaya özgü iş kurallarına göre kayıtları filtreleme.

Dönüştürülmemiş ve dönüştürülmüş FHIR verileri, FHIR R4 spesifikasyonuna uymaları koşuluyla Health Connect'e yazılabilir. Mümkün olduğunda dönüştürülmüş verileri yazmanız önerilir. Ancak aşağıdaki noktaları göz önünde bulundurun:

  • Kullanım alanı dar olan uygulamalar, ekosistemdeki diğer uygulamaların kullanıcı değeri oluşturabileceği önemli sayıda kaydı filtreleyebilir. Bu tür durumlarda, daha eksiksiz olan dönüştürülmemiş FHIR'i yazmak yararlı olabilir. Ancak kullanıcıları bu daha geniş veri kümesinin paylaşıldığını bilgilendirdiğinizden emin olun.
  • Farklı kaynaklardan gelen verileri birleştiriyorsanız verileri Health Connect'te tek bir MedicalDataSource'e yazabilirsiniz. Çakışmaları önlemek için her kaynağa yeni bir kimlik atamanız ve kaynak referanslarını yeni kimlikleri işaret edecek şekilde güncellemeniz de gerekir.
  • Birden fazla kaynaktan gelen verileri tek bir MedicalDataSource altında birleştirmek, veri kaynağını gizleyebilir. Veri tüketicilerinin verilerin kaynağını anlaması genellikle yararlı olduğundan, her kaynak için meta.source alanını kaydın orijinal kaynağıyla (genellikle bir FHIR ana URL'si) doldurmanızı öneririz.