Accedere ai gruppi di lavoro delle tabelle pivot e modificarli.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
addManualGroupingRule(groupName, groupMembers) | PivotGroup | Aggiunge una regola di raggruppamento manuale per questo gruppo pivot. |
areLabelsRepeated() | Boolean | Indica se le etichette vengono visualizzate come ripetute. |
clearGroupingRule() | PivotGroup | Rimuove qualsiasi regola di raggruppamento da questo gruppo pivot. |
clearSort() | PivotGroup | Rimuove qualsiasi ordinamento applicato al gruppo. |
getDateTimeGroupingRule() | DateTimeGroupingRule | Restituisce la regola di raggruppamento per data e ora sul gruppo pivot oppure null se non è impostata alcuna regola di raggruppamento per data e ora. |
getDimension() | Dimension | Indica se si tratta di una riga o di un gruppo di colonne. |
getGroupLimit() | PivotGroupLimit | Restituisce il limite del gruppo pivot per il gruppo pivot. |
getIndex() | Integer | Restituisce l'indice di questo gruppo pivot nell'ordine corrente dei gruppi. |
getPivotTable() | PivotTable | Restituisce il valore PivotTable a cui appartiene questo raggruppamento. |
getSourceDataColumn() | Integer | Restituisce il numero della colonna dei dati di origine riepilogati da questo gruppo. |
getSourceDataSourceColumn() | DataSourceColumn | Restituisce la colonna dell'origine dati su cui opera il gruppo pivot. |
hideRepeatedLabels() | PivotGroup | Nasconde le etichette ripetute per questo raggruppamento. |
isSortAscending() | Boolean | Restituisce true se l'ordinamento è crescente e false se l'ordinamento è decrescente. |
moveToIndex(index) | PivotGroup | Sposta questo gruppo nella posizione specificata nell'elenco corrente di gruppi di righe o colonne. |
remove() | void | Rimuove questo gruppo pivot dalla tabella. |
removeManualGroupingRule(groupName) | PivotGroup | Rimuove la regola di raggruppamento manuale con il valore groupName specificato. |
resetDisplayName() | PivotGroup | Reimposta il nome visualizzato di questo gruppo nella tabella pivot al valore predefinito. |
setDateTimeGroupingRule(dateTimeGroupingRuleType) | PivotGroup | Imposta la regola di raggruppamento per data e ora sul gruppo pivot. |
setDisplayName(name) | PivotGroup | Imposta il nome visualizzato di questo gruppo nella tabella pivot. |
setGroupLimit(countLimit) | PivotGroup | Imposta il limite del gruppo pivot per il gruppo pivot. |
setHistogramGroupingRule(minValue, maxValue, intervalSize) | PivotGroup | Imposta una regola di raggruppamento degli istogrammi per questo gruppo pivot. |
showRepeatedLabels() | PivotGroup | Se è presente più di un raggruppamento di righe o colonne, questo metodo mostra l'etichetta di questo raggruppamento per ogni voce del raggruppamento successivo. |
showTotals(showTotals) | PivotGroup | Consente di stabilire se mostrare nella tabella i valori totali per questo gruppo pivot. |
sortAscending() | PivotGroup | Imposta l'ordinamento crescente. |
sortBy(value, oppositeGroupValues) | PivotGroup | Ordina questo gruppo in base al PivotValue specificato per i valori da oppositeGroupValues . |
sortDescending() | PivotGroup | Imposta l'ordinamento in ordine decrescente. |
totalsAreShown() | Boolean | Indica se i valori totali vengono attualmente mostrati per questo gruppo pivot. |
Documentazione dettagliata
addManualGroupingRule(groupName, groupMembers)
Aggiunge una regola di raggruppamento manuale per questo gruppo pivot.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
groupName | String | Il nome di questa regola di raggruppamento. |
groupMembers | Object[] | I valori inclusi in questa regola di raggruppamento. |
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
areLabelsRepeated()
Indica se le etichette vengono visualizzate come ripetute.
Ritorni
Boolean
: true
se le etichette sono ripetute; altrimenti restituisce false
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearGroupingRule()
Rimuove qualsiasi regola di raggruppamento da questo gruppo pivot.
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearSort()
Rimuove qualsiasi ordinamento applicato al gruppo.
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDateTimeGroupingRule()
Restituisce la regola di raggruppamento per data e ora sul gruppo pivot oppure null
se non è impostata alcuna regola di raggruppamento per data e ora.
Ritorni
DateTimeGroupingRule
: la regola di raggruppamento per data e ora.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDimension()
Indica se si tratta di una riga o di un gruppo di colonne.
Ritorni
Dimension
: la dimensione che rappresenta il tipo di gruppo
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getGroupLimit()
Restituisce il limite del gruppo pivot per il gruppo pivot. Restituisce null
se non è impostato alcun limite per il gruppo pivot.
Ritorni
PivotGroupLimit
: limite del gruppo pivot.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIndex()
Restituisce l'indice di questo gruppo pivot nell'ordine corrente dei gruppi.
Ritorni
Integer
: l'indice del gruppo pivot
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPivotTable()
Restituisce il valore PivotTable
a cui appartiene questo raggruppamento.
Ritorni
PivotTable
: la tabella pivot a cui appartiene questo gruppo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSourceDataColumn()
Restituisce il numero della colonna dei dati di origine riepilogati da questo gruppo. Questo indice è basato su uno. Se questo gruppo riassume i dati di origine nella colonna "A" del foglio di lavoro, questo metodo restituisce 1
.
Ritorni
Integer
: il numero della colonna dei dati di origine
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSourceDataSourceColumn()
Restituisce la colonna dell'origine dati su cui opera il gruppo pivot. Restituisce null
se la tabella pivot non è un {DataSourcePivotTableApi}.
Ritorni
DataSourceColumn
: la colonna dell'origine dati su cui opera il gruppo pivot.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRepeatedLabels()
Nasconde le etichette ripetute per questo raggruppamento. Se le etichette sono già nascoste, ciò risulta autonomo. Se questo metodo viene richiamato prima che vi siano più raggruppamenti di righe o colonne, quando viene aggiunto un ulteriore raggruppamento, le etichette ripetute vengono nascoste.
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isSortAscending()
Restituisce true
se l'ordinamento è crescente e false
se l'ordinamento è decrescente.
Ritorni
Boolean
: true
se l'ordinamento è crescente.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveToIndex(index)
Sposta questo gruppo nella posizione specificata nell'elenco corrente di gruppi di righe o colonne. Questi indici sono in base 0. Ad esempio, se questo gruppo deve essere spostato in prima posizione, questo metodo deve essere chiamato con 0
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
index | Integer | L'indice in cui spostare questo raggruppamento. |
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Rimuove questo gruppo pivot dalla tabella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeManualGroupingRule(groupName)
Rimuove la regola di raggruppamento manuale con il valore groupName
specificato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
groupName | String | Il nome della regola di raggruppamento da rimuovere. |
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
resetDisplayName()
Reimposta il nome visualizzato di questo gruppo nella tabella pivot al valore predefinito.
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDateTimeGroupingRule(dateTimeGroupingRuleType)
Imposta la regola di raggruppamento per data e ora sul gruppo pivot.
Per rimuovere la regola, utilizza clearGroupingRule()
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
dateTimeGroupingRuleType | DateTimeGroupingRuleType | Il tipo di regola da impostare. |
Ritorni
PivotGroup
: il gruppo pivot per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDisplayName(name)
Imposta il nome visualizzato di questo gruppo nella tabella pivot.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome visualizzato da impostare. |
Ritorni
PivotGroup
: il gruppo pivot per il collegamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setGroupLimit(countLimit)
Imposta il limite del gruppo pivot per il gruppo pivot. L'operazione è supportata solo per DataSourcePivotTable
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
countLimit | Integer | Il limite di righe o colonne da impostare. Deve essere positivo. |
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHistogramGroupingRule(minValue, maxValue, intervalSize)
Imposta una regola di raggruppamento degli istogrammi per questo gruppo pivot. Una regola dell'istogramma organizza i valori di una colonna di dati di origine in bucket di dimensione costante. Tutti i valori da minValue
a maxValue
vengono inseriti in gruppi di dimensioni interval
. Tutti i valori inferiori a minValue
vengono inseriti in un bucket, così come tutti i valori maggiori di maxValue
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
minValue | Integer | Il valore minimo degli elementi da inserire nei bucket. I valori inferiori a questo valore vengono combinati in un unico bucket. |
maxValue | Integer | Il valore massimo degli elementi da inserire nei bucket. I valori superiori a questo valore vengono combinati in un unico bucket. |
intervalSize | Integer |
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRepeatedLabels()
Se è presente più di un raggruppamento di righe o colonne, questo metodo mostra l'etichetta di questo raggruppamento per ogni voce del raggruppamento successivo. Se le etichette sono già ripetute, questo risultato non sarà operativo. Se questo metodo viene richiamato prima che vi siano più raggruppamenti di righe o colonne, quando viene aggiunto un ulteriore raggruppamento vengono mostrate le etichette ripetute.
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showTotals(showTotals)
Consente di stabilire se mostrare nella tabella i valori totali per questo gruppo pivot.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
showTotals | Boolean | Indica se mostrare o meno i totali. |
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sortAscending()
Imposta l'ordinamento crescente.
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sortBy(value, oppositeGroupValues)
Ordina questo gruppo in base al PivotValue
specificato per i valori da oppositeGroupValues
.
// Sorts the item group by the "SUM of Quantity" pivot value for the specified salespersons. var sheet = SpreadsheetApp.getActiveSheet(); var pivotTable = sheet.getPivotTables()[0]; var itemGroup = pivotTable.getRowGroups()[0]; var sumQuantityValue = pivotTable.getPivotValues()[0]; itemGroup.sortBy(sumQuantityValue, ['Beth', 'Amir', 'Devyn']);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | PivotValue | Il valore pivot in base al quale ordinare. |
oppositeGroupValues | Object[] | I valori di un gruppo pivot opposto (un gruppo di colonne se si ordina un gruppo di righe o un gruppo di righe se si ordina un gruppo di colonne) utilizzati per ordinare. L'ordine di questi valori determina la precedenza per la rottura di parità. |
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sortDescending()
Imposta l'ordinamento in ordine decrescente.
Ritorni
PivotGroup
: il gruppo pivot per il collegamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
totalsAreShown()
Indica se i valori totali vengono attualmente mostrati per questo gruppo pivot.
Ritorni
Boolean
: true
se vengono visualizzati i valori totali per il gruppo pivot; in caso contrario, restituisce false
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets