Accede a los grupos de sesiones separadas de tablas dinámicas y modifícalos.
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 todas las reglas de agrupación de este grupo de elementos de tabla dinámica. |
clearSort() | PivotGroup | Quita cualquier orden que se haya aplicado a este grupo. |
getDateTimeGroupingRule() | DateTimeGroupingRule | Muestra la regla de agrupación de fecha y hora en el grupo de elementos dinámicos, o null si no se estableció ninguna regla de agrupación de fecha y hora. |
getDimension() | Dimension | Muestra si es 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 elementos dinámicos en el orden de grupo actual. |
getPivotTable() | PivotTable | Muestra el PivotTable al que pertenece esta agrupación. |
getSourceDataColumn() | Integer | Muestra el número de la columna de datos de origen que resume este grupo. |
getSourceDataSourceColumn() | DataSourceColumn | Muestra la columna de la fuente de datos en la que opera el grupo de tabla dinámica. |
hideRepeatedLabels() | PivotGroup | Oculta las etiquetas repetidas para esta agrupación. |
isSortAscending() | Boolean | Muestra true si el orden es ascendente y 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 elementos dinámicos 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 | Configura la regla de agrupación de fecha y hora en el grupo de elementos dinámicos. |
setDisplayName(name) | PivotGroup | Establece el nombre visible 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 elementos 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 posterior. |
showTotals(showTotals) | PivotGroup | Establece si se muestran los valores totales de este grupo de elementos dinámicos en la tabla. |
sortAscending() | PivotGroup | Establece que el orden de clasificación sea ascendente. |
sortBy(value, oppositeGroupValues) | PivotGroup | Ordena este grupo según el PivotValue especificado para los valores de oppositeGroupValues . |
sortDescending() | PivotGroup | Establece el orden de clasificación descendente. |
totalsAreShown() | Boolean | Muestra si los valores totales se muestran actualmente para este grupo de elementos 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 | Es el nombre de esta regla de agrupación. |
groupMembers | Object[] | Son los valores que se incluyen en esta regla de agrupación. |
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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.
Devolvedor
Boolean
: Es true
si las etiquetas se repiten; 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 todas las reglas de agrupación de este grupo de elementos de tabla dinámica.
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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 que se haya aplicado a este grupo.
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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 de elementos dinámicos, o null
si no se estableció ninguna regla de agrupación de fecha y hora.
Devolvedor
DateTimeGroupingRule
: Es 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 es un grupo de filas o columnas.
Devolvedor
Dimension
: Es la dimensión que representa el tipo de 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
getGroupLimit()
Muestra el límite del grupo de elementos de tabla dinámica. Muestra null
si no se establece un límite de grupo de elementos dinámicos.
Devolvedor
PivotGroupLimit
: Es el límite 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
getIndex()
Muestra el índice de este grupo de elementos dinámicos en el orden de grupo actual.
Devolvedor
Integer
: Es 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.
Devolvedor
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 el número de la columna de datos de origen que resume este grupo. Este índice se basa en el 1. Si este grupo resume los datos de origen en la columna "A" de la hoja de cálculo, este método muestra 1
.
Devolvedor
Integer
: Es el número de columna de los 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 la fuente de datos en la que opera el grupo de tabla dinámica. Muestra null
si la tabla dinámica no es una {DataSourcePivotTableApi}.
Devolvedor
DataSourceColumn
: Es la columna de la 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 para esta agrupación. Si las etiquetas ya están ocultas, esto da como resultado 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, las etiquetas repetidas se ocultan.
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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 y muestra false
si el orden es descendente.
Devolvedor
Boolean
: Es 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 el 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á esta agrupación. |
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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 elementos dinámicos 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á. |
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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.
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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)
Configura la regla de agrupación de fecha y hora en el grupo de elementos dinámicos.
Para quitar la regla, usa clearGroupingRule()
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
dateTimeGroupingRuleType | DateTimeGroupingRuleType | El tipo de regla que se establecerá. |
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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 visible de este grupo en la tabla dinámica.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
name | String | El nombre visible que se establecerá. |
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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 se admite para DataSourcePivotTable
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
countLimit | Integer | El límite de filas o columnas que se establecerá Debe ser positivo. |
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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 elementos de tabla dinámica. Una regla de histograma organiza los valores en una columna de datos de origen en buckets de un tamaño constante. Todos los valores desde minValue
hasta maxValue
se colocan en grupos de tamaño interval
. Todos los valores por debajo de 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 que los elementos se coloquen en buckets. Los valores menores que este se combinan en un solo bucket. |
maxValue | Integer | El valor máximo para que los elementos se coloquen en buckets. Los valores superiores a este se combinan en un solo bucket. |
intervalSize | Integer |
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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 posterior. Si las etiquetas ya están repetidas, esto da como resultado 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.
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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 muestran los valores totales de este grupo de elementos dinámicos en la tabla.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
showTotals | Boolean | Indica si se deben mostrar los totales o no. |
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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 que el orden de clasificación sea ascendente.
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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 el PivotValue
especificado 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 | Es el valor de tabla dinámica que se usará para ordenar. |
oppositeGroupValues | Object[] | Los valores de un grupo de elementos dinámicos opuesto (un grupo de columnas si se ordena un grupo de filas o un grupo de filas si se ordena un grupo de columnas) que se usan para ordenar. El orden de estos valores determina la prioridad para el empate. |
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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()
Establece el orden de clasificación descendente.
Devolvedor
PivotGroup
: Es el grupo de elementos dinámicos para el encadenamiento.
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 elementos de tabla dinámica.
Devolvedor
Boolean
: Es true
si se muestran los valores totales para este grupo de elementos 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