الوصول إلى المجموعات المصغّرة في الجدول المحوري وتعديلها
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
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)
تضيف قاعدة تجميع يدوي لهذه المجموعة المحورية.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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. على سبيل المثال، إذا كان يجب نقل هذه المجموعة إلى الموضع الأول، يجب تسمية هذه الطريقة باستخدام 0
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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
المحدّدة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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()
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
dateTimeGroupingRuleType | DateTimeGroupingRuleType | نوع القاعدة المطلوب ضبطها. |
استرجاع الكرة
PivotGroup
- المجموعة المحورية للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDisplayName(name)
لضبط الاسم المعروض لهذه المجموعة في الجدول المحوري.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
name | String | الاسم المعروض المطلوب ضبطه |
استرجاع الكرة
PivotGroup
- المجموعة المحورية للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setGroupLimit(countLimit)
تحدِّد هذه السياسة حدّ المجموعة المحورية في المجموعة المحورية. لا تتوافق هذه العملية إلا مع DataSourcePivotTable
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
minValue | Integer | تمثّل هذه السمة الحد الأدنى لقيمة العناصر المطلوب وضعها في مجموعات بيانات. ويتم دمج القيم الأقل من هذه القيم في حزمة واحدة. |
maxValue | Integer | تمثّل هذه السمة الحد الأقصى لقيمة العناصر التي سيتم وضعها في مجموعات بيانات. ويتم دمج القيم الأكبر من هذه في حزمة واحدة. |
intervalSize | Integer |
استرجاع الكرة
PivotGroup
- المجموعة المحورية للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRepeatedLabels()
عندما يكون هناك أكثر من مجموعة من الصفوف أو الأعمدة، تعرض هذه الطريقة تسمية هذه المجموعة لكل إدخال في التجميع اللاحق. إذا تكررت التسميات بالفعل، فإن هذه النتائج تؤدي إلى "no-op". وإذا تم استدعاء هذه الطريقة قبل أن يكون هناك العديد من مجموعات الصفوف أو الأعمدة، فعند إضافة مجموعة إضافية يتم عرض تسميات متكررة.
استرجاع الكرة
PivotGroup
- المجموعة المحورية للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showTotals(showTotals)
لتحديد ما إذا كان سيتم عرض القيم الإجمالية لهذه المجموعة المحورية في الجدول.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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']);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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