Se usó la API de Cloud Translation para traducir esta página.

Class DataSourceFormula

Acceder a las fórmulas de fuentes de datos existentes y modificarlas Para crear una nueva fórmula de fuente de datos, usa Range.setFormula(formula).

Usa esta clase solo con datos conectados a una base de datos.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`cancelDataRefresh()`	`DataSourceFormula`	Cancela la actualización de datos asociada a este objeto si se está ejecutando.
`forceRefreshData()`	`DataSourceFormula`	Actualiza los datos de este objeto sin importar el estado actual.
`getAnchorCell()`	`Range`	Muestra el objeto `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 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 los datos del objeto.
`refreshData()`	`DataSourceFormula`	Actualiza los datos del objeto.
`setFormula(formula)`	`DataSourceFormula`	Actualiza la fórmula.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	Espera hasta que se complete la ejecución actual. El tiempo de espera se agota después de la cantidad de segundos proporcionada.

Documentación detallada

`cancelDataRefresh()`

Cancela la actualización de datos asociada a este objeto si se está ejecutando.

En este ejemplo, se muestra cómo cancelar la actualización de una fórmula.

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

Arroja una excepción si el tipo de fuente de datos no está habilitado. Usar métodos SpreadsheetApp#enable...Execution() para habilitar la ejecución de datos para una fuente de datos específica el tipo de letra.

Volver

DataSourceFormula: Es 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

`forceRefreshData()`

Actualiza los datos de este objeto sin importar el estado actual. Consulta refreshData() para más detalles. Si deseas cancelar una actualización en ejecución de este objeto, consulta cancelDataRefresh().

Volver

DataSourceFormula: Es 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 objeto Range que representa la celda en la que se ancla esta fórmula de fuente de datos.

Volver

Range: Es 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: Es 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 fuente de datos.

Volver

String: Es 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: Es 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 los datos del objeto.

Volver

DataExecutionStatus: Es el estado de ejecución de los 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 se encuentra en el estado error. Usa DataSource#updateSpec() para actualizar la especificación. El método es se prefiere en lugar de forceRefreshData() para evitar ediciones inesperadas en la fuente de datos.

Volver

DataSourceFormula: Es 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 nueva fórmula.

Volver

DataSourceFormula: Es la fórmula de la fuente de datos 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

`waitForCompletion(timeoutInSeconds)`

Espera hasta que se complete la ejecución actual. El tiempo de espera se agota 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 ejecución de los datos.

Parámetros

Nombre	Tipo	Descripción
`timeoutInSeconds`	`Integer`	El tiempo que se debe esperar para la ejecución de los datos, en segundos. El máximo es 300 segundos.

Volver

DataExecutionStatus: Es el estado de ejecución de los 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