סקירה כללית

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

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

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

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

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

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

  • ערכי DateTime ו-Time: בנכסים שנדרש בהם הערך DateTime או Time, משתמשים בפורמטים של DateTime and 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 במקום אובייקטים. אם האובייקט הוא אופציונלי, צריך להשמיט אותו מהפיד.

ספריות לקוח

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