סקירה כללית

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

• ישויות Restaurant: המסעדות שאתם נותנים להן שירות.
• ישויות Service: תזמון, מיקום ותנאי השירות.
• ישויות Menu: פרטים על התפריט של כל מסעדה.

התרשים הבא מראה איך ישויות Service,‏ Restaurant ו-Menu מייצגות מסעדה אחת:

איור 1: הקשר הכללי בין ישויות הפיד של נתוני ההזמנות מקצה לקצה: שירות, מסעדה ותפריט.

הערה: כדי ללמוד איך יוצרים ספריות לקוח עבור הפיד, אפשר לעיין בקטע יצירה של ספריות לקוח בדף 'כלים'.

הנחיות כלליות

• מסעדות לכל קובץ: כל קובץ נתונים צריך לייצג מסעדה אחת עם הישות הקשורה Service והישות הקשורה Menu. כדאי לתת לשמות הקבצים שמות שיאפשרו לכם לחפש מסעדה בקובץ.

• פורמט קובץ הנתונים: קובצי הנתונים צריכים להיות בפורמט JSON עם קווים חדשים שמפרידים ביניהם (פורמט ndjson).

• ערכי DateTime ו-Time: במאפיינים שדורשים ערך DateTime או Time, צריך להשתמש בפורמטים שצוינו בקטע פורמטים של DateTime ו-Time. לדוגמה, 2017-05-01T06:30:00+05:30 עבור DateTime ו-T08:08:00+05:30 עבור Time.

• מזהים: משתמשים במאפיין @id כדי לזהות את כל הישות הייחודיות בתוך סוג ישות. האורך המקסימלי הוא 300 תווים. @id הוא מזהה ייחודי של הישות מהסוג הזה, אבל בין ישויות יכולים להיות חפיפה בין המזהים. לדוגמה, נניח שמגדירים ישות Service עם המאפיין @id שמוגדר לערך a16. לא ניתן ליצור ישות Service נוספת עם @id של a16. עם זאת, אפשר להשתמש ב-a16 כערך של @id בישות Menu.

• יצירת מזהים: חשוב לשמור על יציבות המזהים – אל תשתמשו במזהי UUID או תשנו אותם באופן אחר (או תיצרו אותם באופן אקראי) בין העלאות של פידים. כך קל יותר לקבל תמיכה בבעיות שקשורות לישות.

• ערכים Null: אין להשתמש בערך null במקום באובייקטים. אם אובייקט הוא אופציונלי, צריך להשמיט אותו מהפיד.

ספריות לקוח

הכלי ליצירת קוד לקוח בקטע 'כלים' זמין לאימות פיד הנתונים של תהליך ההזמנה מקצה לקצה.