Class DataSourceFormula

DataSourceFormula

Acceder a las fórmulas de las 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 que estén conectados a una base de datos.

Métodos

MétodoTipo de datos que se muestraDescripción breve
forceRefreshData()DataSourceFormulaActualiza los datos de este objeto sin importar el estado actual.
getAnchorCell()RangeMuestra el valor Range que representa la celda en la que se ancla esta fórmula de fuente de datos.
getDataSource()DataSourceObtiene la fuente de datos a la que está vinculado el objeto.
getDisplayValue()StringMuestra el valor de visualización de la fórmula de fuente de datos.
getFormula()StringMuestra la fórmula para esta fórmula de fuente de datos.
getStatus()DataExecutionStatusObtiene el estado de ejecución de datos del objeto.
refreshData()DataSourceFormulaActualiza los datos del objeto.
setFormula(formula)DataSourceFormulaActualiza la fórmula.
waitForCompletion(timeoutInSeconds)DataExecutionStatusEspera hasta que se complete 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 información.

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 específico de fuente de datos.

Devolvedor

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

Devolvedor

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.

Devolvedor

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.

Devolvedor

String: Es el valor que se muestra.

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 para esta fórmula de fuente de datos.

Devolvedor

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 datos del objeto.

Devolvedor

DataExecutionStatus: Es 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 está en el 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 específico de fuente de datos.

Devolvedor

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

NombreTipoDescripción
formulaStringLa nueva fórmula.

Devolvedor

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 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 los datos.

Parámetros

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

Devolvedor

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