مَعلمات الإعداد التي يمكن إلغاؤها

توفّر مَعلمات الضبط التي يمكن إلغاؤها خيارًا للسماح لمحرِّري التقارير بتعديل القيم التلقائية في مصدر البيانات. كما أن تحديد معلمات التهيئة على أنها قابلة للتجاوز يجعل مصدر البيانات أكثر مرونة، ويمنح المستخدمين طريقة لإنشاء نماذج تقارير قابلة للتهيئة بواسطة المستخدم.

على سبيل المثال، يمكن أن يتضمن الموصِّل الذي يوفر بيانات الطقس مَعلمة موقع جغرافي تسمح للمشاهدين بطلب تقرير عن الطقس من لغة مختلفة عن اللغة التلقائية.

يوضّح هذا المستند كيفية تحديد المَعلمات التي يمكن إلغاؤها، وتفعيل إمكانية التعديل، وطريقة تعديل قيم المَعلمات من قِبل مستخدمي التقرير. للاطّلاع على مزيد من المعلومات عن كيفية استخدام المَعلمات في Looker Studio، يُرجى الاطّلاع على مَعلمات مصدر البيانات.

الأدوار

أدوار المستخدم المشار إليها في المستند:

Role التعريف
مطوّر أدوات الربط مستخدم أنشأ أداة ربط للمنتدى.
مالك مصدر البيانات مستخدم أنشأ مصدر بيانات ويمتلكه.
محرِّر التقارير مستخدم لديه إذن بالوصول إلى تقرير في وضع التعديل.
الإبلاغ عن مستخدم مستخدِم لديه إذن وصول إلى تقرير معيّن في وضع العرض.

تحديد المعلمات التي يمكن إلغاؤها

يُعرِّف مطوّر أدوات الربط معلَمات الضبط في دالة getConfig() لموصِّل المنتديات. لتحديد معلمة إعداد على أنها يمكن تجاوزها، يستدعي الموصل setAllowOverride(true).

يحدد المثال التالي معلمتين يمكن تجاوزهما: 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();
}

متى يجب تجنُّب تحديد مَعلمة على أنّها قابلة للإلغاء

ننصحك بالتعرُّف على طريقة عمل الموصلات ومصادر البيانات والتقارير استنادًا إلى بعضها البعض من خلال مراجعة كيفية ربط Looker Studio ببياناتك.

تجنَّب تعريف مَعلمة على أنّها قابلة للإلغاء في الحالات التالية:

  1. عندما تؤثر قيمة معلَمة في المخطط.
    • إذا غيّر المستخدِم قيمة معلَمة وكان مخطط البيانات الجديدة المعروضة يختلف عن المخطَّط المحدّد في مصدر البيانات، يمكن أن يتوقّف أي تقرير يعتمد على مصدر البيانات بسبب عدم توفّر الحقول.
  2. إذا كانت قيمة المَعلمة تتحكّم في البيانات الحسّاسة. مثلاً، اختيار الحساب
    • لا تحدِّد معلَمة على أنّها قابلة للإلغاء إذا أردت منع عرض البيانات الحساسة أو مشاركتها عن غير قصد.

تفعيل المعلمات لمستخدمي التقارير

يتحكّم مالكو مصدر البيانات في المَعلمات التي يمكن إلغاؤها والتي يسمح محرِّرو التقارير بتعديلها. بالمثل، يتحكم محرِّرو التقارير في المَعلمات التي يمكن لمشاهدي التقارير تعديلها.

السماح لمحرّري التقارير بتعديل قيم المَعلمات

يتحكّم مالك مصدر البيانات في المَعلمات المسموح بتعديلها في التقارير. يتم ضبط هذه الإعدادات أثناء إنشاء مصدر بيانات أو تعديله، ولا تنطبق إلا على المعلَمات التي تم تحديدها على أنّها يمكن تجاوزها من قِبل مطوّر الموصّل. وفي حال تفعيل هذه السياسة، سيتمكّن محرِّرو التقارير من تعديل المَعلمات في التقرير.

في المثال التالي، يحتوي الموصّل على مَعلمتَين يمكن إلغاءهما: zipcode وunits. سمح مالك مصدر البيانات بتعديل zipcode فقط في التقارير. في التقرير، يتضمّن محرِّر التقارير خيار تعديل قيمة المَعلمة zipcode.

تفعيل خيار الإلغاء

السماح لمشاهدي التقارير بتعديل قيم المَعلمات

يتحكّم محرِّرو التقارير في المَعلمات التي يمكن لمشاهدي التقارير تعديلها. ويمكن بعد ذلك تعديل قيم المَعلمات من خلال عنوان URL للتقرير من خلال أيّ مشاهد للتقرير.

على سبيل المثال، ضع في الاعتبار موصل يحتوي على مَعلمتين تم تعريفهما على أنّهما قابلان للإلغاء: zipcode وunits (الشكل 1). في حال سمح مالك مصدر البيانات بتعديل zipcode في التقارير (الشكل 2)، لن يكون بإمكان محرّري التقارير سوى السماح بتعديل zipcode من قِبل مشاهدي التقارير. لن يملك محرّر التقارير إذن الوصول أو إذن الوصول للسماح بتعديل المَعلمة units من قِبل مشاهدي التقارير.

تم تفعيل معلمة الرمز البريدي
الشكل 1: ضبط الموصّل.

يمكن تعديل مَعلمة الرمز البريدي فقط.
الشكل 2: إدارة المَعلمات.

معلمات عنوان URL

للسماح لمشاهدي التقارير بتعديل قيم المَعلمات من خلال عنوان URL للتقرير:

  1. عدِّل التقرير.
  2. اختَر المورد -> إدارة معلَمات عناوين URL للتقرير.
  3. استخدم مربعات الاختيار السماح بالتعديل في عنوان URL للتقرير للسماح بتعديل قيم المعلمات في عنوان URL للتقرير أو عدم السماح به. يتم حفظ التغييرات تلقائيًا.
  4. انقر على إغلاق في أعلى يسار الصفحة.

تعديل قيم المَعلمات

يمكن لمحرري التقارير تعديل قيم المَعلمات باستخدام لوحة "خصائص التقرير"، بينما يمكن لمشاهدي التقارير تعديل قيم المَعلمات من خلال عنوان 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، لضبط الرمز البريدي على 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، ألحِقه بعنوان 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

    سيلغي عنوان 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. لوحة خصائص التقرير، وفقًا لقواعد اكتساب المعلَمات لمصدر البيانات.