Class PivotTable

PivotTable

אפשר לגשת לטבלאות צירים ולשנות אותן.

Methods

שיטהסוג הערך שמוחזרתיאור קצר
addCalculatedPivotValue(name, formula)PivotValueהפונקציה יוצרת ערך חדש בטבלת הצירים שמחושב מהערך formula שצוין באמצעות הערך name שצוין.
addColumnGroup(sourceDataColumn)PivotGroupהגדרת קיבוץ חדש של עמודות בטבלת הצירים.
addFilter(sourceDataColumn, filterCriteria)PivotFilterיוצר מסנן חדש של טבלת צירים עבור טבלת הצירים.
addPivotValue(sourceDataColumn, summarizeFunction)PivotValueהפונקציה מגדירה ערך חדש בטבלת הצירים עם summarizeFunction שצוין.
addRowGroup(sourceDataColumn)PivotGroupהגדרה של קיבוץ חדש של שורות בטבלת הצירים.
asDataSourcePivotTable()DataSourcePivotTable|nullהפונקציה מחזירה את טבלת הצירים כטבלת צירים של מקור נתונים אם טבלת הצירים מקושרת ל-DataSource, או null אחרת.
getAnchorCell()Rangeהפונקציה מחזירה את Range שמייצג את התא שבו טבלת הצירים הזו מעוגנת.
getColumnGroups()PivotGroup[]הפונקציה מחזירה רשימה מסודרת של קבוצות העמודות בטבלת הצירים הזו.
getFilters()PivotFilter[]הפונקציה מחזירה רשימה מסודרת של המסננים בטבלת הצירים הזו.
getPivotValues()PivotValue[]הפונקציה מחזירה רשימה מסודרת של ערכי הצירים בטבלת הצירים הזו.
getRowGroups()PivotGroup[]הפונקציה מחזירה רשימה מסודרת של קבוצות השורות בטבלת הצירים הזו.
getSourceDataRange()Rangeהפונקציה מחזירה את טווח נתוני המקור שעליו מבוססת טבלת הצירים.
getValuesDisplayOrientation()Dimensionהפונקציה מחזירה תשובה אם הערכים מוצגים כשורה או כעמודה.
remove()voidמחיקת טבלת הצירים.
setValuesDisplayOrientation(dimension)PivotTableהגדרה של הפריסה של טבלת הצירים הזו כך שהערכים יוצגו כעמודות או שורות.

תיעוד מפורט

addCalculatedPivotValue(name, formula)

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

פרמטרים

שםסוגתיאור
nameStringהשם של ערך הציר המחושב הזה.
formulaStringהנוסחה שמשמשת לחישוב הערך הזה.

חזרה

‫PivotValue – PivotValue שנוצר לאחרונה

אישור

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

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

addColumnGroup(sourceDataColumn)

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

פרמטרים

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

חזרה

‫PivotGroup – PivotGroup שנוצר לאחרונה

אישור

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

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

addFilter(sourceDataColumn, filterCriteria)

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

פרמטרים

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

חזרה

‫PivotFilter – PivotFilter שנוצר לאחרונה

אישור

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

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

addPivotValue(sourceDataColumn, summarizeFunction)

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

פרמטרים

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

חזרה

‫PivotValue – PivotValue שנוצר לאחרונה

אישור

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

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

addRowGroup(sourceDataColumn)

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

פרמטרים

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

חזרה

‫PivotGroup – PivotGroup שנוצר לאחרונה

אישור

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

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

asDataSourcePivotTable()

הפונקציה מחזירה את טבלת הצירים כטבלת צירים של מקור נתונים אם טבלת הצירים מקושרת ל-DataSource, או null אחרת.

חזרה

‫DataSourcePivotTable|null — טבלת צירים של מקור נתונים.

אישור

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

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

getAnchorCell()

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

חזרה

‫Range – תא העוגן של טבלת הצירים הזו

אישור

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

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

getColumnGroups()

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

חזרה

‫PivotGroup[] – קבוצות העמודות בטבלת הצירים הזו

אישור

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

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

getFilters()

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

חזרה

‫PivotFilter[] – המסננים בטבלת הצירים הזו

אישור

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

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

getPivotValues()

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

חזרה

‫PivotValue[] – ערכי הצירים בטבלת הצירים הזו

אישור

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

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

getRowGroups()

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

חזרה

‫PivotGroup[] – קבוצות השורות בטבלת הצירים הזו

אישור

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

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

getSourceDataRange()

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

חזרה

‫Range — טווח נתוני המקור של טבלת הצירים הזו.

אישור

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

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

getValuesDisplayOrientation()

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

חזרה

‫Dimension — אם הערכים מוצגים כשורה או כעמודה

אישור

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

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

remove()

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

אישור

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

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

setValuesDisplayOrientation(dimension)

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

פרמטרים

שםסוגתיאור
dimensionDimensionהמאפיין שמציין איך להציג את ערכי הציר.

חזרה

‫PivotTable – טבלת הצירים לשרשור

אישור

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

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