बदले जा सकने वाले कॉन्फ़िगरेशन पैरामीटर

बदले जा सकने वाले कॉन्फ़िगरेशन पैरामीटर से, रिपोर्ट एडिटर को डेटा सोर्स की डिफ़ॉल्ट वैल्यू में बदलाव करने की सुविधा मिलती है. कॉन्फ़िगरेशन पैरामीटर को बदले जा सकने वाले के तौर पर तय करने से, डेटा सोर्स ज़्यादा सुविधाजनक हो जाता है. साथ ही, उपयोगकर्ताओं को उपयोगकर्ता के हिसाब से कॉन्फ़िगर किए जा सकने वाले रिपोर्ट टेंप्लेट बनाने का तरीका भी मिलता है.

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

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

भूमिकाएं

इस दस्तावेज़ में, उपयोगकर्ता की भूमिकाओं के बारे में बताया गया है:

Role	परिभाषा
कनेक्टर डेवलपर	ऐसा उपयोगकर्ता जिसने कम्यूनिटी कनेक्टर बनाया है.
डेटा सोर्स का मालिक	वह उपयोगकर्ता जिसने डेटा सोर्स बनाया और उसका मालिक है.
रिपोर्ट एडिटर	ऐसा उपयोगकर्ता जिसके पास रिपोर्ट में बदलाव मोड का ऐक्सेस हो.
रिपोर्ट व्यूअर	ऐसा उपयोगकर्ता जिसके पास किसी रिपोर्ट के लिए व्यू मोड का ऐक्सेस है.

बदले जा सकने वाले पैरामीटर तय करना

कनेक्टर डेवलपर, कम्यूनिटी कनेक्टर के getConfig() फ़ंक्शन में कॉन्फ़िगरेशन पैरामीटर के बारे में बताता है. किसी कॉन्फ़िगरेशन पैरामीटर को ओवरराइड करने लायक के तौर पर तय करने के लिए, कनेक्टर setAllowOverride(true) को कॉल करता है.

ध्यान दें: पैरामीटर को BigQuery कस्टम क्वेरी के हिस्से के तौर पर भी तय किया जा सकता है.

इस उदाहरण में दो ऐसे पैरामीटर के बारे में बताया गया है जिन्हें बदला नहीं जा सकता: zipcode और units और एक पैरामीटर जिसे बदला नहीं जा सकता: days-to-forcecast.

function getConfig(request) {
  var config = cc.getConfig();

  // A
  config
      .newTextInput()
      .setId("zipcode")
      .setName("ZIP Code")
      .setAllowOverride(true);

  // B
  config
    .newSelectSingle()
    .setId("units")
    .setName("Units")
    .addOption(
        config
          .newOptionBuilder()
          .setLabel("Metric")
          .setValue("metric")
    )
    .addOption(
      config
        .newOptionBuilder()
        .setLabel("Imperial")
        .setValue("imperial")
    )
    .setAllowOverride(true);

  // C
  config
    .newTextInput()
    .setId("days-to-forecast")
    .setName("Days to forecast")
      .setAllowOverride(false);


  return config.build();
}

ध्यान दें: allowOverride की डिफ़ॉल्ट वैल्यू false है. अगर आपको किसी पैरामीटर के लिए बदलाव करने की सुविधा चालू नहीं करनी है, तो setAllowOverride() को कॉल छोड़ें.

किसी पैरामीटर को ओवरराइड करने लायक के तौर पर तय करने से कब बचना चाहिए

हमारा सुझाव है कि Looker Studio आपके डेटा से कैसे कनेक्ट होता है सेक्शन को पढ़कर, यह जानें कि कनेक्टर, डेटा सोर्स, और रिपोर्ट एक-दूसरे के साथ कैसे काम करती हैं.

नीचे दिए गए मामलों में, पैरामीटर को बदले जा सकने वाले के रूप में तय करने से बचें:

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

रिपोर्ट उपयोगकर्ताओं के लिए पैरामीटर चालू करना

डेटा सोर्स के मालिक यह कंट्रोल करते हैं कि रिपोर्ट एडिटर किन पैरामीटर में बदलाव कर सकते हैं. इसी तरह, रिपोर्ट एडिटर यह कंट्रोल करते हैं कि रिपोर्ट व्यूअर किन पैरामीटर में बदलाव कर सकते हैं.

रिपोर्ट एडिटर को पैरामीटर वैल्यू में बदलाव करने की अनुमति दें

डेटा सोर्स का मालिक यह कंट्रोल करता है कि रिपोर्ट में किन पैरामीटर में बदलाव किया जा सकता है. इसे डेटा सोर्स बनाने या उसमें बदलाव करने के दौरान कॉन्फ़िगर किया जाता है. साथ ही, यह सिर्फ़ उन पैरामीटर के लिए लागू होता है जिन्हें कनेक्टर डेवलपर ने बदले जा सकने वाले के तौर पर तय किया है. अगर यह सेटिंग चालू की जाती है, तो रिपोर्ट एडिटर रिपोर्ट के पैरामीटर में बदलाव कर पाएंगे.

यहां दिए गए उदाहरण में, कनेक्टर में दो पैरामीटर हैं जिन्हें बदला जा सकता है: zipcode और units. डेटा सोर्स के मालिक ने सिर्फ़ रिपोर्ट में zipcode में बदलाव करने की अनुमति दी है. रिपोर्ट में, रिपोर्ट एडिटर के पास zipcode पैरामीटर की वैल्यू में बदलाव करने का विकल्प होता है.

रिपोर्ट व्यूअर को पैरामीटर वैल्यू में बदलाव करने की अनुमति दें

रिपोर्ट एडिटर यह कंट्रोल करते हैं कि रिपोर्ट व्यूअर किन पैरामीटर में बदलाव कर सकते हैं. रिपोर्ट का कोई भी व्यूअर, रिपोर्ट यूआरएल की मदद से पैरामीटर वैल्यू में बदलाव कर सकता है.

ध्यान दें: पैरामीटर में बदलाव करने की अनुमति देने के लिए, रिपोर्ट एडिटर का कंट्रोल उन पैरामीटर तक ही सीमित होता है जिन्हें डेटा सोर्स के मालिक ने अनुमति दी हो.

उदाहरण के लिए, एक ऐसा कनेक्टर बनाएं जिसमें बदले जा सकने वाले दो पैरामीटर हों: zipcode और units (पहली इमेज). अगर डेटा सोर्स के मालिक ने zipcode को रिपोर्ट में बदलने की अनुमति दी है (दूसरी इमेज), तो रिपोर्ट एडिटर के पास सिर्फ़ रिपोर्ट व्यूअर से zipcode में बदलाव करने की अनुमति देने का विकल्प होगा. रिपोर्ट व्यूअर से units पैरामीटर में बदलाव करने की अनुमति देने के लिए, रिपोर्ट एडिटर के पास ऐक्सेस या विज़िबिलिटी नहीं होगी.

पहली इमेज: कनेक्टर कॉन्फ़िगरेशन.

दूसरी इमेज: पैरामीटर मैनेज करें.

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

यूआरएल के पैरामीटर

रिपोर्ट व्यूअर को रिपोर्ट यूआरएल के ज़रिए पैरामीटर वैल्यू में बदलाव करने की अनुमति देने के लिए:

1. रिपोर्ट में बदलाव करें.
2. संसाधन -> रिपोर्ट के यूआरएल पैरामीटर मैनेज करें चुनें.
3. रिपोर्ट यूआरएल में पैरामीटर वैल्यू में बदलाव करने की अनुमति देने या न देने के लिए, रिपोर्ट यूआरएल में बदलाव करने की अनुमति दें चेकबॉक्स का इस्तेमाल करें. बदलाव अपने-आप सेव हो जाते हैं.
4. ऊपर दाईं ओर मौजूद, बंद करें पर क्लिक करें.

पैरामीटर वैल्यू में बदलाव करना

रिपोर्ट एडिटर, रिपोर्ट प्रॉपर्टी पैनल का इस्तेमाल करके पैरामीटर वैल्यू में बदलाव कर सकते हैं. जबकि रिपोर्ट व्यूअर, रिपोर्ट यूआरएल से पैरामीटर वैल्यू में बदलाव कर सकते हैं.

रिपोर्ट प्रॉपर्टी पैनल

रिपोर्ट एडिटर, पैरामीटर वैल्यू को कैसे सेट कर सकता है, यह जानने के लिए रिपोर्ट के पैरामीटर में बदलाव करना लेख पढ़ें.

रिपोर्ट यूआरएल पैरामीटर

जिन पैरामीटर को रिपोर्ट यूआरएल में बदलाव करने की अनुमति है उनके लिए वैल्यू को, यूआरएल कोड में बदले गए JSON ऑब्जेक्ट के ज़रिए सेट किया जा सकता है. यह ऑब्जेक्ट, व्यू मोड में रिपोर्ट यूआरएल के साथ जोड़ा जाता है.

यूआरएल कॉन्फ़िगरेशन बनाने के लिए:

1. पैरामीटर के नाम इकट्ठा करें

   1. रिपोर्ट में बदलाव करें.
   2. संसाधन -> रिपोर्ट के यूआरएल पैरामीटर मैनेज करें चुनें.
   3. उन पैरामीटर के नाम पर ध्यान दें जिन्हें रिपोर्ट के यूआरएल की मदद से सेट करना है.

   उदाहरण के लिए, नीचे दी गई इमेज में पैरामीटर का नाम ds0.zipcode है.

   

2. पैरामीटर ऑब्जेक्ट बनाना

   पैरामीटर, JSON ऑब्जेक्ट के ज़रिए तय किए जाते हैं. पैरामीटर वैल्यू के लिए कोड, पैरामीटर के नाम होते हैं.

   {
     "parameterName": parameterValue
   }
   

   पैरामीटर वैल्यू के टाइप, STRING, NUMBER या BOOLEAN में से कोई एक होते हैं. कई वैल्यू स्वीकार करने वाले पैरामीटर (जैसे, एक से ज़्यादा विकल्प चुनने वाले ड्रॉपडाउन) के लिए, वैल्यू की कैटगरी का इस्तेमाल करें.

   उदाहरण के लिए, अगर पैरामीटर का नाम ds0.zipcode है, तो पिन कोड को 94094 पर सेट करने के लिए, JSON इस तरह से दिखेगा:

   {
     "ds0.zipcode": "94094"
   }
   

3. यूआरएल, पैरामीटर ऑब्जेक्ट को कोड में बदलता है

   पैरामीटर ऑब्जेक्ट बनाने के बाद, उसे स्ट्रिंग में बदलने के लिए JSON.stringify() का इस्तेमाल करें. इसके बाद, यूआरएल को कोड में बदलने के लिए [encodeuricomponent] का इस्तेमाल करें.

   var params = {
     "ds0.zipcode": "94094"
   };
   var paramsAsString = JSON.stringify(params);
   var encodedParams = encodeURIComponent(paramsAsString)
   

   इसकी वजह से, कोड में बदली गई यह स्ट्रिंग मिलती है:

   "%7B%22ds0.zipcode%22%3A%2294094%22%7D"
   

4. रिपोर्ट का यूआरएल बनाना

   यूआरएल कोड में बदला गया पैरामीटर ऑब्जेक्ट पाने के बाद, उसे params क्वेरी पैरामीटर का इस्तेमाल करके, रिपोर्ट व्यू के यूआरएल में जोड़ें.

   https://lookerstudio.google.com/reporting/REPORT_ID/page/PAGE_ID?params=%7B%22ds0.zipcode%22%3A%2294094%22%7D

   पक्का करें कि आपने REPORT_ID और PAGE_ID को अपनी रिपोर्ट और पेज की वैल्यू से बदल दिया हो.

5. यूआरएल का इस्तेमाल करना

   रिपोर्ट यूआरएल, पैरामीटर इनहेरिटेंस के आधार पर JSON पैरामीटर ऑब्जेक्ट में बताए गए पैरामीटर को बदल देगा.

पैरामीटर ऑब्जेक्ट का उदाहरण

नीचे दिए गए पैरामीटर ऑब्जेक्ट में, एक से ज़्यादा पैरामीटर सेट करने का तरीका बताया गया है. इससे, अलग-अलग इनपुट टाइप के लिए पैरामीटर वैल्यू सेट करने का तरीका भी पता चलता है.

• ds0.includeToday, चेकबॉक्स इनपुट है
• ds0.units सिर्फ़ एक इनपुट है
• ds1.countries, कई विकल्पों वाला इनपुट है
• ds1.labelName एक टेक्स्ट इनपुट है.

  {
    "ds0.includeToday": true,
    "ds0.units": "Metric",
    "ds1.countries": ["Canada", "Mexico"],
    "ds1.labelName": "Population"
  }

पैरामीटर इनहेरिटेंस

पैरामीटर के लिए इस्तेमाल की जाने वाली वैल्यू, प्राथमिकता के हिसाब से तय की जाती है. यह इस बात पर निर्भर करता है कि पैरामीटर कहां सेट किया गया है. ज़्यादा प्राथमिकता वाली जगहों पर सेट किए गए पैरामीटर, कम प्राथमिकता वाली जगहों पर सेट किए गए पैरामीटर को बदल देते हैं. प्राथमिकता का क्रम (कम से ज़्यादा) है:

1. डेटा सोर्स (डिफ़ॉल्ट)
2. यूआरएल की शिकायत करें
3. डेटा सोर्स के पैरामीटर इनहेरिटेंस नियमों के मुताबिक रिपोर्ट प्रॉपर्टी पैनल.