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

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

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

يوضّح هذا المستند كيفية تحديد المَعلمات القابلة للتجاهل وتفعيلها للتعديل، وكيف يمكن لمستخدمي التقارير تعديل قيم المَعلمات. لمزيد من المعلومات حول كيفية استخدام المَعلمات في "مركز البيانات"، راجِع مَعلمات مصدر البيانات.

الأدوار

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

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

تحديد المَعلمات القابلة للتجاهل

يحدّد مطوّر الموصّل مَعلمات الإعداد في الدالة 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();
}
.

الحالات التي يجب فيها تجنُّب تعريف مَعلمة على أنّها قابلة للتجاهل

ننصحك بالتعرّف على طريقة عمل الموصلات ومصادر البيانات والتقارير معًا من خلال مراجعة [كيفية ربط "مركز البيانات" ببياناتك].

تجنَّب تحديد مَعلمة على أنّها قابلة للتجاهل في الحالات التالية:

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

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

يتحكّم مالكو مصادر البيانات في المَعلمات القابلة للتجاهل التي يمكن أن يعدّلها محرّرو التقارير. وبالمثل، يتحكّم محرّرو التقارير في المَعلمات التي يمكن أن يعدّلها مشاهدو التقارير.

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

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

في المثال التالي، يحتوي الموصل على مَعلمتَين تم تحديدهما على أنّهما قابلتَين للتجاهل: zipcode وunits. لم يسمح مالك مصدر البيانات بتعديل سوى zipcode في التقارير. في التقرير، يتيح محرّر التقارير خيار تعديل قيمة المَعلمة zipcode.

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

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

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

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

تفعيل مَعلمة الرمز البريدي
الشكل 1: إعدادات الوصلة

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

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

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

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

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

يمكن لمحرّري التقارير تعديل قيم المَعلمات باستخدام لوحة خصائص التقرير، بينما يمكن لمشاهدِي التقارير تعديل قيم المَعلمات من خلال عنوان URL الخاص بالتقرير.

لوحة خصائص التقرير

لمعرفة كيف يمكن لمحرِّر تقارير ضبط قيم المَعلمات، اطّلِع على مقالة تعديل المَعلمات في تقرير.

مَعلمات عناوين URL الخاصة بالتقارير

بالنسبة إلى المَعلمات التي يُسمح بتعديلها في عنوان URL الخاص بالتقرير، يمكن ضبط القيم من خلال عنصر JSON بترميز عنوان URL يتم إلحاقه بعنوان URL الخاص بالتقرير في وضع العرض.

لإنشاء إعدادات عنوان URL، اتّبِع الخطوات التالية:

  1. جمع أسماء المَعلمات

    1. عدِّل التقرير.
    2. اختَر المورد -> إدارة مَعلمات التقارير.
    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. لوحة خصائص التقرير، باتّباع قواعد اكتساب إعدادات المعلَمات لمصدر البيانات