فرمت داده های سوابق پزشکی

داده‌های پرونده‌های پزشکی با فرمت HL7 FHIR ذخیره می‌شوند.

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

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

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

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

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

جدول 1: انواع منابع پزشکی Health Connect
نوع منبع پزشکی Health Connect منابع FHIR اعلامیه مجوز Health Connect
آلرژی‌ها آلرژیعدم تحمل 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
داروها دارو، درخواست دارو، بیانیه دارو 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 علائم حیاتی
  • vital-signs دسته FHIR
android.permission.health.READ_MEDICAL_DATA_VITAL_SIGNS

منابع بیمار

Health Connect در حال حاضر برای ذخیره داده‌های پرونده‌های پزشکی فقط برای یک فرد در نظر گرفته شده است. بنابراین، تمام منابع FHIR نوشته شده باید متعلق به یک نفر باشد.

وجود چندین منبع بیمار FHIR در یک سیستم برای یک فرد، غیرمعمول نیست. ترجیح داده می‌شود که برنامه‌ها داده‌ها را تطبیق داده و یک منبع بیمار واحد را در Health Connect بنویسند. با این حال، این امر برای تطبیق ساختارهای سازمانی مختلفی که ممکن است وجود داشته باشد، اجباری نیست.

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

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

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

جدول 2: اعتبارسنجی داده‌های FHIR توسط Health Connect
سطح بررسی اعتبارسنجی
JSON معتبر داده‌ها با فرمت JSON سازگار هستند.
FHIR پشتیبانی شده

نسخه FHIR اعلام شده توسط برنامه نوشتن پشتیبانی می‌شود. نسخه‌های FHIR زیر توسط Health Connect پشتیبانی می‌شوند:

  • ۴.۰.۱
  • ۴.۳.۰
FHIR پشتیبانی شده

نوع منبع FHIR ثبت شده در نمونه منبع پشتیبانی می‌شود. انواع منابع FHIR زیر توسط Health Connect پشتیبانی می‌شوند:

  • آلرژیعدم تحمل
  • وضعیت
  • برخورد
  • ایمن‌سازی
  • مکان
  • دارو
  • درخواست دارو
  • بیانیه دارو
  • مشاهده
  • سازمان
  • بیمار
  • پزشک
  • نقش پزشک
  • رویه
شناسه منحصر به فرد منبع منبع دارای یک فیلد شناسه (ID) با مقداری است که الزامات عبارت منظم (regular expression) را برآورده می‌کند.
شناسه منحصر به فرد منبع منبع، شناسه‌ای را با منبع FHIR دیگری از همان نوع منبع از همان MedicalDataSource به اشتراک نمی‌گذارد.
قوانین کسب و کار شامل یک منبع FHIR محصور شده نمی‌شود. منابع محصور شده، منابع FHIR هستند که درون یک منبع "والد" قرار گرفته‌اند. آنها زمانی استفاده می‌شوند که منبع والد نیاز به ارجاع به منبع دیگری داشته باشد، اما سیستم اطلاعات کافی برای ایجاد آن به عنوان یک منبع مستقل با موجودیت مستقل را ندارد.
FHIR پایه معتبر فیلدهای سطح بالا در JSON مربوط به FHIR، در مشخصات FHIR برای نوع منبع داده شده وجود دارند.
FHIR پایه معتبر فیلدهای سطح بالا مقادیر تهی (null) در JSON ندارند.
FHIR پایه معتبر فیلدهای الزامی سطح بالا همگی موجود هستند.
FHIR پایه معتبر فیلدهای سطح بالا که به عنوان عناصر تکرارشونده در FHIR تعریف می‌شوند، نوع داده array JSON دارند.
FHIR پایه معتبر فیلدهای سطح بالا (شامل عناصر درون array JSON) که به عنوان انواع پیچیده در FHIR تعریف شده‌اند، دارای نوع داده object JSON هستند.
FHIR پایه معتبر فیلدهای سطح بالا (از جمله عناصر درون array JSON) که به عنوان انواع اولیه در FHIR تعریف شده‌اند، نوع داده JSON صحیحی دارند.
نوع داده FHIR نوع داده JSON
عدد صحیح، عدد صحیح بدون علامت، عدد صحیح مثبت، عدد اعشاری شماره
بولی بولی
فوری، زمان، تاریخ، dateTime، رشته، کد، markdown، شناسه uri، آدرس اینترنتی، oid، uuid، متعارف، integer64، base64Binary شماره
به زودی
FHIR پایه معتبر فیلدهای سطح بالا که در FHIR به عنوان انواع اولیه تعریف می‌شوند، الزامات عبارت منظم را برآورده می‌کنند. به زودی
FHIR پایه معتبر افزونه‌هایی برای انواع اولیه در مشخصات FHIR وجود دارند و دارای نوع داده object JSON هستند.
FHIR پایه معتبر برای فیلدهای Choice ( fieldname[x] ) بیش از یک فیلد ثبت نمی‌شود. برای مثال، effectiveDateTime و effectivePeriod نمی‌توانند هر دو در یک نمونه منبع وجود داشته باشند.
FHIR پایه معتبر انواع داده‌های پیچیده شامل فیلدها و انواع داده‌هایی هستند که با مشخصات FHIR مطابقت دارند. به زودی
FHIR پایه معتبر عناصر ستون فقرات (و عناصر درون انواع پیچیده) حاوی فیلدها و انواع داده‌ای هستند که با مشخصات FHIR مطابقت دارند. به زودی
FHIR پایه معتبر فیلدهای value[x] عنصر افزونه‌ها از نوع معتبری هستند و حاوی محتوایی مطابق با آن نوع داده می‌باشند. عناصر افزونه می‌توانند در هر منبعی گنجانده شوند تا اطلاعات اضافی را که بخشی از مشخصات پایه نیستند، نشان دهند. آن‌ها شامل یک url فیلد هستند که به تعریف افزونه لینک می‌دهد و یک فیلد value[x] که حاوی مقدار افزونه است. value[x] باید از لیست مجموعه انواع داده پذیرفته شده باشد. به زودی

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

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

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

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

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