במדריך הזה מוסבר איך משתמשים ב-Google Sheets API כדי ליצור טבלאות צירים בגיליונות אלקטרוניים, ומוסבר למה כדאי לעשות זאת.
מהי טבלת צירים?
טבלאות צירים מאפשרות לסכם נתונים בגיליון האלקטרוני, על ידי צבירת הנתונים, מיון, ספירה או חישוב הממוצע שלהם באופן אוטומטי, תוך הצגת התוצאות הסיכומיות בטבלה חדשה. טבלת צירים פועלת כסוג של שאילתה מול קבוצת נתוני מקור. נתוני המקור האלה נמצאים במקום אחר בגיליון האלקטרוני, וטבלת הצירים מציגה תצוגה מעובדת של הנתונים.
לדוגמה, נניח את קבוצת נתוני המכירות הבאה:
A | B | C | D | E | F | G | |
1 | קטגוריית פריט | מספר הדגם | עלות | כמות | אזור | אנשי מכירות | תאריך משלוח |
2 | גלגל ענק | W-24 | 20.50$ | 4 | מערב | Beth | 1.3.2016 |
3 | דלת | D-01X | $15.00 | 2 | דרום | Amir | 15/03/2016 |
4 | מנוע | ENG-0134 | $100.00 | 1 | צפון | Carmen | 20/03/2016 |
5 | מסגרת | FR-0B1 | 34.00$ | 8 | מזרח | חנה | 3/12/2016 |
6 | חלונית | P-034 | 24.00 ש"ח | 4 | צפון | דניאל | 2/04/2016 |
7 | חלונית | P-052 | 11.50$ | 7 | מזרח | אריק | 16/05/2016 |
8 | גלגל ענק | W-24 | 20.50$ | 11 | דרום | Sheldon | 30/04/2016 |
9 | מנוע | ENG-0161 | 330.00$ | 2 | צפון | ג'סי | 2/7/2016 |
10 | דלת | D-01Y | 29.00 | 6 | מערב | Armando | 13/03/2016 |
11 | מסגרת | FR-0B1 | 34.00$ | 9 | דרום | Yuliana | 27/02/2016 |
12 | חלונית | P-102 | 12 ש"ח | 15 | מערב | Carmen | 18/04/2016 |
13 | חלונית | P-105 | 8.25$ | 13 | מערב | ג'סי | 20/06/2016 |
14 | מנוע | ENG-0211 | 283.00$ | 1 | צפון | Amir | 21/06/2016 |
15 | דלת | D-01X | $15.00 | 2 | מערב | Armando | 3.7.2016 |
16 | מסגרת | FR-0B1 | 34.00$ | 6 | דרום | Carmen | 15/07/2016 |
17 | גלגל ענק | W-25 | 80 ש"ח | 8 | דרום | חנה | 2/05/2016 |
18 | גלגל ענק | W-11 | 29.00 | 13 | מזרח | אריק | 19/05/2016 |
19 | דלת | D-05 | 17.70$ | 7 | מערב | Beth | 28/06/2016 |
20 | מסגרת | FR-0B1 | 34.00$ | 8 | צפון | Sheldon | 30/03/2016 |
אפשר להשתמש בטבלת צירים כדי ליצור דוח שבו מוצג כמה מכשירי כל מספר מודל נמכרו בכל אזור:
קוד המקור ששימש ליצירת טבלת הצירים הזו מופיע בקטע דוגמה שבהמשך.
אחרי שמוסיפים טבלת צירים לגיליון אלקטרוני, המשתמשים יכולים לשנות באופן אינטראקטיבי את המבנה והפרטים של הסיכום באמצעות ממשק המשתמש של Sheets.
עבודה עם טבלאות צירים
ההגדרה של טבלת צירים משויכת לתא יחיד בגיליון. למרות שהתצוגה הנגזרת שלה כוללת הרבה תאים גם בגובה וגם ברוחב, מבחינה פרוגרמטית היא ממוקמת בקואורדינטה של תא אחד. התא הזה הופך לפינה הימנית העליונה של טבלת הצירים שעברתה רינדור, והיקף האופק והאנכה שלו נקבע לפי ההגדרה שלו.
הוספת טבלת צירים
כדי להוסיף טבלת צירים, משתמשים בשיטה batchUpdate ומספקים בקשה מסוג updateCells. משתמשים בבקשה הזו כדי לספק הגדרה של PivotTable כתוכן של תא, כפי שמוצג בהמשך:
"updateCells": {
"rows": {
"values": [{
"pivotTable": MyPivotTable
},
"start": {
"sheetId": sheetId,
"rowIndex": 0,
"columnIndex": 0
},
"fields": "pivotTable"
}
הפונקציה הזו ממוקמת את טבלת הצירים שמתוארת על ידי MyPivotTable
בגיליון שצוין, עם הפינה הימנית העליונה בתא A1
. (הגובה והרוחב של טבלת הצירים הם דינמיים, מציינים רק את המקור).
הסוג PivotTable מאפשר לכם לציין:
- טווח נתוני המקור
- שדה אחד או יותר שהנתונים שלו ירכיבו את השורות של טבלת הצירים
- שדה אחד או יותר שהנתונים שלו ירכיבו את העמודות של טבלת הצירים
- קריטריונים לסינון ולצבירה
- פריסה של טבלת צירים
שינוי ומחיקה של טבלאות צירים
אין בקשות מפורשות לשינוי או למחיקה של טבלת צירים. במקום זאת, צריך להשתמש בבקשה updateCells עם תוכן תא שונה:
- כדי לשנות טבלת צירים, יוצרים הגדרה של PivotTable ששונתה ומעדכנים את התא באמצעותה, בדומה להוספת טבלת צירים חדשה.
- כדי למחוק טבלת צירים, מעדכנים את התא בערכים ריקים. לדוגמה, תוכלו לעיין בדוגמה מחיקת טבלת צירים.
תרחישים לדוגמה
יש שימושים רבים לשולחנות צירים, במגוון רחב של תחומים, כולל ניתוח סטטיסטי, אפליקציות ERP, דיווח פיננסי ועוד. תרחישים לדוגמה לשימוש בטבלאות צירים קלאסיות כוללים פריטים כמו:
- סה"כ מכירות לפי אזור ורבעון
- משכורת ממוצעת לפי תפקיד ומיקום
- מספר התקריות לפי מוצר ושעה ביום
יש מספר עצום של יישומים פוטנציאליים לטבלאות צירים, והיכולת ליצור אותן באופן פרוגרמטי היא כלי חזק. אפשר ליצור טבלאות צירים שתומכות בניתוחים אינטראקטיביים, אבל מותאמות לנסיבות ספציפיות. לדוגמה:
- ניתוח נתוני אירועים מהתקופה של 24 השעות האחרונות
- הצגה או ניתוח של נתונים מצטברים שתואמים לחשבון שנבחר כרגע
- בדיקת נתוני המכירות בטריטוריות ששייכות למשתמש הנוכחי
דוגמה
בדוגמה הזו נוצרת טבלת צירים מקבוצת נתונים כדי ליצור את הדוח 'מספר דגם לפי אזור' שמוצג בתחילת הדף. דוגמאות נוספות מפורטות בדף טבלת צירים לדוגמה.