Class PivotGroup

PivotGruppo

Accedere e modificare i gruppi di distribuzione della tabella pivot.

Metodi

MetodoTipo restituitoBreve descrizione
addManualGroupingRule(groupName, groupMembers)PivotGroupAggiunge una regola di raggruppamento manuale per questo gruppo pivot.
areLabelsRepeated()BooleanRestituisce un valore che indica se le etichette vengono visualizzate come ripetute.
clearGroupingRule()PivotGroupRimuove tutte le regole di raggruppamento da questo gruppo pivot.
clearSort()PivotGroupRimuove qualsiasi ordinamento applicato a questo gruppo.
getDateTimeGroupingRule()DateTimeGroupingRule|nullRestituisce 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()DimensionRestituisce un valore che indica se si tratta di un gruppo di righe o colonne.
getGroupLimit()PivotGroupLimit|nullRestituisce il limite del gruppo pivot sul gruppo pivot.
getIndex()IntegerRestituisce l'indice di questo gruppo pivot nell'ordine corrente dei gruppi.
getPivotTable()PivotTableRestituisce l'PivotTable a cui appartiene questo raggruppamento.
getSourceDataColumn()IntegerRestituisce il numero della colonna di dati di origine riepilogata da questo gruppo.
getSourceDataSourceColumn()DataSourceColumn|nullRestituisce la colonna dell'origine dati su cui opera il gruppo pivot.
hideRepeatedLabels()PivotGroupNasconde le etichette ripetute per questo raggruppamento.
isSortAscending()BooleanRestituisce true se l'ordinamento è crescente, restituisce false se l'ordinamento è decrescente.
moveToIndex(index)PivotGroupSposta questo gruppo nella posizione specificata nell'elenco corrente dei gruppi di righe o colonne.
remove()voidRimuove questo gruppo pivot dalla tabella.
removeManualGroupingRule(groupName)PivotGroupRimuove la regola di raggruppamento manuale con il groupName specificato.
resetDisplayName()PivotGroupReimposta il nome visualizzato di questo gruppo nella tabella pivot sul valore predefinito.
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroupImposta la regola di raggruppamento per data e ora nel gruppo pivot.
setDisplayName(name)PivotGroupImposta il nome visualizzato di questo gruppo nella tabella pivot.
setGroupLimit(countLimit)PivotGroupImposta il limite del gruppo pivot sul gruppo pivot.
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroupImposta una regola di raggruppamento dell'istogramma per questo gruppo pivot.
showRepeatedLabels()PivotGroupQuando è presente più di un raggruppamento di righe o colonne, questo metodo mostra l'etichetta del raggruppamento per ogni voce del raggruppamento successivo.
showTotals(showTotals)PivotGroupSpecifica se mostrare i valori totali per questo gruppo pivot nella tabella.
sortAscending()PivotGroupImposta l'ordine di ordinamento crescente.
sortBy(value, oppositeGroupValues)PivotGroupOrdina questo gruppo in base al PivotValue specificato per i valori di oppositeGroupValues.
sortDescending()PivotGroupImposta l'ordine di ordinamento in ordine decrescente.
totalsAreShown()BooleanRestituisce un valore che indica se i valori totali sono attualmente visualizzati per questo gruppo pivot.

Documentazione dettagliata

addManualGroupingRule(groupName, groupMembers)

Aggiunge una regola di raggruppamento manuale per questo gruppo pivot.

Parametri

NomeTipoDescrizione
groupNameStringIl nome di questa regola di raggruppamento.
groupMembersObject[]I valori inclusi in questa regola di raggruppamento.

Indietro

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

Restituisce un valore che indica se le etichette vengono visualizzate come ripetute.

Indietro

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 tutte le regole di raggruppamento da questo gruppo pivot.

Indietro

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 qualsiasi ordinamento applicato a questo gruppo.

Indietro

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

Indietro

DateTimeGroupingRule|null: 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 un valore che indica se si tratta di un gruppo di righe o colonne.

Indietro

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 è impostato alcun limite del gruppo pivot.

Indietro

PivotGroupLimit|null: 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 corrente dei gruppi.

Indietro

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.

Indietro

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 di dati di origine riepilogata da questo gruppo. Questo indice è basato su 1. Se questo gruppo riepiloga i dati di origine nella colonna "A" del foglio di lavoro, questo metodo restituisce 1.

Indietro

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 oggetto {DataSourcePivotTableApi}.

Indietro

DataSourceColumn|null: 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, il risultato è un'operazione nulla. Se questo metodo viene chiamato prima che siano presenti più raggruppamenti di righe o colonne, quando viene aggiunto un ulteriore raggruppamento, le etichette ripetute vengono nascoste.

Indietro

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 è decrescente.

Indietro

Boolean - true se l'ordine di 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 sono basati su 0. Ad esempio, se questo gruppo deve essere spostato nella prima posizione, questo metodo deve essere chiamato con 0.

Parametri

NomeTipoDescrizione
indexIntegerL'indice in cui spostare questo raggruppamento.

Indietro

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 groupName specificato.

Parametri

NomeTipoDescrizione
groupNameStringIl nome della regola di raggruppamento da rimuovere.

Indietro

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 nome visualizzato di questo gruppo nella tabella pivot sul valore predefinito.

Indietro

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 di raggruppamento per data e ora nel gruppo pivot.

Per rimuovere la regola, utilizza clearGroupingRule().

Parametri

NomeTipoDescrizione
dateTimeGroupingRuleTypeDateTimeGroupingRuleTypeIl tipo di regola da impostare.

Indietro

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

NomeTipoDescrizione
nameStringIl nome visualizzato da impostare.

Indietro

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

Parametri

NomeTipoDescrizione
countLimitIntegerIl limite di conteggio di righe o colonne da impostare. Deve essere positivo.

Indietro

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 dell'istogramma per questo gruppo pivot. Una regola dell'istogramma organizza i valori in una colonna di dati di origine in bucket di dimensioni costanti. Tutti i valori da minValue a maxValue vengono inseriti in gruppi di dimensione interval. Tutti i valori inferiori a minValue vengono inseriti in un bucket, così come tutti i valori superiori a maxValue.

Parametri

NomeTipoDescrizione
minValueIntegerIl valore minimo per inserire gli elementi nei bucket. I valori inferiori a questo vengono combinati in un unico bucket.
maxValueIntegerIl valore massimo per gli elementi da inserire nei bucket. I valori superiori a questo vengono combinati in un unico bucket.
intervalSizeInteger

Indietro

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

Quando è presente più di un raggruppamento di righe o colonne, questo metodo mostra l'etichetta del raggruppamento per ogni voce del raggruppamento successivo. Se le etichette sono già ripetute, il risultato è nessuna operazione. 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.

Indietro

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)

Specifica se mostrare i valori totali per questo gruppo pivot nella tabella.

Parametri

NomeTipoDescrizione
showTotalsBooleanIndica se mostrare o meno i totali.

Indietro

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

Imposta l'ordine di ordinamento crescente.

Indietro

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

NomeTipoDescrizione
valuePivotValueIl valore pivot in base al quale ordinare.
oppositeGroupValuesObject[]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 l'ordinamento. L'ordine di questi valori determina la precedenza per la risoluzione dei pareggi.

Indietro

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'ordine di ordinamento in ordine decrescente.

Indietro

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 un valore che indica se i valori totali sono attualmente visualizzati per questo gruppo pivot.

Indietro

Boolean: true se vengono visualizzati i 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