يصف هذا الدليل كيف ولماذا تستخدم واجهة برمجة تطبيقات Google Sheets API لإنشاء جداول محورية في جداول البيانات الخاصة بك.
ما الجدول المحوري؟
توفر الجداول المحورية طريقة لتلخيص البيانات في جدول البيانات، وتجميع البيانات أو فرزها أو حسابها أو حساب متوسطها تلقائيًا أثناء عرض النتائج الملخصة في جدول جديد. يعمل الجدول المحوري كنوع من الاستعلام مقابل مجموعة بيانات مصدر. توجد بيانات المصدر هذه في موقع آخر في جدول البيانات، ويقدم الجدول المحوري طريقة عرض تمت معالجتها للبيانات.
على سبيل المثال، ضع في الاعتبار مجموعة بيانات المبيعات التالية:
A | B | C | D | ج | ح | G | |
1 | فئة العنصر | رقم الطراز | التكلفة | العدد | منطقة | مندوب مبيعات | تاريخ الشحن |
2 | العجلة | W-24 | SAR 20.50 | 4 | الغرب | بيث | 1/3/2016 |
3 | باب | D-01X | 15.00 دولار أمريكي | 2 | الجنوب | أمير | 2016/3/15 |
4 | المحرك | ENG-0134 | 100.00 دولار أميركي (أو ما يعادله بالعملة المحلية) | 1 | الشمال | كارمن | 20/3/2016 |
5 | إطار | FR-0B1 | 34.00 دولار أمريكي | 8 | الشرق | هناء | 2016/3/12 |
6 | لوحة | P-034 | 6.00 دولار أمريكي | 4 | الشمال | ديفين | 2/4/2016 |
7 | لوحة | P-052 | 11.50 دولار أمريكي | 7 | الشرق | إريك | 16/5/2016 |
8 | العجلة | W-24 | SAR 20.50 | 11 | الجنوب | Sheldon | 30/4/2016 |
9 | المحرك | ENG-0161 | 330.00 دولار أمريكي | 2 | الشمال | جيسي | 2/7/2016 |
10 | باب | D-01Y | 29.00 دولار أمريكي | 6 | الغرب | أرماندو | 2016/3/13 |
11 | إطار | FR-0B1 | 34.00 دولار أمريكي | 9 | الجنوب | يوليانا | 27/2/2016 |
12 | لوحة | P-102 | 3.00 دولارات أمريكية (أو ما يعادلها بالعملة المحلية) | 15 | الغرب | كارمن | 18/4/2016 |
13 | لوحة | P-105 | 8.25 دولار أمريكي | 13 | الغرب | جيسي | 20/6/2016 |
14 | المحرك | ENG-0211 | 283.00 دولار أمريكي | 1 | الشمال | أمير | 21/6/2016 |
15 | باب | D-01X | 15.00 دولار أمريكي | 2 | الغرب | أرماندو | 3/7/2016 |
16 | إطار | FR-0B1 | 34.00 دولار أمريكي | 6 | الجنوب | كارمن | 15/7/2016 |
17 | العجلة | W-25 | $20.00 | 8 | الجنوب | هناء | 2/5/2016 |
18 | العجلة | W-11 | 29.00 دولار أمريكي | 13 | الشرق | إريك | 19/5/2016 |
19 | باب | D-05 | 17.70 دولار أمريكي | 7 | الغرب | بيث | 28/6/2016 |
20 | إطار | FR-0B1 | 34.00 دولار أمريكي | 8 | الشمال | Sheldon | 30/3/2016 |
يمكنك استخدام جدول محوري لإنشاء تقرير يوضح عدد أرقام الطراز التي تم بيعها في كل منطقة:
بالنسبة إلى رمز المصدر المستخدَم لإنشاء هذا الجدول المحوري، اطّلع على القسم مثال أدناه.
بمجرد وضع الجدول المحوري في جدول بيانات، يمكن للمستخدمين تغيير هيكل الملخص وتفاصيله بشكل تفاعلي باستخدام واجهة مستخدم جداول البيانات.
العمل على الجداول المحورية
يرتبط تعريف الجدول المحوري بخلية واحدة على ورقة. على الرغم من أن مظهرها المعروض هو العديد من الخلايا في كل من الارتفاع والعرض، إلا أنها موجودة آليًا في إحداثي واحد للخلية. تصبح هذه الخلية الزاوية العلوية اليسرى من الجدول المحوري المعروض، مع تحديد امتدادها الأفقي والرأسي من خلال تعريفها.
إضافة جدول محوري
لإضافة جدول محوري، استخدِم طريقة batchUpdate، لتوفير طلب updateCells. يمكنك استخدام هذا الطلب لتوفير تعريف PivotTable كمحتوى خلية كما هو موضح أدناه:
"updateCells": {
"rows": {
"values": [{
"pivotTable": MyPivotTable
},
"start": {
"sheetId": sheetId,
"rowIndex": 0,
"columnIndex": 0
},
"fields": "pivotTable"
}
يؤدي هذا إلى وضع الجدول المحوري الموضح في MyPivotTable
على الورقة المحددة،
مع الركن العلوي الأيسر في الخلية A1
. (يكون ارتفاع الجدول المحوري وعرضه ديناميكيين،
ما عليك سوى تحديد المصدر).
يتيح لك النوع PivotTable تحديد ما يلي:
- نطاق بيانات المصدر
- حقل واحد أو أكثر ستشكل بياناته صفوف الجدول المحوري
- حقل أو أكثر ستشكل بياناته أعمدة الجدول المحوري
- معايير التصفية والتجميع
- تخطيط الجدول المحوري
تعديل الجداول المحورية وحذفها
لا توجد طلبات صريحة لتعديل أو حذف جدول محوري. بدلاً من ذلك، يمكنك استخدام طلب updateCells مع محتوى مختلف في الخلية:
- لتعديل جدول محوري، أنشئ تعريف PivotTable معدّلًا وعدِّل الخلية التي تستخدمها، على غرار إضافة جدول محوري جديد.
- لحذف جدول محوري، حدِّث الخلية بقيم فارغة. على سبيل المثال، اطلع على نموذج حذف جدول محوري.
حالات الاستخدام
هناك العديد من الاستخدامات المختلفة للجداول المحورية عبر مجموعة واسعة من المجالات، بما في ذلك التحليل الإحصائي وتطبيقات تخطيط موارد المؤسسات وإعداد التقارير المالية وغيرها. تتضمن حالات استخدام الجدول المحوري الكلاسيكي عناصر مثل:
- إجمالي المبيعات حسب المنطقة والربع السنوي
- متوسط الراتب حسب العنوان والموقع الجغرافي
- عدد الحوادث حسب المنتج والوقت من اليوم
إنّ عدد التطبيقات المحتمَلة للجداول المحورية كبير، والقدرة على إنشائها آلية فعّالة. يمكنك إنشاء جداول محورية تدعم الاستكشاف التفاعلي ولكنها مصمّمة وفقًا لظروف معيّنة، على سبيل المثال:
- استكشاف بيانات الحوادث خلال آخر 24 ساعة
- عرض/تحليل البيانات المجمّعة المقابلة للحساب المحدّد حاليًا
- فحص بيانات المبيعات في المناطق التي ينتمي إليها المستخدم الحالي
مثال
ينشئ هذا المثال جدولاً محوريًا من مجموعة بيانات لإنتاج تقرير "رقم الطراز حسب المنطقة" الذي يظهر في مقدمة هذه الصفحة. للحصول على أمثلة إضافية، يمكنك الاطّلاع على صفحة نموذج الجدول المحوري.