قالب داده‌های «سوابق پزشکی»

داده‌های «سوابق پزشکی» در قالب HL7 FHIR ذخیره می‌شود.

«سوابق پزشکی» از نسخه‌های زیر از «منابع تعامل‌پذیر سریع سلامت» (FHIR) پشتیبانی می‌کند:

انواع منابع پزشکی

FHIR از مجموعه‌ای از مؤلفه‌های پیمانه‌ای به‌نام منابع تشکیل شده است. مجموعه پشتیبانی‌شده منابع FHIR و دسته‌های مربوطه تقریباً براساس بخش‌های خلاصه بین‌المللی بیمار است.

این منابع با دسته‌های داده در Health Connect مطابقت داده می‌شوند که در API به آن‌ها «انواع منابع پزشکی» گفته می‌شود. منابع مشاهده براساس محتوایی مثل کدهای «نام‌ها و کدهای شناسه‌های مشاهدات منطقی» (LOINC) و دسته‌های FHIR نگاشت می‌شوند.

مشاهداتی که به هیچ‌یک از این دسته‌ها تعلق ندارند در Health Connect نوشته نمی‌شوند.

جدول ۱: انواع منابع پزشکی 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
جزئیات درمانگر درمانگر، نقش درمانگر 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 در سیستم برای یک فرد غیرمعمول نیست. ترجیح داده می‌شود که برنامه‌ها داده‌ها را تطبیق دهند و یک منبع «بیمار» واحد در Health Connect بنویسند. بااین‌حال، این مورد برای تطبیق با ساختارهای سازمانی مختلفی که ممکن است وجود داشته باشد، اجرا نمی‌شود.

اعتبارسنجی داده

میاناهای برنامه‌سازی کاربردی «سوابق پزشکی» منابع FHIR معتبر را از نسخه‌های پشتیبانی‌شده می‌پذیرند، و Health Connect برای تأیید اینکه مشخصات FHIR برای هر نسخه پشتیبانی‌شده رعایت شده است، برخی‌از اعتبارسنجی‌ها را انجام می‌دهد.

بررسی‌های اعتبارسنجی که با به‌زودی علامت‌گذاری شده‌اند هنوز اجرا نمی‌شوند، اما در نسخه آتی اجرا خواهند شد. توصیه می‌کنیم برای حفظ سازگاری با نسخه‌های آتی، توسعه را براساس همه بررسی‌های اعتبارسنجی فهرست‌شده انجام دهید.

جدول ۲: اعتبارسنجی Health Connect برای داده‌های FHIR
سطح بررسی اعتبارسنجی
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 پایه معتبر فیلدهای سطح بالا مقادیر تهی JSON ندارند.
FHIR پایه معتبر همه فیلدهای الزامی سطح بالا وجود دارند.
FHIR پایه معتبر فیلدهای سطح بالا که به‌عنوان عناصر تکراری در FHIR تعریف شده‌اند، نوع داده JSON array دارند.
FHIR پایه معتبر فیلدهای سطح بالا (شامل عناصر درون arrayهای JSON) که به‌عنوان انواع پیچیده در FHIR تعریف شده‌اند، نوع داده JSON object دارند.
FHIR پایه معتبر فیلدهای سطح بالا (ازجمله عناصر درون arrayهای JSON) که به‌عنوان انواع اولیه در FHIR تعریف شده‌اند، نوع داده JSON صحیح را دارند.
نوع داده FHIR نوع داده JSON
عدد صحیح، عدد صحیح بدون علامت، عدد صحیح مثبت، عدد اعشاری شماره
بولی بولی
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 پایه معتبر عنصر Extensions value[x] فیلدها از نوع معتبر هستند و محتوا را براساس آن نوع داده دربرمی‌گیرند. عناصر افزونه را می‌توان در هر منبعی گنجاند تا اطلاعات اضافی را که بخشی از مشخصات پایه نیستند نشان دهد. این عناصر حاوی فیلد url هستند که به تعریف افزونه پیوند می‌دهد و فیلد value[x] که حاوی مقدار افزونه است. value[x] باید از فهرست تنظیم‌شده انواع داده‌های پذیرفته‌شده باشد. به‌زودی عرضه می‌شود

داده‌های FHIR تبدیل‌شده

برخی‌از برنامه‌ها داده‌های FHIR را برای برآورده کردن الزامات خودشان تبدیل می‌کنند. برای مثال:

  • ادغام داده‌ها از منابع مختلف (معمولاً میاناهای برنامه‌سازی کاربردی FHIR).
  • نگاشت کدها به اصطلاحات جهانی (برای مثال، SNOMED،‏ LOINC،‏ ICD) و استانداردسازی واحدها.
  • درحال ادغام و حذف داده‌های تکراری.
  • اصلاح قالب‌بندی یا دیگر مشکلات کیفیت داده‌ها.
  • فیلتر کردن سوابق براساس قوانین کسب‌وکار مختص برنامه.

داده‌های FHIR تبدیل‌نشده و تبدیل‌شده را می‌توان در Health Connect نوشت، به‌شرطی که با مشخصات FHIR R4 مطابقت داشته باشند. توصیه می‌کنیم درصورت امکان داده‌های تبدیل‌شده را بنویسید. اما ملاحظات زیر را به‌خاطر داشته باشید:

  • برنامه‌هایی که موارد استفاده محدودی دارند ممکن است تعداد قابل‌توجهی از سوابق را فیلتر کنند که برنامه‌های دیگر در بوم‌سازگان می‌توانند از آن‌ها برای ایجاد ارزش برای کاربر استفاده کنند. در چنین شرایطی، نوشتن FHIR تبدیل‌نشده که کامل‌تر است می‌تواند مفید باشد. بااین‌حال، حتماً به کاربران اطلاع دهید که این مجموعه داده گسترده‌تر هم‌رسانی می‌شود.
  • اگر داده‌هایی را که از منابع مختلف منشأ می‌گیرند ادغام می‌کنید، می‌توانید داده‌ها را در یک MedicalDataSource در Health Connect بنویسید. همچنین باید شناسه جدیدی به هر منبع اختصاص دهید تا از تداخل جلوگیری شود و ارجاع‌های منبع را به‌روز کنید تا به شناسه‌های جدید اشاره کنند.
  • ادغام داده‌ها از چند منبع در یک MedicalDataSource می‌تواند منبع داده‌ها را مبهم کند. ازآنجایی‌که اغلب برای مصرف‌کنندگان داده مفید است که منشأ داده‌ها را درک کنند، توصیه می‌کنیم فیلد meta.source را برای هر منبع با منبع اصلی سوابق (معمولاً نشانی وب پایه FHIR) پر کنید.
قبلی
نمای کلی
بعدی
نوشتن داده‌های پزشکی