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)

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

المَعلمات

الاسمTypeالوصف
columnNameStringاسم عمود مصدر البيانات الذي تستند إليه المجموعة المحورية.

استرجاع الكرة

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

التفويض

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

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

addFilter(columnName, filterCriteria)

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

المَعلمات

الاسمTypeالوصف
columnNameStringاسم عمود مصدر البيانات الذي يستند إليه عامل التصفية.
filterCriteriaFilterCriteriaتمثّل هذه السمة المعايير التي يستخدمها الفلتر.

استرجاع الكرة

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

التفويض

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

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

addPivotValue(columnName, summarizeFunction)

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

addRowGroup(columnName)

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

المَعلمات

الاسمTypeالوصف
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)

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

المَعلمات

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

استرجاع الكرة

DataExecutionStatus — حالة تنفيذ البيانات

التفويض

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

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