Class DataSourcePivotTable

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

Acceder y modificar la tabla dinámica de la fuente de datos existente Para crear una nueva tabla dinámica de fuente de datos, usa Range.createDataSourcePivotTable(dataSource). Usa solo esta clase con datos conectados a una base de datos.

Métodos

MétodoTipo de datos que se muestraDescripción breve
addColumnGroup(columnName)PivotGroupAgrega un nuevo grupo de columnas dinámicas basado en la columna de fuente de datos especificada.
addFilter(columnName, filterCriteria)PivotFilterAgrega un filtro nuevo basado en la columna de fuente de datos especificada con los criterios de filtro especificados.
addPivotValue(columnName, summarizeFunction)PivotValueAgrega un valor de tabla dinámica nuevo basado en la columna de fuente de datos especificada con la función de resumen especificada.
addRowGroup(columnName)PivotGroupAgrega un nuevo grupo de filas dinámicas basado en la columna de fuente de datos especificada.
asPivotTable()PivotTableMuestra la tabla dinámica de la fuente de datos como un objeto de tabla dinámica normal.
forceRefreshData()DataSourcePivotTableActualiza los datos de este objeto sin importar el estado actual.
getDataSource()DataSourceObtiene la fuente de datos a la que está vinculado el objeto.
getStatus()DataExecutionStatusObtiene el estado de ejecución de datos del objeto.
refreshData()DataSourcePivotTableActualiza los datos del objeto.
waitForCompletion(timeoutInSeconds)DataExecutionStatusEspera hasta que se completa la ejecución actual y se agota el tiempo de espera después de la cantidad de segundos proporcionada.

Documentación detallada

addColumnGroup(columnName)

Agrega un nuevo grupo de columnas dinámicas basado en la columna de fuente de datos especificada.

Parámetros

NombreTipoDescripción
columnNameStringEl nombre de la columna de retención de datos en la que se basa el grupo de tabla dinámica.

Volver

PivotGroup: Es el nuevo 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

addFilter(columnName, filterCriteria)

Agrega un filtro nuevo basado en la columna de fuente de datos especificada con los criterios de filtro especificados.

Parámetros

NombreTipoDescripción
columnNameStringEl nombre de la columna de la base de datos en la que se basa el filtro.
filterCriteriaFilterCriteriaLos criterios que utiliza el filtro.

Volver

PivotFilter: Es el filtro nuevo.

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

addPivotValue(columnName, summarizeFunction)

Agrega un valor de tabla dinámica nuevo basado en la columna de fuente de datos especificada con la función de resumen especificada.

Parámetros

NombreTipoDescripción
columnNameStringEl nombre de la columna de la base de datos en la que se basa el valor de tabla dinámica.
summarizeFunctionPivotTableSummarizeFunctionLa función de resumen que usa el valor de tabla dinámica.

Volver

PivotValue: Es el nuevo valor 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

addRowGroup(columnName)

Agrega un nuevo grupo de filas dinámicas basado en la columna de fuente de datos especificada.

Parámetros

NombreTipoDescripción
columnNameStringEl nombre de la columna de retención de datos en la que se basa el grupo de tabla dinámica.

Volver

PivotGroup: Es el nuevo 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

asPivotTable()

Muestra la tabla dinámica de la fuente de datos como un objeto de tabla dinámica normal.

Volver

PivotTable: Es la 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

forceRefreshData()

Actualiza los datos de este objeto sin importar el estado actual. Consulta refreshData() para obtener más detalles.

Muestra una excepción si el tipo de fuente de datos no está habilitado. Usa los métodos SpreadsheetApp#enable...Execution() a fin de habilitar la ejecución de datos para un tipo de fuente de datos específico.

Volver

DataSourcePivotTable: el objeto de datos.

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

getDataSource()

Obtiene la fuente de datos a la que está vinculado el objeto.

Volver

DataSource: la fuente de datos.

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

getStatus()

Obtiene el estado de ejecución de datos del objeto.

Volver

DataExecutionStatus: el estado de ejecución de datos

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

refreshData()

Actualiza los datos del objeto.

Muestra una excepción si actualmente está en estado error. Usa DataSource#updateSpec() para actualizar la especificación. Se prefiere el método en lugar de forceRefreshData() para evitar ediciones inesperadas en la fuente de datos.

Muestra una excepción si el tipo de fuente de datos no está habilitado. Usa los métodos SpreadsheetApp#enable...Execution() a fin de habilitar la ejecución de datos para un tipo de fuente de datos específico.

Volver

DataSourcePivotTable: el objeto de datos.

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

waitForCompletion(timeoutInSeconds)

Espera hasta que se completa la ejecución actual y se agota el tiempo de espera después de la cantidad de segundos proporcionada. Muestra una excepción si la ejecución no se completa cuando se agota el tiempo de espera, pero no cancela la ejecución de datos.

Parámetros

NombreTipoDescripción
timeoutInSecondsIntegerEl tiempo de espera para la ejecución de los datos, en segundos. El máximo es de 300 segundos.

Volver

DataExecutionStatus: el estado de ejecución de datos

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