Class PivotGroup

مجموعةpivot

الوصول إلى مجموعات التقارير التفصيلية للجدول المحوري وتعديلها

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
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)

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

المعلمات

الاسمالنوعالوصف
groupNameStringاسم قاعدة التجميع هذه.
groupMembersObject[]القيم المضمّنة في قاعدة التجميع هذه

الإرجاع

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، وإذا كانت هذه المجموعة تلخّص البيانات المصدر في العمود "أ" من جدول البيانات، ستُرجع هذه الطريقة 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.

المعلمات

الاسمالنوعالوصف
indexIntegerالمؤشر الذي سيتم نقل هذه المجموعة إليه.

الإرجاع

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 المحدّد.

المعلمات

الاسمالنوعالوصف
groupNameStringاسم قاعدة التجميع المطلوب إزالتها.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
dateTimeGroupingRuleTypeDateTimeGroupingRuleTypeنوع القاعدة المطلوب ضبطها.

الإرجاع

PivotGroup: المجموعة المحورية لإنشاء سلاسل.

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

setDisplayName(name)

لضبط الاسم المعروض لهذه المجموعة في الجدول المحوري

المعلمات

الاسمالنوعالوصف
nameStringالاسم المعروض المطلوب ضبطه.

الإرجاع

PivotGroup: المجموعة المحورية لإنشاء سلاسل

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

setGroupLimit(countLimit)

تُستخدَم لضبط الحد الأقصى للمجموعة المحورية في المجموعة المحورية. لا تتوفّر العملية إلّا لـ DataSourcePivotTable.

المعلمات

الاسمالنوعالوصف
countLimitIntegerالحد الأقصى لعدد الصفوف أو الأعمدة المطلوب ضبطه يجب أن تكون موجبة.

الإرجاع

PivotGroup: مجموعة المحور لتسلسل العناصر

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

setHistogramGroupingRule(minValue, maxValue, intervalSize)

تُستخدَم لضبط قاعدة تجميع مخطّط بياني شريطي لهذه المجموعة المحورية. تنظِّم قاعدة الرسم البياني الشريطي القيم في عمود data source إلى مجموعات بحجم ثابت. يتم وضع كل القيم من minValue إلى maxValue في مجموعات بحجم interval. يتم وضع جميع القيم التي تقل عن minValue في حزمة واحدة، كما يتم وضع جميع القيم التي تزيد عن maxValue.

المعلمات

الاسمالنوعالوصف
minValueIntegerالحد الأدنى لقيمة العناصر التي سيتم وضعها في الحزم يتم دمج القيم التي تقل عن هذا الحد في حزمة واحدة.
maxValueIntegerالحدّ الأقصى لقيمة العناصر التي سيتمّ وضعها في الحِزم يتم دمج القيم التي تزيد عن هذا الحد في حزمة واحدة.
intervalSizeInteger

الإرجاع

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)

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

المعلمات

الاسمالنوعالوصف
showTotalsBooleanتحديد ما إذا كان سيتم عرض الإجماليات أم لا

الإرجاع

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.
const sheet = SpreadsheetApp.getActiveSheet();
const pivotTable = sheet.getPivotTables()[0];
const itemGroup = pivotTable.getRowGroups()[0];
const sumQuantityValue = pivotTable.getPivotValues()[0];
itemGroup.sortBy(sumQuantityValue, ['Beth', 'Amir', 'Devyn']);

المعلمات

الاسمالنوعالوصف
valuePivotValueقيمة محور الالتفاف التي سيتم الترتيب حسبها.
oppositeGroupValuesObject[]قيم مجموعة محورية مقابلة (مجموعة أعمدة في حال ترتيب مجموعة صفوف، أو مجموعة صفوف في حال ترتيب مجموعة أعمدة) التي يتم استخدامها للترتيب يحدّد ترتيب هذه القيم الأولوية في تحديد الفائز في حال تساوي النقاط.

الإرجاع

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