الجدول المحوري
جدول محوري
تمثيل JSON |
---|
{ "rows": [ { object ( |
الحقول | |
---|---|
rows[]
|
كل تجميع صفوف في الجدول المحوري |
columns[]
|
كل عمود يتم تجميعه في الجدول المحوري. |
criteria
|
تعيين اختياري للفلاتر لكل إزاحة عمود مصدر يتم تطبيق الفلاتر قبل تجميع البيانات في الجدول المحوري. يُعد مفتاح الخريطة إزاحة العمود للنطاق المصدر الذي تريد فلترته، والقيمة هي معايير هذا العمود.
على سبيل المثال، إذا كان المصدر هو
تم إيقاف هذا الحقل نهائيًا لصالح
|
filterSpecs[]
|
يتم تطبيق الفلاتر على أعمدة المصدر قبل تجميع البيانات للجدول المحوري.
تتم تعبئة كل من
|
values[]
|
قائمة بالقيم التي يمكن تضمينها في الجدول المحوري. |
valueLayout
|
ما إذا كان يجب إدراج القيم أفقيًا (كأعمدة) أو عموديًا (كصفوف). |
dataExecutionStatus
|
الإخراج فقط. حالة تنفيذ البيانات للجداول المحورية لمصدر البيانات |
حقل الاتحاد
source_data . مصدر بيانات الجدول المحوري.
يمكن أن تكون السمة source_data
واحدة فقط من العناصر التالية:
|
|
source
|
النطاق الذي يقرأ منه الجدول المحوري البيانات. |
dataSourceId
|
رقم تعريف مصدر البيانات الذي يستخدمه الجدول المحوري في قراءة البيانات منه. |
PivotGroup
تجميع واحد (إما صف أو عمود) في جدول محوري.
تمثيل JSON |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
الحقول | |
---|---|
showTotals
|
صحيح إذا كان الجدول المحوري يجب أن يشمل القيم الإجمالية لهذه المجموعة. |
valueMetadata[]
|
البيانات الوصفية حول القيم في المجموعة |
sortOrder
|
يجب ترتيب القيم في هذه المجموعة. |
valueBucket
|
مجموعة البيانات المحورية المقابلة للترتيب حسبها. إذا لم يتم تحديد ذلك، يكون الترتيب أبجديًا حسب قيم هذه المجموعة. |
repeatHeadings
|
صحيح إذا كان يجب تكرار العناوين في هذه المجموعة المحورية. ويسري ذلك على مجموعات الصفوف فقط ويتم تجاهله من خلال الأعمدة. يتم تلقائيًا تقليل تكرار العناوين من خلال عدم عرض عناوين على المستوى الأعلى تكون متماثلة فيها. على سبيل المثال، على الرغم من أن الصف الثالث أدناه يتوافق مع "Q1 آذار (مارس)"، لا يتم عرض "Q1" لأنه متكرر مع الصفوف السابقة. في حال ضبط العناوين المتكرّرة على "صحيح"، سيؤدي استخدام هذه السياسة إلى تكرار "Q1" في "فبراير" و"مارس".
|
label
|
التصنيفات المراد استخدامها في مجموعات الصفوف/الأعمدة التي يمكن تخصيصها. في الجدول المحوري التالي، على سبيل المثال، تصنيف الصف هو
|
groupRule
|
قاعدة المجموعة المراد تطبيقها على مجموعة الصفوف/الأعمدة هذه. |
groupLimit
|
الحد الأقصى للعدد في الصفوف أو الأعمدة المراد تطبيقه على هذه المجموعة المحورية. |
حقل الاتحاد
source . مصدر بيانات المجموعة المحورية.
يمكن أن تكون السمة source
واحدة فقط من العناصر التالية:
|
|
sourceColumnOffset
|
إزاحة العمود للنطاق المصدر الذي تستند إليه هذه التجميع.
على سبيل المثال، إذا كان المصدر هو
|
dataSourceColumnReference
|
وتستند إشارة إلى عمود مصدر البيانات إلى هذه المجموعة. |
البيانات الوصفية لمجموعة PivotGroup
البيانات الوصفية حول قيمة في مجموعة محورية
تمثيل JSON |
---|
{
"value": {
object (
|
الحقول | |
---|---|
value
|
القيمة المحسوبة التي تتوافق معها البيانات الوصفية. (يُرجى العِلم أنّ القيمة
|
collapsed
|
صحيح إذا تم تصغير البيانات المقابلة للقيمة. |
PivotGroupRatingValueBucket
معلومات عن القيم التي يجب استخدامها في مجموعة محورية للترتيب.
تمثيل JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object (
|
الحقول | |
---|---|
valuesIndex
|
الإزاحة في
قائمة |
buckets[]
|
تحدد مجموعة البيانات التي يتم اختيار القيم للترتيب منها. على سبيل المثال، في جدول محوري يضم مجموعة صفوف واحدة ومجموعة أعمدة، يمكن أن تحتوي مجموعة الصفوف على قيمتين كحد أقصى. وتتطابق القيمة الأولى مع قيمة ضمن مجموعة الأعمدة الأولى، كما تتطابق القيمة الثانية مع قيمة في مجموعة الأعمدة الثانية. وفي حال عدم إدراج أي قيم، يعني ذلك أنّه يجب ترتيب الصف وفقًا لـ "الإجمالي العام" فوق مجموعات الأعمدة. وفي حال إدراج قيمة واحدة، سينطبق هذا الأمر على استخدام "إجمالي" مجموعة البيانات هذه. |
القاعدة المحورية
إعداد اختياري في
PivotGroup
يحدّد مجموعات البيانات للقيم في عمود بيانات المصدر بدلاً من تقسيم كل قيمة فردية. ويمكن إضافة PivotGroup
واحدة فقط لها قاعدة مجموعة لكل عمود في بيانات المصدر، ولكن في أي عمود معيّن، يمكنك إضافة قاعدة PivotGroup
وقاعدة PivotGroup
لا تحتوي على هذه القاعدة.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
rule . القاعدة المراد تطبيقها على
PivotGroup
يمكن أن تكون السمة rule
واحدة فقط من العناصر التالية:
|
|
manualRule
|
|
histogramRule
|
|
dateTimeRule
|
|
القاعدة اليدوية
تتيح لك تنظيم القيم يدويًا في عمود بيانات المصدر في مجموعات بيانات تحمل أسماء من اختيارك. على سبيل المثال، جدول محوري يجمع السكان حسب الحالة:
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
يمكن تحويله إلى جدول محوري يجمع السكان حسب المنطقة الزمنية من خلال توفير قائمة بالمجموعات (على سبيل المثال، groupName = 'Central'، والعناصر = ['AL'، 'AR'، 'IA', ...]) إلى قاعدة مجموعة يدوية. وتجدر الإشارة إلى أنه يمكن تحقيق تأثير مشابه من خلال إضافة عمود منطقة زمنية إلى بيانات المصدر وتعديل الجدول المحوري.
+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central | 106.3 |
| Eastern | 151.9 |
| Mountain | 17.4 |
...
+-----------+-------------------+
تمثيل JSON |
---|
{
"groups": [
{
object (
|
الحقول | |
---|---|
groups[]
|
قائمة أسماء المجموعات والعناصر المقابلة من بيانات المصدر التي يتم ربطها بكل اسم مجموعة. |
مجموعة القواعد اليدوية
اسم مجموعة وقائمة بالعناصر من بيانات المصدر التي يجب وضعها في المجموعة بهذا الاسم.
تمثيل JSON |
---|
{ "groupName": { object ( |
الحقول | |
---|---|
groupName
|
اسم المجموعة التي يجب أن تكون سلسلة. يجب أن يكون لكل مجموعة في
|
items[]
|
عناصر البيانات المصدر التي يجب وضعها في هذه المجموعة. قد يكون كل عنصر سلسلة أو رقمًا أو قيمة منطقية. يمكن أن تظهر العناصر في مجموعة واحدة على الأكثر ضمن |
قاعدة التكرار
تتيح لك تنظيم القيم الرقمية في عمود بيانات المصدر في مجموعات بيانات بحجم ثابت. يتم وضع جميع القيم من
HistogramRule.start
إلى
HistogramRule.end
في مجموعات بحجم
HistogramRule.interval
. بالإضافة إلى ذلك، يتم وضع جميع القيم الواردة أدناه
HistogramRule.start
في مجموعة واحدة، ويتم وضع جميع القيم التي تتجاوز
HistogramRule.end
في مجموعة أخرى. يجب استخدام السمة
HistogramRule.interval
فقط، ولكن في حال تقديم السمتَين HistogramRule.start
وHistogramRule.end
، يجب أن تكون قيمة HistogramRule.start
أقل من HistogramRule.end
. على سبيل المثال، جدول محوري يعرض متوسط مبلغ الشراء حسب العمر يحتوي على أكثر من 50 صفًا:
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
يمكن تحويله إلى جدول محوري يبدو كما هو موضّح في الجدول أدناه من خلال تطبيق قاعدة مجموعة مدرّج تكراري مع
HistogramRule.start
من 25،
وHistogramRule.interval
من 20،
وHistogramRule.end
من 65.
+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25 | $19.34 |
| 25-45 | $31.43 |
| 45-65 | $35.87 |
| > 65 | $27.55 |
+-------------+-------------------+
| Grand Total | $29.12 |
+-------------+-------------------+
تمثيل JSON |
---|
{ "interval": number, "start": number, "end": number } |
الحقول | |
---|---|
interval
|
حجم مجموعات البيانات التي يتم إنشاؤها. يجب أن تكون موجبة. |
start
|
الحد الأدنى لقيمة وضع العناصر في حِزم بحجم ثابت. يتم تجميع القيم الواردة في البداية في حزمة واحدة. هذا الحقل اختياري. |
end
|
الحد الأقصى للقيمة التي يتم وضع العناصر بها في مجموعات بيانات ذات حجم ثابت. يتم جمع القيم التي تتجاوز النهاية في حزمة واحدة. هذا الحقل اختياري. |
قاعدة التاريخ والوقت
ويسمح لك بتنظيم قيم التاريخ الزمني في عمود بيانات المصدر في مجموعات بيانات استنادًا إلى الأجزاء المحدَّدة من قيم التاريخ أو الوقت. على سبيل المثال، ضَع في الاعتبار جدولاً محوريًا يعرض معاملات المبيعات حسب التاريخ:
+----------+--------------+
| Date | SUM of Sales |
+----------+--------------+
| 1/1/2017 | $621.14 |
| 2/3/2017 | $708.84 |
| 5/8/2017 | $326.84 |
...
+----------+--------------+
تطبيق قاعدة مجموعة التاريخ والوقت مع نتائج
DateTimeRuleType
من YEAR_MONTH في الجدول المحوري التالي.
+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan | $53,731.78 |
| 2017-Feb | $83,475.32 |
| 2017-Mar | $94,385.05 |
...
+--------------+--------------+
تمثيل JSON |
---|
{
"type": enum (
|
الحقول | |
---|---|
type
|
نوع تجميع التاريخ والوقت المراد تطبيقه. |
DateTimeRuleType
الأنواع المتاحة من قواعد التجميع المستندة إلى التاريخ. يفترض هذا المستند أنّ لغة جدول البيانات هي "en-US"، إلا أنّ العرض الفعلي للتواريخ والأوقات يستخدم لغة جدول البيانات لبعض أنواع القواعد.
عمليات التعداد | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
لا يتم استخدام النوع التلقائي. |
SECOND
|
تواريخ المجموعة حسب الثانية، من 0 إلى 59. |
MINUTE
|
تواريخ المجموعة حسب الدقيقة، من 0 إلى 59 |
HOUR
|
تجميع التواريخ حسب الساعة باستخدام نظام 24 ساعة، من 0 إلى 23 |
HOUR_MINUTE
|
تجمّع التواريخ حسب الساعة والدقيقة باستخدام نظام 24 ساعة، مثل 19:45. |
HOUR_MINUTE_AMPM
|
تجمّع التواريخ حسب الساعة والدقيقة باستخدام نظام 12 ساعة، مثل 7:45 مساءً. تتم ترجمة التصنيف AM/PM استنادًا إلى لغة جدول البيانات. |
DAY_OF_WEEK
|
تواريخ المجموعة حسب اليوم من الأسبوع، مثل الأحد ستتم ترجمة أيام الأسبوع استنادًا إلى لغة جدول البيانات. |
DAY_OF_YEAR
|
تواريخ المجموعة حسب اليوم من السنة، من 1 إلى 366 تجدر الإشارة إلى أن التواريخ بعد 29 شباط (فبراير) تقع في مجموعات بيانات مختلفة في السنوات الكبيسة مقارنةً بالسنوات غير الكبيسة. |
DAY_OF_MONTH
|
تواريخ المجموعة حسب اليوم من الشهر، من 1 إلى 31 |
DAY_MONTH
|
تجميع التواريخ حسب اليوم والشهر، على سبيل المثال، من 22 إلى نوفمبر. تتم ترجمة الشهر استنادًا إلى لغة جدول البيانات. |
MONTH
|
تجميع التواريخ حسب الشهر، مثلاً، شهر تشرين الثاني (نوفمبر) وستتم ترجمة الشهر استنادًا إلى لغة جدول البيانات. |
QUARTER
|
التواريخ المجمّعة حسب ربع السنة، على سبيل المثال، الربع الأول (الذي يمثّل من يناير إلى مارس). |
YEAR
|
تواريخ المجموعة حسب السنة، على سبيل المثال، 2008. |
YEAR_MONTH
|
تجميع التواريخ حسب السنة والشهر، على سبيل المثال، 2008-تشرين الثاني (نوفمبر). تتم ترجمة الشهر استنادًا إلى لغة جدول البيانات. |
YEAR_QUARTER
|
تجميع التواريخ حسب السنة والربع السنة مثلاً، الربع الرابع من العام 2008 |
YEAR_MONTH_DAY
|
تواريخ المجموعة حسب السنة والشهر واليوم، مثل 2008-11-22. |
تقييد المجموعة
الحد الأقصى لعدد الصفوف أو الأعمدة في المجموعة المحورية.
تمثيل JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
الحقول | |
---|---|
countLimit
|
الحد الأقصى للعدد |
applyOrder
|
ترتيب تطبيق الحد الأقصى للمجموعة على الجدول المحوري. يتم تطبيق حدود المجموعات المحورية من رقم ترتيب أدنى إلى أعلى. يتم تسوية أرقام الطلبات على أعداد صحيحة متتالية من 0.
لطلب الكتابة، لتخصيص الطلبات المطبّقة بالكامل، يجب ضبط هذا الحقل لجميع حدود المجموعات المحورية باستخدام رقم فريد. بخلاف ذلك، يتم تحديد الترتيب من خلال الفهرس في قائمة |
معايير الارتكاز
معايير عرض/إخفاء الصفوف في جدول محوري.
تمثيل JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
الحقول | |
---|---|
visibleValues[]
|
القيم التي يجب تضمينها. يتم استبعاد القيم غير المدرجة هنا. |
condition
|
شرط يجب أن يكون صحيحًا لكي يتم عرض القيم. (
يتم تقييم قيم الشرط التي تشير إلى النطاقات في تدوين A1 وفقًا لورقة الجدول المحوري. ويتم التعامل مع المراجع بشكل كامل، وبالتالي لا تتم تعبئتها في الجدول المحوري. على سبيل المثال، يتم التعامل مع قيمة الشرط
يمكن الإشارة إلى بيانات المصدر في الجدول المحوري باسم اسم العمود. على سبيل المثال، إذا كانت بيانات المصدر تتضمّن عمودَين باسم "الأرباح" و "التكلفة" وتم تطبيق شرط على عمود "الأرباح" من النوع |
visibleByDefault
|
ما إذا كانت القيم مرئية تلقائيًا. وفي حال ضبطها على "صحيح"، يتم تجاهل
|
المواصفات المحورية
معايير فلتر الجدول المحوري المرتبطة بمعادلة عمود عمود معيّن.
تمثيل JSON |
---|
{ "filterCriteria": { object ( |
الحقول | |
---|---|
filterCriteria
|
معايير العمود |
حقل الاتحاد
source . عمود المصدر الذي ينطبق عليه هذا الفلتر.
يمكن أن تكون السمة source
واحدة فقط من العناصر التالية:
|
|
columnOffsetIndex
|
إزاحة العمود المستندة إلى الصفر للنطاق المصدر |
dataSourceColumnReference
|
الإشارة إلى عمود مصدر البيانات |
القيمة المحورية
تعريف طريقة حساب القيمة في الجدول المحوري
تمثيل JSON |
---|
{ "summarizeFunction": enum ( |
الحقول | |
---|---|
summarizeFunction
|
دالة لتلخيص القيمة. في حال ضبط السمة |
name
|
اسم لاستخدامه للقيمة. |
calculatedDisplayType
|
وفي حال تحديد ذلك، يشير إلى أن القيم المحورية يجب أن تظهر نتيجة لعملية حسابية بقيمة محورية أخرى. على سبيل المثال، إذا تم تحديد ComputeDisplayType على أنه PERCENT_OF_GRAND_TOTAL، يتم عرض جميع القيم المحورية كنسبة مئوية من الإجمالي الكبير. في محرِّر "جداول بيانات Google"، يُشار إلى ذلك باسم "عرض باسم" في قسم القيمة في الجدول المحوري. |
حقل الاتحاد
value . البيانات المطلوب استخدامها للقيم في الجدول المحوري. يجب ضبط قيمة واحدة بالضبط.
يمكن أن تكون السمة value
واحدة فقط من العناصر التالية:
|
|
sourceColumnOffset
|
إزاحة العمود لنطاق المصدر الذي تتم قراءة هذه القيمة منه.
على سبيل المثال، إذا كان المصدر هو
|
formula
|
صيغة مخصّصة لاحتساب القيمة يجب أن تبدأ الصيغة بحرف
|
dataSourceColumnReference
|
الإشارة إلى عمود مصدر البيانات الذي تقرأ منه هذه القيمة. |
PivotValueSummarizeFunction
دالة لتلخيص قيمة محورية.
عمليات التعداد | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
يُرجى عدم استخدام القيمة التلقائية. |
SUM
|
تتطابق مع الدالة
SUM .
|
COUNTA
|
تتطابق مع الدالة
COUNTA .
|
COUNT
|
تتطابق مع الدالة
COUNT .
|
COUNTUNIQUE
|
تتطابق مع الدالة
COUNTUNIQUE .
|
AVERAGE
|
تتطابق مع الدالة
AVERAGE .
|
MAX
|
تتطابق مع الدالة
MAX .
|
MIN
|
تتطابق مع الدالة
MIN .
|
MEDIAN
|
تتطابق مع الدالة
MEDIAN .
|
PRODUCT
|
تتطابق مع الدالة
PRODUCT .
|
STDEV
|
تتطابق مع الدالة
STDEV .
|
STDEVP
|
تتطابق مع الدالة
STDEVP .
|
VAR
|
تتطابق مع الدالة
VAR .
|
VARP
|
تتطابق مع الدالة
VARP .
|
CUSTOM
|
تشير إلى أنّ الصيغة يجب أن تكون كما هي، ولا تكون صالحة إلا في حال ضبط
PivotValue.formula .
|
قدّم نوع القيمة المحورية
الطرق المحتملة لاحتساب القيم المحورية للعرض.
عمليات التعداد | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
القيمة التلقائية هي "عدم الاستخدام". |
PERCENT_OF_ROW_TOTAL
|
تعرض القيم المحورية كنسبة مئوية من إجمالي قيم الصفوف. |
PERCENT_OF_COLUMN_TOTAL
|
تعرِض القيم المحورية كنسبة مئوية من إجمالي قيم العمود. |
PERCENT_OF_GRAND_TOTAL
|
تعرض القيم المحورية كنسبة مئوية من القيم الإجمالية الكبرى. |
تنسيق PivotValueLayout
تنسيق القيم المحورية.
عمليات التعداد | |
---|---|
HORIZONTAL
|
يتم وضع القيم أفقيًا (كأعمدة). |
VERTICAL
|
يتم وضع القيم عموديًا (كصفوف). |