Class 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