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