פרמטרים של config שניתנים לשינוי

פרמטרים של הגדרה שניתנים לשינוי מאפשרים לעורכי הדוחות לשנות ערכי ברירת מחדל במקור נתונים. אם מגדירים פרמטרים של הגדרה כניתן לביטול, מקור נתונים יכול להיות גמיש יותר, ומשתמשים יכולים ליצור תבניות של דוחות שהמשתמשים יכולים להגדיר.

לדוגמה, מחבר שמספק נתוני מזג אוויר יכול לכלול פרמטר מיקום, שמאפשר לצופים בדוח לבקש דוח מזג אוויר ממקום ששונה מברירת המחדל.

במאמר הזה מוסבר איך מגדירים פרמטרים שניתן לבטל, ואיך הם מאפשרים שינוי, ואיך המשתמשים בדוח יכולים לשנות ערכי פרמטרים. מידע נוסף על אופן השימוש בפרמטרים ב-Looker Studio מופיע במאמר פרמטרים של מקורות נתונים.

תפקידים

תפקידי המשתמשים שמוזכרים במסמך:

תפקיד הגדרה
מפתח מחברים משתמש שיצר מחבר קהילה.
הבעלים של מקור הנתונים משתמש שיצר מקור נתונים ומחזיק בבעלותו.
כלי הדוחות משתמש עם גישה למצב עריכה של דוח.
דיווח על צופה משתמש שיש לו גישה למצב תצוגה בדוח.

הגדרת פרמטרים שניתן לבטל

מפתח המחבר מגדיר פרמטרים של הגדרה בפונקציה getConfig() של מחבר קהילות. כדי להגדיר פרמטר config כניתן לביטול, המחבר קורא ל-setAllowOverride(true).

בדוגמה הבאה מוגדרים 2 פרמטרים שניתן לבטל: 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. אם ערך פרמטר שולט במידע אישי רגיש. למשל, בחירת חשבון.
    • לא להגדיר פרמטר כניתן לביטול אם רוצים למנוע הצגה או שיתוף של מידע אישי רגיש ללא כוונה.

הפעלת פרמטרים למשתמשים בדוח

בעלים של מקורות נתונים קובעים אילו פרמטרים שניתנים לשינוי על ידי עורכי הדוחות יכולים לשנות אותם. באופן דומה, עורכי הדוחות קובעים אילו פרמטרים צופים בדוחות יכולים לשנות.

לאפשר לעורכי הדוחות לשנות ערכי פרמטרים

הבעלים של מקור הנתונים קובע אילו פרמטרים אפשר לשנות בדוחות. המדיניות הזו מוגדרת במהלך היצירה או העריכה של מקור נתונים, והיא חלה רק על פרמטרים שמפתח המחבר הוגדר כניתן לשינוי שלהם. אם ההגדרה הזו מופעלת, לעורכי הדוחות תהיה אפשרות לשנות פרמטרים בדוח.

בדוגמה הבאה, למחבר יש 2 פרמטרים שמוגדרים כפרמטרים שניתנים להחלפה: zipcode ו-units. הבעלים של מקור הנתונים אפשרו לשנות רק את zipcode בדוחות. בכלי הדוחות בדוח יש אפשרות לשנות את ערך הפרמטר zipcode.

הפעלת אפשרות הביטול

צופים בדוחות יוכלו לשנות ערכי פרמטרים

עורכי הדוחות קובעים אילו פרמטרים הצופים בדוחות יכולים לשנות. לאחר מכן, כל צופה בדוח יכול לשנות את ערכי הפרמטרים דרך כתובת ה-URL של הדוח.

לדוגמה, נניח שיש מחבר עם 2 פרמטרים שמוגדרים כפרמטרים שניתנים להחלפה: zipcode ו-units (איור 1). אם הבעלים של מקור הנתונים התיר לשנות את zipcode בדוחות (איור 2), עורכי הדוחות יוכלו רק לאפשר לצופים בדיווח לשנות את zipcode. לעורך הדוחות לא תהיה גישה או חשיפה שיאפשרו לצופים לשנות את הפרמטר units.

פרמטר המיקוד מופעל
איור 1: הגדרת המחבר.

אפשר לשנות רק את הפרמטר 'מיקוד'
איור 2: ניהול פרמטרים.

פרמטרים של כתובת אתר

כדי לאפשר לצופים בדוחות לערוך את ערכי הפרמטרים דרך כתובת ה-URL של הדוח:

  1. עורכים את הדוח.
  2. בוחרים באפשרות משאב -> ניהול פרמטרים של כתובות URL של דוח.
  3. עליכם להשתמש בתיבות הסימון Allow to be changed in the report URL (אישור לשינוי בכתובת ה-URL של הדוח) כדי לאפשר או לדחות שינוי של ערכי פרמטרים בכתובת ה-URL של הדוח. השינויים נשמרים אוטומטית.
  4. לוחצים על סגירה בפינה השמאלית העליונה.

שינוי ערכי פרמטרים

עורכי הדוחות יכולים לשנות את ערכי הפרמטרים באמצעות חלונית מאפייני הדוח, וצופים בדוחות יכולים לשנות את ערכי הפרמטרים דרך כתובת ה-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. החלונית של מאפייני הדוח, בהתאם לכללי הירושה של פרמטרים במקור הנתונים.