הגדרת Epic EHR

בדף הזה מוסבר איך לרשום ולהגדיר אפליקציית Epic לפני שיוצרים את מאגר הנתונים של Epic EHR. הארגון שלכם רושם את אפליקציית Epic שלו. בדרך כלל, מנתח הנתונים של Epic מבצע את השלבים האלה.

רישום האפליקציה של Epic

רושמים אפליקציה ל-Gemini Enterprise ב-Epic on FHIR, והופכים אותה לזמינה בסביבות Epic. משתמשים בהגדרות הבאות:

הגדרה ערך
קהל היעד של האפליקציה רופאים או משתמשים עם הרשאת אדמין
ממשקי API נכנסים ממשקי ה-API של R4 המפורטים בהפעלת ממשקי ה-API של Epic
ממשקי API יוצאים ללא
האם האפליקציה הזו תרשום לקוחות דינמיים? לא
האם הלקוח סודי כן
נדרשת גישה קבועה כן
שימוש בטוקני רענון מתגלגלים כן
כתובת ה-URL של קבוצת מפתחות ה-JWK להשאיר ריק
גרסת SMART on FHIR R4
גרסת SMART Scope SMART v1
סכימה ליצירת מזהה FHIR שימוש במזהי FHIR עם מגבלה של 64 תווים למשאבי USCDI FHIR

הגדרות הגישה הקבועה של הארגון לאפליקציה קובעות את משך ההרשאה של המשתמש. כשהתוקף פג, המשתמש צריך לאשר שוב את המחבר.

הגדרת מזהי ה-URI להפניה אוטומטית

באפליקציה, רושמים את שני מזהי ה-URI הבאים להפניה אוטומטית בדיוק כפי שהם מוצגים:

  • https://vertexaisearch.cloud.google.com/oauth-redirect
  • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html

הפעלת ממשקי ה-API של Epic

באפליקציה, מפעילים את ממשקי ה-API לקריאה ולחיפוש של R4 למשאבי ה-FHIR הבאים: Patient,‏ Observation,‏ Condition,‏ MedicationRequest,‏ AllergyIntolerance,‏ DiagnosticReport,‏ DocumentReference,‏ Binary,‏ Encounter,‏ ServiceRequest,‏ Coverage,‏ Immunization ו-Procedure.

למשאבים מסוימים, כמו Observation ו-Condition, יש ממשק API נפרד לכל קטגוריה, למשל בדיקות מעבדה וסימנים חיוניים. מפעילים את הקטגוריות שרוצים שהמשתמשים יוכלו לשאול לגביהן. אל תפעילו ממשקי API לכתיבה.

אם אחד מה-API לא פועל, רק הפעולות שמשתמשות בו ייכשלו.

איך מקבלים את מזהה הלקוח וסוד הלקוח

מערכת Epic מנפיקה מזהה לקוח לסביבה שהיא לא סביבת ייצור ומזהה לקוח לסביבת ייצור של האפליקציה. צריך להשתמש במזהה הלקוח שתואם לסביבת Epic שאליה כתובות ה-URL מפנות. מכיוון שהאפליקציה היא לקוח סודי, יש לה גם סוד לקוח. מזינים את מזהה הלקוח וסוד הלקוח כשיוצרים את מאגר הנתונים.

איך מוצאים את נקודות הקצה של Epic

כדי ליצור את מאגר הנתונים, צריך שלוש כתובות URL מהסביבה של Epic: כתובת ה-URL הבסיסית של FHIR R4, כתובת ה-URL לאימות וכתובת ה-URL של הטוקן. אפשר לקבל אותם מהמנתח של Epic. בהגדרת ה-SMART של הארגון, בכתובת FHIR_BASE_URL/.well-known/smart-configuration, מופיעות גם כתובת ה-URL לאימות (authorization_endpoint) וכתובת ה-URL של האסימון (token_endpoint). מחליפים את FHIR_BASE_URL בכתובת ה-URL הבסיסית של FHIR R4.

צריך להזין כל כתובת URL עם https:// ובלי קו נטוי בסוף. לדוגמה, בארגז החול הציבורי של Epic משתמשים בכתובות ה-URL הבאות:

כתובת URL דוגמה לארגז חול (sandbox) של Epic
כתובת ה-URL הבסיסית של FHIR R4 https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
כתובת URL להרשאה https://fhir.epic.com/interconnect-fhir-oauth/oauth2/authorize
כתובת URL לטוקן https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token

פתרון בעיות

בטבלה הבאה מפורטות בעיות נפוצות ודרכים לפתור אותן:

שגיאה רזולוציה
במסוף תופיע אחת מההודעות הבאות:
  • "כתובת ה-URL של Epic FHIR R4 חייבת להיות כתובת URL מסוג https:// ‎ בלי קו נטוי בסוף".
  • "כתובת ה-URL של Epic Authorize חייבת להיות כתובת URL מסוג https:// ‎ ללא לוכסן בסוף."
  • "כתובת ה-URL של הטוקן של Epic חייבת להיות כתובת URL מסוג https:// ‎ בלי לוכסן בסוף."
 מזינים את כתובת ה-URL עם https:// ובלי קו נטוי עוקב.
במסוף מופיעה ההודעה "Failed to obtain טוקן רענון". באפליקציית Epic, בוחרים באפשרויות Is Confidential Client ו-Requires Persistent Access ושומרים את השינויים. אחר כך, במסוף Google Cloud , לוחצים שוב על Verify Auth.
ב-Epic מדווח שה-URI להפניה אוטומטית לא תואם. רושמים את שני מזהי ה-URI להפניה אוטומטית בדיוק כמו שמוצג בקטע הגדרת מזהי ה-URI להפניה אוטומטית.
במהלך הכניסה, מוצגת ב-Epic ההודעה "בקשת OAuth 2.0 לא חוקית". כל קישור כניסה של Epic פועל רק פעם אחת, כך שטעינה מחדש של חלון הכניסה מציגה את השגיאה הזו. סוגרים את החלון ומתחילים את תהליך הכניסה מחדש בלי לטעון מחדש. אם השגיאה נמשכת, צריך לבדוק אם לאפליקציה יש את ממשקי ה-API להיקפים המבוקשים.
אפשרות החזרה במחיר invalid_client. מזהה הלקוח או סוד הלקוח שגויים, מכילים רווחים מיותרים או שייכים לסביבת Epic אחרת. מזינים את מזהה הלקוח וסוד הלקוח של הסביבה שאליה מפנות כתובות ה-URL.
חלון הכניסה לא חוזר ל-Gemini Enterprise, או שהמחבר לא מקבל הרשאה אחרי הכניסה. סוגרים את חלון הכניסה, טוענים מחדש את Gemini Enterprise ונותנים שוב הרשאה למחבר.
פעולה אחת נכשלת ופעולות אחרות פועלות. ה-API של Epic לפעולה הזו לא מופעל. צריך להפעיל אותה באפליקציה, ואז לבקש מהמשתמש לאשר שוב את המחבר.
‫Gemini Enterprise אומר "נראה שאין לך הרשאה לבצע את הפעולה הזו. Please contact an administrator." (ההרשאה של המחבר בוטלה. צריך לפנות לאדמין) למשתמש שאישר את המחבר בעבר. ההרשאה של המשתמש ב-Epic הסתיימה. המשתמש נותן הרשאה למחבר מחדש.
‫Gemini Enterprise לא מוצא מטופל לפי שם. מוסיפים את תאריך הלידה, או משתמשים ב-MRN או במזהה המטופל ב-Epic.
‫Gemini Enterprise אומר שאי אפשר לאחזר חלק מהרשומות. אבטחת Epic מונעת מהמשתמשים גישה לרשומות האלה. המשתמשים רואים רק את הרשומות ש-Epic מאפשרת להם לראות.
הטקסט של הדוח או ההערה לא זמין. המסמך הוא קובץ PDF או בפורמט אחר שהמחבר לא יכול לקרוא. פותחים את המסמך ב-Epic.
ההרשאה נכשלת שוב ושוב באפליקציה אחת בלבד. מסירים את מאגר הנתונים של Epic EHR מהאפליקציה, מוסיפים אותו בחזרה ונותנים שוב הרשאה למחבר.

המאמרים הבאים