XLS Write

Descripción General #

El comando Xls Write forma parte de la categoría de comandos RPA (Documentos) y permite escribir o modificar datos en celdas específicas de una hoja de cálculo. Con este comando, un robot digital de STELA puede registrar resultados, actualizar valores en memoria o impactar cambios directamente en archivos con formato .xlsx, .xls o .csv.

Ejemplo de Uso Rápido #

Imagina que tu robot extrae información de una página web y necesitas guardar el resultado en una hoja de cálculo. Con Xls Write, puedes indicarle al robot que escriba el dato extraído en la celda A1 de la primera hoja del archivo Resultados.xlsx.

Para ver un ejemplo de uso paso a paso de este comando haz clic aquí. 

Parámetros y Opciones #

Para configurar el comando Xls Write, debes ingresar los siguientes parámetros:

• Archivo (requerido): Ruta completa de acceso al archivo Excel o CSV con el que deseas trabajar (ejemplo: C:\Mis Documentos\Resultados.xlsx).
• Celda (requerido): Especifica la referencia de la celda donde se escribirá la información (ejemplo: A1, B2, C3).
• Valor (requerido): El dato que ingresarás en la celda. Según el formato del dato provisto, STELA aplicará la siguiente interpretación de tipo:
  • Si el texto inicia con =, lo procesará como una fórmula.
  • Si el valor es numérico, lo registrará como número.
  • Si tiene el formato dd/MM/yyyy, lo intentará guardar como fecha.
  • Si ingresas VERDADERO o FALSO, lo registrará como un valor booleano.
  • En cualquier otro caso, lo interpretará y guardará como texto.
• Hoja (opcional): Indica el nombre de la pestaña o hoja del archivo donde se escribirá el dato. Si no se especifica ninguna, se escribirá por defecto en la primera hoja.
• Impactar (opcional): Determina cómo se gestionarán los cambios en el archivo.
  • Si se configura en VERDADERO (o se deja vacío), el archivo guardará los cambios en el disco.
  • Si se configura en FALSO, la modificación se mantendrá temporalmente en memoria para seguir trabajando antes de guardar el documento definitivo.
• Contraseña (opcional): Si el archivo Excel está protegido con clave de acceso, debes ingresarla en este campo.
• Encoding (CSV) (opcional): Selecciona la codificación de caracteres a aplicar cuando se trabaja con archivos CSV. Si se omite, la herramienta utilizará UTF-8 por defecto.

Ejemplos de Uso Avanzado #

• Registrar el resultado de una prueba: Puedes usar Xls Write para guardar el estado final o los tiempos de respuesta de un caso de prueba automatizado directamente en un reporte en Excel.
• Escribir fórmulas dinámicas de cálculo: Puedes ingresar fórmulas como =SUM(B2:B20) dentro del parámetro Valor para que la planilla realice operaciones automáticas sobre los datos insertados por el robot.
• Actualización de datos en lote: En flujos extensos, puedes configurar varias acciones de Xls Write con el parámetro Impactar en FALSO para ir acumulando escrituras en memoria sin ralentizar la ejecución y realizar un único guardado al final marcando VERDADERO.

Errores Comunes y Soluciones #

• Error: El archivo Excel se encuentra abierto en el sistema.
  • Solución: Asegúrate de cerrar la aplicación de Excel en el equipo antes de ejecutar la automatización, ya que el archivo debe estar libre de bloqueos de lectura/escritura.
• Error: No se encuentra la ruta del archivo.
  • Solución: Verifica que la ruta especificada en el parámetro Archivo sea exacta y de acceso válido. Si el archivo no existe al momento de escribir, STELA intentará crearlo automáticamente.
• Error: La hoja indicada no existe.
  • Solución: Comprueba que el nombre introducido en el parámetro Hoja coincida exactamente con la pestaña de destino dentro del libro.

Video Explicativo #