Questa pagina è stata tradotta dall'API Cloud Translation.

Class PivotGroup

Accedi e modifica i gruppi di suddivisione della tabella pivot.

Metodi

Metodo	Tipo restituito	Breve descrizione
`addManualGroupingRule(groupName, groupMembers)`	`PivotGroup`	Aggiunge una regola di raggruppamento manuale per questo gruppo pivot.
`areLabelsRepeated()`	`Boolean`	Restituisce se le etichette vengono visualizzate come ripetute.
`clearGroupingRule()`	`PivotGroup`	Rimuove eventuali regole di raggruppamento da questo gruppo pivot.
`clearSort()`	`PivotGroup`	Rimuove l'ordinamento applicato a questo gruppo.
`getDateTimeGroupingRule()`	`DateTimeGroupingRule`	Restituisce la regola di raggruppamento per data e ora nel gruppo pivot o `null` se non è impostata alcuna regola di raggruppamento per data e ora.
`getDimension()`	`Dimension`	Restituisce se si tratta di un gruppo di righe o colonne.
`getGroupLimit()`	`PivotGroupLimit`	Restituisce il limite del gruppo pivot nel gruppo pivot.
`getIndex()`	`Integer`	Restituisce l'indice di questo gruppo pivot nell'ordine del gruppo corrente.
`getPivotTable()`	`PivotTable`	Restituisce l'`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, `false` se l'ordinamento è decrescente.
`moveToIndex(index)`	`PivotGroup`	Sposta questo gruppo nella posizione specificata nell'elenco corrente dei 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`	Ripristina il valore predefinito del nome visualizzato di questo gruppo nella tabella pivot.
`setDateTimeGroupingRule(dateTimeGroupingRuleType)`	`PivotGroup`	Imposta la regola di raggruppamento per 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 sul gruppo pivot.
`setHistogramGroupingRule(minValue, maxValue, intervalSize)`	`PivotGroup`	Imposta una regola di raggruppamento dell'istogramma per questo gruppo pivot.
`showRepeatedLabels()`	`PivotGroup`	Quando è 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`	Imposta se mostrare i valori totali per questo gruppo pivot nella tabella.
`sortAscending()`	`PivotGroup`	Imposta l'ordinamento in ordine crescente.
`sortBy(value, oppositeGroupValues)`	`PivotGroup`	Ordina questo gruppo in base al `PivotValue` specificato per i valori di `oppositeGroupValues`.
`sortDescending()`	`PivotGroup`	Imposta l'ordinamento in ordine decrescente.
`totalsAreShown()`	`Boolean`	Restituisce se al momento sono visualizzati i valori totali 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 l'accodamento.

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()`

Restituisce se le etichette vengono visualizzate come ripetute.

Invio

Boolean: true se le etichette sono ripetute; 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

`clearGroupingRule()`

Rimuove eventuali regole di raggruppamento da questo gruppo pivot.

Invio

PivotGroup: il gruppo pivot per l'accodamento.

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 l'accodamento.

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 nel gruppo pivot o null se non è impostata alcuna regola di raggruppamento per data e ora.

Invio

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()`

Restituisce se si tratta di un gruppo di righe o colonne.

Invio

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 nel gruppo pivot. Restituisce null se non è impostato alcun limite per i gruppi pivot.

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 l'PivotTable a cui appartiene questo raggruppamento.

Invio

PivotTable: la tabella pivot a cui appartiene il 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. Questo indice è basato su 1. Se questo gruppo riassume i dati di origine nella colonna "A" del foglio di lavoro, questo metodo restituisce 1.

Invio

Integer: il numero della colonna di 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}.

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, l'operazione non viene eseguita. Se questo metodo viene chiamato prima che siano presenti più raggruppamenti di righe o colonne, quando viene aggiunto un altro raggruppamento, le etichette ripetute vengono nascoste.

Invio

PivotGroup: il gruppo pivot per l'accodamento.

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, false se l'ordinamento è 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 dei gruppi di righe o colonne. Questi indici hanno come base 0. Ad esempio, se questo gruppo deve essere spostato nella prima posizione, questo metodo deve essere chiamato con 0.

Parametri

Nome	Tipo	Descrizione
`index`	`Integer`	L'indice in cui spostare questo raggruppamento.

Invio

PivotGroup: il gruppo pivot per l'accodamento.

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 l'accodamento.

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()`

Ripristina il valore predefinito del nome visualizzato di questo gruppo nella tabella pivot.

Invio

PivotGroup: il gruppo pivot per l'accodamento.

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 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 l'accodamento.

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 l'accodamento

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 sul gruppo pivot. L'operazione è supportata solo per DataSourcePivotTable.

Parametri

Nome	Tipo	Descrizione
`countLimit`	`Integer`	Il limite di conteggio delle righe o delle colonne da impostare. Deve essere positivo.

Invio

PivotGroup: il gruppo pivot per l'accodamento.

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 dell'istogramma per questo gruppo pivot. Una regola di istogramma organizza i valori di una colonna di dati di origine in bucket di dimensioni costanti. 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 superiori a maxValue.

Parametri

Nome	Tipo	Descrizione
`minValue`	`Integer`	Il valore minimo per gli elementi da inserire nei bucket. I valori inferiori a questo valore vengono combinati in un unico bucket.
`maxValue`	`Integer`	Il valore massimo per gli elementi da inserire nei bucket. I valori superiori a questo valore vengono combinati in un unico bucket.
`intervalSize`	`Integer`

Invio

PivotGroup: il gruppo pivot per l'accodamento.

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()`

Quando è 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, il risultato è un'operazione non eseguita. Se questo metodo viene chiamato prima che siano presenti più raggruppamenti di righe o colonne, quando viene aggiunto un raggruppamento aggiuntivo vengono visualizzate le etichette ripetute.

Invio

PivotGroup: il gruppo pivot per l'accodamento.

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)`

Imposta 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 l'accodamento.

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 in ordine crescente.

Invio

PivotGroup: il gruppo pivot per l'accodamento.

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 di oppositeGroupValues.

// Sorts the item group by the "SUM of Quantity" pivot value for the specified
// salespersons.
const sheet = SpreadsheetApp.getActiveSheet();
const pivotTable = sheet.getPivotTables()[0];
const itemGroup = pivotTable.getRowGroups()[0];
const 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 ordini un gruppo di righe o un gruppo di righe se ordini un gruppo di colonne) utilizzati per l'ordinamento. L'ordine di questi valori determina la precedenza per lo spareggio.

Invio

PivotGroup: il gruppo pivot per l'accodamento.

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.

Invio

PivotGroup: il gruppo pivot per l'accodamento.

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 al momento sono visualizzati i valori totali per questo gruppo pivot.

Invio

Boolean: true se per questo gruppo pivot vengono visualizzati i valori totali; 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