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

Class PivotGroup

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

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`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()`

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

חזרה

Dimension – המאפיין שמייצג את סוג הקבוצה הזו

אישור

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

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

`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()`

מחזירה את המספר של עמודת נתוני המקור שהקבוצה מסכמת. האינדקס הזה מבוסס על 1, אם הקבוצה הזו מסכמת נתוני מקור בעמודה "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. לדוגמה, אם צריך להעביר את הקבוצה למיקום הראשון, צריך לקרוא ל-method 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