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

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

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

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

ভূমিকা

নথি জুড়ে ব্যবহারকারীর ভূমিকা উল্লেখ করা হয়েছে:

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

ওভাররিডেবল প্যারামিটার সংজ্ঞায়িত করা

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

দ্রষ্টব্য: পরামিতিগুলিকে একটি BigQuery কাস্টম কোয়েরির অংশ হিসাবেও সংজ্ঞায়িত করা যেতে পারে।

নিম্নলিখিত উদাহরণটি 2টি ওভাররিডেবল প্যারামিটার সংজ্ঞায়িত করে: zipcode এবং units এবং 1টি প্যারামিটার যা ওভাররাইডযোগ্য নয়: 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. যদি একটি প্যারামিটার মান সংবেদনশীল ডেটা নিয়ন্ত্রণ করে। যেমন অ্যাকাউন্ট নির্বাচন।
   • আপনি যদি সংবেদনশীল ডেটা অনিচ্ছাকৃত দেখা বা ভাগ করে নেওয়া রোধ করতে চান তবে একটি প্যারামিটারকে ওভাররিডেবল হিসাবে সংজ্ঞায়িত করবেন না।

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

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

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

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

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

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

রিপোর্ট এডিটররা নিয়ন্ত্রণ করে যে কোন প্যারামিটারগুলি রিপোর্ট দর্শকদের দ্বারা সংশোধন করা যেতে পারে৷ পরামিতি মান তারপর রিপোর্ট URL এর মাধ্যমে রিপোর্টের যেকোনো দর্শক দ্বারা সংশোধন করা যেতে পারে।

দ্রষ্টব্য: প্যারামিটারগুলিকে সংশোধন করার অনুমতি দেওয়ার উপর একটি রিপোর্ট সম্পাদকের নিয়ন্ত্রণ ডেটা উৎসের মালিকের দ্বারা অনুমোদিত প্যারামিটারগুলির মধ্যে সীমাবদ্ধ৷

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

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

চিত্র 2 : পরামিতি পরিচালনা করুন।

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

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

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

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

পরামিতি মান পরিবর্তন করা হচ্ছে

রিপোর্ট এডিটররা রিপোর্ট প্রপার্টি প্যানেল ব্যবহার করে প্যারামিটার মান পরিবর্তন করতে পারে যখন রিপোর্ট ভিউয়াররা রিপোর্ট URL এর মাধ্যমে প্যারামিটার মান পরিবর্তন করতে পারে।

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

একটি প্রতিবেদন সম্পাদক কীভাবে প্যারামিটারের মান সেট করতে পারে তা জানতে, একটি প্রতিবেদনে পরামিতি সংশোধন করুন দেখুন।

URL প্যারামিটার রিপোর্ট করুন

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

একটি URL কনফিগারেশন তৈরি করতে:

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 তৈরি করুন

   একবার আপনার কাছে 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. ইউআরএল ব্যবহার করুন

   রিপোর্ট URL প্যারামিটার উত্তরাধিকারের উপর ভিত্তি করে JSON প্যারামিটার অবজেক্টে সংজ্ঞায়িত প্যারামিটারগুলিকে ওভাররাইড করবে।

পরামিতি বস্তুর উদাহরণ

নিম্নলিখিত প্যারামিটার অবজেক্ট দেখায় কিভাবে একাধিক প্যারামিটার সেট করতে হয়। এটি বিভিন্ন ইনপুট প্রকারের জন্য প্যারামিটার মান নির্ধারণের চিত্রও তুলে ধরে।

• ds0.includeToday একটি চেকবক্স ইনপুট
• ds0.units হল একটি সিঙ্গেল সিলেক্ট ইনপুট
• ds1.countries হল একটি মাল্টি-সিলেক্ট ইনপুট
• ds1.labelName একটি টেক্সট ইনপুট।

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

পরামিতি উত্তরাধিকার

প্যারামিটারের জন্য ব্যবহৃত মানটি যেখানে প্যারামিটার সেট করা হয়েছে তার উপর ভিত্তি করে অগ্রাধিকারের একটি ক্রম অনুসরণ করে। উচ্চ অগ্রাধিকার অবস্থানে সেট করা পরামিতিগুলি নিম্ন অগ্রাধিকার অবস্থানে সেট করা প্যারামিটারগুলিকে ওভাররাইড করে। অগ্রাধিকারের ক্রম (সর্বনিম্ন থেকে সর্বোচ্চ) হল:

1. ডেটা উৎস (ডিফল্ট)
2. রিপোর্ট URL
3. তথ্য উৎস প্যারামিটার উত্তরাধিকার নিয়ম অনুসরণ করে বৈশিষ্ট্য প্যানেল রিপোর্ট করুন।