XlsRead (GSuite)

Descripción General #

El comando xlsRead(GSuite) pertenece a la categoría de comandos RPA GSuite. Su función principal es consultar y extraer información guardada en una celda específica o en un rango de celdas de una hoja de cálculo almacenada en Google Sheets.

Este comando permite a tus automatizaciones obtener datos actualizados en la nube (como cotizaciones, listados de insumos o estados de órdenes) para luego utilizarlos en otros pasos del flujo de trabajo de STELA sin necesidad de descargar la planilla al disco local.

Ejemplo de Uso Rápido #

Imagina que necesitas obtener el precio unitario de un producto almacenado en la celda C5 de la pestaña «Precios» dentro de una planilla de Google Sheets. Configuras xlsRead(GSuite) indicando el ID del archivo, la celda deseada y la variable donde quieres almacenar esa cifra. Luego, el robot utiliza el valor guardado para completar un formulario web de facturación.

Parámetros y Opciones #

• Archivo (requerido): Identificador único del archivo Google Sheets (Spreadsheet ID que se encuentra en la URL del documento), por ejemplo 1WadqXjSnw83M9rRhxjTc5CeaMrSsVpGUSjnxajceMvM.
  • Puedes ingresar el ID directamente, usar una variable o constante que lo contenga, o incluso utilizar el editor extendido para casos más complejos.
• Celda (requerido): Coordenada o referencia de la celda o conjunto de celdas que deseas leer dentro de la planilla (por ejemplo: A1, B2, C10 para celdas puntuales, o A1:D10 para un rango específico).
• Hoja (opcional): Nombre exacto de la pestaña dentro del libro de Google Sheets donde se realizará la lectura. Si no especificas este campo, la lectura se realizará sobre la primera hoja o la hoja activa del documento.
• Guardar resultado (opcional): Variable donde se almacenará el dato extraído. Si lees una sola celda, la variable guardará ese valor escalar. Si lees un rango completo de celdas, STELA estructurará los datos delimitados por comas entre columnas y saltos de línea entre filas.
  
  Es crucial entender que cuando se lee un rango de celdas, como A1:B10, STELA no guarda todos los datos en una sola variable. En cambio, genera una variable independiente para el valor de cada celda dentro del contenedor que indiques.Por ejemplo, si lees el rango A1:B4 y lo quieres guardar en el contenedor Totales bajo la variable totalVentas, el conector xlsRead (GSuite) creará variables separadas dentro de Totales, resultando en algo como:[Totales]
  A1 = Valor de A1
  A2 = Valor de A2
  A3 = Valor de A3
  A4 = Valor de A4
  B1 = Valor de B1
  B2 = Valor de B2
  B3 = Valor de B3
  B4 = Valor de B4
  

  La correcta designación de esta variable es fundamental para la manipulación posterior de los datos en tu flujo de trabajo.

Ejemplos de Uso Avanzado #

1. Automatización de Informes Dinámicos: Configura un flujo en STELA para que xlsRead(GSuite) consulte de forma automática un rango específico de transacciones (por ejemplo, A2:E50) desde una hoja de Google Sheets actualizada diariamente. Con la información recuperada dentro de una variable de trabajo, el robot puede combinar este paso con comandos como enviar_mail para remitir el reporte consolidado al equipo gerencial o writeTXT para registrar un resumen local del procesamiento.
2. Extracción y Carga Masiva en Sistemas CRM: Cuando se requiere alimentar plataformas de negocio con listas extensas de contactos o prospectos, utiliza xlsRead(GSuite) para obtener un bloque completo de datos (por ejemplo, A2:C100) directo desde la nube. STELA almacena los registros en una variable consolidada, permitiendo que el flujo procese la información de manera secuencial e ingrese cada cliente en el sistema CRM o de marketing a través del canal WEB.
3. Validación de Reglas de Negocio en Tiempo Real: Antes de ejecutar transacciones críticas, emplea xlsRead(GSuite) para leer listas de precios, stock de productos o datos de clientes almacenados en Google Sheets. A continuación, integra el dato leído con comandos como comparar, si o mientras para verificar que los importes sean mayores a cero, que los códigos respeten un formato específico mediante expresiones regulares o que las fechas operativas se encuentren dentro del rango permitido.

Errores Comunes y Soluciones #

• Error: El ID del archivo de Google Sheets es incorrecto o no se encuentra.
  • Solución: Verifica que hayas copiado únicamente el identificador alfanumérico que aparece en la URL de Google Sheets y asegúrate de no haber ingresado la ruta de un disco local (C:\...).

• Error: La hoja especificada no existe en el documento.
  • Solución: Revisa que el parámetro opcional hoja coincida exactamente en nombre, acentos y mayúsculas/minúsculas con la pestaña creada en Google Sheets.
• Error de permisos al intentar acceder al archivo de Google Drive.
  • Solución: Confirma que las credenciales de GSuite configuradas en la administración del proyecto de STELA tengan otorgados permisos de acceso o lectura sobre el documento de Google Sheets.
• Error por rango o celda con formato inválido.
  • Solución: Asegúrate de que las coordenadas ingresadas cumplan con el formato estándar de hojas de cálculo (por ejemplo: A1 o A1:B10).

Video ejemplo: #