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

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

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

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

תפקידים

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

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

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

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

בדוגמה הבאה מוגדרים 2 פרמטרים שניתן לשנות: zipcode ו-units ופרמטר אחד שלא ניתן לשנות: 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 Studio מקשר לנתונים שלכם.

לא מומלץ להגדיר פרמטר כפרמטר שאפשר לשנות במקרים הבאים:

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

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

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

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

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

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

מתבצעת הפעלה של האפשרות לשינוי מברירת המחדל

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

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

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

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

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

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

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

  1. עורכים את הדוח.
  2. בוחרים באפשרות Resource -> ניהול פרמטרים של כתובות URL בדוח.
  3. השתמשו בתיבות הסימון אפשר לשנות אותן בכתובת ה-URL של הדוח כדי לאשר או למנוע שינוי של ערכי פרמטרים בכתובת ה-URL של הדוח. השינויים הם נשמר אוטומטית.
  4. לוחצים על סגירה בפינה השמאלית העליונה.

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

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

חלונית הדיווח על מאפייני הדוח

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

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

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

כך יוצרים הגדרה של כתובת URL:

  1. אוספים שמות פרמטרים

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