الوصول إلى الجدول المحوري لمصدر البيانات الحالي وتعديله لإنشاء جدول محوري جديد لمصدر بيانات، استخدم
Range.createDataSourcePivotTable(dataSource)
لا تستخدِم هذه الفئة إلا مع البيانات المرتبطة بقاعدة بيانات.
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
addColumnGroup(columnName) | PivotGroup | تضيف مجموعة أعمدة محورية جديدة استنادًا إلى عمود مصدر البيانات المحدّد. |
addFilter(columnName, filterCriteria) | PivotFilter | تضيف فلترًا جديدًا استنادًا إلى عمود مصدر البيانات المحدّد مع معايير الفلترة المحدّدة. |
addPivotValue(columnName, summarizeFunction) | PivotValue | إضافة قيمة محورية جديدة بناءً على عمود مصدر البيانات المحدد مع التلخيص المحدد الأخرى. |
addRowGroup(columnName) | PivotGroup | تضيف مجموعة صفوف محورية جديدة استنادًا إلى عمود مصدر البيانات المحدّد. |
asPivotTable() | PivotTable | تعرض الجدول المحوري لمصدر البيانات ككائن جدول محوري عادي. |
cancelDataRefresh() | DataSourcePivotTable | تؤدي هذه السياسة إلى إلغاء عملية إعادة تحميل البيانات المرتبطة بهذا العنصر إذا كانت قيد التشغيل حاليًا. |
forceRefreshData() | DataSourcePivotTable | تتم إعادة تحميل بيانات هذا العنصر بغض النظر عن حالته الحالية. |
getDataSource() | DataSource | يحصل على مصدر البيانات المرتبط به العنصر. |
getStatus() | DataExecutionStatus | الحصول على حالة تنفيذ البيانات للعنصر. |
refreshData() | DataSourcePivotTable | يُعيد تحميل بيانات العنصر. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | انتظر حتى اكتمال التنفيذ الحالي، وتنتهي المهلة بعد عدد الثواني المحدد. |
الوثائق التفصيلية
addColumnGroup(columnName)
تضيف مجموعة أعمدة محورية جديدة استنادًا إلى عمود مصدر البيانات المحدّد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
columnName | String | اسم عمود مصدر البيانات الذي تستند إليه المجموعة المحورية. |
الإرجاع
PivotGroup
— المجموعة المحورية الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addFilter(columnName, filterCriteria)
تضيف فلترًا جديدًا استنادًا إلى عمود مصدر البيانات المحدّد مع معايير الفلترة المحدّدة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
columnName | String | اسم عمود مصدر البيانات الذي يعتمد عليه الفلتر. |
filterCriteria | FilterCriteria | المعايير التي يستخدمها الفلتر. |
الإرجاع
PivotFilter
: الفلتر الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addPivotValue(columnName, summarizeFunction)
إضافة قيمة محورية جديدة بناءً على عمود مصدر البيانات المحدد مع التلخيص المحدد الأخرى.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
columnName | String | اسم عمود مصدر البيانات الذي تستند إليه القيمة المحورية. |
summarizeFunction | PivotTableSummarizeFunction | دالة التلخيص التي تستخدمها القيمة المحورية. |
الإرجاع
PivotValue
— القيمة المحورية الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addRowGroup(columnName)
تضيف مجموعة صفوف محورية جديدة استنادًا إلى عمود مصدر البيانات المحدّد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
columnName | String | اسم عمود مصدر البيانات الذي تستند إليه المجموعة المحورية. |
الإرجاع
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
cancelDataRefresh()
تؤدي هذه السياسة إلى إلغاء عملية إعادة تحميل البيانات المرتبطة بهذا العنصر إذا كانت قيد التشغيل حاليًا.
يوضّح هذا المثال كيفية إلغاء عملية إعادة تحميل الصيغة.
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
يعرض هذا العمود استثناءً إذا لم يكن نوع مصدر البيانات مفعَّلاً. استخدام طريقة
SpreadsheetApp#enable...Execution()
لتفعيل تنفيذ البيانات لمصدر بيانات معيّن
الكتابة.
الإرجاع
DataSourcePivotTable
— كائن البيانات.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
تتم إعادة تحميل بيانات هذا العنصر بغض النظر عن حالته الحالية. يمكنك الاطّلاع على refreshData()
عن
المزيد من التفاصيل. إذا أردت إلغاء عملية إعادة تحميل جارية لهذا العنصر، يُرجى الاطّلاع على cancelDataRefresh()
.
يعرض هذا العمود استثناءً إذا لم يكن نوع مصدر البيانات مفعَّلاً. استخدام طريقة 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)
انتظر حتى اكتمال التنفيذ الحالي، وتنتهي المهلة بعد عدد الثواني المحدد. لعرض استثناء في حالة عدم اكتمال التنفيذ عند انتهاء المهلة، ولكن لا يلغي وتنفيذ البيانات.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
timeoutInSeconds | Integer | مدة الانتظار لتنفيذ البيانات بالثواني. الحد الأقصى هو 300 ثوانٍ. |
الإرجاع
DataExecutionStatus
— حالة تنفيذ البيانات
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets