بررسی اجمالی

ساختار فید داده‌های End-to-End سفارش شما توسط طرح موجودی رابطه‌ای تعریف می‌شود. فید داده‌های Ordering End-to-End از موجودیت‌های سطح بالای زیر تشکیل شده است:

نمودار زیر نشان می‌دهد که چگونه نهادهای 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 استفاده کنید.

  • ID Generation : شناسه های خود را ثابت نگه دارید - از UUID استفاده نکنید و یا شناسه ها را بین آپلود فید تغییر/تصادفی نکنید. این امکان پشتیبانی آسان تر از مسائل مربوط به نهاد را فراهم می کند.

  • مقادیر تهی : از مقدار null به جای اشیا استفاده نکنید. اگر یک شی اختیاری است، باید آن را از فید خود حذف کنید.

کتابخانه های مشتری

تولیدکننده کد سرویس گیرنده در بخش ابزارها برای اعتبارسنجی فید داده‌های End-to-End سفارش شما در دسترس است.