تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class Field

يحتوي على بيانات ذات صلة بالحقل. وتحدّد خصائصه طريقة استخدام الحقل في "مركز البيانات".

const cc = DataStudioApp.createCommunityConnector();
const fields = cc.getFields();

const field1 = fields.newDimension()
                   .setId('field1_id')
                   .setName('Field 1 ID')
                   .setDescription('The first field.')
                   .setType(cc.FieldType.YEAR_MONTH)
                   .setGroup('DATETIME');

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`getAggregation()`	`AggregationType`	تعرِض هذه الدالة `AggregationType` لهذا `Field`.
`getDescription()`	`String`	تعرِض هذه السمة وصف `Field`.
`getFormula()`	`String`	عرض صيغة هذا `Field`
`getGroup()`	`String`	عرض مجموعة هذا `Field`
`getId()`	`String`	تعرِض هذه السمة رقم تعريف `Field` هذا.
`getIsReaggregatable()`	`Boolean`	تعرِض القيمة `true` إذا كان يمكن إعادة تجميع هذا الحقل، و`false` في حال عدم إمكانية ذلك.
`getName()`	`String`	عرض اسم هذا `Field`
`getType()`	`FieldType`	تعرِض هذه الدالة `FieldType` لهذا `Field`.
`isDefault()`	`Boolean`	تعرِض `true` إذا كان هذا `Field` هو المقياس أو السمة التلقائية.
`isDimension()`	`Boolean`	تعرِض `true` إذا كان هذا الحقل سمة.
`isHidden()`	`Boolean`	تعرِض هذه السمة القيمة `true` إذا كان هذا `Field` مخفيًا.
`isMetric()`	`Boolean`	تعرِض هذه الدالة القيمة `true` إذا كان هذا الحقل مقياسًا.
`setAggregation(aggregation)`	`Field`	تُستخدَم لضبط نوع التجميع لهذا `Field`.
`setDescription(description)`	`Field`	لضبط وصف هذا `Field`.
`setFormula(formula)`	`Field`	تُستخدَم لضبط صيغة هذا `Field`.
`setGroup(group)`	`Field`	لضبط مجموعة هذا `Field`.
`setId(id)`	`Field`	لضبط رقم تعريف هذا `Field`.
`setIsHidden(isHidden)`	`Field`	لضبط حالة إخفاء هذا `Field`.
`setIsReaggregatable(isReaggregatable)`	`Field`	تُستخدَم لضبط حالة السماح بإعادة التجميع لـ `Field`.
`setName(name)`	`Field`	لضبط اسم `Field` هذا.
`setType(type)`	`Field`	تُستخدَم لضبط `FieldType` لهذا `Field`.

مستندات تفصيلية

`getAggregation()`

تعرِض هذه الدالة AggregationType لهذا Field. AggregationType تحدِّد طريقة دمج "مركز البيانات" للبيانات المتشابهة في السمات.

الإرجاع

AggregationType: نوع التجميع لهذا الحقل.

`getDescription()`

تعرِض هذه السمة وصف Field. الأوصاف هي شرح موجز لهدف الحقل.

الإرجاع

String: وصف هذا الحقل.

`getFormula()`

عرض صيغة هذا Field تحدِّد الصِيَغ عملية تحويل بيانات ينفِّذها "مركز البيانات" في وقت طلب البحث.

الإرجاع

String: صيغة هذا الحقل.

`getGroup()`

عرض مجموعة هذا Field يتم عرض الحقول التي تم جمعها في مجموعة معًا في واجهة مستخدم "مركز البيانات".

الإرجاع

String: المجموعة لهذا الحقل.

`getId()`

تعرِض هذه السمة رقم تعريف Field هذا. تكون المعرّفات فريدة لكل مجموعة من الحقول، ويتم استخدامها في الصِيَغ للإشارة إلى الحقول.

الإرجاع

String: رقم تعريف هذا الحقل.

`getIsReaggregatable()`

تعرِض القيمة true إذا كان يمكن إعادة تجميع هذا الحقل، وfalse في حال عدم إمكانية ذلك.

الإرجاع

‫Boolean: true إذا كان يمكن إعادة تجميع هذا الحقل، false في حال عدم إمكانية ذلك

`getName()`

عرض اسم هذا Field يتم عرض الأسماء للمستخدم من أجل تمييز الحقول.

الإرجاع

String: اسم هذا الحقل.

`getType()`

تعرِض هذه الدالة FieldType لهذا Field.

الإرجاع

FieldType: نوع هذا الحقل.

`isDefault()`

تعرِض true إذا كان هذا Field هو المقياس أو السمة التلقائية.

الإرجاع

Boolean — true إذا كانت هذه السمة Field هي المقياس أو السمة التلقائية، false في غير ذلك.

`isDimension()`

تعرِض true إذا كان هذا الحقل سمة.

الإرجاع

Boolean: true إذا كان هذا الحقل سمة، وfalse في حال عدم ذلك

`isHidden()`

تعرِض هذه السمة القيمة true إذا كان هذا Field مخفيًا. يمكنك استخدام الحقول المخفية في المعادلات، ولكن ليس في الرسوم البيانية. لا يمكنك إخفاء الحقول التي تحتوي على صِيَغ.

الإرجاع

Boolean: true إذا كان هذا Field مخفيًا، وfalse بخلاف ذلك

`isMetric()`

تعرِض هذه الدالة القيمة true إذا كان هذا الحقل مقياسًا.

الإرجاع

Boolean: true إذا كان هذا الحقل مقياسًا، وfalse في حال عدم ذلك

`setAggregation(aggregation)`

تُستخدَم لضبط نوع التجميع لهذا Field. AggregationType تحدِّد كيفية دمج "مركز البيانات" للبيانات المتشابهة في السمات. يؤدي ذلك إلى ظهور خطأ في حال استدعائه في مقياس.