Class DataSourcePivotTable

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
DataSourcePivotTable

الوصول إلى الجدول المحوري لمصدر البيانات الحالي وتعديله. لإنشاء جدول محوري جديد للبيانات، استخدِم Range.createDataSourcePivotTable(dataSource).

لا تستخدم هذه الفئة إلا مع البيانات التي ترتبط بقاعدة بيانات.

الطُرق

الطريقةنوع الإرجاعوصف قصير
addColumnGroup(columnName)PivotGroupتضيف مجموعة أعمدة محورية جديدة استنادًا إلى عمود مصدر البيانات المحدّد.
addFilter(columnName, filterCriteria)PivotFilterلإضافة فلتر جديد استنادًا إلى عمود مصدر البيانات المحدد مع معايير الفلتر المحددة.
addPivotValue(columnName, summarizeFunction)PivotValueتضيف قيمة محورية جديدة بناءً على عمود مصدر البيانات المحدد مع دالة الملخص المحددة.
addRowGroup(columnName)PivotGroupلإضافة مجموعة صفوف محورية جديدة استنادًا إلى عمود مصدر البيانات المحدّد
asPivotTable()PivotTableيعرض الجدول المحوري لمصدر البيانات ككائن جدول محوري عادي.
forceRefreshData()DataSourcePivotTableإعادة تحميل بيانات هذا العنصر بغض النظر عن الحالة الحالية.
getDataSource()DataSourceالحصول على مصدر البيانات المرتبط به العنصر.
getStatus()DataExecutionStatusتحصل على حالة تنفيذ البيانات للعنصر.
refreshData()DataSourcePivotTableلإعادة تحميل بيانات العنصر.
waitForCompletion(timeoutInSeconds)DataExecutionStatusالانتظار حتى اكتمال عملية التنفيذ الحالية، وستنتهي المهلة بعد عدد الثواني المقدَّم.

المستندات التفصيلية

addColumnGroup(columnName)

تضيف مجموعة أعمدة محورية جديدة استنادًا إلى عمود مصدر البيانات المحدّد.

المَعلمات

الاسمالنوعالوصف
columnNameStringيعتمد اسم عمود مصدر البيانات على المجموعة المحورية.

تذكرة ذهاب وعودة

PivotGroup — المجموعة المحورية الجديدة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

addFilter(columnName, filterCriteria)

لإضافة فلتر جديد استنادًا إلى عمود مصدر البيانات المحدد مع معايير الفلتر المحددة.

المَعلمات

الاسمالنوعالوصف
columnNameStringيستند اسم عمود مصدر البيانات إلى الفلتر.
filterCriteriaFilterCriteriaالمعايير التي يستخدمها الفلتر

تذكرة ذهاب وعودة

PivotFilter — الفلتر الجديد.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

addPivotValue(columnName, summarizeFunction)

تضيف قيمة محورية جديدة بناءً على عمود مصدر البيانات المحدد مع دالة الملخص المحددة.

المَعلمات

الاسمالنوعالوصف
columnNameStringيستند اسم عمود مصدر البيانات إلى القيمة المحورية.
summarizeFunctionPivotTableSummarizeFunctionدالة التلخيص التي تستخدمها القيمة المحورية.

تذكرة ذهاب وعودة

PivotValue — القيمة المحورية الجديدة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

addRowGroup(columnName)

لإضافة مجموعة صفوف محورية جديدة استنادًا إلى عمود مصدر البيانات المحدّد

المَعلمات

الاسمالنوعالوصف
columnNameStringيعتمد اسم عمود مصدر البيانات على المجموعة المحورية.

تذكرة ذهاب وعودة

PivotGroup — المجموعة المحورية الجديدة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

asPivotTable()

يعرض الجدول المحوري لمصدر البيانات ككائن جدول محوري عادي.

تذكرة ذهاب وعودة

PivotTable — الجدول المحوري.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

forceRefreshData()

إعادة تحميل بيانات هذا العنصر بغض النظر عن الحالة الحالية. لمزيد من التفاصيل، يمكنك الاطّلاع على refreshData().

عرض استثناء إذا لم يتم تفعيل نوع مصدر البيانات. استخدِم طرق SpreadsheetApp#enable...Execution() لتفعيل تنفيذ البيانات لنوع مصدر بيانات معيّن.

تذكرة ذهاب وعودة

DataSourcePivotTable — كائن البيانات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

getDataSource()

الحصول على مصدر البيانات المرتبط به العنصر.

تذكرة ذهاب وعودة

DataSource — مصدر البيانات

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

getStatus()

تحصل على حالة تنفيذ البيانات للعنصر.

تذكرة ذهاب وعودة

DataExecutionStatus - حالة تنفيذ البيانات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

refreshData()

لإعادة تحميل بيانات العنصر.

عرض استثناء إذا كان حاليًا في حالة error استخدِم DataSource#updateSpec() لتعديل المواصفات. ننصحك باستخدام الطريقة بدلاً من forceRefreshData() لمنع إجراء تعديلات غير متوقّعة على مصدر البيانات.

عرض استثناء إذا لم يتم تفعيل نوع مصدر البيانات. استخدِم طرق SpreadsheetApp#enable...Execution() لتفعيل تنفيذ البيانات لنوع مصدر بيانات معيّن.

تذكرة ذهاب وعودة

DataSourcePivotTable — كائن البيانات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

waitForCompletion(timeoutInSeconds)

الانتظار حتى اكتمال عملية التنفيذ الحالية، وستنتهي المهلة بعد عدد الثواني المقدَّم. عرض استثناء في حال عدم اكتمال التنفيذ عند انتهاء المهلة، مع عدم إلغاء تنفيذ البيانات

المَعلمات

الاسمالنوعالوصف
timeoutInSecondsIntegerوقت الانتظار لتنفيذ البيانات، بالثواني الحد الأقصى هو 300 ثانية.

تذكرة ذهاب وعودة

DataExecutionStatus - حالة تنفيذ البيانات.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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