Accéder au tableau croisé dynamique de la source de données et le modifier Pour créer un tableau croisé dynamique de source de données, utilisez Range.createDataSourcePivotTable(dataSource).
Utilisez cette classe uniquement avec les données connectées à une base de données.
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
addColumnGroup(columnName) | PivotGroup | Ajoute un groupe de colonnes de tableaux croisés dynamiques en fonction de la colonne de source de données spécifiée. |
addFilter(columnName, filterCriteria) | PivotFilter | Ajoute un filtre basé sur la colonne de la source de données spécifiée, avec les critères de filtrage définis. |
addPivotValue(columnName, summarizeFunction) | PivotValue | Ajoute une nouvelle valeur de tableau croisé dynamique basée sur la colonne de source de données spécifiée et la fonction de synthèse spécifiée. |
addRowGroup(columnName) | PivotGroup | Ajoute un nouveau groupe de lignes croisées basé sur la colonne de source de données spécifiée. |
asPivotTable() | PivotTable | Renvoie le tableau croisé dynamique de source de données sous la forme d'un objet de tableau croisé dynamique standard. |
forceRefreshData() | DataSourcePivotTable | Actualise les données de cet objet, quel que soit leur état actuel. |
getDataSource() | DataSource | Récupère la source de données à laquelle l'objet est associé. |
getStatus() | DataExecutionStatus | Récupère l'état d'exécution des données de l'objet. |
refreshData() | DataSourcePivotTable | Actualise les données de l'objet. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Attend la fin de l'exécution en cours. Le délai expire après le nombre de secondes indiqué. |
Documentation détaillée
addColumnGroup(columnName)
Ajoute un groupe de colonnes de tableaux croisés dynamiques en fonction de la colonne de source de données spécifiée.
Paramètres
| Nom | Type | Description |
|---|---|---|
columnName | String | Nom de la colonne de sources de données sur laquelle le groupe de tableaux croisés dynamiques est basé. |
Aller-retour
PivotGroup : nouveau groupe de tableaux croisés dynamiques.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addFilter(columnName, filterCriteria)
Ajoute un filtre basé sur la colonne de la source de données spécifiée, avec les critères de filtrage définis.
Paramètres
| Nom | Type | Description |
|---|---|---|
columnName | String | Nom de la colonne de sources de données sur laquelle se base le filtre. |
filterCriteria | FilterCriteria | Critères utilisés par le filtre. |
Aller-retour
PivotFilter : nouveau filtre.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addPivotValue(columnName, summarizeFunction)
Ajoute une nouvelle valeur de tableau croisé dynamique basée sur la colonne de source de données spécifiée et la fonction de synthèse spécifiée.
Paramètres
| Nom | Type | Description |
|---|---|---|
columnName | String | Nom de la colonne de source de données sur laquelle la valeur du tableau croisé dynamique est basée. |
summarizeFunction | PivotTableSummarizeFunction | Fonction de synthèse utilisée par la valeur de tableau croisé dynamique |
Aller-retour
PivotValue : nouvelle valeur du tableau croisé dynamique.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addRowGroup(columnName)
Ajoute un nouveau groupe de lignes croisées basé sur la colonne de source de données spécifiée.
Paramètres
| Nom | Type | Description |
|---|---|---|
columnName | String | Nom de la colonne de sources de données sur laquelle le groupe de tableaux croisés dynamiques est basé. |
Aller-retour
PivotGroup : nouveau groupe de tableaux croisés dynamiques.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
asPivotTable()
Renvoie le tableau croisé dynamique de source de données sous la forme d'un objet de tableau croisé dynamique standard.
Aller-retour
PivotTable : tableau croisé dynamique.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
Actualise les données de cet objet, quel que soit leur état actuel. Pour en savoir plus, consultez refreshData().
Lève une exception si le type de source de données n'est pas activé. Utilisez les méthodes SpreadsheetApp#enable...Execution() afin d'activer l'exécution de données pour un type de source de données spécifique.
Aller-retour
DataSourcePivotTable : objet de données
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getDataSource()
Récupère la source de données à laquelle l'objet est associé.
Aller-retour
DataSource : source de données
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getStatus()
Récupère l'état d'exécution des données de l'objet.
Aller-retour
DataExecutionStatus : état d'exécution des données.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
refreshData()
Actualise les données de l'objet.
Lève une exception si l'état actuel est error. Utilisez DataSource#updateSpec() pour mettre à jour la spécification. Cette méthode est préférable à forceRefreshData() pour éviter toute modification inattendue de la source de données.
Lève une exception si le type de source de données n'est pas activé. Utilisez les méthodes SpreadsheetApp#enable...Execution() afin d'activer l'exécution de données pour un type de source de données spécifique.
Aller-retour
DataSourcePivotTable : objet de données
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
Attend la fin de l'exécution en cours. Le délai expire après le nombre de secondes indiqué. Lève une exception si l'exécution n'est pas terminée lors de l'expiration du délai, mais n'annule pas l'exécution des données.
Paramètres
| Nom | Type | Description |
|---|---|---|
timeoutInSeconds | Integer | Temps d'attente pour l'exécution des données, en secondes. La valeur maximale est de 300 secondes. |
Aller-retour
DataExecutionStatus : état d'exécution des données.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets