Descripción General #
El comando xlsWrite(GSuite) pertenece a la categoría de comandos RPA GSuite. Su función principal es escribir o actualizar información directamente dentro de una celda específica en una hoja de cálculo almacenada en Google Sheets.
Esta funcionalidad es esencial para flujos de automatización que gestionan datos en la nube, permitiendo actualizar reportes, registrar estados de procesos, guardar valores calculados o insertar métricas de negocio de forma remota sin necesidad de manipular archivos locales.
Ejemplo de Uso Rápido #
Imagina un flujo de trabajo que consulta diariamente el valor de la tasa de cambio del dólar (USD) desde una API o sitio financiero. Una vez obtenido el valor, el robot utiliza el comando xlsWrite(GSuite) para registrar esa tasa en la celda B2 de la pestaña «Control_Diario» en la planilla de finanzas compartida de la empresa.
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 donde se escribirá el valor (por ejemplo:
A1,B2,C10). - Valor (requerido): Ingresa el contenido que deseas escribir en la celda especificada. Puede ser texto, números o cualquier otro valor admitido por Google Sheets.
- Hoja (opcional): Nombre exacto de la pestaña dentro del libro de Google Sheets donde se debe aplicar la escritura (por ejemplo:
Control_DiariooFinanzas). Si se deja vacío, la acción se aplicará en la hoja principal o activa por defecto.
Ejemplos de Uso Avanzado #
- Registro Diario de Cotizaciones Financieras: El robot extrae la tasa de cambio de divisas al inicio de la jornada laboral y utiliza xlsWrite(GSuite) para actualizar la celda correspondiente en el libro contable consolidado de Google Sheets, garantizando que el equipo de finanzas cuente siempre con la cifra oficial actualizada.
- Actualización Automática de Inventario: Puedes combinar xlsWrite(GSuite) con otros comandos de STELA para actualizar automáticamente el inventario de tu tienda en línea. Por ejemplo, cada vez que se realice una venta, STELA puede restar la cantidad vendida del stock disponible en tu hoja de cálculo.
- Registro de Marcas de Tiempo y Auditoría: Al finalizar la ejecución de un proceso masivo en la nube, el robot utiliza xlsWrite(GSuite) para registrar en la celda de control la hora de finalización del ciclo y el estado del procesamiento («COMPLETADO» o «ERROR»).
Errores Comunes y Soluciones #
Error: El archivo de Google Sheets no se encuentra o el ID es incorrecto.
- Solución: Verifica que hayas copiado únicamente la clave alfanumérica (Spreadsheet ID) de la URL del navegador.
Error: La hoja especificada no existe en el documento.
- Solución: Revisa que el parámetro opcional hoja coincida exactamente en nombre, espacios y mayúsculas/minúsculas con la pestaña creada en Google Sheets.
Error de permisos de acceso o escritura.
- Solución: Asegúrate de que las credenciales de GSuite configuradas en el proyecto de STELA (cuenta de servicio o cuenta OAuth2) tengan otorgados los permisos de edición sobre la hoja de cálculo de destino.
Casos de Uso #
- Automatización de la entrada de datos en hojas de cálculo.
- Generación automática de informes y dashboards.
- Actualización en tiempo real de inventarios y registros.
- Seguimiento de proyectos y tareas.
- Extracción de datos web, para posterior ingreso en una hoja de calculo.