Class Field

שדה

מכיל נתונים שקשורים לשדה. המאפיינים שלו קובעים איך השדה ישמש ב-Data Studio.

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');

Methods

שיטהסוג הערך שמוחזרתיאור קצר
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 קובע איך Data Studio משלב נתונים דומים במאפיינים.

חזרה

AggregationType — סוג הצבירה של השדה הזה.


getDescription()

מחזירה את התיאור של ה-Field הזה. התיאורים הם הסברים קצרים על המטרה של השדה.

חזרה

String — התיאור של השדה הזה.


getFormula()

הפונקציה מחזירה את הנוסחה של Field. נוסחאות מגדירות טרנספורמציה של נתונים ש-Data Studio מפעיל בזמן השאילתה.

חזרה

String – הנוסחה של השדה הזה.


getGroup()

מחזירה את הקבוצה של ה-Field הזה. השדות שנאספים לקבוצה מוצגים יחד בממשק המשתמש של Data Studio.

חזרה

String – הקבוצה של השדה הזה.


getId()

מחזירה את המזהה של ה-Field הזה. המזהים ייחודיים לכל קבוצת שדות ומשמשים בנוסחאות להפניה לשדות.

חזרה

String – המזהה של השדה הזה.


getIsReaggregatable()

הפונקציה מחזירה true אם אפשר לבצע צבירה מחדש של השדה הזה, אחרת היא מחזירה false.

חזרה

Booleantrue אם אפשר לצבור מחדש את השדה הזה, false אחרת.


getName()

מחזירה את השם של ה-Field הזה. השמות מוצגים למשתמש כדי להבחין בין השדות.

חזרה

String – השם של השדה הזה.


getType()

הפונקציה מחזירה את ה-FieldType של ה-Field הזה.

חזרה

FieldType – הסוג של השדה הזה.


isDefault()

הפונקציה מחזירה true אם Field הוא מדד או מאפיין ברירת המחדל.

חזרה

Booleantrue אם Field הוא מדד או מאפיין ברירת המחדל; false אחרת.


isDimension()

מחזירה true אם השדה הזה הוא מאפיין.

חזרה

Booleantrue אם השדה הזה הוא מאפיין; מחזירה false אחרת.


isHidden()

הפונקציה מחזירה את הערך true אם Field מוסתר. אפשר להשתמש בשדות מוסתרים בנוסחאות, אבל לא בתרשימים. אי אפשר להסתיר שדות שמכילים נוסחאות.

חזרה

Booleantrue אם Field מוסתר, false אחרת.


isMetric()

הפונקציה מחזירה true אם השדה הזה הוא מדד.

חזרה

Booleantrue אם השדה הזה הוא מדד; מחזירה false אחרת.


setAggregation(aggregation)

מגדיר את סוג הצבירה של Field. AggregationType קובע איך Data Studio משלב נתונים דומים במאפיינים. אם מפעילים את הפונקציה הזו על מדד, מוצגת שגיאה.

פרמטרים

שםסוגתיאור
aggregationAggregationTypeסוג הצבירה שרוצים להגדיר.

חזרה

Field – ה-builder הזה, לשרשור.


setDescription(description)

מגדירים את התיאור של Field. התיאורים הם הסברים קצרים על המטרה של השדה.

פרמטרים

שםסוגתיאור
descriptionStringהתיאור שצריך להגדיר.

חזרה

Field – ה-builder הזה, לשרשור.


setFormula(formula)

הגדרת הנוסחה של Field. נוסחאות מגדירות טרנספורמציה של נתונים ש-Data Studio מפעיל בזמן השאילתה.

פרמטרים

שםסוגתיאור
formulaStringהנוסחה להגדרה.

חזרה

Field – ה-builder הזה, לשרשור.


setGroup(group)

מגדיר את הקבוצה של Field. השדות שנאספים לקבוצה מוצגים יחד בממשק המשתמש של Data Studio.

פרמטרים

שםסוגתיאור
groupStringהקבוצה שרוצים להגדיר.

חזרה

Field – ה-builder הזה, לשרשור.


setId(id)

מגדירה את המזהה של Field. המזהים ייחודיים לכל קבוצת שדות, ומשמשים בנוסחאות להפניה לשדות.

פרמטרים

שםסוגתיאור
idStringהמזהה שצריך להגדיר.

חזרה

Field – ה-builder הזה, לשרשור.


setIsHidden(isHidden)

מגדיר את הסטטוס המוסתר של Field. אפשר להשתמש בשדות מוסתרים בנוסחאות, אבל לא בתרשימים. אי אפשר להסתיר שדות שמכילים נוסחאות.

פרמטרים

שםסוגתיאור
isHiddenBooleanהסטטוס המוסתר שרוצים להגדיר.

חזרה

Field – ה-builder הזה, לשרשור.


setIsReaggregatable(isReaggregatable)

הגדרת הסטטוס של Field בנוגע להצגת נתונים מצטברים מחדש. ניסיון להגדיר סוג צבירה בשדה שלא ניתן לחישוב מצטבר מוביל לשגיאה.

פרמטרים

שםסוגתיאור
isReaggregatableBooleanהסטטוס שצריך להגדיר לגבי האפשרות לאיחוד מחדש.

חזרה

Field – ה-builder הזה, לשרשור.


setName(name)

מגדיר את השם של Field. השמות מוצגים למשתמש כדי להבחין בין השדות.

פרמטרים

שםסוגתיאור
nameStringהשם שרוצים להגדיר.

חזרה

Field – ה-builder הזה, לשרשור.


setType(type)

הפונקציה מגדירה את ה-FieldType של ה-Field הזה.

פרמטרים

שםסוגתיאור
typeFieldTypeהסוג שרוצים להגדיר.

חזרה

Field – ה-builder הזה, לשרשור.