Class Field

Champ

Contient des données liées au champ. Ses propriétés déterminent l'utilisation du champ 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 l'AggregationType de cet objet 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 l'FieldType de cet objet Field.
isDefault()BooleanRenvoie true si cette Field est la métrique ou la dimension par défaut.
isDimension()BooleanRenvoie true si ce champ est une dimension.
isHidden()BooleanRenvoie true si cet élément Field est masqué.
isMetric()BooleanRenvoie true si ce champ est une métrique.
setAggregation(aggregation)FieldDéfinit le type d'agrégation de cette Field.
setDescription(description)FieldDéfinit la description de cet élément Field.
setFormula(formula)FieldDéfinit la formule de cet élément Field.
setGroup(group)FieldDéfinit le groupe de cet élément Field.
setId(id)FieldDéfinit l'ID de cet objet Field.
setIsHidden(isHidden)FieldDéfinit l'état masqué de cet objet Field.
setIsReaggregatable(isReaggregatable)FieldDéfinit l'état d'autorisation de la réagrégation 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 l'AggregationType de cet objet Field. AggregationType détermine comment Data Studio combine des données similaires en dimensions.

Renvois

AggregationType : type d'agrégation pour ce champ.


getDescription()

Renvoie la description de cet objet Field. Les descriptions sont de courtes explications de 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'interface utilisateur de 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 sinon.


getName()

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

Renvois

String : nom de ce champ.


getType()

Renvoie l'FieldType de cet objet Field.

Renvois

FieldType : type de ce champ.


isDefault()

Renvoie true si cette 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, ou false dans le cas contraire.


isHidden()

Renvoie true si cet élément 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 cet élément Field est masqué, sinon false.


isMetric()

Renvoie true si ce champ est une métrique.

Renvois

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


setAggregation(aggregation)

Définit le type d'agrégation de cette Field. AggregationType détermine comment Data Studio combine des données similaires en dimensions. Cette opération génère une erreur si elle 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 cet élément Field. Les descriptions sont de courtes explications de 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 cet élément 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 cet élément Field. Les champs collectés dans un groupe sont présentés ensemble dans l'interface utilisateur de 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 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.

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 objet 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 masqué à définir.

Renvois

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


setIsReaggregatable(isReaggregatable)

Définit l'état d'autorisation de la réagrégation pour un Field. Une erreur est générée lorsque vous tentez de définir un type d'agrégation sur un champ qui ne peut pas être réagrégé.

Paramètres

NomTypeDescription
isReaggregatableBooleanÉtat de la réagrégation autorisé à 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 l'utilisateur afin 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.