Saltar al contenido principal
Version: 5.0.0

Cómo Convertir Archivos

La funcionalidad de Conversión permite transformar imágenes (.jpg, .png, .jpeg) directamente a formato PDF.

Restricción de sentido de conversión

Actualmente, solo está disponible la conversión Imagen ➔ PDF. La conversión de documentos Word y Excel no está disponible temporalmente. Tampoco se soporta la conversión inversa.


Conversión de documentos Word y Excel​

La conversión de documentos Word y Excel a PDF no está disponible temporalmente en esta versión. No es necesario configurar ni guardar una API Key para utilizar FileUtils Pro.

1. Primer Uso​

Si el ticket no tiene adjuntos compatibles para convertir 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 - Convertir

Esta pantalla incluye:

  • Mensaje contextual: Informa que aún no hay archivos compatibles para convertir 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 Convertir deshabilitado: El botón de acción permanece deshabilitado mientras no haya archivos en el área de staging.
tip

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


2. Listado de Archivos Compatibles​

Al seleccionar la pestaña Convertir, la columna izquierda mostrará únicamente los adjuntos del ticket con formatos compatibles:

  • Imágenes: .jpg, .png, .jpeg

3. Preparar la Conversión​

  1. Mover a Staging: Arrastra o añade los archivos deseados a la columna de preparación (Staging) de la derecha.
  2. Selección múltiple: Es posible seleccionar y procesar hasta un máximo de 3 archivos de manera simultánea.
Límite de Procesamiento Simultáneo

Puedes procesar hasta 3 archivos al mismo tiempo en la pestaña de conversión.

Archivos en staging - Convertir


4. Configurar el Resultado​

En el pie de página (footer) del modal de conversión, podrás definir los parámetros de salida para los archivos generados:

  • Nombre del archivo de salida: El comportamiento varía según el número de archivos seleccionados:
    • Un solo archivo: El campo de texto en el footer se autocompletará con un nombre sugerido en el formato CONVERTED_[NOMBRE-ORIGINAL].pdf, permitiéndote modificarlo libremente. El sistema valida los caracteres en tiempo real (no se permiten / \ : * ? " < > |), muestra un contador y establece un límite máximo de 100 caracteres.
    • Múltiples archivos: Si se procesa más de un archivo a la vez, se inhabilitará la edición individual del nombre y se mostrará el mensaje explicativo en el footer: * Se usará nombre original para múltiples archivos. En este caso, cada archivo resultante conservará su nombre de origen con la respectiva extensión .pdf.
  • Formato de salida: Actualmente, solo se encuentra disponible la opción de salida en formato PDF.
  • Opciones de destino (Acción Posterior): Define el comportamiento del archivo resultante:
    • Adjuntar al ticket: Los nuevos archivos PDF se guardarán directamente en el item de trabajo.
    • Adjuntar y eliminar originales: Guarda los archivos PDF en el ticket y elimina de manera definitiva los archivos de origen (imágenes).
    • Solo descargar: Descarga los archivos directamente al navegador del usuario sin almacenarlos 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 conversión


5. Ejecutar la Conversión​

Una vez configuradas las opciones, haz clic en el botón Convertir. Durante el proceso, se presentarán los siguientes indicadores:

  • Bloqueo de seguridad: El botón de conversión se deshabilitará inmediatamente para evitar clics dobles y proteger el estado del procesamiento.
  • Barras de progreso individuales: Cada archivo en cola mostrará su propia barra de carga en tiempo real para indicar el avance individual de su conversión.

Proceso de conversión en progreso


6. 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 que confirma que la conversión se completó correctamente. Este mensaje se cierra automáticamente.
  • Mensaje de descarga: Si seleccionaste "Solo descargar", verás un flag de éxito indicando que la descarga ha iniciado. Este mensaje también se cierra automáticamente.

Mensaje de éxito

Comportamiento de las Notificaciones​

  • Tipos de flags:
    • Éxito (verde): Operación completada correctamente, incluyendo el inicio de descarga.
    • Información (azul): Mensajes informativos adicionales del proceso.
    • 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.

7. Verificar el Resultado​

Una vez que todas las conversiones en curso hayan 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.