ساختار فید دادههای End-to-End سفارش شما توسط طرح موجودی رابطهای تعریف میشود. فید دادههای Ordering End-to-End از موجودیتهای سطح بالای زیر تشکیل شده است:
- نهادهای
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
استفاده کنید.ID Generation : شناسه های خود را ثابت نگه دارید - از UUID استفاده نکنید و یا شناسه ها را بین آپلود فید تغییر/تصادفی نکنید. این امکان پشتیبانی آسان تر از مسائل مربوط به نهاد را فراهم می کند.
مقادیر تهی : از مقدار
null
به جای اشیا استفاده نکنید. اگر یک شی اختیاری است، باید آن را از فید خود حذف کنید.
کتابخانه های مشتری
تولیدکننده کد سرویس گیرنده در بخش ابزارها برای اعتبارسنجی فید دادههای End-to-End سفارش شما در دسترس است.