Cómo Comprimir Archivos
La funcionalidad de Compresión permite agrupar múltiples adjuntos del ticket en un único archivo .zip de forma rápida y sencilla, facilitando el envío y almacenamiento de documentos.
1. Primer Uso
Si el ticket no tiene adjuntos o el área de staging está vacía, verás una pantalla orientativa que te guiará en tu primer uso.

Esta pantalla incluye:
- Mensaje contextual: Informa que aún no hay archivos disponibles para comprimir en esta pestaña.
- Botón Adjuntar archivo: Abre el diálogo nativo de Jira para agregar archivos directamente al ticket sin salir de la mesa de trabajo.
- Botón Comprimir deshabilitado: El botón de acción permanece deshabilitado mientras no haya archivos en el área de staging.
Para habilitar el botón Comprimir, necesitas mover al menos 1 archivo al área de staging.
2. Preparar la Compresión
- Seleccionar Archivos: Arrastra los archivos desde la columna de la izquierda a la columna de Staging.
- Selección múltiple: Puedes seleccionar todos los archivos que necesites comprimir. No hay límite de archivos para la compresión.
Si un archivo en el área de preparación supera el tamaño máximo configurado o tiene un formato no soportado, FileUtils Pro muestra advertencias visuales antes de procesar:
- Badge: Indicador visible sobre el archivo inválido.
- Tooltip: Explica el motivo concreto (tamaño o formato).
- Resaltado visual: Destaca el archivo problemático en la lista de staging.
Mientras existan archivos inválidos, el botón Comprimir permanece deshabilitado. Corrige o retira esos archivos del área de preparación para continuar.

3. Configurar el Resultado
En el pie de página (footer) del modal de compresión, podrás definir los parámetros de salida para el archivo generado:
- Nombre del archivo ZIP: El campo de texto se autocompletará con un nombre sugerido en el formato
FILES_[CLAVE-DEL-ISSUE].zip(por ejemplo,FILES_TI-2.zip). Puedes editarlo directamente. El sistema valida los caracteres en tiempo real (no se permiten/ \ : * ? " < > |), muestra un contador y establece un límite máximo de 100 caracteres. - Opciones de destino (Acción Posterior): Define el comportamiento del archivo resultante:
- Adjuntar al ticket: El archivo
.zipse guardará directamente en el item de trabajo. - Adjuntar y eliminar originales: Guarda el archivo
.zipy elimina los archivos que usaste para la compresión (ideal para mantener el item de trabajo limpio). - Solo descargar: Descarga el archivo
.zipdirectamente al navegador del usuario sin almacenarlo en Jira.
- Adjuntar al ticket: El archivo
Si seleccionas la opción Adjuntar y eliminar originales y hay más de 5 archivos en el área de preparación, se mostrará un diálogo de confirmación con la lista completa de archivos que serán eliminados y un aviso de que esta acción no se puede deshacer. Deberás confirmar explícitamente para continuar.

4. Ejecutar la Compresión
Una vez configuradas las opciones, haz clic en el botón Comprimir. Durante el proceso, se presentarán los siguientes indicadores:
- Bloqueo de seguridad: El botón de compresión se deshabilitará inmediatamente para evitar clics dobles y proteger el estado del procesamiento.
- Barra de progreso: Se mostrará una barra de progreso en tiempo real para indicar el avance de la compresión.

5. Notificaciones del Sistema
Al finalizar el proceso, el sistema mostrará notificaciones con flags para informarte del resultado:
- Mensaje de éxito: Verás un flag de éxito confirmando que la compresión se completó correctamente. Este mensaje se cierra automáticamente.
- Mensaje de información: Si seleccionaste "Solo descargar", verás un flag de información indicando que la descarga ha iniciado. Este mensaje también se cierra automáticamente.
- Mensaje de error: Si ocurre un fallo durante el procesamiento, verás un flag de error con un mensaje accionable. Estos mensajes requieren cierre manual.
Si la mesa de trabajo deja de responder por un error no controlado, FileUtils Pro muestra una pantalla de recuperación (Error Boundary) con opciones para reintentar o recargar. Ante fallos de red, el sistema también aplica reintentos automáticos con backoff exponencial. Los errores 4xx/5xx de Jira o CloudConvert se presentan con mensajes accionables.

Comportamiento de las Notificaciones
- Tipos de flags:
- Éxito (verde): Operación completada correctamente.
- Información (azul): Mensajes informativos como el inicio de descarga.
- Error (rojo): Fallos en el procesamiento. Requieren cierre manual.
- Cierre automático: Los flags de éxito e información se cierran automáticamente tras unos segundos.
- Cierre manual: Los flags de error deben ser cerrados manualmente por el usuario.
- Cola de notificaciones: El sistema puede mostrar hasta 3 notificaciones simultáneas. Si se alcanza el límite, las nuevas notificaciones esperarán su turno.
6. Verificar el Resultado
Una vez que la compresión haya terminado de forma satisfactoria, el sistema desbloqueará el panel y mostrará un mensaje de éxito indicando que el proceso ha concluido correctamente.
- Detalles del archivo: El mensaje incluirá el nombre final del archivo generado y su tamaño (indicado en KB, MB, etc.), confirmando que el proceso se completó correctamente.