Class Field

Champ

Contient des données liées aux champs. Ses propriétés déterminent la façon dont le champ est utilisé dans 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');

Méthodes

MéthodeType renvoyéBrève description
getAggregation()AggregationTypeRenvoie le AggregationType de cette Field.
getDescription()StringRenvoie la description de cet objet Field.
getFormula()StringRenvoie la formule de cet objet Field.
getGroup()StringRenvoie le groupe de cet objet Field.
getId()StringRenvoie l'ID de cet objet Field.
getIsReaggregatable()BooleanRenvoie true si ce champ peut être réagrégé, ou false dans le cas contraire.
getName()StringRenvoie le nom de cet objet Field.
getType()FieldTypeRenvoie le FieldType de cette Field.
isDefault()BooleanRenvoie true si ce Field est la métrique ou la dimension par défaut.
isDimension()BooleanRenvoie true si ce champ est une dimension.
isHidden()BooleanRenvoie true si ce Field est masqué.
isMetric()BooleanRenvoie true si ce champ est une métrique.
setAggregation(aggregation)FieldDéfinit le type d'agrégation de ce Field.
setDescription(description)FieldDéfinit la description de ce Field.
setFormula(formula)FieldDéfinit la formule de cette Field.
setGroup(group)FieldDéfinit le groupe de ce Field.
setId(id)FieldDéfinit l'ID de ce Field.
setIsHidden(isHidden)FieldDéfinit l'état masqué de cet Field.
setIsReaggregatable(isReaggregatable)FieldDéfinit l'état d'agrégation autorisée pour un Field.
setName(name)FieldDéfinit le nom de cet objet Field.
setType(type)FieldDéfinit le FieldType de ce Field.

Documentation détaillée

getAggregation()

Renvoie le AggregationType de cette Field. AggregationType détermine comment Data Studio combine des données similaires en dimensions.

Renvois

AggregationType : aggregationType pour ce champ.


getDescription()

Renvoie la description de cet objet Field. Les descriptions sont de brèves explications sur l'objectif d'un champ.

Renvois

String : description de ce champ.


getFormula()

Renvoie la formule de cet objet Field. Les formules définissent une transformation de données que Data Studio exécute au moment de la requête.

Renvois

String : formule de ce champ.


getGroup()

Renvoie le groupe de cet objet Field. Les champs collectés dans un groupe sont présentés ensemble dans l'UI Data Studio.

Renvois

String : groupe de ce champ.


getId()

Renvoie l'ID de cet objet Field. Les ID sont uniques pour chaque ensemble de champs et sont utilisés dans les formules pour faire référence aux champs.

Renvois

String : ID de ce champ.


getIsReaggregatable()

Renvoie true si ce champ peut être réagrégé, ou false dans le cas contraire.

Renvois

Boolean : true si ce champ peut être réagrégé, false dans le cas contraire.


getName()

Renvoie le nom de cet objet Field. Les noms sont affichés pour permettre à l'utilisateur de distinguer les champs.

Renvois

String : nom de ce champ.


getType()

Renvoie le FieldType de cette Field.

Renvois

FieldType : type de ce champ.


isDefault()

Renvoie true si ce Field est la métrique ou la dimension par défaut.

Renvois

Boolean : true si cette Field est la métrique ou la dimension par défaut, false sinon.


isDimension()

Renvoie true si ce champ est une dimension.

Renvois

Boolean : true si ce champ est une dimension, false dans le cas contraire.


isHidden()

Renvoie true si ce Field est masqué. Vous pouvez utiliser des champs masqués dans les formules, mais pas dans les graphiques. Vous ne pouvez pas masquer les champs contenant des formules.

Renvois

Boolean : true si ce Field est masqué, false sinon.


isMetric()

Renvoie true si ce champ est une métrique.

Renvois

Boolean : true si ce champ est une métrique, false dans le cas contraire.


setAggregation(aggregation)

Définit le type d'agrégation de ce Field. AggregationType détermine comment Data Studio combine des données similaires en dimensions. Cela génère une erreur si l'opération est appelée sur une métrique.

Paramètres

NomTypeDescription
aggregationAggregationTypeType d'agrégation à définir.

Renvois

Field : ce générateur, pour le chaînage.


setDescription(description)

Définit la description de ce Field. Les descriptions sont de brèves explications sur l'objectif d'un champ.

Paramètres

NomTypeDescription
descriptionStringDescription à définir.

Renvois

Field : ce générateur, pour le chaînage.


setFormula(formula)

Définit la formule de cette Field. Les formules définissent une transformation de données que Data Studio exécute au moment de la requête.

Paramètres

NomTypeDescription
formulaStringFormule à définir.

Renvois

Field : ce générateur, pour le chaînage.


setGroup(group)

Définit le groupe de ce Field. Les champs collectés dans un groupe sont présentés ensemble dans l'UI Data Studio.

Paramètres

NomTypeDescription
groupStringGroupe à définir.

Renvois

Field : ce générateur, pour le chaînage.


setId(id)

Définit l'ID de ce Field. Les ID sont uniques pour chaque ensemble de champs et sont utilisés dans les formules pour faire référence aux champs.

Paramètres

NomTypeDescription
idStringID à définir.

Renvois

Field : ce générateur, pour le chaînage.


setIsHidden(isHidden)

Définit l'état masqué de cet Field. Vous pouvez utiliser des champs masqués dans les formules, mais pas dans les graphiques. Vous ne pouvez pas masquer les champs contenant des formules.

Paramètres

NomTypeDescription
isHiddenBooleanÉtat caché à définir.

Renvois

Field : ce générateur, pour le chaînage.


setIsReaggregatable(isReaggregatable)

Définit l'état d'agrégation autorisée pour un Field. Toute tentative de définition d'un type d'agrégation sur un champ qui ne peut pas être réagrégé génère une erreur.

Paramètres

NomTypeDescription
isReaggregatableBooleanÉtat de réagrégation autorisée à définir.

Renvois

Field : ce générateur, pour le chaînage.


setName(name)

Définit le nom de cet objet Field. Les noms sont affichés pour permettre à l'utilisateur de distinguer les champs.

Paramètres

NomTypeDescription
nameStringNom à définir.

Renvois

Field : ce générateur, pour le chaînage.


setType(type)

Définit le FieldType de ce Field.

Paramètres

NomTypeDescription
typeFieldTypeType à définir.

Renvois

Field : ce générateur, pour le chaînage.