פורמט הנתונים של מסמך ה-PHR

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

ביומן הבריאות יש תמיכה בגרסאות הבאות של Fast Health Interoperable Resources‏ (FHIR):

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

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

המשאבים האלה ממופה לקטגוריות נתונים ב-Health Connect, שנקראות 'סוגי משאבים רפואיים' ב-API. משאבי התצפיות ממופים על סמך תוכן כמו קודים של Logical Observation Identifiers Names and Codes‏ (LOINC) וקטגוריות של FHIR.

תצפיות שלא שייכות לאף אחת מהקטגוריות האלה לא נכתבות ב-Health Connect.

טבלה 1: סוגי המשאבים הרפואיים ב-Health Connect
סוג המשאב הרפואי ב-Health Connect משאבי FHIR
אלרגיות AllergyIntolerance
מצבים רפואיים תנאי
מעבדה

תצפית

  • laboratory קטגוריית FHIR
תרופות Medication, ‏ MedicationRequest, ‏ MedicationStatement
פרטים אישיים מטופל
פרטי המטפל Practitioner, ‏ PractitionerRole
היריון

תצפית

  • קודי LOINC של הריון
הליכים רפואיים הליך מחקר
רקע סוציאלי

תצפית

  • קודי LOINC של רקע אישי
  • social-history קטגוריית FHIR
חיסונים חיסונים
ביקורים אצל מומחים רפואיים מפגש, מיקום, ארגון
סימנים חיוניים

תצפית

  • קודי LOINC של סימנים חיוניים
  • vital-signs קטגוריית FHIR

משאבים למטופלים

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

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

אימות נתונים

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

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

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

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

  • 4.0.1
  • 4.3.0
פורמטים נתמכים של FHIR

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

  • AllergyIntolerance
  • תנאי
  • מפגש
  • חיסונים
  • מיקום
  • תרופות
  • MedicationRequest
  • MedicationStatement
  • תצפית
  • ארגון
  • מטופל
  • פרטי המטפל/ת
  • PractitionerRole
  • הליך מחקר
מזהה משאב ייחודי למשאב יש שדה מזהה עם ערך שעומד בדרישות של ביטוי רגולרי.
מזהה משאב ייחודי המשאב לא משתף מזהה עם משאב 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
integer, ‏ unsignedInt, ‏ positiveInt, ‏ decimal מספר
בוליאני בוליאני
instant, ‏ time, ‏ date, ‏ dateTime, ‏ string, ‏ code, ‏ markdown,‏ id uri, ‏ url, ‏ oid, ‏ uuid, ‏ canonical, ‏ integer64, ‏ base64Binary מספר
בקרוב
נתוני FHIR בסיסיים תקינים שדות ברמה העליונה שמוגדרים בתור סוגים פרימיטיביים ב-FHIR עומדים בדרישות של ביטויים רגולריים. בקרוב
נתוני FHIR בסיסיים תקינים תוספים לסוגי נתונים פרימיטיביים נמצאים במפרט FHIR, והם כוללים את סוג הנתונים object בפורמט JSON.
נתוני FHIR בסיסיים תקינים לא מתועד יותר משדה אחד עבור שדות בחירה (fieldname[x]).לדוגמה, לא ניתן לכלול את effectiveDateTime ואת effectivePeriod באותו מופע של משאב.
נתוני FHIR בסיסיים תקינים סוגי נתונים מורכבים מכילים שדות וסוגים של נתונים שתואמים למפרט FHIR. בקרוב
נתוני FHIR בסיסיים תקינים רכיבי השדרה (ורכיבים בתוך סוגים מורכבים) מכילים שדות וסוגים של נתונים שתואמים למפרט של FHIR. בקרוב
נתוני FHIR בסיסיים תקינים השדות value[x] של רכיב התוספים הם מסוג תקין ומכילים תוכן בהתאם לסוג הנתונים הזה. אפשר לכלול אלמנטים של תוספים בכל משאב כדי לייצג מידע נוסף שלא נכלל במפרט הבסיסי. הם מכילים שדה url שמקשר להגדרה של התוסף ושדה value[x] שמכיל את ערך התוסף. value[x] חייב להיות מתוך רשימה מוגדרת של סוגי נתונים קבילים. בקרוב

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

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

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

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

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