Descripción General #
El comando FileFx se encuentra dentro de la categoría de comandos RPA, para la gestión de documentos y archivos en STELA.
¿Quieres automatizar tareas repetitivas con tus archivos? Con el comando FileFx, puedes crear, mover, renombrar y mucho más, todo desde tu robot digital para automatizar el manejo del sistema de archivos local o de red dentro de un flujo de trabajo.
Ejemplo de Uso Rápido #
Imagina que recibes diariamente un archivo comprimido .zip con facturas en una carpeta de descargas. Con el comando FileFx, puedes estructurar una secuencia automatizada para:
- Verificar si el archivo comprimido existe en el directorio.
- Descomprimir el archivo en una carpeta específica de procesamiento.
- Listar todos los archivos extraídos para que el robot los procese uno a uno.
- Mover el archivo .zip original a una carpeta de archivo o respaldo para mantener limpia la bandeja de entrada.
Parámetros y Opciones #
El comportamiento de FileFx se adapta dinámicamente según la acción que requieras ejecutar. A continuación se detallan los parámetros generales y las funciones disponibles
- Función (obligatorio): Define la operación específica a realizar sobre el sistema de archivos
- Crear: Genera un nuevo archivo en la ubicación que especifiques.
- Crear carpeta: Genera una carpeta en la ruta indicada.
- Borrar: Elimina un archivo de forma permanente.
- Renombrar: Cambia el nombre o la ubicación de un archivo existente.
- Copiar: Crea una copia exacta de un archivo en una nueva ubicación.
- Mover: Traslada un archivo de una carpeta a otra.
- Descomprimir: Extrae el contenido de un archivo comprimido.
- Existe: Verifica si un archivo existe y almacena el resultado.
- Listar archivos: Revisa una carpeta y registra todos los archivos visibles en un contenedor
- Listar Carpetas: Obtiene una lista de todas las carpetas dentro de una ruta determinada.
- Parámetro 1: Define el elemento primario de la operación (normalmente la ruta de origen, archivo o carpeta objetivo)
- Parámetro 2: Define el elemento secundario de la operación (como la ruta de destino, nuevo nombre o etiqueta de contenedor)
- Guardar Resultado (opcional): Variable donde se almacenará el resultado devuelto por la función (aplica para funciones de consulta)
Cada una de las opciones de FileFx requiere que definas los parámetros necesarios para su ejecución. Tu robot digital utilizará estos datos —como la ruta del archivo, el nuevo nombre o la ubicación de destino— para realizar la acción que le indiques.
Ejemplos de Uso Avanzado #
- Estrategia de Control de Duplicados antes del Procesamiento: Antes de descargar o generar un reporte pesado, se evalúa si el archivo ya fue procesado con la función
EXISTE. Si la variable resultante retorna1, se ejecuta la funciónBORRARsobre la copia antigua antes de proceder a la generación del nuevo documento, previniendo errores de bloqueo o información obsoleta - Procesamiento Dinámico de Lotes en Carpetas: Se utiliza la función
LISTAR ARCHIVOSespecificando una carpeta de entrada. STELA devolverá el total de archivos encontrados en la variablefileCounty sus nombres en variables ordenadas (file1,file2, etc.). Con esta información, el robot puede iterar mediante un bucle sobre cada archivo para leerlo, procesar su contenido y finalmente invocar la funciónMOVERpara enviarlo a una carpeta de «Procesados». - Extracción Automatizada de Insumos Comprimidos: Al recibir paquetes masivos de información de proveedores en formato
.zip, el robot utiliza la funciónDESCOMPRIMIRindicando únicamente la ruta del archivo. Al finalizar la extracción en la carpeta generada automáticamente por STELA, se ejecutaLISTAR CARPETASpara recorrer los subdirectorios extraídos y validar la integridad de la estructura.
Errores Comunes y Soluciones #
- Error: Archivo no encontrado. El archivo o directorio indicado en el Parámetro 1 no existe en el sistema de archivos al momento de ejecutar el comando
- Solución: Asegúrate de que la ruta del archivo sea correcta y que el archivo exista. Puedes realizar una validación previa mediante la función
EXISTEde FileFx o una acción de espera antes de ejecutar operaciones sobre elementos dinámicos.
- Solución: Asegúrate de que la ruta del archivo sea correcta y que el archivo exista. Puedes realizar una validación previa mediante la función
- Error: Permisos insuficientes.
- Solución: Verifica que tengas los permisos necesarios para realizar la operación en el archivo o carpeta.
Casos de Uso #
- Automatización de tareas repetitivas: Copiar archivos diariamente, eliminar archivos temporales, etc.
- Gestión de archivos: Organizar documentos, crear copias de seguridad, etc.
- Extracción Automatizada de Insumos Comprimidos:Usando la función DESCOMPRIMIR y luego LISTAR CARPETAS para recorrer los subdirectorios extraídos y validar la integridad de la estructura.