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

Class DataSourcePivotTable

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

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

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`addColumnGroup(columnName)`	`PivotGroup`	הפונקציה מוסיפה קבוצה חדשה של עמודות בטבלת צירים על סמך העמודה של מקור הנתונים שצוינה.
`addFilter(columnName, filterCriteria)`	`PivotFilter`	הוספת מסנן חדש על סמך העמודה של מקור הנתונים שצוינה, עם קריטריונים המסנן שצוינו.
`addPivotValue(columnName)`	`PivotValue`	הוספת ערך ציר חדש על סמך עמודת מקור הנתונים שצוינה, ללא פונקציית סיכום.
`addPivotValue(columnName, summarizeFunction)`	`PivotValue`	הוספת ערך PivotTable חדש על סמך עמודת מקור הנתונים שצוינה, באמצעות פונקציית הסיכום שצוינה.
`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)`

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

הקוד הבא מסביר איך להוסיף מדידה של Looker כערך ציר.

// TODO(developer): Replace with your spreadsheet ID which has a Looker data source.
var spreadsheet = SpreadsheetApp.openById("abcd1234")
var datasource = spreadsheet.getDataSources()[0];
var pivotTable = datasource.createDataSourcePivotTableOnNewSheet();

pivotTable.addPivotValue("columnName");

השיטה הזו זמינה רק למקורות נתונים של Looker.

פרמטרים

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

חזרה

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

אישור

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

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

`addPivotValue(columnName, summarizeFunction)`

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

כדי להוסיף ערכי ציר למדידות של Looker צריך להשתמש ב-addPivotValue(columnName).

פרמטרים

שם	סוג	תיאור
`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().

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

חזרה

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() כדי למנוע עריכות לא צפויות במקור הנתונים.

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

חזרה

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