يتم تحديد بنية خلاصة بيانات "الطلب من البداية إلى النهاية" من خلال مخطّط المستودع التعريفي. تتألف خلاصة بيانات "الطلب من البداية إلى النهاية" من الكيانات ذات المستوى الأعلى التالية:
Restaurantالكيانات: المطاعم التي توفّر لها الخدمة- عناصر
Service: توقيت الخدمة وموقعها الجغرافي وشروطها - عناصر
Menu: تفاصيل قائمة الطعام في كل مطعم
يوضّح المخطّط البياني التالي كيف تمثّل عناصر Service وRestaurant وMenu
مطعمًا واحدًا:
الإرشادات العامة
المطاعم في كل ملف: يجب أن يمثّل كل ملف بيانات مطعمًا واحدًا مع الكيانَين
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بدلاً من العناصر. إذا كان العنصر اختياريًا، يجب حذفه من خلاصتك.
مكتبات العملاء
يتوفّر أداة إنشاء رموز العملاء في قسم "الأدوات" للتحقّق من صحة خلاصة بيانات "الطلب من خلال قنوات متعددة".