לגשת לקבוצות משנה בטבלת צירים ולשנות אותן.
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
addManualGroupingRule(groupName, groupMembers) | PivotGroup | הוספה של כלל קיבוץ ידני לקבוצת הצירים הזו. |
areLabelsRepeated() | Boolean | מחזירה אם תוויות מוצגות כחוזרות. |
clearGroupingRule() | PivotGroup | פעולה זו מסירה כללי קיבוץ מקבוצת הצירים הזו. |
clearSort() | PivotGroup | כל המיון שהוחל על הקבוצה יוסר. |
getDateTimeGroupingRule() | DateTimeGroupingRule | הפונקציה מחזירה את כלל הקיבוץ של תאריך ושעה בקבוצת הצירים, או null אם לא הוגדר כלל קיבוץ לפי תאריך ושעה. |
getDimension() | Dimension | מחזירה אם זו קבוצה של שורות או של עמודות. |
getGroupLimit() | PivotGroupLimit | מחזירה את המגבלה של קבוצת הצירים. |
getIndex() | Integer | מחזירה את האינדקס של קבוצת הצירים הזו בסדר הנוכחי של הקבוצה. |
getPivotTable() | PivotTable | מחזירה את PivotTable שאליו שייכת הקיבוץ הזה. |
getSourceDataColumn() | Integer | מחזירה את מספר העמודה של נתוני המקור שהקבוצה מסכמת. |
getSourceDataSourceColumn() | DataSourceColumn | מחזירה את העמודה של מקור הנתונים שעליה פועלת קבוצת הצירים. |
hideRepeatedLabels() | PivotGroup | הסתרת תוויות חוזרות בקיבוץ הזה. |
isSortAscending() | Boolean | הפונקציה מחזירה את הערך true אם המיון הוא בסדר עולה, ומחזירה את הערך false אם סדר המיון יורד. |
moveToIndex(index) | PivotGroup | מעביר את הקבוצה הזו למיקום שצוין ברשימה הנוכחית של קבוצות השורות או העמודות. |
remove() | void | הסרה של קבוצת הצירים הזאת מהטבלה. |
removeManualGroupingRule(groupName) | PivotGroup | מסירה את כלל הקיבוץ הידני עם הערך groupName שצוין. |
resetDisplayName() | PivotGroup | איפוס השם המוצג של הקבוצה הזו בטבלת הצירים לערך ברירת המחדל. |
setDateTimeGroupingRule(dateTimeGroupingRuleType) | PivotGroup | מגדיר את כלל הקיבוץ לפי תאריך ושעה בקבוצת הצירים. |
setDisplayName(name) | PivotGroup | מגדיר את שם התצוגה של הקבוצה הזו בטבלת הצירים. |
setGroupLimit(countLimit) | PivotGroup | הגדרת המגבלה של קבוצת הצירים. |
setHistogramGroupingRule(minValue, maxValue, intervalSize) | PivotGroup | מגדיר כלל קיבוץ היסטוגרמה עבור קבוצת הצירים הזו. |
showRepeatedLabels() | PivotGroup | כשיש יותר מקיבוץ שורות או עמודות, השיטה הזו מציגה את התווית של הקיבוץ הזה לכל רשומה בקיבוץ שאחריו. |
showTotals(showTotals) | PivotGroup | מגדירה אם להציג בטבלה את הערכים הכוללים של קבוצת הצירים הזו. |
sortAscending() | PivotGroup | מגדיר את סדר המיון בסדר עולה. |
sortBy(value, oppositeGroupValues) | PivotGroup | ממיין את הקבוצה הזו לפי PivotValue שצוין עבור הערכים מה-oppositeGroupValues . |
sortDescending() | PivotGroup | מגדיר את סדר המיון בסדר יורד. |
totalsAreShown() | Boolean | מחזירה אם הערכים הכוללים מוצגים כרגע לקבוצת הצירים הזו. |
תיעוד מפורט
addManualGroupingRule(groupName, groupMembers)
הוספה של כלל קיבוץ ידני לקבוצת הצירים הזו.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
groupName | String | השם של כלל הקיבוץ הזה. |
groupMembers | Object[] | הערכים שכלולים בכלל הקיבוץ הזה. |
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
areLabelsRepeated()
מחזירה אם תוויות מוצגות כחוזרות.
החזרות
Boolean
- true
אם התוויות חוזרות על עצמן, אחרת מוחזרת false
.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearGroupingRule()
פעולה זו מסירה כללי קיבוץ מקבוצת הצירים הזו.
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearSort()
כל המיון שהוחל על הקבוצה יוסר.
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDateTimeGroupingRule()
הפונקציה מחזירה את כלל הקיבוץ של תאריך ושעה בקבוצת הצירים, או null
אם לא הוגדר כלל קיבוץ לפי תאריך ושעה.
החזרות
DateTimeGroupingRule
- כלל הקיבוץ לפי תאריך ושעה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDimension()
getGroupLimit()
מחזירה את המגבלה של קבוצת הצירים. הפונקציה מחזירה את הערך null
אם לא הוגדרה מגבלה על קבוצת הצירים.
החזרות
PivotGroupLimit
- המגבלה של קבוצת הצירים.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIndex()
מחזירה את האינדקס של קבוצת הצירים הזו בסדר הנוכחי של הקבוצה.
החזרות
Integer
- האינדקס של קבוצת הצירים
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPivotTable()
מחזירה את PivotTable
שאליו שייכת הקיבוץ הזה.
החזרות
PivotTable
– טבלת הצירים שאליה שייכת הקבוצה הזו.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSourceDataColumn()
מחזירה את מספר העמודה של נתוני המקור שהקבוצה מסכמת. האינדקס הזה מבוסס על אחד, אם הקבוצה הזו מסכמת את נתוני המקור בעמודה "A" של הגיליון האלקטרוני, השיטה הזו מחזירה את הערך 1
.
החזרות
Integer
– מספר העמודה של נתוני המקור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSourceDataSourceColumn()
מחזירה את העמודה של מקור הנתונים שעליה פועלת קבוצת הצירים. הפונקציה מחזירה את הערך null
אם טבלת הצירים היא לא {DataSourcePivotTableApi}.
החזרות
DataSourceColumn
– עמודת מקור הנתונים שבה פועלת קבוצת הצירים.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRepeatedLabels()
הסתרת תוויות חוזרות בקיבוץ הזה. אם התוויות כבר מוסתרות, הפעולה הזו גורמת לחוסר פעולה. אם מפעילים את השיטה הזו לפני שיש כמה קיבוצים של שורות או עמודות, כשמוסיפים קיבוץ נוסף התוויות שחוזרות על עצמן מוסתרות.
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isSortAscending()
הפונקציה מחזירה את הערך true
אם המיון הוא בסדר עולה, ומחזירה את הערך false
אם סדר המיון יורד.
החזרות
Boolean
- true
אם סדר המיון הוא עולה.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveToIndex(index)
מעביר את הקבוצה הזו למיקום שצוין ברשימה הנוכחית של קבוצות השורות או העמודות. המדדים האלה מבוססים על 0. לדוגמה, אם צריך להעביר את הקבוצה הזו למיקום הראשון,
צריך לקרוא לשיטה הזו באמצעות 0
.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
index | Integer | האינדקס שאליו צריך להעביר את הקיבוץ הזה. |
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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
removeManualGroupingRule(groupName)
מסירה את כלל הקיבוץ הידני עם הערך groupName
שצוין.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
groupName | String | השם של כלל הקיבוץ שיש להסיר. |
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
resetDisplayName()
איפוס השם המוצג של הקבוצה הזו בטבלת הצירים לערך ברירת המחדל.
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDateTimeGroupingRule(dateTimeGroupingRuleType)
מגדיר את כלל הקיבוץ לפי תאריך ושעה בקבוצת הצירים.
כדי להסיר את הכלל, יש להשתמש בפונקציה clearGroupingRule()
.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
dateTimeGroupingRuleType | DateTimeGroupingRuleType | סוג הכלל שצריך להגדיר. |
החזרות
PivotGroup
– קבוצת הצירים, לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDisplayName(name)
מגדיר את שם התצוגה של הקבוצה הזו בטבלת הצירים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
name | String | השם המוצג להגדרה. |
החזרות
PivotGroup
– קבוצת הצירים לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setGroupLimit(countLimit)
הגדרת המגבלה של קבוצת הצירים. הפעולה נתמכת רק עבור DataSourcePivotTable
.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
countLimit | Integer | מגבלת הספירה של שורות או עמודות להגדרה. חייב להיות חיובי. |
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHistogramGroupingRule(minValue, maxValue, intervalSize)
מגדיר כלל קיבוץ היסטוגרמה עבור קבוצת הצירים הזו. כלל היסטוגרמה מארגן את הערכים בעמודת נתוני מקור לקטגוריות בגודל קבוע. כל הערכים מ-minValue
עד maxValue
ממוקמים בקבוצות בגודל interval
. כל הערכים שמתחת ל-minValue
מוקצים לקטגוריה אחת, וכך גם כל הערכים שגדולים מ-maxValue
.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
minValue | Integer | הערך המינימלי שצריך להקצות לפריטים בקטגוריות. ערכים שקטנים יותר משולבים בקטגוריה אחת. |
maxValue | Integer | הערך המקסימלי של פריטים שיש לכלול בקטגוריות. ערכים גדולים יותר משולבים בקטגוריה אחת. |
intervalSize | Integer |
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRepeatedLabels()
כשיש יותר מקיבוץ שורות או עמודות, השיטה הזו מציגה את התווית של הקיבוץ הזה לכל רשומה בקיבוץ שאחריו. אם תוויות כבר חוזרות על עצמן, זה גורם לחוסר פעולה. אם מפעילים את השיטה הזו לפני שיש כמה קיבוצים של שורות או עמודות, כשמוסיפים קיבוץ נוסף מוצגות תוויות חוזרות.
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showTotals(showTotals)
מגדירה אם להציג בטבלה את הערכים הכוללים של קבוצת הצירים הזו.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
showTotals | Boolean | האם להציג סכומים כוללים. |
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sortAscending()
מגדיר את סדר המיון בסדר עולה.
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sortBy(value, oppositeGroupValues)
ממיין את הקבוצה הזו לפי PivotValue
שצוין עבור הערכים מה-oppositeGroupValues
.
// Sorts the item group by the "SUM of Quantity" pivot value for the specified salespersons. var sheet = SpreadsheetApp.getActiveSheet(); var pivotTable = sheet.getPivotTables()[0]; var itemGroup = pivotTable.getRowGroups()[0]; var sumQuantityValue = pivotTable.getPivotValues()[0]; itemGroup.sortBy(sumQuantityValue, ['Beth', 'Amir', 'Devyn']);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
value | PivotValue | ערך הציר שלפיו רוצים למיין. |
oppositeGroupValues | Object[] | הערכים של קבוצת צירים הפוכה (קבוצת עמודות אם ממיינים קבוצת שורות, או קבוצת שורות אם ממיינים קבוצת עמודות) שמשמשים למיון. הסדר של הערכים האלה קובע את העדיפות לשבירת עניבה. |
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sortDescending()
מגדיר את סדר המיון בסדר יורד.
החזרות
PivotGroup
– קבוצת הצירים לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
totalsAreShown()
מחזירה אם הערכים הכוללים מוצגים כרגע לקבוצת הצירים הזו.
החזרות
Boolean
– true
אם הערכים הכוללים מוצגים לקבוצת הצירים הזו. אחרת, הפונקציה מחזירה את הערך
false
.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets