PivotTable
جدول محوري.
تمثيل JSON |
---|
{ "rows": [ { object ( |
الحقول | |
---|---|
rows[]
|
يتم تجميع كل صف في الجدول المحوري. |
columns[]
|
كل تجميع للأعمدة في الجدول المحوري. |
criteria
|
تعيين اختياري للفلاتر لكل إزاحة عمود مصدر. يتم تطبيق عوامل التصفية قبل تجميع البيانات في الجدول المحوري. مفتاح الخريطة هو إزاحة العمود للنطاق المصدر الذي تريد فلترته، والقيمة هي المعيار لذلك العمود.
على سبيل المثال، إذا كان المصدر هو
تم إيقاف هذا الحقل نهائيًا لصالح
|
filterSpecs[]
|
عوامل التصفية المطبقة على أعمدة المصدر قبل تجميع البيانات للجدول المحوري.
وتتم تعبئة كل من
|
values[]
|
قائمة بالقيم المراد تضمينها في الجدول المحوري. |
valueLayout
|
ما إذا كان يجب سرد القيم أفقيًا (كأعمدة) أو عموديًا (كصفوف). |
dataExecutionStatus
|
النتائج فقط. حالة تنفيذ البيانات للجداول المحورية لمصدر البيانات. |
حقل الاتحاد
source_data . مصدر بيانات الجدول المحوري.
يمكن أن تكون السمة source_data واحدًا فقط مما يلي:
|
|
source
|
النطاق الذي تتم قراءة البيانات منه في الجدول المحوري. |
dataSourceId
|
معرّف مصدر البيانات الذي يقرأ الجدول المحوري البيانات منه. |
PivotGroup
تجميع واحد (صف أو عمود) في جدول محوري.
تمثيل JSON |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
الحقول | |
---|---|
showTotals
|
True إذا كان الجدول المحوري يجب أن يتضمن الإجماليات لهذا التجميع. |
valueMetadata[]
|
بيانات التعريف حول القيم في المجموعة. |
sortOrder
|
الترتيب الذي يجب فيه ترتيب القيم في هذه المجموعة |
valueBucket
|
مجموعة بيانات المجموعة المحورية المقابلة للترتيب وفقًا لها. في حال عدم تحديد ذلك، يكون الترتيب أبجديًا حسب قيم هذه المجموعة. |
repeatHeadings
|
صحيح إذا كان يجب تكرار العناوين في هذه المجموعة المحورية. ولا يصلح هذا إلا لتجميع الصفوف ويتم تجاهله بواسطة الأعمدة. بشكل تلقائي، يتم تقليل تكرار العناوين من خلال عدم عرض عناوين من المستوى الأعلى عندما تكون متطابقة. على سبيل المثال، على الرغم من أن الصف الثالث أدناه يتجاوب مع "الربع الأول من آذار (مارس)"، لا يتم عرض "Q1" لأنه مكرر مع الصفوف السابقة. سيؤدي ضبط عناوين متكررة على "صحيح" إلى تكرار "Q1" في "Feb" و"Mar".
|
label
|
التصنيفات المراد استخدامها لمجموعات الصفوف/الأعمدة التي يمكن تخصيصها. على سبيل المثال، في الجدول المحوري التالي، تصنيف الصف هو
|
groupRule
|
قاعدة المجموعة المطلوب تطبيقها على مجموعة الصفوف/الأعمدة هذه. |
groupLimit
|
الحد الأقصى لعدد الصفوف أو الأعمدة المطلوب تطبيقه على هذه المجموعة المحورية. |
حقل الاتحاد
source . مصدر البيانات للمجموعة المحورية.
يمكن أن تكون السمة source واحدًا فقط مما يلي:
|
|
sourceColumnOffset
|
إزاحة العمود للنطاق المصدر الذي يستند إليه هذا التجميع.
على سبيل المثال، إذا كان المصدر هو |
dataSourceColumnReference
|
المرجع إلى عمود مصدر البيانات الذي يستند إليه هذا التجميع. |
PivotGroupValueMetadata
بيانات التعريف حول قيمة في مجموعة محورية.
تمثيل JSON |
---|
{
"value": {
object (
|
الحقول | |
---|---|
value
|
القيمة المحسوبة التي تتجاوب معها البيانات الوصفية. (يُرجى العِلم أنّ
السمة |
collapsed
|
True إذا تم تصغير البيانات المقابلة للقيمة. |
PivotGroupSortValueBucket
يشير ذلك المصطلح إلى معلومات حول القيم المتوفّرة في مجموعة محورية يجب استخدامها للفرز.
تمثيل JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object (
|
الحقول | |
---|---|
valuesIndex
|
الإزاحة في
قائمة |
buckets[]
|
تحدد مجموعة القيم التي يتم اختيار القيم للفرز منها. على سبيل المثال، في جدول محوري يحتوي على مجموعة صفوف واحدة ومجموعات أعمدة، يمكن أن تدرج مجموعة الصفوف ما يصل إلى قيمتَين. تتجاوب القيمة الأولى مع قيمة داخل مجموعة الأعمدة الأولى، وتتجاوب القيمة الثانية مع قيمة في مجموعة الأعمدة الثانية. إذا لم يتم سرد أي قيم، فهذا يشير إلى أنه يجب فرز الصف وفقًا لـ "الإجمالي الكلي" فوق مجموعات الأعمدة. وإذا تم إدراج قيمة واحدة، ستتوافق هذه القيمة مع استخدام "الإجمالي" لهذه الحزمة. |
PivotGroupRule
هو إعداد اختياري في PivotGroup
يحدّد مجموعات البيانات للقيم في عمود بيانات المصدر بدلاً من تقسيم كل قيمة فردية. يمكن إضافة
PivotGroup
واحد فقط مع قاعدة مجموعة لكل عمود في البيانات المصدر، ولكن يمكنك إضافة
PivotGroup
في أي عمود
يحتوي على قاعدة
وPivotGroup
لا يتضمّنها.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
rule . القاعدة المطلوب تطبيقها على
PivotGroup .
يمكن أن تكون السمة rule واحدًا فقط مما يلي:
|
|
manualRule
|
A
|
histogramRule
|
|
dateTimeRule
|
A
|
ManualRule
تسمح لك هذه السياسة بتنظيم القيم يدويًا في عمود البيانات المصدر في مجموعات تتضمّن أسماء من اختيارك. على سبيل المثال، جدول محوري يجمع السكان حسب الولاية:
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
يمكن تحويلها إلى جدول محوري يُجمِّع السكان حسب المنطقة الزمنية من خلال توفير قائمة من المجموعات (على سبيل المثال، groupName = 'Central', items = ['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 مساءً. تتم ترجمة تعيين صباحًا/مساءً استنادًا إلى لغة جدول البيانات. |
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 |
PivotGroupLimit
الحد الأقصى للعدد في الصفوف أو الأعمدة في المجموعة المحورية.
تمثيل JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
الحقول | |
---|---|
countLimit
|
الحد الأقصى للعدد. |
applyOrder
|
الترتيب الذي تم به تطبيق حد المجموعة على الجدول المحوري. يتم تطبيق حدود المجموعات المحورية من رقم الطلب الأدنى إلى الأعلى. تتم تسوية أرقام الطلبات لتصبح أعداد صحيحة متتالية تبدأ من 0.
في ما يتعلّق بطلبات الكتابة، يجب ضبط هذا الحقل برقم فريد لتخصيص الطلبات بشكل كامل، وذلك في جميع حدود المجموعات المحورية. أمّا في الحالات الأخرى، فسيتم تحديد الترتيب من خلال الفهرس في قائمة |
PivotFilterCriteria
معايير إظهار/إخفاء الصفوف في جدول محوري.
تمثيل JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object (
|
الحقول | |
---|---|
visibleValues[]
|
القيم التي يجب تضمينها. يتم استبعاد القيم غير المدرَجة هنا. |
condition
|
شرط يجب أن يكون true حتى يتم عرض القيم. (
لا يلغي
يتم تقييم قيم الشرط التي تشير إلى النطاقات في تدوين A1 بالنسبة إلى ورقة الجدول المحوري. يتم التعامل مع المراجع بشكل مطلق، لذلك لا يتم ملء الجدول المحوري. على سبيل المثال، يتم التعامل مع قيمة الشرط
يمكن الإشارة إلى بيانات المصدر للجدول المحوري عن طريق اسم رأس العمود. على سبيل المثال، إذا كانت بيانات المصدر تحتوي على عمودين باسم "الأرباح" و "التكلفة" وتم تطبيق شرط على عمود "الأرباح" بالنوع
|
visibleByDefault
|
ما إذا كانت القيم مرئية تلقائيًا إذا كانت القيمة true، يتم تجاهل
|
PivotFilterSpec
معايير فلاتر الجدول المحوري المرتبطة بإزاحة عمود مصدر معيّن.
تمثيل JSON |
---|
{ "filterCriteria": { object ( |
الحقول | |
---|---|
filterCriteria
|
تمثّل هذه السمة معايير العمود. |
حقل الاتحاد
source . عمود المصدر الذي ينطبق عليه هذا الفلتر.
يمكن أن تكون السمة source واحدًا فقط مما يلي:
|
|
columnOffsetIndex
|
إزاحة العمود المستندة إلى الصفر للنطاق المصدر. |
dataSourceColumnReference
|
المرجع إلى عمود مصدر البيانات. |
PivotValue
تعريف كيفية حساب القيمة في الجدول المحوري.
تمثيل JSON |
---|
{ "summarizeFunction": enum ( |
الحقول | |
---|---|
summarizeFunction
|
دالة لتلخيص القيمة. إذا تم ضبط |
name
|
اسم لاستخدامه للقيمة. |
calculatedDisplayType
|
إذا تم تحديدها، فإنها تشير إلى أنه يجب عرض القيم المحورية كنتيجة لعملية حسابية مع قيمة محورية أخرى. على سبيل المثال، إذا تم تحديد ComputeDisplayType بنسبة PERCENT_OF_GRAND_TOTAL، يتم عرض جميع القيم المحورية كنسبة مئوية من الإجمالي الكلي. في محرر جداول البيانات، يشار إلى ذلك باسم "إظهار باسم" في قسم القيمة من الجدول المحوري. |
حقل الاتحاد
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
|
يتم وضع القيم عموديًا (كصفوف). |