این راهنما نحوه و چرایی استفاده از Google Sheets API برای ایجاد جداول محوری در صفحات گسترده را توضیح می دهد.
جدول محوری چیست؟
جداول محوری روشی را برای خلاصه کردن داده ها در صفحه گسترده ارائه می دهد، به طور خودکار جمع آوری، مرتب سازی، شمارش یا میانگین گیری داده ها در حالی که نتایج خلاصه شده را در یک جدول جدید نمایش می دهد. جدول محوری به عنوان نوعی پرس و جو در برابر مجموعه داده های منبع عمل می کند. این داده منبع در مکان دیگری در صفحه گسترده وجود دارد و جدول محوری یک نمای پردازش شده از داده ها را ارائه می دهد.
به عنوان مثال، مجموعه داده های فروش زیر را در نظر بگیرید:
الف | ب | سی | دی | E | اف | جی | |
1 | دسته بندی آیتم | شماره مدل | هزینه | مقدار | منطقه | فروشنده | تاریخ ارسال |
2 | چرخ | W-24 | 20.50 دلار | 4 | غرب | بث | 3/1/2016 |
3 | درب | D-01X | 15.00 دلار | 2 | جنوب | امیر | 1395/3/15 |
4 | موتور | ENG-0134 | 100.00 دلار | 1 | شمال | کارمن | 2016/3/20 |
5 | قاب | FR-0B1 | 34.00 دلار | 8 | شرق | هانا | 3/12/2016 |
6 | پانل | P-034 | 6.00 دلار | 4 | شمال | دوین | 4/2/2016 |
7 | پانل | P-052 | 11.50 دلار | 7 | شرق | اریک | 1395/5/16 |
8 | چرخ | W-24 | 20.50 دلار | 11 | جنوب | شلدون | 30/4/2016 |
9 | موتور | ENG-0161 | 330.00 دلار | 2 | شمال | جسی | 7/2/2016 |
10 | درب | D-01Y | 29.00 دلار | 6 | غرب | آرماندو | 1395/3/13 |
11 | قاب | FR-0B1 | 34.00 دلار | 9 | جنوب | یولیانا | 2016/2/27 |
12 | پانل | P-102 | 3.00 دلار | 15 | غرب | کارمن | 1395/4/18 |
13 | پانل | P-105 | 8.25 دلار | 13 | غرب | جسی | 2016/6/20 |
14 | موتور | ENG-0211 | 283.00 دلار | 1 | شمال | امیر | 2016/6/21 |
15 | درب | D-01X | 15.00 دلار | 2 | غرب | آرماندو | 7/3/2016 |
16 | قاب | FR-0B1 | 34.00 دلار | 6 | جنوب | کارمن | 1395/07/15 |
17 | چرخ | W-25 | 20.00 دلار | 8 | جنوب | هانا | 5/2/2016 |
18 | چرخ | W-11 | 29.00 دلار | 13 | شرق | اریک | 1395/5/19 |
19 | درب | D-05 | 17.70 دلار | 7 | غرب | بث | 2016/6/28 |
20 | قاب | FR-0B1 | 34.00 دلار | 8 | شمال | شلدون | 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 اصلاح شده ایجاد کنید و سلول را با استفاده از آن به روز کنید، شبیه به اضافه کردن یک جدول محوری جدید.
- برای حذف یک جدول محوری، سلول را با مقادیر خالی به روز کنید. برای مثال، نمونه Delete a pivot table را ببینید.
موارد استفاده کنید
کاربردهای مختلفی برای جداول محوری، در طیف وسیعی از زمینه ها از جمله تجزیه و تحلیل آماری، کاربردهای ERP، گزارشگری مالی و موارد دیگر وجود دارد. موارد استفاده از جدول محوری کلاسیک شامل موارد زیر است:
- کل فروش بر اساس منطقه و سه ماهه
- میانگین حقوق بر اساس عنوان و مکان
- تعداد حوادث بر اساس محصول و زمان روز
تعداد کاربردهای بالقوه جداول محوری بسیار زیاد است و توانایی تولید آنها به صورت برنامه نویسی قدرتمند است. شما می توانید جداول محوری ایجاد کنید که از کاوش تعاملی پشتیبانی می کنند اما برای شرایط خاص طراحی شده اند، به عنوان مثال:
- دادههای حادثه را برای آخرین دوره 24 ساعته کاوش کنید
- مشاهده/تحلیل داده های انبوه مربوط به حساب انتخابی فعلی
- داده های فروش را برای مناطق متعلق به کاربر فعلی بررسی کنید
مثال
این مثال یک جدول محوری از یک مجموعه داده ایجاد می کند تا گزارش «شماره مدل بر اساس منطقه» را که در مقدمه این صفحه نشان داده شده است، تولید کند. برای مثالهای بیشتر، صفحه نمونه جدول محوری را ببینید.