FileFx – Existe

Descripción General #

La función EXISTE del comando FileFx pertenece a la categoría RPA (Documentos) de STELA. Su propósito es comprobar la presencia de un archivo o directorio específico dentro del sistema de archivos local o de red antes de llevar a cabo operaciones de lectura, modificación o movimiento.

Esta función devuelve un valor escalar numérico (1 si el archivo o carpeta existe y 0 si no existe) que se almacena en una variable para gestionar de manera dinámica la lógica del robot mediante comandos de decisión como Si o bucles Mientras.

Parámetros y opciones #

• Función (obligatorio): Operación a ejecutar dentro del comando. Selecciona o escribe EXISTE.
• Parámetro 1 (obligatorio): Ruta completa del archivo o directorio a verificar . Ejemplo C:\temp\reporte.xlsx
• Parámetro 2 (No aplica) : No se utiliza en esta función. Se deja vacío.
• Guardar Resultado (opcional): Nombre de la variable de STELA donde se guardará el resultado de la consulta (1 si existe, 0 si no existe). Si se omite, STELA asignará el resultado a una etiqueta derivada por defecto

Usos más comunes  #

• Manejo de marcadores de estado: La función EXISTE permite verificar antes de iniciar un proceso crítico , si está presente un archivo requerido, de esta forma la automatización puede evaluar si se detiene o avanza con la ejecución de la tarea.
• Verificación y creación dinámica de directorios: El robot consulta con EXISTE si la estructura de carpetas necesaria en el flujo de trabajo ya fue creada, de acuerdo con el valor que tome la variable y con el uso de comandos de decisión, se puede proceder asegurando la correcta ejecución del proceso.

Ejemplo de uso #

Imagina que tu automatización debe procesar un archivo Excel de ventas. Antes de intentar abrirlo o leerlo con XlsRead, usas FileFx con la función EXISTE para confirmar si el archivo ya se descargó. Si el archivo existe en el disco el robot procede con la lectura.Si el archivo no existe, el robot realiza una pausa o ejecuta un flujo alternativo de excepción.

Pasos

1. Seleccionar la función EXISTE en la parametrización del comando FileFx
2. Configurar Parámetro 1: Define la ruta completa del archivo a verificar C:\Descargas\reporte_diario.xlsx
3. Configurar la variable donde se guardará el resultado de la consulta: existe_reporte

4. Ejecutar el bot con la función EXISTE

5. Verificar el valor de la variable guardada. (Ver archivo _wrk_datos en la carpeta de logs)

Ya que la función guardó el valor 1 en la variable existe_reporte, se confirma que el archivo existe en el disco, y el robot puede proceder con la lectura.

Errores Comunes y Soluciones #

• Error: La variable retorna 0 a pesar de que el archivo es visible en el equipo.
  • Solución: Verifica que la ruta indicada en el Parámetro 1 incluya el camino completo de carpetas y la extensión del archivo (ej. .xlsx, .pdf). Asegúrate además de no incluir comillas dobles innecesarias alrededor de la ruta.
• Error: Falla de acceso por permisos en rutas o unidades de red compartidas.
  • Solución: Confirma que el usuario o agente ejecutor de STELA tenga permisos suficientes de lectura sobre la carpeta o servidor de red que se está consultando.