Accesso e modifica dei gruppi di lavoro delle tabelle pivot.
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 sono visualizzate come ripetute. |
clearGroupingRule() | PivotGroup | Rimuove qualsiasi regola di raggruppamento da questo gruppo pivot. |
clearSort() | PivotGroup | Rimuove l'ordinamento applicato a questo gruppo. |
getDateTimeGroupingRule() | DateTimeGroupingRule | Restituisce la regola di raggruppamento data-ora nel gruppo pivot o null se non esistono valori di data e ora
è impostata una regola di raggruppamento. |
getDimension() | Dimension | Indica se si tratta di un gruppo di righe o colonne. |
getGroupLimit() | PivotGroupLimit | Restituisce il limite del gruppo pivot sul gruppo pivot. |
getIndex() | Integer | Restituisce l'indice di questo gruppo pivot nell'ordine del gruppo corrente. |
getPivotTable() | PivotTable | Restituisce il valore PivotTable a cui appartiene questo raggruppamento. |
getSourceDataColumn() | Integer | Restituisce il numero della colonna di dati di origine riassunta 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, restituisce false se l'ordinamento è
in ordine 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 valore predefinito del nome visualizzato di questo gruppo nella tabella pivot. |
setDateTimeGroupingRule(dateTimeGroupingRuleType) | PivotGroup | Imposta la regola per il raggruppamento di data e ora nel 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 impostare se mostrare i valori totali per questo gruppo pivot nella tabella. |
sortAscending() | PivotGroup | Consente di impostare l'ordinamento in modo crescente. |
sortBy(value, oppositeGroupValues) | PivotGroup | Ordina questo gruppo in base al valore PivotValue specificato per i valori di oppositeGroupValues . |
sortDescending() | PivotGroup | Imposta l'ordinamento su decrescente. |
totalsAreShown() | Boolean | Restituisce se i valori totali sono 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. |
Invio
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
areLabelsRepeated()
Indica se le etichette sono visualizzate come ripetute.
Invio
Boolean
: true
se le etichette vengono 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.
Invio
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
clearSort()
Rimuove l'ordinamento applicato a questo gruppo.
Invio
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
getDateTimeGroupingRule()
Restituisce la regola di raggruppamento data-ora nel gruppo pivot o null
se non esistono valori di data e ora
è impostata una regola di raggruppamento.
Invio
DateTimeGroupingRule
: la regola per il raggruppamento di 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 un gruppo di righe o colonne.
Invio
Dimension
: la dimensione che rappresenta il tipo di 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
getGroupLimit()
Restituisce il limite del gruppo pivot sul gruppo pivot. Restituisce null
se non esistono limiti del gruppo pivot
è impostata.
Invio
PivotGroupLimit
: il 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 del gruppo corrente.
Invio
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.
Invio
PivotTable
: 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 di dati di origine riassunta da questo gruppo. L'indice è in base a 1, se
questo gruppo riassume i dati di origine nella colonna "A" del foglio di lavoro questo metodo restituisce 1
.
Invio
Integer
: il numero di 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 il pivot
non è {DataSourcePivotTableApi}.
Invio
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ò determina l'assenza di operazioni. Se questo metodo viene chiamato prima che esistano più raggruppamenti di righe o colonne, quando raggruppamento aggiunto. Le etichette ripetute sono nascoste.
Invio
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
isSortAscending()
Restituisce true
se l'ordinamento è crescente, restituisce false
se l'ordinamento è
in ordine decrescente.
Invio
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
sono basati su 0. Ad esempio, se questo gruppo deve essere spostato nella prima posizione,
deve essere chiamato con 0
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
index | Integer | L'indice in cui spostare questo raggruppamento. |
Invio
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
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. |
Invio
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
resetDisplayName()
Reimposta il valore predefinito del nome visualizzato di questo gruppo nella tabella pivot.
Invio
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
setDateTimeGroupingRule(dateTimeGroupingRuleType)
Imposta la regola per il raggruppamento di data e ora nel gruppo pivot.
Per rimuovere la regola, utilizza clearGroupingRule()
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
dateTimeGroupingRuleType | DateTimeGroupingRuleType | Il tipo di regola da impostare. |
Invio
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. |
Invio
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
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 massimo di righe o colonne da impostare. Deve essere positivo. |
Invio
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
setHistogramGroupingRule(minValue, maxValue, intervalSize)
Imposta una regola di raggruppamento degli istogrammi per questo gruppo pivot. Una regola degli istogrammi organizza i valori in un
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 posizionati 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. Valori inferiori a questo valore vengono combinati in un unico bucket. |
maxValue | Integer | Il valore massimo degli elementi da inserire nei bucket. Valori superiori a questo vengono combinati in un unico bucket. |
intervalSize | Integer |
Invio
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
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 vengono già ripetute, autonomo. Se questo metodo viene chiamato prima che esistano più raggruppamenti di righe o colonne, quando un ulteriore raggruppamento viene aggiunto. Vengono mostrate etichette ripetute.
Invio
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
showTotals(showTotals)
Consente di impostare se mostrare i valori totali per questo gruppo pivot nella tabella.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
showTotals | Boolean | Indica se mostrare o meno i totali. |
Invio
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
sortAscending()
Consente di impostare l'ordinamento in modo crescente.
Invio
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
sortBy(value, oppositeGroupValues)
Ordina questo gruppo in base al valore PivotValue
specificato per i valori di 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 gruppo di righe o un gruppo di righe per l'ordinamento di un gruppo di colonne) utilizzati per l'ordinamento. L'ordine di questi valori determinano la precedenza per il tie-breaking. |
Invio
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
sortDescending()
Imposta l'ordinamento su decrescente.
Invio
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
totalsAreShown()
Restituisce se i valori totali sono attualmente mostrati per questo gruppo pivot.
Invio
Boolean
- true
se sono visualizzati valori totali per questo gruppo pivot; 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