نظرة عامة

يتمّ تحديد بنية خلاصة البيانات الشاملة للطلب من خلال مخطّط المستودع العلائقي. تتكون خلاصة البيانات الشاملة للطلب من الكيانات التالية ذات المستوى الأعلى:

يوضّح المخطّط التالي كيف تمثّل كيانات Service وRestaurant وMenu مطعمًا واحدًا:

رسم بياني للعلاقة بين فئات قائمة خدمات المطاعم
الشكل 1: العلاقة العامة بين كيانات خلاصة البيانات الشاملة للطلب: الخدمة والمطاعم والقائمة.

الإرشادات العامة

  • المطاعم لكل ملف: يجب أن يمثّل كل ملف بيانات مطعمًا واحدًا يتضمّن كيانَي 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 بدلاً من الكائنات. إذا كان العنصر اختياريًا، عليك حذفه من الخلاصة.

مكتبات العملاء

يمكنك استخدام منشئ رمز العميل في قسم "الأدوات" للتحقّق من صحة خلاصة البيانات "الشاملة" الخاصة بالطلبات.

التالي
البدء بسرعة