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

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

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

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

الأدوار

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

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

تحديد المعلمات القابلة للإلغاء

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