En el ámbito gubernamental del estado de Tamaulipas, se ha adoptado la tecnología Google AppSheets para desarrollar aplicativos simples que aborden problemáticas cotidianas. Sin embargo, conforme algunos de estos aplicativos muestran un potencial significativo, surge la necesidad imperante de migrarlos hacia plataformas más robustas. Es importante destacar que esta decisión no implica que Google AppSheets carezca de robustez; simplemente, se busca aprovechar plataformas con características adicionales para atender las crecientes demandas y complejidades de dichos aplicativos.
Necesitamos una herramienta que nos permita llamar datos de hojas de spreadsheets de una manera más conveniente, así que se desarrolló esta herramienta (sencilla para mi al menos), que nos proporciona un api sencillo para poder cargar estos datos en memoria, pero convertidos a objetos faciles de manejar.
Imagina que tenemos una base de datos de usuarios en un archivo de spreadsheets
1.- Archivo Credentials.json de Google Lo puedes conseguir aquí 2.- Id del Spreadsheet 3.- Nombre de la Hoja 4.- Un nombre para cada columna dentro de tu código
npm i appsheet-companion
yarn add appsheet-companion
Uso
import { Init, type Companion, type SheetDataReq} from 'appsheet-companion'
async function main(){
const companion = Init({
credentials: 'path/to/credentials.json'
});
const usersRequest:SheetDataReq = {
sheetName:'USERS',// hoja dentro del spreadsheet
sheetRange:'A2:ZZ',
googleFileId:'1_1qQIS-cZhQqjhPQmnwevrjOKuBJo8G6-G-p5hIwjXc', // id del spreadsheet
// opcional, si no se especifica, se toman los nombres de las columnas de la primera fila de la hoja
// y se procesan como underscore_case
// ej. Nombre de columna: 'Nombre de Usuario' -> nombre_de_usuario
columns:[{
position:0,
name:'id',
},
{
position:1,
name:'nombre'
},
{
position:2,
name:'apellido'
},
{
position:3,
name:'email'
}]
}
const usersTable = companion.spreadSheetServices.useDataFromTable(usersRequest);
console.log(usersTable.response.rawData); // Datos recibidos de la tabla en formato string[][]
console.log(usersTable.response.data); // Datos recibidos de la tabla convertidos a objetos
/* ej.
[{
id:'1',
nombre:'Alan',
apellido:'Torres',
email:'a@a.com'
}]
*/
}