Class PivotGroup

PivotGroup

Accedere ai gruppi di lavoro delle tabelle pivot e modificarli.

Metodi

MetodoTipo restituitoBreve descrizione
addManualGroupingRule(groupName, groupMembers)PivotGroupAggiunge una regola di raggruppamento manuale per questo gruppo pivot.
areLabelsRepeated()BooleanIndica se le etichette vengono visualizzate come ripetute.
clearGroupingRule()PivotGroupRimuove qualsiasi regola di raggruppamento da questo gruppo pivot.
clearSort()PivotGroupRimuove qualsiasi ordinamento applicato al gruppo.
getDateTimeGroupingRule()DateTimeGroupingRuleRestituisce 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()DimensionIndica se si tratta di una riga o di un gruppo di colonne.
getGroupLimit()PivotGroupLimitRestituisce il limite del gruppo pivot per il gruppo pivot.
getIndex()IntegerRestituisce l'indice di questo gruppo pivot nell'ordine corrente dei gruppi.
getPivotTable()PivotTableRestituisce il valore PivotTable a cui appartiene questo raggruppamento.
getSourceDataColumn()IntegerRestituisce il numero della colonna dei dati di origine riepilogati da questo gruppo.
getSourceDataSourceColumn()DataSourceColumnRestituisce 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 e false se l'ordinamento è decrescente.
moveToIndex(index)PivotGroupSposta questo gruppo nella posizione specificata nell'elenco corrente di gruppi di righe o colonne.
remove()voidRimuove questo gruppo pivot dalla tabella.
removeManualGroupingRule(groupName)PivotGroupRimuove la regola di raggruppamento manuale con il valore groupName specificato.
resetDisplayName()PivotGroupReimposta il nome visualizzato di questo gruppo nella tabella pivot al valore predefinito.
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroupImposta la regola di raggruppamento per data e ora sul gruppo pivot.
setDisplayName(name)PivotGroupImposta il nome visualizzato di questo gruppo nella tabella pivot.
setGroupLimit(countLimit)PivotGroupImposta il limite del gruppo pivot per il gruppo pivot.
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroupImposta una regola di raggruppamento degli istogrammi per questo gruppo pivot.
showRepeatedLabels()PivotGroupSe è 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)PivotGroupConsente di stabilire se mostrare nella tabella i valori totali per questo gruppo pivot.
sortAscending()PivotGroupImposta l'ordinamento crescente.
sortBy(value, oppositeGroupValues)PivotGroupOrdina questo gruppo in base al PivotValue specificato per i valori da oppositeGroupValues.
sortDescending()PivotGroupImposta l'ordinamento in ordine decrescente.
totalsAreShown()BooleanIndica 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

NomeTipoDescrizione
groupNameStringIl nome di questa regola di raggruppamento.
groupMembersObject[]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

NomeTipoDescrizione
indexIntegerL'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

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

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

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

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

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

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

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

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