پارامترهای پیکربندی قابل جبران

پارامترهای پیکربندی ناپذیر گزینه ای را فراهم می کند که به ویرایشگرهای گزارش اجازه می دهد مقادیر پیش فرض را در منبع داده تغییر دهند. تعریف پارامترهای پیکربندی به‌عنوان غیرقابل جبران، منبع داده را انعطاف‌پذیرتر می‌کند و راهی برای ایجاد الگوهای گزارش قابل تنظیم توسط کاربر می‌دهد.

به عنوان مثال، اتصال دهنده ای که داده های آب و هوا را ارائه می دهد می تواند شامل یک پارامتر مکان باشد که به بینندگان گزارش اجازه می دهد گزارش آب و هوا را از محلی متفاوت از پیش فرض درخواست کنند.

این سند توضیح می‌دهد که چگونه پارامترهای قابل لغو تعریف می‌شوند، برای اصلاح فعال می‌شوند و چگونه مقادیر پارامتر را می‌توان توسط کاربران گزارش تغییر داد. برای کسب اطلاعات بیشتر در مورد نحوه استفاده از پارامترها در Looker Studio به پارامترهای منبع داده مراجعه کنید.

نقش ها

نقش های کاربری که در سراسر سند به آنها ارجاع داده شده است:

نقش تعریف
توسعه دهنده رابط کاربری که یک رابط انجمن ساخته است .
مالک منبع داده کاربری که منبع داده ایجاد کرده و مالک آن است .
ویرایشگر گزارش کاربری با حالت ویرایش به گزارش دسترسی دارد .
گزارش بیننده کاربری با حالت مشاهده به گزارش دسترسی دارد .

تعریف پارامترهای قابل جبران

توسعه دهنده کانکتور پارامترهای پیکربندی را در تابع getConfig() یک اتصال دهنده جامعه تعریف می کند. برای تعریف یک پارامتر پیکربندی به‌عنوان قابل لغو، کانکتور setAllowOverride(true) را فراخوانی می‌کند.

مثال زیر 2 پارامتر قابل لغو تعریف می کند: zipcode و units و 1 پارامتری که قابل لغو نیست: days-to-forcecast .

اسکرین شات از 2 پارامتر قابل جبران

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();
}

چه زمانی از تعریف یک پارامتر به عنوان قابل رد شدن اجتناب شود

توصیه می‌شود با بررسی نحوه اتصال استودیو Looker به داده‌های شما، یاد بگیرید که چگونه رابط‌ها، منابع داده و گزارش‌ها در ارتباط با یکدیگر کار می‌کنند.

در موارد زیر از تعریف یک پارامتر به عنوان قابل ابطال اجتناب کنید:

  1. زمانی که مقدار یک پارامتر روی طرحواره تاثیر می گذارد.
    • اگر کاربر یک مقدار پارامتر را تغییر دهد و طرح داده های جدید برگشتی با آنچه در منبع داده تعریف شده است متفاوت باشد، هر گزارش وابسته به منبع داده ممکن است به دلیل عدم وجود فیلدها خراب شود.
  2. اگر یک مقدار پارامتر داده های حساس را کنترل کند. به عنوان مثال انتخاب حساب.
    • اگر می‌خواهید از مشاهده یا اشتراک‌گذاری ناخواسته داده‌های حساس جلوگیری کنید، پارامتری را به‌عنوان قابل لغو تعریف نکنید.

فعال کردن پارامترها برای کاربران گزارش

صاحبان منبع داده کنترل می کنند که کدام پارامترهای قابل لغو مجاز به تغییر توسط ویرایشگرهای گزارش هستند. به طور مشابه، ویرایشگرهای گزارش کنترل می کنند که کدام پارامترها می توانند توسط بازدیدکنندگان گزارش تغییر کنند.

به ویرایشگرهای گزارش اجازه دهید مقادیر پارامترها را تغییر دهند

مالک منبع داده کنترل می کند که کدام پارامترها مجاز به تغییر در گزارش ها هستند. این در هنگام ایجاد یا ویرایش یک منبع داده پیکربندی می‌شود و فقط برای پارامترهایی که توسط توسعه‌دهنده Connector قابل لغو تعریف شده‌اند قابل اعمال است. اگر فعال باشد، ویرایشگرهای گزارش می توانند پارامترها را در گزارش تغییر دهند .

در مثال زیر، یک کانکتور دارای 2 پارامتر است که به‌عنوان قابل لغو تعریف شده‌اند: zipcode و units . مالک منبع داده فقط اجازه داده است که zipcode در گزارش‌ها اصلاح شود. در گزارش، ویرایشگر گزارش این گزینه را دارد که مقدار پارامتر zipcode را تغییر دهد.

فعال کردن گزینه لغو

به بازدیدکنندگان گزارش اجازه دهید مقادیر پارامترها را تغییر دهند

ویرایشگرهای گزارش کنترل می کنند که کدام پارامترها می توانند توسط بازدیدکنندگان گزارش تغییر کنند. سپس مقادیر پارامتر را می توان از طریق URL گزارش توسط هر بیننده گزارش تغییر داد.

به عنوان مثال، کانکتوری را در نظر بگیرید که دارای 2 پارامتر است که به عنوان قابل حذف تعریف شده است: zipcode و units (شکل 1). اگر مالک منبع داده اجازه داده باشد که zipcode در گزارش‌ها تغییر یابد (شکل 2)، ویرایشگرهای گزارش فقط می‌توانند اجازه دهند zipcode توسط بازدیدکنندگان گزارش اصلاح شود. ویرایشگر گزارش دسترسی یا دیدی نخواهد داشت تا اجازه دهد پارامتر units توسط بازدیدکنندگان گزارش اصلاح شود.

پارامتر کد پستی فعال شد
شکل 1 : پیکربندی رابط.

فقط پارامتر کد پستی قابل تغییر است
شکل 2 : پارامترها را مدیریت کنید.

پارامترهای URL

برای اینکه به بینندگان گزارش اجازه دهید مقادیر پارامترها را از طریق URL گزارش ویرایش کنند:

  1. گزارش را ویرایش کنید
  2. منبع -> مدیریت پارامترهای URL گزارش را انتخاب کنید.
  3. از کادرهای تأیید اجازه تغییر در URL گزارش استفاده کنید تا تغییر مقادیر پارامتر در URL گزارش مجاز یا غیرمجاز باشد. تغییرات به طور خودکار ذخیره می شوند.
  4. روی Close در بالا سمت راست کلیک کنید.

تغییر مقادیر پارامترها

ویرایشگرهای گزارش می توانند مقادیر پارامترها را با استفاده از پانل ویژگی های گزارش تغییر دهند در حالی که بینندگان گزارش می توانند مقادیر پارامتر را از طریق URL گزارش تغییر دهند.

پانل مشخصات گزارش

برای اینکه بدانید چگونه یک ویرایشگر گزارش می‌تواند مقادیر پارامتر را تنظیم کند، به اصلاح پارامترها در گزارش مراجعه کنید.

گزارش پارامترهای URL

برای پارامترهایی که مجاز به تغییر در URL گزارش هستند، مقادیر را می‌توان از طریق یک شی JSON کدگذاری شده با URL که در حالت مشاهده به URL گزارش اضافه شده است، تنظیم کرد.

برای ایجاد یک پیکربندی URL:

  1. نام پارامترها را جمع آوری کنید

    1. گزارش را ویرایش کنید
    2. منبع -> مدیریت پارامترهای URL گزارش را انتخاب کنید.
    3. به نام پارامترهایی که قصد دارید از طریق URL گزارش تنظیم کنید توجه کنید.

    به عنوان مثال، در شکل زیر نام پارامتر ds0.zipcode است.

    فعال کردن پارامترهای url

  2. شی پارامتر را ایجاد کنید

    پارامترها از طریق یک شی JSON تعریف می شوند. کلید مقادیر پارامترها نام پارامترها هستند.

    {
  "parameterName": parameterValue
}

    انواع مقدار پارامتر یکی از STRING ، NUMBER یا BOOLEAN هستند. برای پارامترهایی که چندین مقدار را می پذیرند (یعنی چند انتخاب کشویی) از آرایه ای از مقادیر استفاده کنید.

    برای مثال، اگر نام پارامتر ds0.zipcode باشد، برای تنظیم ZIP Code روی 94094 ، JSON به صورت زیر است:

    {
  "ds0.zipcode": "94094"
}

  3. URL شی پارامتر را رمزگذاری می کند

    پس از ایجاد شی پارامتر، از JSON.stringify() برای تبدیل آن به رشته استفاده کنید، سپس از [encodeURIcomponent] برای رمزگذاری URL آن استفاده کنید.

    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 به URL نمای گزارش اضافه کنید.

    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 استفاده کنید

    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. گزارش پانل ویژگی ها، با پیروی از قوانین وراثت پارامتر منبع داده.