खास जानकारी

ऑर्डरिंग एंड-टू-एंड डेटा फ़ीड का स्ट्रक्चर, रिलेशनल इन्वेंट्री स्कीमा से तय होता है. ऑर्डरिंग एंड-टू-एंड डेटा फ़ीड में ये टॉप-लेवल इकाइयां शामिल होती हैं:

इस डायग्राम में दिखाया गया है कि Service, Restaurant, और Menu इकाइयां, एक रेस्टोरेंट को कैसे दिखाती हैं:

रेस्टोरेंट की सेवा के मेन्यू की क्लास के बीच संबंध दिखाने वाला डायग्राम
पहली इमेज: ऑर्डर करने की प्रोसेस के दौरान, डेटा फ़ीड की इकाइयों के बीच का पूरा संबंध: सेवा, रेस्टोरेंट, और मेन्यू.

सामान्य दिशा-निर्देश

  • हर फ़ाइल में रेस्टोरेंट: हर डेटा फ़ाइल में एक रेस्टोरेंट के साथ-साथ उससे जुड़ी Service और Menu इकाइयां होनी चाहिए. फ़ाइल के ऐसे नाम रखें जिनसे किसी रेस्टोरेंट की फ़ाइल को खोजने में मदद मिल सके.

  • डेटा फ़ाइल का फ़ॉर्मैट: डेटा फ़ाइलों को, नई लाइन से अलग की गई JSON फ़ाइलों (ndjson फ़ॉर्मैट) के तौर पर फ़ॉर्मैट किया जाना चाहिए.

  • तारीख और समय की वैल्यू: जिन प्रॉपर्टी के लिए DateTime या Time वैल्यू की ज़रूरत होती है उनके लिए, तारीख और समय के फ़ॉर्मैट में बताए गए फ़ॉर्मैट का इस्तेमाल करें. उदाहरण के लिए, DateTime के लिए 2017-05-01T06:30:00+05:30 और Time के लिए T08:08:00+05:30.

  • आईडी: इकाई के टाइप में मौजूद सभी यूनीक इकाइयों की पहचान करने के लिए, @id प्रॉपर्टी का इस्तेमाल करें. इसमें 300 से ज़्यादा वर्ण नहीं होने चाहिए. @id, उस टाइप की इकाई का यूनीक आइडेंटिफ़ायर होता है. हालांकि, सभी इकाइयों के आईडी ओवरलैप हो सकते हैं. उदाहरण के लिए, मान लें कि आपने Service प्रॉपर्टी को a16 पर सेट करके, Service इकाई तय की है.@id a16 के @id वाली कोई दूसरी Service इकाई नहीं बनाई जा सकती. हालांकि, Menu इकाई की @id वैल्यू के तौर पर a16 का इस्तेमाल किया जा सकता है.

  • आईडी जनरेशन: अपने आईडी को स्थिर रखें - यूयूआईडी का इस्तेमाल न करें या फ़ीड अपलोड के बीच आईडी को बदलें/रैंडम बनाएं. इससे इकाई से जुड़ी समस्याओं के लिए, आसानी से सहायता मिलती है.

  • शून्य वैल्यू: ऑब्जेक्ट के बजाय, वैल्यू null का इस्तेमाल न करें. अगर कोई ऑब्जेक्ट ज़रूरी नहीं है, तो आपको उसे अपने फ़ीड से हटा देना चाहिए.

क्लाइंट लाइब्रेरी

टूल सेक्शन में मौजूद क्लाइंट कोड जनरेटर, ऑर्डरिंग के एंड-टू-एंड डेटा फ़ीड की पुष्टि करने के लिए उपलब्ध है.