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 – ה-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 הזה, לשרשור.