تنسيق بيانات السجلّات الطبية

يتم تخزين بيانات "السجلات الطبية" بتنسيق HL7 FHIR.

تتوافق ميزة "السجلّات الطبية" مع إصدارات "موارد قابلية التشغيل البيني للرعاية الصحية السريعة" (FHIR) التالية:

أنواع المراجع الطبية

يتألف معيار FHIR من مجموعة من المكوّنات النموذجية تُعرف باسم الموارد. تستند مجموعة موارد FHIR والفئات المتوافقة معها بشكل عام إلى أقسام ملخّص المريض الدولي.

يتم ربط هذه المراجع بفئات البيانات في Health Connect، ويُشار إليها باسم "أنواع المراجع الطبية" في واجهة برمجة التطبيقات. يتم ربط موارد البيانات المرصودة استنادًا إلى محتوى مثل رموز LOINC وفئات FHIR.

لا تتم كتابة الملاحظات التي لا تنتمي إلى أي من هذه الفئات في Health Connect.

الجدول 1: أنواع المراجع الطبية في Health Connect
نوع المرجع الطبي في Health Connect موارد FHIR بيان أذونات Health Connect
بيانات الحساسية AllergyIntolerance android.permission.health.READ_MEDICAL_DATA_ALLERGIES_INTOLERANCES
الحالات الطبية الشرط android.permission.health.READ_MEDICAL_DATA_CONDITIONS
المختبر

ملاحظة

  • فئة FHIR‏ (laboratory)
android.permission.health.READ_MEDICAL_DATA_LABORATORY_RESULTS
بيانات الأدوية Medication، MedicationRequest، MedicationStatement android.permission.health.READ_MEDICAL_DATA_MEDICATIONS
التفاصيل الشخصية مريض android.permission.health.READ_MEDICAL_DATA_PERSONAL_DETAILS
تفاصيل الممارسِين الطبيين Practitioner، PractitionerRole android.permission.health.READ_MEDICAL_DATA_PRACTITIONER_DETAILS
بيانات الحمل

ملاحظة

  • رموز LOINC الخاصة بالحمل
android.permission.health.READ_MEDICAL_DATA_PREGNANCY
بيانات الإجراءات الطبية الإجراء android.permission.health.READ_MEDICAL_DATA_PROCEDURES
تأثيرات نمط الحياة

ملاحظة

  • رموز LOINC الخاصة بالسجلّ الاجتماعي
  • فئة FHIR‏ (social-history)
android.permission.health.READ_MEDICAL_DATA_SOCIAL_HISTORY
بيانات اللقاحات بيانات التحصين android.permission.health.READ_MEDICAL_DATA_VACCINES
الزيارات الطبية المواجهة، الموقع الجغرافي، المؤسسة android.permission.health.READ_MEDICAL_DATA_VISITS
بيانات المؤشرات الحيوية

ملاحظة

  • رموز LOINC الخاصة ببيانات المؤشرات الحيوية
  • فئة FHIR‏ (vital-signs)
android.permission.health.READ_MEDICAL_DATA_VITAL_SIGNS

مراجع للمرضى

يهدف تطبيق Health Connect حاليًا إلى تخزين بيانات السجلات الطبية لشخص واحد فقط. لذلك، يجب أن تنتمي جميع موارد FHIR المكتوبة إلى الشخص نفسه.

من الشائع أن تتوفّر موارد متعددة من نوع "مريض" بتنسيق FHIR في نظام واحد لشخص واحد. يُفضَّل أن توفّق التطبيقات البيانات وتكتب مصدر Patient واحدًا في Health Connect. ومع ذلك، لا يتم فرض ذلك لاستيعاب الهياكل التنظيمية المختلفة التي قد تكون موجودة.

التحقّق من صحة البيانات

تقبل واجهات برمجة التطبيقات الخاصة بسجلات المرضى موارد FHIR صالحة من الإصدارات المتوافقة، ويجري تطبيق Health Connect بعض عمليات التحقّق للتأكّد من اتّباع مواصفات FHIR لكل إصدار متوافق.

لم يتم بعد فرض عمليات التحقّق من الصحة التي تم وضع علامة ستتوفّر قريبًا عليها، ولكن سيتم فرضها في إصدار مستقبلي. ننصحك بتطوير جميع عمليات التحقّق من الصحة المدرَجة للحفاظ على التوافق مع الإصدارات المستقبلية.

الجدول 2: التحقّق من صحة بيانات 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 صالحة يجب أن تتوفّر الحقول من المستوى الأعلى في ملف JSON الخاص بتنسيق FHIR في مواصفات FHIR لنوع المورد المحدّد.
قاعدة FHIR صالحة لا تحتوي الحقول ذات المستوى الأعلى على قيم JSON فارغة.
قاعدة FHIR صالحة تتوفّر جميع الحقول المطلوبة على المستوى الأعلى.
قاعدة FHIR صالحة الحقول ذات المستوى الأعلى المحدّدة على أنّها عناصر متكرّرة في FHIR لها نوع بيانات JSON array.
قاعدة FHIR صالحة الحقول ذات المستوى الأعلى (بما في ذلك العناصر داخل arrays بتنسيق JSON) المعرّفة على أنّها أنواع معقّدة في FHIR لها نوع بيانات object بتنسيق JSON.
قاعدة FHIR صالحة تحتوي الحقول من المستوى الأعلى (بما في ذلك العناصر ضمن arrays في 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]).على سبيل المثال، لا يمكن أن يكون كل من effectiveDateTime وeffectivePeriod موجودَين في مثيل المورد نفسه.
قاعدة FHIR صالحة تحتوي أنواع البيانات المعقّدة على حقول وأنواع بيانات تتطابق مع مواصفات FHIR. قريبًا
قاعدة FHIR صالحة تحتوي عناصر Backbone (والعناصر ضمن الأنواع المعقّدة) على حقول وأنواع بيانات تتطابق مع مواصفات FHIR. قريبًا
قاعدة FHIR صالحة يجب أن تكون حقول عنصر الإضافات value[x] من نوع صالح وأن تحتوي على محتوى يتوافق مع نوع البيانات هذا. يمكن تضمين عناصر الإضافة في أي مورد لتمثيل معلومات إضافية غير مضمّنة في المواصفات الأساسية. تحتوي هذه العناصر على حقل url يرتبط بتعريف الإضافة، وحقل value[x] يحتوي على قيمة الإضافة. يجب أن يكون value[x] من قائمة أنواع البيانات المقبولة المحدّدة. قريبًا

بيانات FHIR المحوَّلة

تحوّل بعض التطبيقات بيانات FHIR لتلبية متطلباتها الخاصة. مثلاً:

  • دمج البيانات من مصادر مختلفة (عادةً ما تكون واجهات FHIR API)
  • ربط الرموز بالمصطلحات العالمية (مثل SNOMED وLOINC وICD) وتوحيد الوحدات
  • دمج البيانات وإزالة التكرار
  • حلّ المشاكل المتعلّقة بالتنسيق أو غيرها من المشاكل المتعلّقة بجودة البيانات
  • تصفية السجلات استنادًا إلى قواعد النشاط التجاري الخاصة بالتطبيق

يمكن نقل بيانات FHIR غير المحوَّلة والمحوَّلة إلى Health Connect، شرط أن تتوافق مع مواصفات FHIR R4. ننصحك بكتابة البيانات المحوَّلة حيثما أمكن ذلك. يُرجى مراعاة الاعتبارات التالية:

  • قد تستبعد التطبيقات ذات حالات الاستخدام المحدودة عددًا كبيرًا من السجلات التي يمكن أن تستفيد منها تطبيقات أخرى في النظام الأساسي. في مثل هذه الحالات، قد يكون من المفيد كتابة بيانات FHIR غير المحوّلة التي تكون أكثر اكتمالاً. ومع ذلك، احرص على إبلاغ المستخدمين بأنّه تتم مشاركة مجموعة البيانات الأوسع هذه.
  • في حال دمج بيانات واردة من مصادر مختلفة، يمكنك كتابة البيانات في MedicalDataSource واحد في Health Connect. يجب أيضًا تعيين رقم تعريف جديد لكل مرجع لتجنُّب حدوث تعارضات، وتعديل مراجع الموارد للإشارة إلى أرقام التعريف الجديدة.
  • قد يؤدي دمج البيانات من مصادر متعددة في MedicalDataSource واحد إلى إخفاء مصدر البيانات. بما أنّه من المفيد غالبًا أن يفهم مستهلكو البيانات مصدرها، ننصح بملء الحقل meta.source لكل مورد بالمصدر الأصلي للسجلّ (عادةً ما يكون عنوان URL أساسيًا بتنسيق FHIR).