บันทึกข้อมูลสุขภาพส่วนบุคคล

แพลตฟอร์ม Health Connect มีประเภทข้อมูลหลากหลาย ซึ่งส่วนใหญ่ครอบคลุมกรณีการใช้งานด้านความแข็งแรงสมบูรณ์และการออกกำลังกาย ซึ่งช่วยให้แอปในระบบนิเวศ Android สามารถแชร์ข้อมูลได้โดยไม่ต้องมีการผสานรวม API แบบ 1:1 ที่มีค่าใช้จ่ายสูง เวชระเบียนส่วนบุคคล (PHR) ขยายความสามารถนี้เพื่อรวมข้อมูลทางการแพทย์พื้นฐานในรูปแบบ Fast Healthcare Interoperability Resources (FHIR®) ซึ่งรวมถึงข้อมูลต่อไปนี้

  • API สําหรับแอปพลิเคชันที่เขียนข้อมูลทางการแพทย์
  • ประสบการณ์การใช้งานเบราว์เซอร์ที่แสดงต่อผู้ใช้สำหรับข้อมูลทางการแพทย์ที่จัดเก็บไว้ใน Health Connect เป็นประเภทข้อมูลทางการแพทย์ใหม่ รวมถึงสิทธิ์แบบละเอียดสำหรับการอนุญาตให้อ่านดาวน์สตรีม
  • API สําหรับแอปพลิเคชันที่อ่านข้อมูลทางการแพทย์ตามสิทธิ์ที่ผู้ใช้ให้ไว้
ภาพรวมของวิธีที่บันทึกข้อมูลสุขภาพส่วนบุคคลทำงานร่วมกับ Health Connect
รูปที่ 1 วิธีที่บันทึกข้อมูลสุขภาพส่วนบุคคลทำงานร่วมกับ Health Connect

PHR API พร้อมใช้งานผ่าน SDK ของ Android 16 ดูวิธีการเริ่มต้นได้ที่หัวข้อตั้งค่า Android SDK เวอร์ชัน 16

ข้อจำกัด

เนื่องจาก API เหล่านี้ยังอยู่ระหว่างการพัฒนา จึงยังมีข้อจำกัดบางอย่างและคอมโพเนนต์บางรายการยังไม่พร้อมใช้งานอย่างเต็มรูปแบบ

  • โดยทั่วไปแล้ว Health Connect Jetpack SDK จะใช้เพื่อลดความซับซ้อนในการผสานรวมโดยการรวม API ของ Health Connect แต่ตอนนี้ยังไม่มี SDK ดังกล่าว จึงต้องใช้ API ของเฟรมเวิร์ก Android ที่เกี่ยวข้อง
  • นโยบายของ Play สําหรับการเข้าถึง PHR ยังอยู่ระหว่างการพัฒนา และแอปอาจต้องมีคุณสมบัติตรงตามข้อกําหนดเพิ่มเติมก่อนจึงจะเผยแพร่ใน Play Store ได้
  • ฟีเจอร์บางอย่าง เช่น API ตามบันทึกการเปลี่ยนแปลง ยังไม่ได้รับการพัฒนาสำหรับ PHR API

รูปแบบข้อมูล PHR

ระบบจะจัดเก็บข้อมูล PHR ในรูปแบบ HL7 FHIR โดยในขั้นต้นจะรองรับเฉพาะเวอร์ชัน R4

การตรวจสอบข้อมูล

PHR API จะยอมรับทรัพยากร FHIR เวอร์ชัน R4 ที่ถูกต้อง และ Health Connect จะดำเนินการตรวจสอบบางอย่างเพื่อให้เป็นไปตามข้อกำหนด FHIR R4

การตรวจสอบความถูกต้องที่ทําเครื่องหมายเป็นเร็วๆ นี้ยังไม่บังคับใช้ แต่จะใช้ได้ในรุ่นที่จะออกในอนาคต เราขอแนะนำให้พัฒนาตามการตรวจสอบการถูกต้องทั้งหมดที่ระบุไว้เพื่อหลีกเลี่ยงปัญหาในรุ่นต่อๆ ไป

ตารางที่ 1: การตรวจสอบข้อมูล FHIR ของ Health Connect
ระดับ การตรวจสอบความถูกต้อง
JSON ที่ถูกต้อง ข้อมูลเป็นไปตามรูปแบบ JSON
FHIR ที่รองรับ

ระบบรองรับเวอร์ชัน FHIR ที่ประกาศโดยแอปพลิเคชันการเขียน Health Connect รองรับ FHIR เวอร์ชันต่อไปนี้

  • 4.0.1
  • 4.3.0
FHIR ที่รองรับ

ระบบรองรับประเภททรัพยากร FHIR ที่บันทึกไว้ในอินสแตนซ์ทรัพยากร Health Connect รองรับประเภททรัพยากร FHIR ต่อไปนี้

  • AllergyIntolerance
  • เงื่อนไข
  • แพ็กเกจใกล้ชิดกับโลมา
  • วัคซีนและภูมิคุ้มกัน
  • ตำแหน่ง
  • ยา
  • MedicationRequest
  • MedicationStatement
  • การสังเกต
  • องค์กร
  • ผู้ป่วย
  • แพทย์
  • PractitionerRole
  • ขั้นตอน
รหัสทรัพยากรที่ไม่ซ้ำกัน ทรัพยากรมีช่องรหัสซึ่งมีค่าที่เป็นไปตามข้อกําหนดของนิพจน์ทั่วไป
รหัสทรัพยากรที่ไม่ซ้ำกัน ทรัพยากรไม่ได้แชร์รหัสกับทรัพยากร FHIR อื่นที่มีประเภททรัพยากรเดียวกันจาก MedicalDataSource เดียวกัน
กฎทางธุรกิจ ไม่มีทรัพยากร FHIR ที่มีอยู่ในนั้น

ทรัพยากรที่รวมอยู่คือทรัพยากร FHIR ที่ฝังอยู่ภายในทรัพยากร "หลัก" ทรัพยากรย่อยจะใช้เมื่อทรัพยากรหลักต้องอ้างอิงทรัพยากรอื่น แต่ระบบมีข้อมูลไม่เพียงพอที่จะสร้างทรัพยากรสแตนด์อโลนนี้ให้อยู่ได้ด้วยตัวเอง
FHIR พื้นฐานที่ถูกต้อง ช่องระดับบนสุดใน FHIR JSON อยู่ในข้อกำหนด FHIR สำหรับประเภททรัพยากรที่ระบุ
FHIR พื้นฐานที่ถูกต้อง ช่องระดับบนสุดไม่มีค่า Null ของ JSON
FHIR พื้นฐานที่ถูกต้อง ช่องระดับบนสุดที่กําหนดเป็นองค์ประกอบที่ซ้ำกันใน FHIR จะมีประเภทข้อมูล JSON array
FHIR พื้นฐานที่ถูกต้อง ช่องระดับบนสุด (รวมถึงองค์ประกอบภายใน array ของ JSON) ที่กําหนดเป็นประเภทที่ซับซ้อนใน FHIR จะมีประเภทข้อมูล object ของ JSON
FHIR พื้นฐานที่ถูกต้อง ช่องระดับบนสุด (รวมถึงองค์ประกอบภายใน array ของ JSON) ที่กําหนดเป็นประเภทพื้นฐานใน FHIR ต้องเป็นประเภทข้อมูล JSON ที่ถูกต้อง

ประเภทข้อมูล FHIR ประเภทข้อมูล JSON
integer, unsignedInt, positiveInt, decimal ตัวเลข
บูลีน บูลีน
instant, time, date, dateTime, string, code, markdown, id uri, url, oid, uuid, canonical, integer64, base64Binary ตัวเลข
เร็วๆ นี้
FHIR พื้นฐานที่ถูกต้อง ฟิลด์ระดับบนสุดที่กําหนดเป็นประเภทพื้นฐานใน FHIR ต้องเป็นไปตามข้อกําหนดของนิพจน์ทั่วไป

เร็วๆ นี้
FHIR พื้นฐานที่ถูกต้อง ส่วนขยายสำหรับประเภทพื้นฐานมีอยู่ในสเปค FHIR และมีประเภทข้อมูล JSON object
FHIR พื้นฐานที่ถูกต้อง ระบบจะบันทึกช่องตัวเลือก (fieldname[x]) ไม่เกิน 1 ช่อง

ตัวอย่างเช่น effectiveDateTime และ effectivePeriod ต้องไม่ปรากฏในอินสแตนซ์แหล่งข้อมูลเดียวกัน
FHIR พื้นฐานที่ถูกต้อง ประเภทข้อมูลที่ซับซ้อนประกอบด้วยช่องและประเภทข้อมูลที่ตรงกับข้อกำหนด FHIR

เร็วๆ นี้
FHIR พื้นฐานที่ถูกต้อง องค์ประกอบแบ็กโบนน์ (และองค์ประกอบภายในประเภทที่ซับซ้อน) มีช่องและประเภทข้อมูลที่ตรงกับข้อกำหนด FHIR

เร็วๆ นี้
FHIR พื้นฐานที่ถูกต้อง องค์ประกอบส่วนขยาย ช่อง value[x] เป็นประเภทที่ถูกต้องและมีเนื้อหาตามประเภทข้อมูลนั้น

องค์ประกอบส่วนขยายสามารถรวมอยู่ในทรัพยากรใดก็ได้เพื่อแสดงข้อมูลเพิ่มเติมที่ไม่ได้อยู่ในข้อกำหนดพื้นฐาน โดยจะมีช่อง url ที่ลิงก์กับคำจำกัดความของส่วนขยาย และช่อง value[x] ที่มีค่าส่วนขยาย value[x] ต้องมาจากรายการประเภทข้อมูลที่ยอมรับ

เร็วๆ นี้
FHIR พื้นฐานที่ถูกต้อง มีช่องที่ต้องกรอกระดับบนสุดครบถ้วน

หมวดหมู่ข้อมูล

ชุดทรัพยากร FHIR และหมวดหมู่ที่เกี่ยวข้องที่รองรับจะอิงตามส่วนสรุปผู้ป่วยระหว่างประเทศโดยคร่าวๆ ดังนี้

  • หมวดหมู่การแพ้ - มีทรัพยากร AllergyIntolerance
  • หมวดหมู่เงื่อนไข - มีแหล่งข้อมูลเงื่อนไข
  • หมวดหมู่การเข้าชม - มีทรัพยากรการพบปะ สถานที่ตั้ง และองค์กร
  • หมวดหมู่วัคซีน - มีทรัพยากรเกี่ยวกับการสร้างภูมิคุ้มกัน
  • หมวดหมู่รายละเอียดส่วนบุคคล - มีแหล่งข้อมูลสำหรับผู้ป่วย
  • หมวดหมู่รายละเอียดผู้ประกอบวิชาชีพทางการแพทย์ - มีแหล่งข้อมูล Practitioner, PractitionerRole
  • หมวดหมู่กระบวนการ - มีแหล่งข้อมูลกระบวนการ
  • หมวดหมู่ยา - มีทรัพยากร Medication, MedicationRequest, MedicationStatement

แหล่งข้อมูลการสังเกตการณ์จะจัดหมวดหมู่ตามเนื้อหา ดังนี้

  • การตั้งครรภ์ - อิงตามรหัส LOINC การตั้งครรภ์
  • ประวัติทางสังคม - อิงตามรหัส LOINC ของประวัติทางสังคมหรือหมวดหมู่ FHIR "social-history"
  • สัญญาณชีพ - อิงตามรหัส LOINC ของสัญญาณชีพหรือหมวดหมู่ FHIR "vital-signs"
  • ห้องปฏิบัติการ - อิงตามหมวดหมู่ FHIR "ห้องปฏิบัติการ"

ระบบจะไม่เขียนข้อมูลสังเกตการณ์ที่ไม่อยู่ในหมวดหมู่เหล่านี้ลงใน Health Connect

แหล่งข้อมูลสำหรับผู้ป่วย

ปัจจุบัน Health Connect มีไว้เพื่อจัดเก็บข้อมูล PHR ของบุคคลธรรมดาเพียงรายเดียวเท่านั้น ดังนั้นทรัพยากร FHIR ทั้งหมดที่เขียนขึ้นควรเป็นของบุคคลเดียวกัน

การที่ทรัพยากรผู้ป่วย FHIR หลายรายการอยู่ในระบบสำหรับบุคคลธรรมดาเพียงคนเดียวนั้นไม่ใช่เรื่องแปลก เราขอแนะนำให้เขียนแอปเพื่อปรับยอดข้อมูลและเขียนแหล่งข้อมูลผู้ป่วยรายการเดียวไปยัง Health Connect อย่างไรก็ตาม ระบบจะไม่บังคับใช้รูปแบบนี้เพื่อรองรับโครงสร้างองค์กรที่แตกต่างกันที่อาจมีอยู่

ข้อมูล FHIR ที่เปลี่ยนรูปแบบ

แอปบางแอปจะเปลี่ยนรูปแบบข้อมูล FHIR เพื่อให้เป็นไปตามข้อกำหนดของตนเอง เช่น

  • การผสานข้อมูลจากแหล่งที่มาต่างๆ (โดยทั่วไปคือ FHIR API)
  • การแมปรหัสกับคำศัพท์ทั่วโลก (เช่น SNOMED, LOINC, ICD) และการทำให้หน่วยเป็นมาตรฐาน
  • การรวมและกรองข้อมูลที่ซ้ำกันออก
  • การแก้ไขการจัดรูปแบบหรือปัญหาอื่นๆ ด้านคุณภาพของข้อมูล
  • การกรองระเบียนตามกฎทางธุรกิจเฉพาะแอป

ข้อมูล FHIR ที่ไม่ได้เปลี่ยนรูปแบบและเปลี่ยนรูปแบบแล้วสามารถเขียนลงใน Health Connect ได้ ตราบใดที่ข้อมูลดังกล่าวเป็นไปตามข้อกำหนด FHIR R4 เราขอแนะนำให้คุณเขียนข้อมูลที่เปลี่ยนรูปแบบเมื่อเป็นไปได้ แต่โปรดคำนึงถึงข้อควรพิจารณาต่อไปนี้

  • แอปที่มี Use Case แบบแคบอาจกรองระเบียนจำนวนมากออก ซึ่งแอปอื่นๆ ในระบบนิเวศอาจสร้างคุณค่าให้แก่ผู้ใช้ได้ ในกรณีเช่นนี้ คุณอาจต้องเขียน FHIR ที่ไม่ได้เปลี่ยนรูปแบบซึ่งสมบูรณ์กว่า อย่างไรก็ตาม โปรดแจ้งให้ผู้ใช้ทราบว่ามีการแชร์ชุดข้อมูลขนาดใหญ่นี้
  • หากต้องการผสานข้อมูลที่มาจากแหล่งที่มาต่างๆ คุณสามารถเขียนข้อมูลลงใน MedicalDataSource รายการเดียวใน Health Connect นอกจากนี้ คุณยังต้องกําหนดรหัสใหม่ให้กับทรัพยากรแต่ละรายการเพื่อหลีกเลี่ยงการทับซ้อน และอัปเดตการอ้างอิงทรัพยากรเพื่อชี้ไปยังรหัสใหม่
  • การผสานข้อมูลจากแหล่งที่มาหลายแห่งลงใน MedicalDataSource รายการเดียวอาจทำให้แหล่งที่มาของข้อมูลไม่ชัดเจน เนื่องจากความเข้าใจแหล่งที่มาของข้อมูลมักเป็นประโยชน์ต่อผู้ใช้ข้อมูล เราจึงขอแนะนำให้ป้อนข้อมูลในช่อง meta.source สำหรับแต่ละแหล่งข้อมูลด้วยแหล่งที่มาเดิมของระเบียน (โดยทั่วไปคือ URL ฐาน FHIR)

ประสบการณ์ของผู้ใช้

ข้อมูลทั่วไปเกี่ยวกับประสบการณ์ของผู้ใช้จะแสดงในส่วนนี้

สิทธิ์

การขอสิทธิ์อ่านหรือเขียนบันทึกทางการแพทย์จะทำงานคล้ายกับหน้าจอสิทธิ์ของ Health Connect ที่มีอยู่ แต่ระบบจะแสดงหน้าจอบันทึกสุขภาพแยกต่างหาก

สิทธิ์

การเรียกดูข้อมูล

นอกจากนี้ Health Connect ยังมีการแสดงภาพพื้นฐานและการเรียกดูข้อมูล PHR ที่เก็บไว้ ซึ่งคล้ายกับประเภทข้อมูล Health Connect ที่มีอยู่

การท่องเว็บ