פורמט הנתונים של תיקים רפואיים

נתוני הרשומות הרפואיות מאוחסנים בפורמט HL7 FHIR.

התכונה 'תיקים רפואיים' תומכת בגרסאות הבאות של Fast Health Interoperable Resources ‏(FHIR):

סוגי משאבים רפואיים

‫FHIR מורכב מקבוצה של רכיבים מודולריים שנקראים משאבים. קבוצת המשאבים הנתמכים של FHIR והקטגוריות התואמות מבוססות בערך על הקטעים של סיכום המידע על המטופל הבינלאומי.

המשאבים האלה ממופים לקטגוריות נתונים ב-Health Connect, שנקראות Medical Resource Types (סוגי משאבים רפואיים) ב-API. מיפוי של משאבי תצפית מבוסס על תוכן כמו שמות וקודים של מזהי תצפיות לוגיות (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
מעבדה

תצפית

  • laboratory קטגוריית FHIR
android.permission.health.READ_MEDICAL_DATA_LABORATORY_RESULTS
תרופות תרופות, בקשה למתן תרופה, הצהרה על תרופה android.permission.health.READ_MEDICAL_DATA_MEDICATIONS
פרטים אישיים מטופל android.permission.health.READ_MEDICAL_DATA_PERSONAL_DETAILS
פרטי המטפל פרטי המטפל/ת, 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 של רקע סוציאלי
  • social-history קטגוריית FHIR
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 עבור אדם יחיד. מומלץ שאפליקציות יבצעו התאמה בין נתונים ויכתבו משאב Patient יחיד ל-Health Connect. עם זאת, ההגדרה הזו לא נאכפת כדי להתאים למבנים ארגוניים שונים שעשויים להתקיים.

אימות נתונים

ממשקי ה-API של הרשומות הרפואיות מקבלים משאבי FHIR תקינים מגרסאות נתמכות, ו-Health Connect מבצע אימות מסוים כדי לוודא שהמפרט של FHIR לכל גרסה נתמכת מתקיים.

בדיקות האימות שמסומנות בתווית בקרוב עדיין לא נאכפות, אבל הן ייאכפו בגרסה עתידית. כדי לשמור על תאימות לגרסאות עתידיות, מומלץ לפתח בהתאם לכל בדיקות האימות שמופיעות ברשימה.

טבלה 2: אימות נתוני FHIR ב-Health Connect
רמה בדיקת אימות
קובץ JSON תקין הנתונים תואמים לפורמט JSON.
תמיכה ב-FHIR

יש תמיכה בגרסת FHIR שהוגדרה על ידי אפליקציית הכתיבה. ‫Health Connect תומך בגרסאות הבאות של FHIR:

  • 4.0.1
  • 4.3.0
תמיכה ב-FHIR

סוג המשאב FHIR שמתועד במופע המשאב נתמך. אלו סוגי משאבי FHIR שנתמכים ב-Health Connect:

  • ‫AllergyIntolerance
  • תנאי
  • מפגש
  • חיסונים
  • מיקום
  • תרופות
  • MedicationRequest
  • MedicationStatement
  • תצפית
  • ארגון
  • מטופל
  • פרטי המטפל/ת
  • PractitionerRole
  • הליך מחקר
מזהה משאב ייחודי למשאב יש שדה מזהה עם ערך שעומד בדרישות של ביטוי רגולרי.
מזהה משאב ייחודי למשאב אין מזהה משותף עם משאב FHIR אחר מאותו סוג משאב מאותו MedicalDataSource.
כללים עסקיים הוא לא כולל משאב FHIR מוכל. משאבים מוכלים הם משאבי FHIR שמוטמעים בתוך משאב 'הורה'. הם משמשים כשמשאב האב צריך להפנות למשאב אחר, אבל למערכת אין מספיק מידע כדי ליצור אותו כמשאב עצמאי עם קיום עצמאי.
Valid Base FHIR שדות ברמה העליונה ב-FHIR JSON קיימים במפרט FHIR עבור סוג המשאב הנתון.
Valid Base FHIR בשדות ברמה העליונה אין ערכי JSON null.
Valid Base FHIR כל שדות החובה ברמה העליונה מופיעים.
Valid Base FHIR שדות ברמה העליונה שמוגדרים כרכיבים חוזרים ב-FHIR הם מסוג נתונים array JSON.
Valid Base FHIR שדות ברמה העליונה (כולל רכיבים בתוך JSON arrays) מוגדרים כסוגים מורכבים ב-FHIR עם סוג נתונים של JSON object.
Valid Base 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 מספר
בקרוב
Valid Base FHIR שדות ברמה העליונה שמוגדרים כסוגים פרימיטיביים ב-FHIR עומדים בדרישות של ביטויים רגולריים. בקרוב
Valid Base FHIR הרחבות לסוגים פרימיטיביים קיימות במפרט FHIR ויש להן סוג נתונים object JSON.
Valid Base FHIR לא מתועד יותר משדה אחד עבור שדות בחירה (fieldname[x]).לדוגמה, אי אפשר שגם effectiveDateTime וגם effectivePeriod יופיעו באותו מופע של משאב.
Valid Base FHIR סוגי נתונים מורכבים מכילים שדות וסוגי נתונים שתואמים למפרט FHIR. בקרוב
Valid Base FHIR רכיבי Backbone (ורכיבים בתוך סוגים מורכבים) מכילים שדות וסוגי נתונים שתואמים למפרט FHIR. בקרוב
Valid Base FHIR רכיב התוספים השדות value[x] הם מסוג תקין ומכילים תוכן בהתאם לסוג הנתונים. אפשר לכלול אלמנטים של הרחבות בכל משאב כדי לייצג מידע נוסף שלא נכלל במפרט הבסיסי. האלמנטים האלה מכילים שדה url שמקשר להגדרה של ההרחבה, ושדה value[x] שמכיל את ערך ההרחבה. ‫value[x] חייב להיות מתוך רשימה מוגדרת של סוגי נתונים מקובלים. בקרוב

נתוני FHIR שעברו טרנספורמציה

אפליקציות מסוימות משנות את נתוני FHIR כדי להתאים אותם לדרישות שלהן. לדוגמה:

  • מיזוג נתונים ממקורות שונים (בדרך כלל ממשקי FHIR API).
  • מיפוי קודים למינוחים גלובליים (לדוגמה, SNOMED, ‏ LOINC, ‏ ICD) ויחידות סטנדרטיות.
  • איחוד נתונים והסרת כפילויות.
  • תיקון בעיות בפורמט או בעיות אחרות באיכות הנתונים.
  • סינון רשומות על סמך כללים עסקיים ספציפיים לאפליקציה.

אפשר לכתוב ב-Health Connect את נתוני ה-FHIR שלא עברו המרה ואת נתוני ה-FHIR שעברו המרה, בתנאי שהם עומדים במפרט FHIR R4. מומלץ לכתוב נתונים שעברו טרנספורמציה איפה שאפשר. אבל חשוב לזכור את השיקולים הבאים:

  • אפליקציות עם תרחישי שימוש מצומצמים עשויות לסנן מספר משמעותי של רשומות שאפליקציות אחרות במערכת האקולוגית יכולות ליצור מהן ערך למשתמשים. במקרים כאלה, כדאי לכתוב את ה-FHIR שלא עבר המרה, כי הוא יהיה מלא יותר. עם זאת, חשוב להודיע למשתמשים שקבוצת הנתונים הרחבה יותר משותפת.
  • אם ממזגים נתונים שמגיעים ממקורות שונים, אפשר לכתוב נתונים בMedicalDataSource יחיד ב-Health Connect. כדי למנוע התנגשויות, צריך גם להקצות מזהה חדש לכל משאב ולעדכן את ההפניות למשאבים כך שיצביעו על המזהים החדשים.
  • כשממזגים נתונים מכמה מקורות לתוך MedicalDataSource אחד, יכול להיות שיהיה קשה לדעת מה המקור של הנתונים. לעתים קרובות צרכני נתונים צריכים להבין את מקור הנתונים, ולכן מומלץ לאכלס את השדה meta.source עבור כל משאב במקור המקורי של הרשומה (בדרך כלל כתובת URL בסיסית של FHIR).