Funciones de Acceso a Planilla de Cálculo

Estas simples instrucciones proveen una manera simple de acceder a la información de la página activa donde sea instalado el script. Lo ideal es que tengas estas 4 funciones a mano y puedas utilizarlas hasta que te familiarices con el acceso a datos convencional.

El código está diseñado de manera de utilizar las llamadas en diferentes niveles, para que se pueda obtener el libro, la página, el rango de celdas o direcamente todos los datos de la página.

Decidí utilizar el símbolo $ como antecesor al nombre de la función para identificarlas fácilmente dentro del código. Además, la letra que sigue indica que objeto se va a obtener invocando la función de la manera siguiente:

• L: obtiene el Libro activo.
• H: obtiene la Hoja del Libro activo.
• R: obtiene el Rango de la Hoja que contiene valores.
• D: obtiene todos los datos de la hoja.

Función para obtener el LIBRO: $l

function $l(){

//Función para obtener la pagina activa.

var libro = SpreadsheetApp.getActiveSpreadsheet();

return libro;

}

Función para obtener la HOJA: $h

Función para obtener el RANGO: $r

function $r(n){

//Devuelve el rango de las celdas que contienen datos

// de la hoja con nombre igual al parámetro.

var h = $h(n);

return h.getRange(1, 1, h.getLastRow()-1, h.getLastColumn()-1);

}

Función para obtener los DATOS: $d

function $d(n){

//Función que devuelve una matriz con los valores

//de la hoja con nombre igual al parámetro.

return $r(n).getValues();

}