ওভাররিডেবল কনফিগার প্যারামিটার

ওভাররাইডযোগ্য কনফিগারেশন প্যারামিটার রিপোর্ট এডিটরদের একটি ডেটা সোর্সের ডিফল্ট মান পরিবর্তন করার সুযোগ দেয়। কনফিগারেশন প্যারামিটারকে ওভাররাইডযোগ্য হিসেবে সংজ্ঞায়িত করলে একটি ডেটা সোর্স আরও নমনীয় হয় এবং ব্যবহারকারীদের নিজস্ব কনফিগারযোগ্য রিপোর্ট টেমপ্লেট তৈরি করার সুযোগ দেয়।

উদাহরণস্বরূপ, আবহাওয়ার ডেটা প্রদানকারী একটি কানেক্টরে একটি লোকেশন প্যারামিটার অন্তর্ভুক্ত থাকতে পারে, যা রিপোর্ট দর্শকদের ডিফল্ট লোকাল থেকে ভিন্ন কোনো লোকাল থেকে আবহাওয়ার রিপোর্টের অনুরোধ করার সুযোগ দেয়।

এই ডকুমেন্টে বর্ণনা করা হয়েছে কীভাবে ওভাররাইডযোগ্য প্যারামিটার সংজ্ঞায়িত করা হয়, পরিবর্তনের জন্য সক্রিয় করা হয় এবং রিপোর্ট ব্যবহারকারীরা কীভাবে প্যারামিটারের মান পরিবর্তন করতে পারেন। ডেটা স্টুডিওতে প্যারামিটার কীভাবে ব্যবহৃত হয় সে সম্পর্কে আরও জানতে ডেটা সোর্স প্যারামিটার দেখুন।

ভূমিকা

এই নথি জুড়ে উল্লেখিত ব্যবহারকারীর ভূমিকাগুলো হলো:

ভূমিকা	সংজ্ঞা
কানেক্টর ডেভেলপার	একজন ব্যবহারকারী যিনি একটি কমিউনিটি কানেক্টর তৈরি করেছেন ।
ডেটা উৎসের মালিক	একজন ব্যবহারকারী যিনি একটি ডেটা সোর্স তৈরি করেছেন এবং যার মালিক ।
প্রতিবেদন সম্পাদক	একজন ব্যবহারকারী যার একটি রিপোর্ট সম্পাদনা করার অ্যাক্সেস আছে ।
রিপোর্ট ভিউয়ার	একজন ব্যবহারকারীর একটি রিপোর্ট দেখার মোডে অ্যাক্সেস আছে ।

ওভাররাইডযোগ্য প্যারামিটার সংজ্ঞায়িত করা

কানেক্টর ডেভেলপার একটি কমিউনিটি কানেক্টরের 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() কলটি বাদ দিতে পারেন।

কখন একটি প্যারামিটারকে ওভাররাইডযোগ্য হিসেবে সংজ্ঞায়িত করা এড়িয়ে চলতে হবে

[ডেটা স্টুডিও কীভাবে আপনার ডেটার সাথে সংযোগ স্থাপন করে] পর্যালোচনা করে কানেক্টর, ডেটা সোর্স এবং রিপোর্টগুলো একে অপরের সাথে কীভাবে কাজ করে তা শিখে নেওয়ার পরামর্শ দেওয়া হচ্ছে।

নিম্নলিখিত ক্ষেত্রগুলিতে কোনো প্যারামিটারকে ওভাররাইডযোগ্য হিসেবে সংজ্ঞায়িত করা থেকে বিরত থাকুন:

1. যখন কোনো প্যারামিটারের মান স্কিমাকে প্রভাবিত করে।
   • যদি কোনো ব্যবহারকারী কোনো প্যারামিটারের মান পরিবর্তন করেন এবং ফেরত আসা নতুন ডেটার স্কিমা ডেটা সোর্সে সংজ্ঞায়িত স্কিমা থেকে ভিন্ন হয়, তাহলে ফিল্ড অনুপস্থিত থাকার কারণে ডেটা সোর্সের উপর নির্ভরশীল যেকোনো রিপোর্ট অকার্যকর হয়ে যেতে পারে।
2. যদি কোনো প্যারামিটার মান সংবেদনশীল তথ্য নিয়ন্ত্রণ করে। যেমন, অ্যাকাউন্ট নির্বাচন।
   • সংবেদনশীল তথ্যের অনিচ্ছাকৃত দেখা বা শেয়ার হওয়া আটকাতে চাইলে কোনো প্যারামিটারকে ওভাররাইডযোগ্য হিসেবে সংজ্ঞায়িত করবেন না।

রিপোর্ট ব্যবহারকারীদের জন্য প্যারামিটার সক্রিয় করা

ডেটা সোর্সের মালিকরা নিয়ন্ত্রণ করেন যে রিপোর্ট এডিটররা কোন ওভাররাইডযোগ্য প্যারামিটারগুলো পরিবর্তন করতে পারবেন। একইভাবে, রিপোর্ট এডিটররা নিয়ন্ত্রণ করেন যে রিপোর্ট ভিউয়াররা কোন প্যারামিটারগুলো পরিবর্তন করতে পারবেন।

রিপোর্ট সম্পাদকদের প্যারামিটার মান পরিবর্তন করার অনুমতি দিন।

ডেটা সোর্সের মালিক নিয়ন্ত্রণ করেন যে রিপোর্টে কোন প্যারামিটারগুলো পরিবর্তন করার অনুমতি দেওয়া হবে। এটি একটি ডেটা সোর্স তৈরি বা সম্পাদনা করার সময় কনফিগার করা হয় এবং এটি শুধুমাত্র সেইসব প্যারামিটারের ক্ষেত্রে প্রযোজ্য যেগুলোকে কানেক্টর ডেভেলপার দ্বারা ওভাররাইডযোগ্য হিসেবে সংজ্ঞায়িত করা হয়েছে। যদি এটি সক্রিয় করা থাকে, তাহলে রিপোর্ট সম্পাদকরা একটি রিপোর্টের প্যারামিটারগুলো পরিবর্তন করতে পারবেন।

নিম্নলিখিত উদাহরণে, একটি কানেক্টরের দুটি প্যারামিটার ওভাররাইডযোগ্য হিসাবে সংজ্ঞায়িত করা আছে: zipcode এবং units । ডেটা সোর্সের মালিক রিপোর্টে শুধুমাত্র zipcode পরিবর্তন করার অনুমতি দিয়েছেন। রিপোর্টে, রিপোর্ট এডিটরের কাছে zipcode প্যারামিটারের মান পরিবর্তন করার বিকল্প রয়েছে।

রিপোর্ট দর্শকদের প্যারামিটার মান পরিবর্তন করার অনুমতি দিন।

রিপোর্ট সম্পাদকরা নিয়ন্ত্রণ করেন যে রিপোর্ট দর্শকরা কোন প্যারামিটারগুলো পরিবর্তন করতে পারবে। এরপর রিপোর্টের যেকোনো দর্শক রিপোর্ট ইউআরএল-এর মাধ্যমে প্যারামিটারগুলোর মান পরিবর্তন করতে পারে।

দ্রষ্টব্য: প্যারামিটার পরিবর্তনের অনুমতি দেওয়ার ক্ষেত্রে একজন রিপোর্ট সম্পাদকের নিয়ন্ত্রণ, ডেটা সোর্স মালিক কর্তৃক অনুমোদিত প্যারামিটারগুলোর মধ্যেই সীমাবদ্ধ।

উদাহরণস্বরূপ, এমন একটি কানেক্টরের কথা ভাবুন যেখানে zipcode এবং units (চিত্র ১) - এই দুটি প্যারামিটারকে ওভাররাইডযোগ্য হিসেবে সংজ্ঞায়িত করা হয়েছে। যদি ডেটা সোর্সের মালিক রিপোর্টে zipcode পরিবর্তন করার অনুমতি দিয়ে থাকেন (চিত্র ২), তাহলে রিপোর্ট এডিটররা শুধুমাত্র রিপোর্ট ভিউয়ারদেরকেই zipcode পরিবর্তন করার অনুমতি দিতে পারবেন। রিপোর্ট ভিউয়ারদেরকে units প্যারামিটারটি পরিবর্তন করার অনুমতি দেওয়ার মতো অ্যাক্সেস বা ক্ষমতা রিপোর্ট এডিটরের থাকবে না।

চিত্র ১ : সংযোগকারী কনফিগারেশন।

চিত্র ২ : প্যারামিটারসমূহ পরিচালনা করুন।

সতর্কীকরণ: রিপোর্ট দর্শকরা প্যারামিটার দ্বারা নিয়ন্ত্রিত যেকোনো ডেটা অ্যাক্সেস করতে পারবেন। অনিচ্ছাকৃতভাবে সংবেদনশীল ডেটা শেয়ার করা এড়াতে, কোনো প্যারামিটার পরিবর্তন করার অনুমতি দেওয়ার আগে ডেটা সোর্স এবং ডেটা সোর্স ক্রেডেনশিয়াল সঠিকভাবে কনফিগার করা আছে কিনা তা পর্যালোচনা ও নিশ্চিত করুন। যদি কোনো প্যারামিটার সংবেদনশীল ডেটাতে অ্যাক্সেস সক্ষম করে , তবে রিপোর্ট দর্শকরা যেন শুধুমাত্র তাদের নিজেদের ডেটা দেখতে পারেন তা নিশ্চিত করতে দর্শকের ক্রেডেনশিয়াল ব্যবহার করার কথা বিবেচনা করুন।

URL প্যারামিটার

রিপোর্ট দর্শকদের রিপোর্ট URL-এর মাধ্যমে প্যারামিটার মান সম্পাদনা করার অনুমতি দিতে:

1. প্রতিবেদনটি সম্পাদনা করুন।
2. রিসোর্স নির্বাচন করুন -> রিপোর্ট প্যারামিটার পরিচালনা করুন ।
3. রিপোর্ট ইউআরএল-এ প্যারামিটার মান পরিবর্তনের অনুমতি দিতে বা না দিতে, ‘রিপোর্ট ইউআরএল-এ পরিবর্তনের অনুমতি দিন’ চেকবক্সগুলো ব্যবহার করুন। পরিবর্তনগুলো স্বয়ংক্রিয়ভাবে সংরক্ষিত হয়ে যায়।
4. উপরের ডানদিকে থাকা ক্লোজ বাটনে ক্লিক করুন।

প্যারামিটার মান পরিবর্তন করা

রিপোর্ট সম্পাদকরা রিপোর্ট প্রোপার্টি প্যানেল ব্যবহার করে প্যারামিটারের মান পরিবর্তন করতে পারেন, অন্যদিকে রিপোর্ট দর্শকরা রিপোর্ট ইউআরএল-এর মাধ্যমে প্যারামিটারের মান পরিবর্তন করতে পারেন।

রিপোর্ট বৈশিষ্ট্য প্যানেল

একজন রিপোর্ট এডিটর কীভাবে প্যারামিটারের মান নির্ধারণ করতে পারেন, তা জানতে “রিপোর্টে প্যারামিটার পরিবর্তন করুন” দেখুন।

রিপোর্ট ইউআরএল প্যারামিটার

যেসব প্যারামিটার রিপোর্ট URL-এ পরিবর্তন করার অনুমতি আছে, সেগুলোর মান ভিউ মোডে রিপোর্ট URL-এর সাথে একটি URL-এনকোডেড JSON অবজেক্ট যুক্ত করে সেট করা যেতে পারে।

ইউআরএল কনফিগারেশন তৈরি করতে:

1. প্যারামিটার নাম সংগ্রহ করুন

   1. প্রতিবেদনটি সম্পাদনা করুন।
   2. রিসোর্স নির্বাচন করুন -> রিপোর্ট প্যারামিটার পরিচালনা করুন ।
   3. রিপোর্ট URL-এর মাধ্যমে আপনি যে প্যারামিটারগুলো সেট করতে চান, সেগুলোর নাম নোট করুন।

   উদাহরণস্বরূপ, নিচের চিত্রে প্যারামিটারের নাম হলো ds0.zipcode ।

   

2. প্যারামিটার অবজেক্ট তৈরি করুন

   প্যারামিটারগুলো একটি JSON অবজেক্টের মাধ্যমে সংজ্ঞায়িত করা হয়। প্যারামিটারের মানগুলোর জন্য কী-গুলো হলো প্যারামিটারের নাম।

   {
     "parameterName": parameterValue
   }
   

   প্যারামিটার ভ্যালুর টাইপগুলো হলো STRING , NUMBER বা BOOLEAN । যেসব প্যারামিটার একাধিক ভ্যালু গ্রহণ করে (যেমন মাল্টি-সিলেক্ট ড্রপডাউন), সেগুলোর জন্য ভ্যালুর একটি অ্যারে ব্যবহার করুন।

   উদাহরণস্বরূপ, যদি প্যারামিটারের নাম ds0.zipcode হয় এবং জিপ কোড 94094 এ সেট করতে হয়, তাহলে JSON-টি হবে নিম্নরূপ:

   {
     "ds0.zipcode": "94094"
   }
   

3. প্যারামিটার অবজেক্টটি URL এনকোড করুন

   প্যারামিটার অবজেক্ট তৈরি করার পর, সেটিকে স্ট্রিং-এ রূপান্তর করতে JSON.stringify() ব্যবহার করুন, তারপর URL এনকোড করতে [encodeURIComponent] ব্যবহার করুন।

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

   এর ফলে নিম্নলিখিত এনকোডেড স্ট্রিংটি পাওয়া যায়:

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

4. রিপোর্ট URL তৈরি করুন

   একবার ইউআরএল এনকোডেড প্যারামিটার অবজেক্টটি পেয়ে গেলে, 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. ডেটা সোর্স প্যারামিটার ইনহেরিটেন্স নিয়ম অনুসরণ করে রিপোর্ট প্রোপার্টিজ প্যানেল।