تمت ترجمة هذه الصفحة بواسطة 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)`

تضيف قاعدة تجميع يدوي لهذه المجموعة المحورية.

المَعلمات

الاسم	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