יצירת פידים
כדי שהנתונים יוצגו ישירות ב-Google, צריך לספק ל-Google פידים באופן קבוע. נדרשים הפידים הבאים.
| פיד | תיאור | תדירות |
|---|---|---|
| מטפל/ת | מכיל נתונים שמתארים בעלי מקצוע עצמאיים, כולל קישורים של צד שלישי לקביעת פגישות עם בעלי מקצוע עצמאיים. (הצד השני: FHIR practitioner) . [נדרש רק להזמנות אצל מטפלים ספציפיים] | אחת ל-24 שעות |
| מתקן | מכיל נתונים שמתארים מיקומים או מוסדות של שירותי בריאות, כמו מרפאות ומרכזי בדיקות מעבדה, כולל קישורים של צד שלישי להזמנת שירותים במוסדות האלה. (החלק המקביל: מיקום FHIR) | אחת ל-24 שעות |
| סוג הפגישה | מכילה רשימה של כל סוגי הפגישות, כולל מזהה ושם. לדוגמה: בדיקה, חולה ומטופל חדש. הוא ישמש כמקור מידע כדי לצמצם את לוחות הזמנים. (החלק המקביל: סוג הפגישה ב-FHIR) | אחת ל-24 שעות |
| זמינות | הצגת משבצות זמינות של ספקי שירות, מוסדות, סוגי שירותים וסוגי פגישות נתונים. (החלק המקביל: FHIR slot) צריך לספק כיסוי של 24 שעות לפחות, החל מהתזמון הזמין הבא, לכל שילוב של רופא, מוסד וסוג פגישה. | פעם ב-15 עד 60 דקות |
| המרה | לשתף עם Google את שיעור ההמרות, כולל מדדים לגבי ביקור בקישורים והשלמת תיאום פגישות. | פעם בשבוע |
הפורמט של הפידים מתואר באמצעות תחביר של protocol buffer 3, אבל אפשר לעיין בדוגמאות של פידים כדי לראות את פורמט ה-JSON. מומלץ להעלות את הפיד בפורמט JSON.
גודל קובץ הפיד, חלוקה למקטעים ודחיסת נתונים
מומלץ לעיין במדריכים הבאים בנושא דחיסה וקטעי נתונים:כדי לקבוע את הגודל של הפידים, כדאי להיעזר בהנחיות הבאות (פיד יכול להיות מורכב מכמה קבצים שנקראים 'פלחים'):
- חלוקת הפיד המומלצת:
- פיד של מטפל: 1 שריד
- פיד של מתקן: 1 שריד
- פיד של סוג פגישות: 1 פלחי
- פיד המרות: 1 פלחי
- פיד זמינות : פחות מ-20 פלחים
- גודל קובצי הפיד ופיצול:
- חשוב לוודא שגודל הקובץ של כל שבר קטן מ-200MB (אחרי דחיסת הנתונים). אם יש צורך, משתמשים במספר פלחים.
- אין צורך לשלוח רשומות נפרדות שנשלחו באותה שריד בפידים עתידיים.
- כדי לשפר את הביצועים, כדאי לפצל את הנתונים באופן שווה בין הפיצולים, כך שכל קבצי הפיצול יהיו בגודל דומה.
- אם צריך, משתמשים ב-gzip כדי לדחוס פידים של JSON בטקסט ללא הצפנה. עם זאת, צריך לעשות זאת לכל שריד פיד בנפרד.
העלאת הפידים לחשבון SFTP Dropbox
כדי להתחיל להעלות פידים, קודם צריך להשלים את ההוראות להגדרה. לאחר מכן, עוברים לדף feeds בפורטל השותפים. צריך להעלות את כל הפידים לחשבון Generic.
צריך להעלות כל פיד בנפרד באמצעות SFTP עם קובץ תיאור של קבוצת קבצים.
שם הקובץ של מתאר קבוצת קבצים צריך להיות <feed_name>-<
generation_timestamp>.filesetdesc.json,
שבו <feed_name> יכול להיות
healthappointments.practitioner, healthappointments.facility,
healthappointments.appointment_type ו-healthappointments.availability.
למידע נוסף, אפשר לעיין במאמר שימוש בתיבת הדואר הנכנס של הפיד הגנרי. דוגמאות זמינות בדף טעימות.
מוודאים שהנתונים נראים נכונים
נכנסים לפורטל השותפים. כדי למצוא את הדפים הבאים בקטע Dashboards, עוברים לסביבת Sandbox.
- פידים
- הנתונים הסטטיסטיים של סיכום הפיד, וגם ציון השגיאות במהלך העלאת הפיד.
כדי לוודא שהנתונים נראים תקינים אחרי ההעלאה הראשונית לסביבת Sandbox, כדאי לבדוק אם יש שגיאות בפיד בדף פידים.
העלאת הפידים לסביבת הייצור
אחרי שתוכלו להעלות פידים מלאים ללא שגיאות לסביבת ה-Sandbox באופן עקבי, תוכלו להתחיל להעלות אותם לסביבת הייצור. בשלב הזה השילוב לא יהיה פעיל.
אחרי שכל נתוני הפיד בסביבת הייצור מועלים באופן עקבי ומחוברים למערכת הייצור, הפידים מוכנים לבדיקה.
Google בודקת את הפידים
אחרי שתעלו את הפידים, Google מעבדת אותם ומעריכה אותם מבחינת איכות ושלמות.