דף זה תורגם על ידי Cloud Translation API.

Class DataSourcePivotTable

גישה לטבלת צירים קיימת של מקור נתונים ושינוי שלהם. כדי ליצור טבלת צירים חדשה של מקור נתונים, משתמשים ב-Range.createDataSourcePivotTable(dataSource).

יש להשתמש במחלקה הזו רק עם נתונים שמחוברים למסד נתונים.

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
`addColumnGroup(columnName)`	`PivotGroup`	הוספה של קבוצה חדשה של עמודות צירים על סמך העמודה שצוינה במקור הנתונים.
`addFilter(columnName, filterCriteria)`	`PivotFilter`	הוספת מסנן חדש על סמך העמודה שצוינה של מקור הנתונים עם הקריטריונים שצוינו.
`addPivotValue(columnName, summarizeFunction)`	`PivotValue`	הוספת ערך ציר חדש על סמך העמודה שצוינה במקור הנתונים עם פונקציית הסיכום שצוינה.
`addRowGroup(columnName)`	`PivotGroup`	הוספה של קבוצה חדשה של שורות צירים על סמך העמודה שצוינה במקור הנתונים.
`asPivotTable()`	`PivotTable`	מחזירה את טבלת הצירים של מקור הנתונים כאובייקט רגיל של טבלת צירים.
`cancelDataRefresh()`	`DataSourcePivotTable`	מבטל את רענון הנתונים המשויך לאובייקט הזה אם הוא פועל עכשיו.
`forceRefreshData()`	`DataSourcePivotTable`	רענון הנתונים של האובייקט הזה ללא קשר למצב הנוכחי.
`getDataSource()`	`DataSource`	מקבלת את מקור הנתונים שאליו האובייקט מקושר.
`getStatus()`	`DataExecutionStatus`	מקבל את סטטוס ביצוע הנתונים של האובייקט.
`refreshData()`	`DataSourcePivotTable`	רענון של נתוני האובייקט.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	בהמתנה עד שההפעלה הנוכחית תסתיים, והתזמון יסתיים אחרי מספר השניות שצוין.

תיעוד מפורט

`addColumnGroup(columnName)`

הוספה של קבוצה חדשה של עמודות צירים על סמך העמודה שצוינה במקור הנתונים.

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה למקור הנתונים שעליו מבוססת קבוצת הצירים.

החזרות

PivotGroup – קבוצת הצירים החדשה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה באחד או יותר מההיקפים הבאים:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addFilter(columnName, filterCriteria)`

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

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה למקור הנתונים שעליו מבוסס המסנן.
`filterCriteria`	`FilterCriteria`	הקריטריונים של המסנן.

החזרות

PivotFilter – המסנן החדש.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה באחד או יותר מההיקפים הבאים:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addPivotValue(columnName, summarizeFunction)`

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

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה מקור הנתונים שעליו מבוסס הערך.
`summarizeFunction`	`PivotTableSummarizeFunction`	פונקציית הסיכום שבה משתמש ערך הציר.

החזרות

PivotValue – הערך החדש בטבלת הציר.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה באחד או יותר מההיקפים הבאים:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addRowGroup(columnName)`

הוספה של קבוצה חדשה של שורות צירים על סמך העמודה שצוינה במקור הנתונים.

פרמטרים

שם	סוג	תיאור
`columnName`	`String`	שם העמודה למקור הנתונים שעליו מבוססת קבוצת הצירים.

החזרות

PivotGroup – קבוצת הצירים החדשה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה באחד או יותר מההיקפים הבאים:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`asPivotTable()`

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

החזרות

PivotTable - טבלת הצירים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה באחד או יותר מההיקפים הבאים:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`cancelDataRefresh()`

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

בדוגמה הזו מוסבר איך לבטל רענון של נוסחאות.

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

מחריג את הקוד אם הסוג של מקור הנתונים לא מופעל. משתמשים בשיטות SpreadsheetApp#enable...Execution() כדי לאפשר ביצוע נתונים לסוג ספציפי של מקור נתונים.

החזרות

DataSourcePivotTable – אובייקט הנתונים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה באחד או יותר מההיקפים הבאים:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`forceRefreshData()`

רענון הנתונים של האובייקט הזה ללא קשר למצב הנוכחי. פרטים נוספים מופיעים בכתובת refreshData(). אם ברצונך לבטל רענון שרץ כרגע של האובייקט הזה, יש לעיין ב-cancelDataRefresh().

החזרות

DataSourcePivotTable – אובייקט הנתונים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה באחד או יותר מההיקפים הבאים:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSource()`

מקבלת את מקור הנתונים שאליו האובייקט מקושר.

החזרות

DataSource – מקור הנתונים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה באחד או יותר מההיקפים הבאים:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getStatus()`

מקבל את סטטוס ביצוע הנתונים של האובייקט.

החזרות

DataExecutionStatus – סטטוס ביצוע הנתונים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה באחד או יותר מההיקפים הבאים:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`refreshData()`

רענון של נתוני האובייקט.

הוספת החרגה אם היא נמצאת כרגע במצב error. שימוש ב-DataSource#updateSpec() לעדכון המפרט. השיטה הזו מועדפת על פני forceRefreshData() כדי למנוע עריכות לא צפויות במקור הנתונים.

החזרות

DataSourcePivotTable – אובייקט הנתונים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה באחד או יותר מההיקפים הבאים:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`waitForCompletion(timeoutInSeconds)`

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

פרמטרים

שם	סוג	תיאור
`timeoutInSeconds`	`Integer`	זמן ההמתנה לביצוע נתונים, בשניות. הערך המקסימלי הוא 300 שניות.

החזרות

DataExecutionStatus – סטטוס ביצוע הנתונים.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה באחד או יותר מההיקפים הבאים:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets