Class Field

שדה

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

var cc = DataStudioApp.createCommunityConnector();
var fields = cc.getFields();
var types = cc.FieldType;

var field1 = fields.newDimension()
  .setId('field1_id')
  .setName('Field 1 ID')
  .setDescription('The first field.')
  .setType(types.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 קובע איך Data Studio משלב נתונים דומים למאפיינים.

חזרה

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


getDescription()

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

חזרה

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


getFormula()

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