Acceder y modificar grupos de desglose de tablas dinámicas
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
addManualGroupingRule(groupName, groupMembers) | PivotGroup | Agrega una regla de agrupación manual para este grupo de elementos de tabla dinámica. |
areLabelsRepeated() | Boolean | Muestra si las etiquetas se muestran como repetidas. |
clearGroupingRule() | PivotGroup | Quita las reglas de agrupación de este grupo de elementos de tabla dinámica. |
clearSort() | PivotGroup | Quita cualquier orden aplicado a este grupo. |
getDateTimeGroupingRule() | DateTimeGroupingRule | 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. |
getDimension() | Dimension | Muestra si se trata de un grupo de filas o columnas. |
getGroupLimit() | PivotGroupLimit | Muestra el límite del grupo de elementos de tabla dinámica. |
getIndex() | Integer | Muestra el índice de este grupo de tabla dinámica en el orden actual del grupo. |
getPivotTable() | PivotTable | Muestra el PivotTable al que pertenece esta agrupación. |
getSourceDataColumn() | Integer | Muestra la cantidad de columnas de datos de origen que resume este grupo. |
getSourceDataSourceColumn() | DataSourceColumn | Muestra la columna de fuente de datos en la que opera el grupo de elementos de tabla dinámica. |
hideRepeatedLabels() | PivotGroup | Oculta las etiquetas repetidas de esta agrupación. |
isSortAscending() | Boolean | Muestra true si el orden es ascendente, muestra false si el orden es descendente. |
moveToIndex(index) | PivotGroup | Mueve este grupo a la posición especificada en la lista actual de grupos de filas o columnas. |
remove() | void | Quita este grupo de tabla dinámica de la tabla. |
removeManualGroupingRule(groupName) | PivotGroup | Quita la regla de agrupación manual con el groupName especificado. |
resetDisplayName() | PivotGroup | Restablece el nombre visible de este grupo en la tabla dinámica a su valor predeterminado. |
setDateTimeGroupingRule(dateTimeGroupingRuleType) | PivotGroup | Establece la regla de agrupación de fecha y hora en el grupo de tabla dinámica. |
setDisplayName(name) | PivotGroup | Establece el nombre comercial de este grupo en la tabla dinámica. |
setGroupLimit(countLimit) | PivotGroup | Establece el límite del grupo de elementos de tabla dinámica. |
setHistogramGroupingRule(minValue, maxValue, intervalSize) | PivotGroup | Establece una regla de agrupación de histogramas para este grupo de tabla dinámica. |
showRepeatedLabels() | PivotGroup | 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. |
showTotals(showTotals) | PivotGroup | Establece si se deben mostrar los valores totales para este grupo de tabla dinámica en la tabla. |
sortAscending() | PivotGroup | Establece el orden ascendente como ascendente. |
sortBy(value, oppositeGroupValues) | PivotGroup | Ordena este grupo según la PivotValue especificada para los valores de oppositeGroupValues . |
sortDescending() | PivotGroup | Configura el orden de clasificación como descendente. |
totalsAreShown() | Boolean | Muestra 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
Nombre | Tipo | Descripción |
---|---|---|
groupName | String | El nombre de esta regla de agrupación. |
groupMembers | Object[] | 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
Nombre | Tipo | Descripción |
---|---|---|
index | Integer | El í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
Nombre | Tipo | Descripción |
---|---|---|
groupName | String | El 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
Nombre | Tipo | Descripción |
---|---|---|
dateTimeGroupingRuleType | DateTimeGroupingRuleType | El 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
Nombre | Tipo | Descripción |
---|---|---|
name | String | El 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
Nombre | Tipo | Descripción |
---|---|---|
countLimit | Integer | El 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
Nombre | Tipo | Descripción |
---|---|---|
minValue | Integer | El valor mínimo para los elementos que se colocarán en depósitos. Los valores inferiores a este se combinan en un solo bucket. |
maxValue | Integer | El valor máximo de los elementos que se colocarán en segmentos. Los valores mayores que este se combinan en un solo bucket. |
intervalSize | Integer |
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
Nombre | Tipo | Descripción |
---|---|---|
showTotals | Boolean | Si 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
Nombre | Tipo | Descripción |
---|---|---|
value | PivotValue | El valor de tabla dinámica que se debe ordenar. |
oppositeGroupValues | Object[] | 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