Reference

मान लीजिए आप एक कपड़ों का ऑनलाइन स्टोर चलाते हैं। हर उत्पाद के लिए आप यह लिख रखना चाहते हैं कि वह किस ब्रांड का है। अगर एक ही ब्रांड "DailyWear" के दर्जनों उत्पाद हैं, तो हर उत्पाद में ब्रांड का नाम, logo और परिचय बार-बार एक जैसा ही टाइप करना पड़ता है। और जब ब्रांड का परिचय बदलता है, तो उन दर्जनों को एक-एक करके सुधारना पड़ता है।

Reference इस दोहराव को हटा देता है। ब्रांड की जानकारी अलग से बस एक बार बना दी जाती है, और हर उत्पाद को उस ब्रांड से बस जोड़ देना होता है। एक ही जानकारी हर बार दोबारा टाइप करने के बजाय, एक जगह रखी जानकारी को जोड़कर इस्तेमाल करना, यही reference है। ब्रांड का परिचय एक बार सुधारने पर, वह उन सभी उत्पाद में एक साथ लागू हो जाता है जिन्हें उस ब्रांड से जोड़ा गया है।

इस page में बताया गया है कि एक Content को दूसरे Content से जोड़ने वाला reference क्या है, जोड़ने पर क्या होता है, और Content आपस में कैसे जुड़ते हैं।

इशारा करना और नकल उतारना में अंतर

ब्रांड की जानकारी हर उत्पाद में लिखने के दो तरीके सोचे जा सकते हैं।

एक है नकल उतारना। हर बार उत्पाद बनाते समय ब्रांड का नाम "DailyWear" और ब्रांड का परिचय उसी उत्पाद के अंदर सीधे लिख देना। 100 उत्पाद में वही लेख 100 प्रतियों में चला जाता है। ब्रांड का परिचय बदलने पर सभी 100 प्रतियों को ढूँढकर सुधारना पड़ता है, और एक भी छूट जाए तो हर उत्पाद में अलग-अलग परिचय दिखने लगता है।

दूसरा है इशारा करना। ब्रांड "DailyWear" को एक अलग Content के रूप में बना रखना, और हर उत्पाद बस उस ब्रांड Content की ओर इशारा करता है। जानकारी सिर्फ़ ब्रांड वाली एक ही जगह पर रहती है। परिचय को उसी एक जगह पर सुधारने पर, उस ब्रांड की ओर इशारा करने वाले सभी उत्पाद उसी नए परिचय का पालन करते हैं।

Reference यही "इशारा करना" है। जोड़ को रखने वाले Field को कंटेंट स्टूडियो में Content Reference कहते हैं। उत्पाद Content Type में एक Content Reference Field रख देने पर, उस खाने में से ब्रांड Content चुनकर जोड़ा जाता है। उपमा के तौर पर, ब्रांड की जानकारी हर उत्पाद में हाथ से नकल करने के बजाय "इस उत्पाद का ब्रांड वहाँ रखा DailyWear है" कहते हुए एक तीर खींच देना है।

जोड़ की बनावट

उत्पाद और ब्रांड को जोड़ने पर बनावट कुछ इस तरह बनती है। कई उत्पाद एक ही ब्रांड वाली जगह से जुड़ते हैं।

उत्पाद "स्टेनलेस टम्बलर 500ml" ──जोड़──▶
उत्पाद "इंसुलेटेड मिनी टम्बलर 350ml" ──जोड़──▶   ब्रांड "DailyWear"
उत्पाद "पोर्टेबल फोल्डेबल वॉटर बोतल 600ml" ──जोड़──▶

ब्रांड "DailyWear" को सिर्फ़ एक बार बनाया जाता है, और tumbler हो या water bottle, सब इसी एक जगह से जुड़ते हैं। ब्रांड का परिचय DailyWear Content में एक बार सुधारने पर, ऊपर के तीनों उत्पाद उसी नए परिचय का पालन करते हैं।

जोड़ केवल Content के बीच ही नहीं, Content से Media (अपलोड की गई image, video जैसी फ़ाइलों) तक भी बनाया जा सकता है। उत्पाद में मुख्य तस्वीर लगाना इसका एक उदाहरण है। यह page Content को आपस में जोड़ने का मामला बताता है। Media लगाने का तरीका Media में बताया गया है।

जोड़ने पर साथ क्या आता है

उत्पाद में ब्रांड जोड़ रखने पर, उत्पाद की जानकारी लाते समय जुड़े हुए ब्रांड की जानकारी भी साथ लाई जा सकती है। tumbler उत्पाद को screen पर दिखाते समय, उस उत्पाद से जुड़े ब्रांड "DailyWear" का नाम और परिचय तक एक साथ आ जाते हैं। उत्पाद की ओर ब्रांड की जानकारी नकल करके नहीं रखी, फिर भी जोड़ का पीछा करते हुए ब्रांड वाली एक जगह से मान पढ़ लिए जाते हैं, इसीलिए।

इसलिए ब्रांड की जानकारी हमेशा एक ही जगह, ब्रांड Content में ही रखनी होती है। हर बार उत्पाद पढ़ते समय उस समय की ब्रांड जानकारी जोड़ का पीछा करते हुए साथ आती है। ब्रांड को सुधारने पर, अगली बार उत्पाद पढ़ते समय सुधारी गई जानकारी साथ आती है।

जुड़े हुए Content को कहाँ तक साथ लाना है, किस अनुरोध से लाना है, इसका विस्तृत स्वरूप API रेफरेंस में बताया गया है। कंटेंट स्टूडियो में बस जोड़ रखना ही काफ़ी है।

जो जुड़ सकता है, उसका प्रकार तय करना

Content Reference Field में "इस खाने में सिर्फ़ किसी ख़ास Content को ही जोड़ा जा सकता है" ऐसी सीमा लगाई जा सकती है। अगर यह उत्पाद का ब्रांड वाला खाना है, तो कोई भी Content आ जाए तो दिक़्क़त होगी। क्योंकि review या notice ग़लती से ब्रांड की जगह न जुड़ जाए।

इसलिए इस खाने में सिर्फ़ "ब्रांड" Content Type से बने Content को ही जोड़े जा सकने जैसा तय किया जा सकता है। ऐसा कर रखने पर ब्रांड वाले खाने में चुने जा सकने वाले विकल्प ब्रांड तक सीमित हो जाते हैं, और दूसरे प्रकार के Content नहीं जुड़ते। जो Content Type जुड़ सकते हैं, उन्हें एक से अधिक भी एक साथ अनुमति दी जा सकती है। उदाहरण के लिए एक ही खाने में "ब्रांड" और "साझेदार" दोनों की अनुमति देकर, दोनों में से किसी को भी जोड़ने दिया जा सकता है।

यह सीमा Content Reference Field की विस्तृत सेटिंग्स में तय की जाती है। वैधीकरण में संदर्भ Content Type को चालू करके, अनुमति देने वाले Content Type के रूप में "ब्रांड" चुन लें।

यह सीमा सहेजते या publish करते समय जाँची जाती है। अनुमति दिए गए Content Type से इतर Content जोड़ने पर सहेजना रुक जाता है, और जोड़ रखा गया Content इस बीच हटा दिया गया हो और अब न मिल पाए, तो भी जाँच में फँस जाता है। यह ग़लत तरीके से जुड़े हुए जोड़ों के जमा होने को रोकने वाला उपाय है।

एक खाने में कई जोड़ना

अक्सर एक उत्पाद में सिर्फ़ एक ब्रांड जोड़ देना ही काफ़ी होता है। लेकिन कभी-कभी एक खाने में कई जोड़ने की ज़रूरत भी होती है। उदाहरण के लिए "इस उत्पाद के साथ देखने लायक उत्पाद" वाले खाने में कई संबंधित उत्पाद जोड़ रखना चाहते हैं।

इस स्थिति में Content Reference Field को सूची प्रकार के रूप में उपयोग करें पर सेट किया जाता है। तब एक खाने में कई Content जोड़े जा सकते हैं। "साथ देखने लायक उत्पाद" वाले खाने में tumbler, water bottle और thermos सब जोड़ रखने जैसा। list type के रूप में इस्तेमाल करते समय भी जुड़ सकने वाले प्रकार की सीमा वैसे ही लगाई जा सकती है।

"उत्पाद" में ब्रांड जोड़ने वाला खाना बनाना

उत्पाद ब्रांड को जोड़ सके, इसके लिए "उत्पाद" Content Type में Content Reference प्रकार का Field जोड़ा जाता है। Field जोड़ने का तरीका Content मॉडलिंग में बताया गया है। Field का प्रकार चुनने वाली screen में Content Reference चुनने के बाद, ऊपर देखे गए "जो जुड़ सकता है, उसका प्रकार" को "ब्रांड" तय कर लें।

जोड़ने के लिए कोई लक्ष्य होना ज़रूरी है, इसलिए उससे पहले ब्रांड वाला पक्ष पहले तैयार कर रखें।

1. "ब्रांड" Content Type बनाएं। ब्रांड का नाम, परिचय जैसे Field डालें।
2. "ब्रांड" Content Type से ब्रांड Content "DailyWear" एक बनाएं।
3. "उत्पाद" Content Type में Content Reference Field जोड़ें, और जो जुड़ सकता है उसका प्रकार "ब्रांड" तय करें।
4. उत्पाद "स्टेनलेस टम्बलर 500ml" खोलें और संपादित करें दबाएं।
5. ब्रांड वाले खाने का मौजूदा Content जोड़ें दबाएं। Content चुनें window खुलता है।
6. सूची में से "DailyWear" चुनकर जोड़ें।

Content चुनें window में सिर्फ़ वही "ब्रांड" दिखता है जिसे जुड़ सकने वाले प्रकार के रूप में तय किया गया है। पहले लगाई गई सीमा यहाँ वैसी ही लागू होती है।

अब tumbler उत्पाद ब्रांड "DailyWear" से जुड़ गया है। दूसरे उत्पाद में भी उसी खाने में "DailyWear" चुनने पर, कई उत्पाद एक ब्रांड से एक साथ जुड़ जाते हैं।

जोड़ संभालते समय जान लेने योग्य बातें

जुड़ा हुआ Content ग़ायब हो जाए तो जाँच में फँसता है। उत्पाद ने जोड़ रखे ब्रांड Content को हटा देने पर, उत्पाद का ब्रांड वाला खाना ऐसे Content से जुड़ी अवस्था में आ जाता है जो अब मिल नहीं पाता। इस अवस्था में उत्पाद को सहेजते या publish करते समय जाँच में रुक जाता है। कोई दूसरा ब्रांड दोबारा जोड़ दें, या अगर वह खाना अनिवार्य नहीं है तो उसे खाली करके फिर से कोशिश करें।

जोड़ने से दोनों Content एक में मिल नहीं जाते। उत्पाद और ब्रांड अलग-अलग Content के रूप में बने रहते हैं। उत्पाद को मिटाने पर भी ब्रांड Content वैसे ही रहता है, और ब्रांड को सुधारने पर भी उत्पाद Content स्वयं वैसा ही रहता है। बदलता सिर्फ़ वह मान है जो जोड़ का पीछा करते हुए साथ पढ़ा जाता है।

आगे क्या करें

• Content मॉडलिंग: "उत्पाद" Content Type में Content Reference Field जोड़ने का तरीका बताता है।
• Media: उत्पाद में मुख्य तस्वीर जैसे Media लगाने का तरीका बताता है।
• स्थिति और publish: जुड़े हुए Content को publish करके बाहर सार्वजनिक करने के चरण बताता है।
• API रेफरेंस: जुड़े हुए Content को साथ लाने वाला अनुरोध स्वरूप और जोड़ को रखने वाली Refer मद की संरचना program में सीधे संभालते समय इसका संदर्भ लें।