Class PivotGroup

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.
PivotGroup.

Acceder y modificar grupos de desglose de tablas dinámicas

Métodos

MétodoTipo de datos que se muestraDescripción breve
addManualGroupingRule(groupName, groupMembers)PivotGroupAgrega una regla de agrupación manual para este grupo de elementos de tabla dinámica.
areLabelsRepeated()BooleanMuestra si las etiquetas se muestran como repetidas.
clearGroupingRule()PivotGroupQuita las reglas de agrupación de este grupo de elementos de tabla dinámica.
clearSort()PivotGroupQuita cualquier orden aplicado a este grupo.
getDateTimeGroupingRule()DateTimeGroupingRuleMuestra la regla de agrupación de fecha y hora en el grupo dinámico o null si no se estableció ninguna regla de agrupación por fecha y hora.
getDimension()DimensionMuestra si se trata de un grupo de filas o columnas.
getGroupLimit()PivotGroupLimitMuestra el límite del grupo de elementos de tabla dinámica.
getIndex()IntegerMuestra el índice de este grupo de tabla dinámica en el orden actual del grupo.
getPivotTable()PivotTableMuestra el PivotTable al que pertenece esta agrupación.
getSourceDataColumn()IntegerMuestra la cantidad de columnas de datos de origen que resume este grupo.
getSourceDataSourceColumn()DataSourceColumnMuestra la columna de fuente de datos en la que opera el grupo de elementos de tabla dinámica.
hideRepeatedLabels()PivotGroupOculta las etiquetas repetidas de esta agrupación.
isSortAscending()BooleanMuestra true si el orden es ascendente, muestra false si el orden es descendente.
moveToIndex(index)PivotGroupMueve este grupo a la posición especificada en la lista actual de grupos de filas o columnas.
remove()voidQuita este grupo de tabla dinámica de la tabla.
removeManualGroupingRule(groupName)PivotGroupQuita la regla de agrupación manual con el groupName especificado.
resetDisplayName()PivotGroupRestablece el nombre visible de este grupo en la tabla dinámica a su valor predeterminado.
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroupEstablece la regla de agrupación de fecha y hora en el grupo de tabla dinámica.
setDisplayName(name)PivotGroupEstablece el nombre comercial de este grupo en la tabla dinámica.
setGroupLimit(countLimit)PivotGroupEstablece el límite del grupo de elementos de tabla dinámica.
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroupEstablece una regla de agrupación de histogramas para este grupo de tabla dinámica.
showRepeatedLabels()PivotGroupCuando hay más de una agrupación de filas o columnas, este método muestra la etiqueta de esta agrupación para cada entrada de la agrupación siguiente.
showTotals(showTotals)PivotGroupEstablece si se deben mostrar los valores totales para este grupo de tabla dinámica en la tabla.
sortAscending()PivotGroupEstablece el orden ascendente como ascendente.
sortBy(value, oppositeGroupValues)PivotGroupOrdena este grupo según la PivotValue especificada para los valores de oppositeGroupValues.
sortDescending()PivotGroupConfigura el orden de clasificación como descendente.
totalsAreShown()BooleanMuestra si los valores totales se muestran actualmente para este grupo de tabla dinámica.

Documentación detallada

addManualGroupingRule(groupName, groupMembers)

Agrega una regla de agrupación manual para este grupo de elementos de tabla dinámica.

Parámetros

NombreTipoDescripción
groupNameStringEl nombre de esta regla de agrupación.
groupMembersObject[]Los valores que se incluyen en esta regla de agrupación.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

areLabelsRepeated()

Muestra si las etiquetas se muestran como repetidas.

Volver

Boolean: true si se repiten las etiquetas; de lo contrario, muestra false.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clearGroupingRule()

Quita las reglas de agrupación de este grupo de elementos de tabla dinámica.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clearSort()

Quita cualquier orden aplicado a este grupo.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDateTimeGroupingRule()

Muestra la regla de agrupación de fecha y hora en el grupo dinámico o null si no se estableció ninguna regla de agrupación por fecha y hora.

Volver

DateTimeGroupingRule: la regla de agrupación de fecha y hora.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDimension()

Muestra si se trata de un grupo de filas o columnas.

Volver

Dimension: la dimensión que representa este tipo de grupo

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getGroupLimit()

Muestra el límite del grupo de elementos de tabla dinámica. Muestra null si no se establece ningún límite de grupo de elementos de tabla dinámica.

Volver

PivotGroupLimit: el límite de grupos de tabla dinámica.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getIndex()

Muestra el índice de este grupo de tabla dinámica en el orden actual del grupo.

Volver

Integer: el índice del grupo de elementos de tabla dinámica

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getPivotTable()

Muestra el PivotTable al que pertenece esta agrupación.

Volver

PivotTable: Es la tabla dinámica a la que pertenece este grupo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSourceDataColumn()

Muestra la cantidad de columnas de datos de origen que resume este grupo. Este índice se basa en 1 y, si este grupo resume los datos de origen en la columna “A” de la hoja de cálculo, este método muestra 1.

Volver

Integer: Es el número de columna de datos de origen.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSourceDataSourceColumn()

Muestra la columna de fuente de datos en la que opera el grupo de elementos de tabla dinámica. Muestra null si la tabla dinámica no es una {DataSourcePivotTableApi}.

Volver

DataSourceColumn: la columna de fuente de datos en la que opera el grupo de tabla dinámica.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

hideRepeatedLabels()

Oculta las etiquetas repetidas de esta agrupación. Si las etiquetas ya están ocultas, esto genera una no-op. Si se llama a este método antes de que haya varias agrupaciones de filas o columnas, cuando se agrega una agrupación adicional, se ocultan las etiquetas repetidas.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isSortAscending()

Muestra true si el orden es ascendente, muestra false si el orden es descendente.

Volver

Boolean: true si el orden de clasificación es ascendente.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

moveToIndex(index)

Mueve este grupo a la posición especificada en la lista actual de grupos de filas o columnas. Estos índices se basan en 0. Por ejemplo, si este grupo debe moverse a la primera posición, se debe llamar a este método con 0.

Parámetros

NombreTipoDescripción
indexIntegerEl índice al que se moverá la agrupación.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

remove()

Quita este grupo de tabla dinámica de la tabla.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

removeManualGroupingRule(groupName)

Quita la regla de agrupación manual con el groupName especificado.

Parámetros

NombreTipoDescripción
groupNameStringEl nombre de la regla de agrupación que se quitará.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

resetDisplayName()

Restablece el nombre visible de este grupo en la tabla dinámica a su valor predeterminado.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setDateTimeGroupingRule(dateTimeGroupingRuleType)

Establece la regla de agrupación de fecha y hora en el grupo de tabla dinámica.

Para quitar la regla, usa clearGroupingRule().

Parámetros

NombreTipoDescripción
dateTimeGroupingRuleTypeDateTimeGroupingRuleTypeEl tipo de regla que se establecerá.

Volver

PivotGroup: Es el grupo de elementos dinámicos para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setDisplayName(name)

Establece el nombre comercial de este grupo en la tabla dinámica.

Parámetros

NombreTipoDescripción
nameStringEl nombre visible que se establecerá.

Volver

PivotGroup: Es el grupo de pivot para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setGroupLimit(countLimit)

Establece el límite del grupo de elementos de tabla dinámica. La operación solo es compatible con DataSourcePivotTable.

Parámetros

NombreTipoDescripción
countLimitIntegerEl límite de recuento de filas o columnas que se establecerán. Debe ser un número positivo.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHistogramGroupingRule(minValue, maxValue, intervalSize)

Establece una regla de agrupación de histogramas para este grupo de tabla dinámica. Una regla de histograma organiza los valores en una columna de datos de origen en depósitos de un tamaño constante. Todos los valores del minValue al maxValue se colocan en grupos del tamaño interval. Todos los valores inferiores a minValue se colocan en un bucket, al igual que todos los valores mayores que maxValue.

Parámetros

NombreTipoDescripción
minValueIntegerEl valor mínimo para los elementos que se colocarán en depósitos. Los valores inferiores a este se combinan en un solo bucket.
maxValueIntegerEl valor máximo de los elementos que se colocarán en segmentos. Los valores mayores que este se combinan en un solo bucket.
intervalSizeInteger

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

showRepeatedLabels()

Cuando hay más de una agrupación de filas o columnas, este método muestra la etiqueta de esta agrupación para cada entrada de la agrupación siguiente. Si las etiquetas ya se repiten, esto genera una no-op. Si se llama a este método antes de que haya varias agrupaciones de filas o columnas, cuando se agrega una agrupación adicional, se muestran etiquetas repetidas.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

showTotals(showTotals)

Establece si se deben mostrar los valores totales para este grupo de tabla dinámica en la tabla.

Parámetros

NombreTipoDescripción
showTotalsBooleanSi se muestran los totales o no.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

sortAscending()

Establece el orden ascendente como ascendente.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

sortBy(value, oppositeGroupValues)

Ordena este grupo según la PivotValue especificada para los valores de 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']);

Parámetros

NombreTipoDescripción
valuePivotValueEl valor de tabla dinámica que se debe ordenar.
oppositeGroupValuesObject[]Los valores de un grupo dinámico opuesto (un grupo de columnas si ordenas un grupo de filas o un grupo de filas si ordenas un grupo de columnas) que se usan para ordenar los datos. El orden de estos valores determina la prioridad para el empate.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

sortDescending()

Configura el orden de clasificación como descendente.

Volver

PivotGroup: Es el grupo de pivote para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

totalsAreShown()

Muestra si los valores totales se muestran actualmente para este grupo de tabla dinámica.

Volver

Boolean: true si se muestran los valores totales para este grupo de tabla dinámica; de lo contrario, muestra false.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets