Acceder a las fórmulas de fuentes de datos existentes y modificarlas Para crear una fórmula de fuente de datos nueva, usa Range.setFormula(formula).
Usa solo esta clase con datos conectados a una base de datos.
Métodos
| Método | Tipo de datos que se muestra | Descripción breve |
|---|---|---|
forceRefreshData() | DataSourceFormula | Actualiza los datos de este objeto sin importar el estado actual. |
getAnchorCell() | Range | Muestra el Range que representa la celda en la que se ancla esta fórmula de fuente de datos. |
getDataSource() | DataSource | Obtiene la fuente de datos a la que está vinculado el objeto. |
getDisplayValue() | String | Muestra el valor de visualización de la fórmula de la fuente de datos. |
getFormula() | String | Muestra la fórmula de esta fórmula de fuente de datos. |
getStatus() | DataExecutionStatus | Obtiene el estado de ejecución de datos del objeto. |
refreshData() | DataSourceFormula | Actualiza los datos del objeto. |
setFormula(formula) | DataSourceFormula | Actualiza la fórmula. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Espera 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
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
DataSourceFormula: 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
getAnchorCell()
Muestra el Range que representa la celda en la que se ancla esta fórmula de fuente de datos.
Volver
Range: la celda de anclaje
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
getDisplayValue()
Muestra el valor de visualización de la fórmula de la fuente de datos.
Volver
String: el valor de visualización.
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
getFormula()
Muestra la fórmula de esta fórmula de fuente de datos.
Volver
String: La fórmula.
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
DataSourceFormula: 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
setFormula(formula)
Actualiza la fórmula.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
formula | String | La fórmula nueva. |
Volver
DataSourceFormula: es la fórmula de la fuente de datos 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
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
| Nombre | Tipo | Descripción |
|---|---|---|
timeoutInSeconds | Integer | El 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