El comando xlsRead (GSuite) permite al usuario leer una celda / rango de un Google Sheet. El valor leído se guardará en la variable indicada por parámetro. En caso de que se trate de un rango se guardan los valores de cada una de las celdas en sus respectivas variables (ej. A12 = valor en A12)
En caso de que el archivo no exista / no se pueda acceder o que haya un error a nivel de la información que haga imposible la búsqueda (Celda | Rango inválido, hoja inexistente, etc) el comando reportará un error.
Dentro de sus parámetros se debe ingresar la el id del archivo, es decir, la identificación del archivo para que STELA pueda encontrar el documento dentro de Google Drive. Posteriormente solicita la celda o rango desde el que se desea leer la información, por ejemplo: A1 (celda) o A1:B2 (rango). Esta información es obligatoria dentro de los parámetros del comando.
Luego solicita la hoja en la que escribir la información. Si no se especifica, tomará por defecto la hoja número 1. Se debe especificar donde se guarda la información leída desde la hoja de cálculo de Google. Se puede seleccionar la opción check si tomar una fotografía antes o después de la ejecución de este comando.
Parámetros:
- Archivo: Identificador del Google Sheet a procesar. Este parámetro acepta Strings, Variable, Constant o Extended. Es un parámetro requerido.
- Celda | Rango: Celda o rango del que se va a leer su valor. Este parámetro acepta Strings, Variable, Constant o Extended. Es un parámetro requerido.
- Hoja: Hoja dentro del archivo Google Sheet desde la que se va a leer. Este parámetro acepta Strings, Variable, Constant o Extended. No es un parámetro requerido. Si el valor de este comando es vacío se toma la primera del archivo
- Guardar Resultado: Variable en la que se va a guardar resultado (en caso de ser un rango solo se toma la categoría para poner los resultados en ella para cada celda. Es un parámetro requerido.
Video ejemplo: