פרמטרים

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

איך פרמטרים פועלים

פרמטרים מתנהגים כמו משתנים בשפת תכנות. הפרמטרים משמשים לשלוש מטרות עיקריות:

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

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

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

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

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

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

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

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

יצירת פרמטר

אפשר ליצור פרמטרים במקומות הבאים:

• מקור נתונים
• המחבר של BigQuery

יצירת פרמטר במקור נתונים

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

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

יצירת פרמטר במחבר BigQuery

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

פרמטרים ופלאגינים לחיבור למקור נתונים

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

1. עורכים את מקור הנתונים.
2. בפינה הימנית העליונה, לוחצים על עריכת החיבור.
3. אם המחבר מספק פרמטרים שניתנים לעריכה, הם מופיעים בתחתית הדף. מחברים שמאפשרים לכם להגדיר פרמטרים מותאמים אישית יכללו הוראות בדף.
4. משתמשים בתיבות הסימון Allow <parameter name> to be modified in reports (אפשרות לשנות את [שם הפרמטר] בדוחות) כדי לאפשר או לא לאפשר עריכה של הפרמטר בדוחות.
5. בפינה השמאלית העליונה, לוחצים על חיבור מחדש.

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

עריכה של פרמטר קיים

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

1. עורכים את מקור הנתונים שמכיל את הפרמטר.
2. מחפשים את הפרמטר ברשימת השדות.
3. לוחצים על הסמל @ משמאל לשם הפרמטר.
4. מבצעים את השינויים הרצויים ולוחצים על שמירה בפינה השמאלית התחתונה.

הגדרת פרמטר

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

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

‫Parameter ID (מזהה פרמטר): מוגדר כברירת מחדל. מזהה הפרמטר משמש באופן פנימי את Data Studio כדי לזהות את הפרמטר. הצופים בדוח לא רואים את זה.

חשוב: שינוי מזהה הפרמטר ישבור רכיבים ושדות מחושבים שכוללים את הפרמטר.

סוג הנתונים : פרמטרים יכולים לאחסן טקסט, מספרים או ערכים בוליאניים (true/false).

ערכים מותרים : מציינים את הערכים שהמשתמש יכול להזין.

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

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

ערך ברירת מחדל : מציינים ערך התחלתי לפרמטר.

הגדרת ערכי פרמטרים

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

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

הגדרת ערך ברירת מחדל לפרמטר

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

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

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

1. עריכת הדוח
2. למעלה, לוחצים על הוספת רכיב אינטראקטיבי.
3. בוחרים את סוג הפקד שרוצים להוסיף.
4. בחלונית מאפיינים, בוחרים בכרטיסייה הגדרה.
5. מוסיפים את הפרמטר לשדה הבקרה.

מידע נוסף על אמצעי בקרה

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

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

1. עריכת הדוח
2. בוחרים רכיב שמבוסס על מקור נתונים שכולל פרמטרים.
3. בחלק התחתון של הכרטיסייה DATA (נתונים) של הרכיב, עורכים את ערכי ברירת המחדל של הפרמטרים.

אפשר גם לערוך פרמטרים ברמת הדוח וברמת הדף:

1. עריכת הדוח
2. בוחרים באפשרות קובץ > הגדרות הדוח או דף > הגדרות הדף הנוכחי.
3. עורכים את ערכי הפרמטרים.

ירושה של פרמטרים

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

1. מקור נתונים (ברירת מחדל)
2. דיווח
3. דף
4. קבוצה
5. תרשים או אמצעי בקרה ספציפיים

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

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

הפרמטרים של דוח Data Studio והערכים התואמים שלהם מועברים כמחרוזות JSON מקודדות בכתובת URL, שמצורפות לכתובת ה-URL של הדוח באמצעות פרמטר השאילתה 'params'.

מידע נוסף זמין במדריך למפתחים.

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

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

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

1. עריכת הדוח
2. בוחרים באפשרות משאב > ניהול משתנים (פרמטרים).
3. בעמודה אפשר לשנות בכתובת ה-URL של הדוח, מסמנים את הפרמטרים שרוצים לאפשר.

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

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

שימוש בפרמטרים

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

שימוש בפרמטר בשדה מחושב

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

שדה מחושב עם פרמטר. אפשר ללחוץ כדי להרחיב.

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

קודם יוצרים את הפרמטר שיכיל את מכפיל התחזית:

1. נכנסים ל-Data Studio.
2. עורכים את מקור הנתונים.
3. בפינה השמאלית העליונה, לוחצים על הוספת פרמטר.
4. נותנים שם לפרמטר (לדוגמה, 'מכפיל תחזית').
5. מגדירים את סוג הנתונים למספר.
6. כדי לפשט את התהליך, משאירים את האפשרות ערכים מותרים מוגדרת לכל ערך.
   אתם יכולים להשתמש באפשרויות האחרות כדי לאפשר למשתמש לבחור מתוך רשימת ערכים, או להגביל את הערך שהוא יכול להזין לטווח מסוים.
7. מגדירים את ערך ברירת המחדל ל-1.
8. לוחצים על Save.
9. כדי לחזור לרשימת השדות של מקור הנתונים, לוחצים על כל השדות בצד ימין.

לאחר מכן יוצרים את השדה המחושב:

1. בפינה השמאלית העליונה, לוחצים על הוספת שדה .
2. נותנים שם לשדה (לדוגמה, 'תחזית מכירות עם פרמטר').
3. בנוסחה, מכפילים את השדה 'מכירות' ממקור הנתונים בפרמטר Forecast multiplier. לדוגמה, אם במקור הנתונים יש שדה בשם הכנסה, מזינים את הערך הבא:
   Revenue * Forecast multiplier
4. לוחצים על Save.

לאחר מכן, מוסיפים רכיב בקרה כדי לאסוף את הקלט של המשתמש:

1. עריכה או יצירה של דוח.
2. אם צריך, מוסיפים את מקור הנתונים לדוח.
3. למעלה, לוחצים על /> הוספת רכיב אינטראקטיבי .
4. בוחרים את אמצעי הבקרה תיבת קלט.
   הפקד של תיבת הקלט מאפשר להקליד ערכי פרמטרים ישירות. סוגים אחרים של אמצעי בקרה מאפשרים לבחור מתוך רשימה, להשתמש בסרגל הזזה או להחליף ערכים בוליאניים באמצעות תיבת סימון.
5. בצד שמאל, בקטע מאפייני נתונים, מוסיפים את הפרמטר Forecast multiplier שיצרתם קודם.

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

1. למעלה, לוחצים על הוספת תרשים.
2. כדי לפשט את התהליך, בוחרים כרטיס מידע.
3. בצד שמאל, בקטע מאפייני נתונים, מוסיפים את השדה המחושב Sales forecast with parameter כמדד.

עכשיו, נסו בעצמכם:

1. בפינה השמאלית העליונה, לוחצים על הצגה.
2. מזינים מספר באמצעי הבקרה Forecast multiplier (מכפיל התחזית) ואז מקישים על Enter.
3. הערך בכרטיס המידע ישתנה בהתאם למכפלה של הערך שתזינו.

שימוש בפרמטר בתצוגה חזותית

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

הצגה או הסתרה של פרמטרים בדוחות

אפשר להציג או להסתיר פרמטרים שיצרתם במקור נתונים:

1. עורכים את מקור הנתונים.
2. מאתרים את הפרמטר.
3. משמאל לפרמטר, לוחצים על סמל האפשרויות .
4. לוחצים על הצגה (אם הפרמטר מוסתר כרגע) או על הסתרה (אם הפרמטר מוצג כרגע).

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

העתקה של רכיב עם פרמטרים

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

תיקון פרמטרים לא תקינים

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

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

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

מקור מידע שקשור לנושא

מידע על אמצעי בקרה