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