Preguntas Frecuentes (FAQ)

P: ¿Qué versión tengo instalada?

R: La versión verificable en Jira Cloud es la que aparece en Apps → Manage apps (por ejemplo, 4.0.0). Esa es la versión Forge.

En este sitio de documentación, el selector de versión muestra:

• La versión Forge (por ejemplo, 4.0.0) para releases ya desplegadas en producción.
• El sufijo (pre) (por ejemplo, 1.2.0 (pre)) para releases internas MB Group anteriores, sin versión verificable en Manage apps.

Cada entrada del changelog indica la correspondencia en el formato Release X.Y.Z · Forge A.B.C.

P: ¿FileUtils Pro está disponible en el Atlassian Marketplace?

R: Aún no. Puedes instalarlo mediante el enlace indicado en la introducción. La versión instalada es visible en Apps → Manage apps.

P: ¿Qué tipos de archivos puedo fusionar?

R: Puedes fusionar archivos de tipo .pdf e imágenes en formato .jpg, .png y .jpeg.

P: ¿Hay un límite de archivos para la fusión?

R: No hay un límite estricto impuesto por la interfaz, pero recomendamos no exceder los 10 archivos para asegurar un rendimiento óptimo durante el procesamiento en la nube.

P: ¿Qué sucede con las imágenes al fusionarlas con un PDF?

R: FileUtils Pro convierte automáticamente cada imagen en una página de PDF independiente, manteniendo su relación de aspecto, y la inserta en el documento final según el orden establecido en la columna de Staging.

P: ¿Por qué el botón "Fusionar" está deshabilitado?

R: El botón se habilita únicamente cuando has movido al menos dos archivos a la columna de Staging (la columna derecha). También permanece deshabilitado si hay archivos inválidos en staging (tamaño máximo superado o formato no compatible).

P: ¿Cómo funciona la pestaña Comprimir?

R: La pestaña Comprimir agrupa los adjuntos del ticket en un archivo .zip. Puedes editar el nombre del resultado, ver el progreso de la operación y elegir si deseas adjuntar el .zip al ticket, adjuntar y eliminar los originales, o solo descargar. Consulta la guía Cómo Comprimir Archivos.

P: ¿Por qué el botón "Comprimir" está deshabilitado?

R: El botón se habilita cuando hay al menos 1 archivo válido en staging. Queda deshabilitado si el área está vacía o si existen archivos inválidos (tamaño máximo superado o formato no compatible). Esos archivos se marcan con badge, tooltip y resaltado visual.

P: ¿Puedo recuperar los archivos originales si seleccioné "Adjuntar y eliminar originales"?

R: No. Esta acción es definitiva ya que los archivos son eliminados de Jira para mantener el Work Item limpio. Si necesitas conservar los originales, te recomendamos usar la opción Adjuntar al ticket.

P: ¿Qué ocurre si la aplicación muestra un error inesperado?

R: FileUtils Pro incluye un Error Boundary con una pantalla de recuperación. Desde ahí puedes reintentar o recargar la mesa de trabajo. Ante fallos de red, el sistema aplica reintentos automáticos con backoff exponencial. Los errores 4xx/5xx de Jira o CloudConvert muestran mensajes accionables para ayudarte a continuar.

P: ¿Dónde se procesan mis archivos?

R: El procesamiento de fusión, compresión y la conversión de imágenes se realizan directamente en el navegador web del usuario, garantizando la privacidad de los datos. Para la conversión de documentos Word y Excel, se utiliza el servicio externo seguro Cloud Convert a través de la API provista.

P: ¿Qué formatos puedo convertir a PDF?

R: Actualmente, puedes convertir de forma individual archivos Word (.doc, .docx), libros de Excel (.xls, .xlsx) e imágenes (.png, .jpg, .jpeg) a formato PDF. No se soporta la conversión inversa (de PDF a otros formatos).

P: ¿Cuántos archivos puedo convertir de forma simultánea?

R: Puedes seleccionar y procesar hasta un máximo de 3 archivos al mismo tiempo en la pestaña de conversión.

P: ¿Por qué necesito una API Key de Cloud Convert y cómo funciona el límite de uso?

R: La conversión de archivos complejos como Word o Excel requiere un motor externo especializado. Cloud Convert proporciona este servicio. Puedes registrar una cuenta gratuita de Cloud Convert que incluye un límite diario de conversiones sin costo (suficiente para un uso moderado). Si necesitas realizar una cantidad mayor de conversiones, puedes actualizar tu suscripción directamente con dicho proveedor externo.