डीएसपीएल कुकबुक

इस दस्तावेज़ में, काम के DSPL और कैननिकल सिद्धांत की कुकबुक शामिल है "रेसिपी". इन कैंपेन में, कई लोगों के लिए चरण-दर-चरण निर्देश ऐसे टास्क जो मूल भाषा की सुविधाओं से कहीं ज़्यादा हैं. ट्यूटोरियल और डेवलपर गाइड. कॉन्टेंट नीचे दिए गए दस्तावेज़ पिछले दस्तावेज़ों की जानकारी पर आधारित हैं, इसलिए हर दस्तावेज़ को पढ़ना न भूलें. "कुकिंग" शुरू करने से पहले उन्हें हल करना चाहिए.

हर रेसिपी एक लक्ष्य से शुरू होती है. इसके बाद, एक खास सूची होती है, जिसमें फ़ॉलो करें. इनमें DSPL स्निपेट या बाहरी उदाहरणों के लिंक भी शामिल होते हैं. अगर आपको आपके पास रेसिपी के बारे में कोई सुझाव, शिकायत या राय है या आप दूसरों के सुझाव देना चाहते हैं, तो कृपया पोस्ट करें DSPL फ़ोरम में एक मैसेज भेजा है.

मूल रेसिपी

डिसप्ले नेम तय करना

लक्ष्य

"डिसप्ले नेम" जोड़ें (डाइमेंशन) के हर इंस्टेंस के साथ कॉन्सेप्ट को समझने की कोशिश करते हैं. ये नाम इसके बजाय Public Data Explorer UI में दिखाई देंगे कॉन्सेप्ट इंस्टेंस आईडी, जो आम तौर पर छोटे होते हैं और लोगों के लिए मुश्किल होते हैं समझना.

चरण

1. अपने कॉन्सेप्ट को entity:entity. तक बढ़ाएं
2. किसी कॉन्सेप्ट से जुड़ी परिभाषा में name कॉलम जोड़ें टेबल.
3. बाद वाली प्रॉपर्टी को हर इंस्टेंस के नाम के साथ भरें.

नोट

• यहां साफ़ तौर पर name प्रॉपर्टी को तय करने की ज़रूरत नहीं है आपके कॉन्सेप्ट का मेटाडेटा; यह परिभाषा अपने-आप शामिल हो जाती है, जब entity:entity तक बढ़ाएं.
• description और info_url को भी जोड़ा जा सकता है कॉलम का इस्तेमाल करें.

कॉन्सेप्ट की हैरारकी तैयार करना

लक्ष्य

(डाइमेंशन) के कॉन्सेप्ट की हैरारकी बनाएं. ये यहां दिखाई देंगे सार्वजनिक डेटा एक्सप्लोरर के यूज़र इंटरफ़ेस (यूआई) को ट्री के तौर पर दिखाने से, उपयोगकर्ताओं को ग्रुप को समझने में मदद मिलती है और उनके बीच नेविगेट करें.

चरण

1. "पैरंट" का मतलब समझाना कॉन्सेप्ट (उदाहरण के लिए, region).
2. "बच्चे" के बारे में जानकारी दें कॉन्सेप्ट (उदाहरण के लिए, subregion).
3. बच्चे के खाते में ऐसी प्रॉपर्टी जोड़ें जिसमें पैरंट का रेफ़रंस हो और जिसमें isParent एट्रिब्यूट:

   <property concept="..." isParent="true"/>

   जहां बिंदुओं को पैरंट आईडी से बदल दिया जाता है.
4. बच्चे की परिभाषा टेबल में, वह कॉलम जोड़ें जो पैरंट.
5. हर चाइल्ड इंस्टेंस के लिए, बाद वाले इंस्टेंस को और कॉन्सेप्ट न जोड़ा हो.

नोट

• इसमें country / state का संबंध देखें: इसके लिए ट्यूटोरियल डेटासेट इसका एक उदाहरण देखें.
• बच्चे का बताया गया हर पैरंट आईडी, माता-पिता के आईडी में होना चाहिए की परिभाषा टेबल में दी गई है. ऐसा न होने पर, इंपोर्टर कोई गड़बड़ी पैदा करेगा.
• माता-पिता और बच्चा एक ही सिद्धांत हो सकते हैं, जैसे कि खुद के बारे में बताने वाले वीडियो पदानुक्रम देखें). business कॉन्सेप्ट को इसमें देखें अमेरिका में हुई खुदरा बिक्री का डेटासेट देखें.

कॉन्सेप्ट इंस्टेंस की कैटगरी तय करना

लक्ष्य

कॉन्सेप्ट इंस्टेंस के लिए कैटगरी बनाएं, जो विकल्पों के तौर पर दिखेंगी Public Data Explorer रंग पिकर में.

चरण

1. "कैटगरी" तय करना कॉन्सेप्ट (उदाहरण के लिए, income_level).
2. "बच्चे" के बारे में जानकारी दें कॉन्सेप्ट (उदाहरण के लिए, country).
3. चाइल्ड में ऐसी प्रॉपर्टी जोड़ें जो कैटगरी के कॉन्सेप्ट का रेफ़रंस देती हो और इसमें शामिल है name एलिमेंट:

   <property concept="..."/>
     <info>
       <name><value>"..."</value></name>
     </info>
   </property>

   जहां डॉट के पहले सेट को कैटगरी कॉन्सेप्ट आईडी से बदला जाता है और दूसरे सेट को आपकी प्रॉपर्टी के पसंदीदा डिसप्ले नेम से बदल दिया गया है (उदाहरण के लिए, "कमाई का स्तर").
4. बच्चे की परिभाषा टेबल में, वह कॉलम जोड़ें जो कैटगरी कॉन्सेप्ट.
5. हर चाइल्ड इंस्टेंस के लिए, बाद वाले इंस्टेंस को श्रेणी की अवधारणा.

नोट

• किसी कॉन्सेप्ट में कई प्रॉपर्टी हो सकती हैं, जो कैटगरी के तौर पर काम करती हैं; इसमें केस में, उपयोगकर्ता को ये सभी कलर पिकर में विकल्पों के तौर पर दिखेंगे.
• इनमें से कोई एक कैटगरी, पैरंट भी हो सकती है. ऐसा इन कामों के लिए किया जाता है यूज़र इंटरफ़ेस (यूआई) में इन इंस्टेंस को हैरारकी के हिसाब से व्यवस्थित करना. पिछला देखें रेसिपी देखें.

कॉन्सेप्ट इंस्टेंस को क्रम से लगाने का तरीका

लक्ष्य

कॉन्सेप्ट के इंस्टेंस को क्रम से लगाने का तरीका तय करें. इस ऑर्डर का इस्तेमाल तब किया जाता है, जब Public Data Explorer के बाएं नेविगेशन में इंस्टेंस की सूची विज़ुअलाइज़ेशन पेज.

चरण

1. अपने कॉन्सेप्ट को entity:entity या इसके किसी एक कॉन्सेप्ट पर लागू करें बच्चे (उदाहरण के लिए, geo:location).
2. अपने कॉन्सेप्ट मेटाडेटा में entity_order एट्रिब्यूट जोड़ें.
3. पिछली वैल्यू को ALPHA में से किसी एक पर सेट करें या TABLE; पहले की वजह से इंस्टेंस सूची में शामिल हो जाएंगे अपने डिसप्ले नेम का क्रम तय करेंगे, जबकि बाद वाला विकल्प, इंस्टेंस को बनाए रखेगा उसी क्रम में होनी चाहिए जैसा वे कॉन्सेप्ट डेफ़िनिशन टेबल में दिखती हैं.

नोट

• ALPHA वर्तमान डिफ़ॉल्ट है, इसलिए अगर आप इसका उपयोग करना चाहते हैं है, तो ऊपर दिए गए चरण ज़रूरी नहीं हैं.
• entity:entity दस्तावेज़ देखें.

टाइम रेसिपी

तिमाही डेटा

लक्ष्य

हर तीन महीने के अंतराल में दिया गया डेटा विज़ुअलाइज़ करें.

चरण

1. अपने स्लाइस डेटा में मौजूद सभी तिमाहियों को महीनों में बदलें (उदाहरण के लिए, महीने के हिसाब से.
2. अपने स्लाइस में इस डाइमेंशन को time:month के तौर पर देखें एक्सएमएल.

हफ़्ते का डेटा

लक्ष्य

हर हफ़्ते के इंटरवल पर तय किया गया डेटा विज़ुअलाइज़ करना.

चरण

1. अपने स्लाइस डेटा में मौजूद सभी हफ़्तों को दिनों में बदलें (उदाहरण के लिए, पहले हफ़्ते का दिन).
2. अपने स्लाइस एक्सएमएल में, इस डाइमेंशन को time:day के तौर पर इस्तेमाल करें.

जियो रेसिपी

country या state का इस्तेमाल किया जा रहा है कैननिकल सिद्धांत

लक्ष्य

कैननिकल country या state सिद्धांतों का इस्तेमाल करें, सभी अक्षांश/देशांतर वैल्यू वगैरह को इंपोर्ट करना, ताकि इनका इस्तेमाल करने की ज़रूरत न हो को डेटासेट में परिभाषित किया गया है.

चरण

1. पक्का करें कि आपके स्लाइस डेटा की CSV फ़ाइलें, कैननिकल देश के मान्य आईडी हैं और राज्य परिभाषा टेबल में.
2. geo:country और/या geo_us:state को इस खाते से जोड़ें डाइमेंशन इस्तेमाल करें.
3. पक्का करें कि इन कॉलम के नाम, नामों से मेल खाते हों में जोड़ा गया था (इसमें इंपोर्ट किए गए डेटासेट का नाम शामिल नहीं है, जैसे कि country) या अगर नहीं है, तो mapDimension को शामिल करें आपकी स्लाइस की परिभाषा में स्टेटमेंट. उदाहरण:

   <slice id="...">
     ...
     <dimension concept="geo:country"/>
     ...
     <mapDimension concept="geo:country" toColumn="my_country"/>
   </slice>

कैननिकल देशों के सिर्फ़ एक सबसेट का इस्तेमाल करके या राज्य

लक्ष्य

कैननिकल भौगोलिक सिद्धांत के किसी सबसेट का इस्तेमाल करें, ताकि सिर्फ़ यह सबसेट ही हो, न कि पूरी सूची, जैसे सभी देश) सार्वजनिक रूप से दिखती हैं डेटा एक्सप्लोरर का यूज़र इंटरफ़ेस (यूआई).

चरण

1. एक ऐसा लोकल कॉन्सेप्ट बताएं जो सुपरसेट के कॉन्सेप्ट को आगे बढ़ाता है. उदाहरण:

   <concept id="my_country_subset" extends="geo:country">
   ...
   </concept>

2. संबंधित कॉन्सेप्ट की परिभाषा वाली CSV में, सिर्फ़ सुपरसेट का इस्तेमाल करें. उदाहरण:

   my_country_subset
   FR  
   MX
   US

नोट

• आपके सबसेट कॉन्सेप्ट का हर इंस्टेंस, सुपरसेट कॉन्सेप्ट; आप "बड़ा" नहीं कर सकते नए कॉन्सेप्ट को इंस्टेंस.

अपने भौगोलिक सिद्धांत तय करना

लक्ष्य

अपने हिसाब से भौगोलिक कॉन्सेप्ट बनाएं, जिन्हें एक्सप्लोर और मैप किया जा सके. जैसे, कैननिकल या Google के तय किए गए कैननिकल यूआरएल.

चरण

1. ऐसा कॉन्सेप्ट बनाएं जो geo:location को बड़ा करता हो.
2. संबंधित कॉन्सेप्ट की परिभाषा वाली टेबल में, कॉलम शामिल करें name, latitude, और longitude.
3. अपने कॉन्सेप्ट के हर इंस्टेंस के लिए बाद की प्रॉपर्टी को भरें; यह अक्षांश और देशांतर की वैल्यू, N और E के कन्वेंशन के हिसाब से फ़्लोट करती हैं पॉज़िटिव है और W और S नेगेटिव हैं.

नोट

• name को साफ़ तौर पर शामिल करने की ज़रूरत नहीं है, आपकी latitude, और longitude प्रॉपर्टी कॉन्सेप्ट डेफ़िनिशन, क्योंकि एक्सटेंडेट करने पर ये अपने-आप शामिल हो जाती हैं geo:location.
• निर्देश पाने के लिए ट्यूटोरियल डेटासेट में state की परिभाषा देखें उदाहरण के लिए.

मेट्रिक और यूनिट रेसिपी

प्रतिशत का इस्तेमाल किया जा रहा है

लक्ष्य

ऐसा (मेट्रिक) सिद्धांत तय करें जो किसी दूसरी चीज़ का प्रतिशत होता है.

चरण

1. अपने कॉन्सेप्ट को quantity:ratio तक बढ़ाएं.
2. is_percentage एट्रिब्यूट को true पर सेट करें.

   <attribute id="is_percentage">
     <value>true</value>
   </attribute>

3. विकल्प के तौर पर, percentage_of एट्रिब्यूट को इनके आधार पर सेट करें इस कॉन्सेप्ट का एक प्रतिशत हिस्सा है. उदाहरण:

   <attribute id="percentage_of">
     <value>labor force</value>
   </attribute>

currency इकाइयों का इस्तेमाल किया जा रहा है

लक्ष्य

मेट्रिक (मेट्रिक) वाला ऐसा सिद्धांत बताएं जिसमें मुद्रा की इकाइयां हों (उदाहरण के लिए, डॉलर में शुल्क लिया जाएगा).

चरण

1. अपनी मेट्रिक को quantity:quantity या उसकी एक मेट्रिक तक बढ़ाएं बच्चे, जैसे quantity:amount.
2. ऐसा unit एट्रिब्यूट जोड़ें जिससे रेफ़रंस मिलता हो unit:currency और इसका मान जुड़ी हुई मुद्रा की परिभाषा टेबल. उदाहरण:

   <concept id="...">
     <attribute concept="unit:currency">
       <value>EUR</value>
     </attribute>
   </concept>

कस्टम इकाई बनाना

लक्ष्य

अपनी एक या ज़्यादा मेट्रिक के लिए कस्टम यूनिट बनाएं.

चरण

1. ऐसा कॉन्सेप्ट बनाएं जो unit:unit को बड़ा करता हो.
2. कॉलम unit_text और symbol को असोसिएटेड डेफ़िनिशन टेबल. वैकल्पिक रूप से, यदि आप चिह्न स्थिति, आप एक symbol_position भी जोड़ सकते हैं कॉलम.
3. अपने इकाई. "क्षेत्र" के लिए CSV फ़ाइल का उदाहरण इकाइयां:

   my_unit,unit_text,symbol,symbol_position
   SQKM,square kilometers,km²,END
   SQML,square miles,miles²,END

4. अपनी नई इकाई को (मेट्रिक) के सिद्धांत में इस्तेमाल करने के लिए, पक्का करें कि बाद वाला पॉइंट, quantity:quantity या उसके किसी चाइल्ड पब्लिशर को बढ़ाता है. इसके बाद, ऐसा एट्रिब्यूट जोड़ें जो आपके यूनिट कॉन्सेप्ट का रेफ़रंस देता हो. उदाहरण:

   <concept id="..." extends="quantity:amount">
     ...
     <attribute concept="my_unit">
       <value>SQKM</value>
     </attribute>
     ...
   </concept>
   

नोट

• अगर आपके यूनिट कॉन्सेप्ट में सिर्फ़ एक इंस्टेंस है, तो आईडी को हटाया जा सकता है कॉलम और साथ ही value टैग में इस्तेमाल कर रही हैं.
• कैननिकल मुद्रा की परिभाषा देखें कॉन्सेप्ट के बारे में जानें.