جدول محوري
جدول محوري
تمثيل 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
|
صحيح إذا كان يجب تكرار العناوين في مجموعة Pivot هذه. يصلح هذا فقط لتجميع الصفوف ويتم تجاهله بواسطة الأعمدة. بشكل افتراضي، يتم تقليل تكرار العناوين عن طريق عدم عرض عناوين ذات مستوى أعلى عند تطابقها. على سبيل المثال، على الرغم من أن الصف الثالث أدناه يتجاوب مع "الربع الأول من آذار (مارس)"، و"Q1" لأنه متكرر مع الصفوف السابقة. سيؤدي ضبط تكرار العناوين على "صحيح" إلى حدوث "Q1" تكرارًا في "فبراير" و"مارس".
|
label
|
التصنيفات التي سيتم استخدامها لمجموعات الصفوف أو الأعمدة والتي يمكن تخصيصها على سبيل المثال، في الجدول المحوري التالي، يكون تصنيف الصف هو
|
groupRule
|
قاعدة المجموعة المطلوب تطبيقها على مجموعة الصفوف/الأعمدة هذه. |
groupLimit
|
الحد الأقصى لعدد الصفوف أو الأعمدة المطلوب تطبيقه على مجموعة الجدول المحوري هذه |
حقل الربط
source . مصدر بيانات المجموعة المحورية.
source
واحد فقط مما يلي:
|
|
sourceColumnOffset
|
إزاحة العمود لنطاق المصدر الذي يستند إليه هذا التجميع.
على سبيل المثال، إذا كان المصدر
|
dataSourceColumnReference
|
المرجع إلى عمود مصدر البيانات الذي يستند إليه هذا التجميع. |
PivotGroupValueMetadata
بيانات التعريف عن قيمة في مجموعة محورية
تمثيل JSON |
---|
{
"value": {
object ( |
الحقول | |
---|---|
value
|
القيمة المحسوبة التي تتوافق معها البيانات الوصفية (لاحظ أن
|
collapsed
|
صحيح إذا كانت البيانات المقابلة للقيمة مصغّرة. |
PivotGroupSortValueBucket
معلومات حول القيم التي يجب استخدامها في المجموعة المحورية للفرز.
تمثيل JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object ( |
الحقول | |
---|---|
valuesIndex
|
معادلة فرق البيانات
|
buckets[]
|
تحدد مجموعة البيانات التي يتم اختيار القيم منها للترتيب. على سبيل المثال، في جدول محوري يحتوي على مجموعة صفوف واحدة & مجموعتَي أعمدة، يمكن لمجموعة الصفوف سرد ما يصل إلى قيمتين. تتطابق القيمة الأولى مع قيمة ضمن مجموعة الأعمدة الأولى، وتتطابق القيمة الثانية مع قيمة في مجموعة الأعمدة الثانية. في حال عدم إدراج أي قيم، يعني ذلك أنّه يجب ترتيب الصف وفقًا "للمجموع الكلي" على مستوى مجموعات الأعمدة. في حال إدراج قيمة واحدة، سيؤدي ذلك إلى استخدام "الإجمالي" لهذه المجموعة. |
PivotGroupRule
إعداد اختياري في
PivotGroup
يحدِّد مجموعات للقيم في عمود البيانات المصدر بدلاً من تقسيم كل قيمة فردية. واحد فقط
PivotGroup
بقاعدة مجموعة لكل عمود في بيانات المصدر، ولكن يمكنك في أي عمود إضافة
PivotGroup
لديها قاعدة
PivotGroup
إلا أنها لا تستخدم.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الربط
rule . القاعدة التي سيتم تطبيقها على
PivotGroup
rule
يمكن أن تكون إحدى القيم التالية فقط:
|
|
manualRule
|
أ
|
histogramRule
|
|
dateTimeRule
|
حاسمة
|
ManualRule
تسمح لك هذه الميزة بتنظيم القيم يدويًا في عمود بيانات المصدر في مجموعات بأسماء من اختيارك. على سبيل المثال، جدول محوري يجمع عدد السكان حسب الولاية:
+-------+-------------------+
| 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[]
|
قائمة بأسماء المجموعات والعناصر المقابلة لها من البيانات المصدر التي ترتبط بكل اسم مجموعة |
ManualRuleGroup
اسم مجموعة وقائمة بالعناصر من بيانات المصدر التي يجب وضعها في المجموعة بهذا الاسم.
تمثيل JSON |
---|
{ "groupName": { object ( |
الحقول | |
---|---|
groupName
|
اسم المجموعة، الذي يجب أن يكون سلسلة. يجب أن يكون لكل مجموعة في
|
items[]
|
العناصر المتوفّرة في بيانات المصدر التي يجب وضعها في هذه المجموعة قد يكون كل عنصر سلسلة أو رقمًا أو قيمة منطقية. لا يمكن أن تظهر العناصر في أكثر من مجموعة واحدة داخل مجموعة محدّدة.
|
HistogramRule
تسمح لك بتنظيم القيم الرقمية في عمود بيانات المصدر في مجموعات ذات حجم ثابت. يتم وضع كل القيم من
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
|
الحد الأقصى للقيمة التي يتم عندها وضع العناصر في مجموعات ذات حجم ثابت. يتم تجميع القيم فوق النهاية في مجموعة واحدة. هذا الحقل اختياري. |
DateTimeRule
يتيح لك تنظيم قيم التاريخ والوقت في عمود بيانات المصدر في مجموعات استنادًا إلى أجزاء محدّدة من قيم التاريخ أو الوقت. على سبيل المثال، نأخذ جدولاً محوريًا يعرض معاملات المبيعات حسب التاريخ:
+----------+--------------+
| 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
|
تجميع التواريخ حسب ربع السنة، على سبيل المثال Q1 (الذي يمثل يناير - مارس). |
YEAR
|
تجميع التواريخ حسب السنة، على سبيل المثال 2008. |
YEAR_MONTH
|
تجميع التواريخ حسب السنة والشهر، على سبيل المثال 2008-تشرين الثاني (نوفمبر). تتم ترجمة الشهر استنادًا إلى لغة جدول البيانات. |
YEAR_QUARTER
|
تجميع التواريخ حسب السنة والربع، على سبيل المثال، الربع الرابع من عام 2008 |
YEAR_MONTH_DAY
|
تجميع التواريخ حسب السنة والشهر واليوم، على سبيل المثال 2008-11-22. |
PivotGroupLimit
الحد الأقصى لعدد الصفوف أو الأعمدة في المجموعة المحورية.
تمثيل JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
الحقول | |
---|---|
countLimit
|
الحدّ الأقصى لعدد العناصر |
applyOrder
|
ترتيب تطبيق الحد الأقصى للمجموعة على الجدول المحوري يتم تطبيق حدود المجموعة المحورية من الرقم الأدنى إلى الرقم الأعلى. تتم تسوية أرقام الطلبات إلى الأعداد الصحيحة المتتالية من 0.
بالنسبة إلى طلب الكتابة، لتخصيص الطلبات المُطبَّقة بالكامل، يجب ضبط هذا الحقل في جميع حدود المجموعات المحورية باستخدام رقم فريد. بخلاف ذلك، يتم تحديد الترتيب حسب الفهرس في قائمة
|
PivotFilterCriteria
معايير إظهار/إخفاء الصفوف في جدول محوري.
تمثيل JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object ( |
الحقول | |
---|---|
visibleValues[]
|
القيم التي يجب تضمينها ويتم استبعاد القيم غير المدرَجة هنا. |
condition
|
شرط يجب أن يكون صحيحًا حتى يتم عرض القيم. (
يتم تقييم قيم الشروط التي تشير إلى نطاقات في تنسيق A1 بالنسبة إلى ورقة الجدول المحوري. يتم التعامل مع المراجع بشكل مطلق، لذلك لا يتم ملؤها في الجدول المحوري. على سبيل المثال، قيمة الشرط
يمكن الإشارة إلى بيانات مصدر الجدول المحوري من خلال اسم عنوان العمود. على سبيل المثال، إذا كانت البيانات المصدر تتضمّن عمودَين باسم "الأرباح" و"التكلفة" وتم تطبيق شرط على عمود "الأرباح" من النوع
|
visibleByDefault
|
ما إذا كانت القيم مرئية تلقائيًا إذا كانت القيمة true، تكون
|
PivotFilterSpec
معايير فلترة الجدول المحوري المرتبطة بقيمة بدء عمود مصدر معيّن.
تمثيل JSON |
---|
{ "filterCriteria": { object ( |
الحقول | |
---|---|
filterCriteria
|
معايير العمود |
حقل الربط
source . عمود المصدر الذي ينطبق عليه هذا الفلتر
source
يمكن أن تكون إحدى القيم التالية فقط:
|
|
columnOffsetIndex
|
إزاحة العمود بالاستناد إلى الصفر لنطاق المصدر |
dataSourceColumnReference
|
يشير إلى المرجع إلى عمود مصدر البيانات. |
PivotValue
تعريف كيفية حساب قيمة في الجدول المحوري.
تمثيل JSON |
---|
{ "summarizeFunction": enum ( |
الحقول | |
---|---|
summarizeFunction
|
دالة لتلخيص القيمة في حال ضبط
|
name
|
اسم يمكن استخدامه للقيمة. |
calculatedDisplayType
|
إذا تم تحديدها، فإنها تشير إلى أنه يجب عرض القيم المحورية كنتيجة لعملية حسابية بقيمة محورية أخرى. على سبيل المثال، إذا تم تحديد calculatedDisplayType على أنّه PERCENT_OF_GRAND_TOTAL، يتم عرض جميع قيم جدول Pivot كنسبة مئوية من الإجمالي العام. في محرر "جداول بيانات Google"، يُشار إلى ذلك باسم "Show as" في قسم القيمة في الجدول المحوري. |
حقل الاتحاد
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
.
|
NONE
|
يشير إلى أن القيمة قد تم تلخيصها بالفعل، ولم يتم تحديد دالة التلخيص بشكل صريح. تُستخدَم للجداول المحورية لمصدر بيانات Looker التي سبق تلخيص قيمتها. |
PivotValueCalculatedDisplayType
الطرق المحتملة لحساب القيم المحورية للعرض.
عمليات التعداد | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
القيمة التلقائية، لا تستخدمها. |
PERCENT_OF_ROW_TOTAL
|
تعرِض هذه السمة قيم الجدول المحوري كنسبة مئوية من قيم إجمالي الصفوف. |
PERCENT_OF_COLUMN_TOTAL
|
تعرض القيم المحورية كنسبة مئوية من إجمالي قيم العمود. |
PERCENT_OF_GRAND_TOTAL
|
تعرض القيم المحورية كنسبة مئوية من القيم الإجمالية الكلية. |
PivotValueLayout
تخطيط القيم المحورية.
عمليات التعداد | |
---|---|
HORIZONTAL
|
يتم عرض القيم أفقيًا (كأعمدة). |
VERTICAL
|
يتم ترتيب القيم عموديًا (كصفوف). |