Class PivotGroup

PivotGroup

Accesso e modifica dei gruppi di lavoro delle tabelle pivot.

Metodi

MetodoTipo restituitoBreve descrizione
addManualGroupingRule(groupName, groupMembers)PivotGroupAggiunge una regola di raggruppamento manuale per questo gruppo pivot.
areLabelsRepeated()BooleanIndica se le etichette sono visualizzate come ripetute.
clearGroupingRule()PivotGroupRimuove qualsiasi regola di raggruppamento da questo gruppo pivot.
clearSort()PivotGroupRimuove l'ordinamento applicato a questo gruppo.
getDateTimeGroupingRule()DateTimeGroupingRuleRestituisce 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()DimensionIndica se si tratta di un gruppo di righe o colonne.
getGroupLimit()PivotGroupLimitRestituisce il limite del gruppo pivot sul gruppo pivot.
getIndex()IntegerRestituisce l'indice di questo gruppo pivot nell'ordine del gruppo corrente.
getPivotTable()PivotTableRestituisce il valore PivotTable a cui appartiene questo raggruppamento.
getSourceDataColumn()IntegerRestituisce il numero della colonna di dati di origine riassunta 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, restituisce false se l'ordinamento è in ordine 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 valore predefinito del nome visualizzato di questo gruppo nella tabella pivot.
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroupImposta la regola per il raggruppamento di 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 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 impostare se mostrare i valori totali per questo gruppo pivot nella tabella.
sortAscending()PivotGroupConsente di impostare l'ordinamento in modo crescente.
sortBy(value, oppositeGroupValues)PivotGroupOrdina questo gruppo in base al valore PivotValue specificato per i valori di oppositeGroupValues.
sortDescending()PivotGroupImposta l'ordinamento su decrescente.
totalsAreShown()BooleanRestituisce 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

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

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

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

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

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

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

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

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

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

NomeTipoDescrizione
valuePivotValueIl valore pivot in base al quale ordinare.
oppositeGroupValuesObject[]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