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