Saltar al contenido principal
Version: 4.0.0

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.

Mesa de trabajo en estado vacío - Comprimir

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.
tip

Para habilitar el botón Comprimir, necesitas mover al menos 1 archivo al área de staging.


2. Preparar la Compresión

  1. Seleccionar Archivos: Arrastra los archivos desde la columna de la izquierda a la columna de Staging.
  2. Selección múltiple: Puedes seleccionar todos los archivos que necesites comprimir. No hay límite de archivos para la compresión.
Validación de Archivos

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.

Preparar compresión


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 .zip se guardará directamente en el item de trabajo.
    • Adjuntar y eliminar originales: Guarda el archivo .zip y elimina los archivos que usaste para la compresión (ideal para mantener el item de trabajo limpio).
    • Solo descargar: Descarga el archivo .zip directamente al navegador del usuario sin almacenarlo en Jira.
Confirmación al eliminar archivos

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.

Configurar resultado de compresión


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.

Proceso de compresión en progreso


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.
Recuperación ante errores inesperados

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.

Mensaje de éxito de compresión

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.