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)

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

المعلمات

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

تُستخدَم لضبط قاعدة تجميع مخطّط بياني شريطي لهذه المجموعة المحورية. تنظِّم قاعدة الرسم البياني الشريطي القيم في عمود data source إلى مجموعات بحجم ثابت. يتم وضع كل القيم من 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.
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']);

المعلمات

الاسم	النوع	الوصف
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