Tıbbi Kayıtlar veri biçimi

Tıbbi Kayıtlar verileri HL7 FHIR biçiminde saklanır.

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

Tıbbi Kaynak Türleri

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

Bu kaynaklar, Health Connect'teki veri kategorileriyle eşlenir ve API'de Tıbbi Kaynak Türleri olarak adlandırılır. Gözlem kaynakları, Logical Observation Identifiers Names and Codes (LOINC) kodları ve FHIR kategorileri gibi içeriklere göre eşlenir.

Bu kategorilerden 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ı Health Connect izin beyanı
Alerjiler AllergyIntolerance android.permission.health.READ_MEDICAL_DATA_ALLERGIES_INTOLERANCES
Rahatsızlıklar Koşul android.permission.health.READ_MEDICAL_DATA_CONDITIONS
Laboratuvar

Gözlem

  • laboratory FHIR kategorisi
 android.permission.health.READ_MEDICAL_DATA_LABORATORY_RESULTS
İlaçlar İlaç, MedicationRequest, MedicationStatement android.permission.health.READ_MEDICAL_DATA_MEDICATIONS
Kişisel bilgiler Hasta android.permission.health.READ_MEDICAL_DATA_PERSONAL_DETAILS
Uzman bilgileri Pratisyen, PractitionerRole android.permission.health.READ_MEDICAL_DATA_PRACTITIONER_DETAILS
Hamilelik

Gözlem

  • Hamilelik LOINC kodları
 android.permission.health.READ_MEDICAL_DATA_PREGNANCY
Müdahaleler Prosedür android.permission.health.READ_MEDICAL_DATA_PROCEDURES
Sosyal geçmiş

Gözlem

  • Sosyal geçmiş LOINC kodları
  • social-history FHIR kategorisi
 android.permission.health.READ_MEDICAL_DATA_SOCIAL_HISTORY
Aşılar Aşı android.permission.health.READ_MEDICAL_DATA_VACCINES
Doktor randevuları Karşılaşma, Konum, Kuruluş android.permission.health.READ_MEDICAL_DATA_VISITS
Hayati bulgular

Gözlem

  • Hayati bulgular LOINC kodları
  • vital-signs FHIR kategorisi
 android.permission.health.READ_MEDICAL_DATA_VITAL_SIGNS

Hasta kaynakları

Health Connect, şu anda yalnızca tek bir kişinin tıbbi kayıt verilerini saklamak için tasarlanmış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 Patient kaynağının bulunması yaygın bir durumdur. Uygulamaların verileri uzlaştırması ve Health Connect'e tek bir Hasta kaynağı yazması tercih edilir. Ancak, olabilecek farklı organizasyon yapılarını barındırmak için bu zorunlu tutulmaz.

Veri doğrulama

Tıbbi Kayıt API'leri, desteklenen sürümlerden geçerli FHIR kaynaklarını kabul eder ve Health Connect, desteklenen her sürüm için FHIR spesifikasyonuna uyulduğunu doğrulamak üzere bazı doğrulama işlemleri gerçekleştirir.

Yakında olarak işaretlenen doğrulama kontrolleri henüz zorunlu kılınmamıştır ancak ilerideki bir sürümde zorunlu kılınacaktır. Gelecekteki sürümlerle uyumluluğu korumak için listelenen tüm doğrulama kontrollerine göre geliştirme yapmanızı öneririz.

Tablo 2: Health Connect'in FHIR verilerini doğrulaması
Seviye Doğrulama Kontrolü
Geçerli JSON Veriler JSON biçimine uygundur.
Desteklenen FHIR

Yazma uygulaması tarafından belirtilen FHIR sürümü desteklenir. Health Connect aşağıdaki FHIR sürümlerini destekler:

  • 4.0.1
  • 4.3.0
Desteklenen FHIR

Kaynak örneğinde kayıtlı 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 Kaynağın, normal ifade şartlarını karşılayan bir değere sahip bir kimlik alanı var.
Benzersiz kaynak kimliği Kaynak, aynı MedicalDataSource'dan aynı kaynak türündeki başka bir FHIR kaynağıyla kimlik paylaşmıyor.
İşletme Kuralları Kapsanan FHIR kaynağı içermez. Kapsanan kaynaklar, bir "üst" kaynağa yerleştirilmiş FHIR kaynaklarıdır. Üst kaynak başka bir kaynağa referans vermesi gerektiğinde ancak sistemin bunu bağımsız bir kaynak olarak oluşturmak için yeterli bilgisi olmadığında kullanılır.
Geçerli Temel FHIR FHIR JSON'ındaki üst düzey alanlar, belirtilen kaynak türü için FHIR spesifikasyonunda bulunur.
Geçerli Temel FHIR Üst düzey alanlarda JSON null değerleri yok.
Geçerli Temel FHIR Üst düzeydeki zorunlu alanların tümü mevcut olmalıdır.
Geçerli Temel FHIR FHIR'da tekrar eden öğeler olarak tanımlanan üst düzey alanlar, JSON array veri türüne sahiptir.
Geçerli Temel FHIR Üst düzey alanlar (JSON array'ları içindeki öğeler dahil) şeklinde tanımlanır: FHIR'daki karmaşık türler, JSON object veri türüne sahiptir.
Geçerli Temel FHIR Üst düzey alanlar (JSON array'lerindeki öğeler dahil) Primitive types olarak tanımlanan FHIR'da doğru JSON veri türüne sahiptir.
FHIR veri türü JSON veri türü
integer, unsignedInt, positiveInt, decimal numara
boole boole
instant, time, date, dateTime, string, code, markdown, id uri, url, oid, uuid, canonical, integer64, base64Binary numara
Çok yakında
Geçerli Temel FHIR FHIR'da 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ürlerin 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, effectiveDateTime ve effectivePeriod aynı kaynak örneğinde bulunamaz.
Geçerli Temel FHIR Karmaşık veri türleri, FHIR spesifikasyonuyla eşleşen alanlar ve veri türleri içerir. Çok yakında
Geçerli Temel FHIR Temel öğeler (ve karmaşık türlerdeki öğeler), FHIR spesifikasyonuyla eşleşen alanlar ve veri türleri içerir. Çok yakında
Geçerli Temel FHIR Uzantılar öğesi value[x] alanları geçerli bir türdedir ve bu veri türüne göre içerik barındırır. Temel spesifikasyonun parçası olmayan ek bilgileri temsil etmek için herhangi bir kaynağa uzantı öğeleri eklenebilir. Bu öğeler, uzantının tanımına bağlanan bir url alanı ve uzantı değerini içeren bir value[x] alanı içerir. value[x], kabul edilen veri türlerinin belirlenmiş listesinden olmalıdır. Çok yakında

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

Bazı uygulamalar, kendi gereksinimlerini karşılamak için FHIR verilerini dönüştürür. Örneğin:

  • Farklı kaynaklardaki (genellikle FHIR API'leri) 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
  • Kayıtları uygulamaya özel iş kurallarına göre filtreleme.

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

  • Dar kullanım alanlarına sahip uygulamalar, ekosistemdeki diğer uygulamaların kullanıcı değeri oluşturabileceği önemli sayıda kaydı filtreleyebilir. Bu gibi durumlarda, dönüştürülmemiş ve daha eksiksiz olan FHIR'ı yazmak faydalı olabilir. Ancak bu daha geniş veri kümesinin paylaşıldığını kullanıcılara bildirdiğinizden emin olun.
  • Farklı kaynaklardan gelen verileri birleştiriyorsanız Health Connect'te verileri tek bir MedicalDataSource'ye yazabilirsiniz. Çakışmaları önlemek için her kaynağa yeni bir kimlik atamanız ve kaynak referanslarını yeni kimlikleri gösterecek şekilde güncellemeniz de gerekir.
  • Birden fazla kaynaktan gelen verilerin tek bir MedicalDataSource içinde birleştirilmesi, verilerin kaynağını gizleyebilir. Veri tüketicilerinin verilerin kaynağını anlaması genellikle faydalı olduğundan, her kaynak için meta.source alanını kaydın orijinal kaynağıyla (genellikle bir FHIR temel URL'si) doldurmanızı öneririz.
Önceki
Genel bakış
Sonraki
Tıbbi verileri yazma