Abrir adjunto de ticket
Abre, descarga o previsualiza un archivo adjunto desde la conversación de un ticket de Reportes y mejoras. La app usa el identificador del adjunto para recuperar el archivo con la sesión autenticada, tanto desde Mis reportes como desde la bandeja de soporte cuando el usuario tiene acceso.
En este artículo
Esta guía se centra en el momento en que el usuario ya está dentro del detalle de un ticket y necesita consultar un PDF, una imagen u otro archivo adjunto. Antylogic muestra el adjunto como tarjeta o previsualización dentro de la conversación.
El archivo se sirve mediante `GET /api/app/files/{fileId}`. La ruta exige sesión, conserva metadatos como nombre y tipo de contenido, y no modifica el ticket ni el archivo.
Antes de empezar
- Has iniciado sesión en Antylogic.
- El ticket existe y puedes abrirlo desde `/my-reports/{reportId}`; en soporte, desde `/support-requests/{reportId}` con `user-reports:manage`.
- La conversación incluye al menos un adjunto visible.
- El adjunto tiene un identificador de archivo válido en sus metadatos.
Instrucciones
- 1.
Abrir el detalle del ticket
Entra en Reportes y mejoras y abre el ticket que contiene el archivo. La pantalla carga la conversación y muestra los adjuntos asociados al mensaje inicial o a las respuestas del ticket.
- 2.
Localizar el adjunto
Busca la tarjeta o previsualización del archivo dentro de la conversación. Las imágenes pueden verse inline; otros formatos aparecen con nombre, tamaño y un distintivo como PDF, IMG, DOC, XLS, ZIP o FILE.
- 3.
Pulsar la tarjeta o previsualización
Pulsa el adjunto para iniciar la apertura. En web, Antylogic intenta abrir el archivo en una pestaña nueva o descargarlo con un enlace temporal; en iOS puede previsualizar PDF dentro de la app; en Android u otros entornos nativos descarga a caché y usa el visor disponible.
- 4.
Confirmar el archivo abierto
Comprueba que el archivo se abre, se descarga o se muestra en el visor correspondiente. El nombre, tipo y tamaño visibles salen de los metadatos del archivo cuando están disponibles.
- 5.
Usar el mismo flujo desde soporte
Desde `/support-requests/{reportId}`, soporte abre la misma conversación y usa el mismo mecanismo de adjuntos. La diferencia está en el permiso para entrar a la bandeja, no en una descarga distinta del archivo.
Validaciones y límites
- Si `reportId` está vacío, el detalle muestra error y no intenta cargar el ticket.
- La tarjeta del adjunto queda deshabilitada si no hay acción de apertura o si `attachment.id` está vacío.
- La apertura usa `GET /api/app/files/{fileId}` con sesión autenticada.
- Si falta el identificador del archivo, la app lanza `Missing attachment file id`; si no puede construir la URL, lanza `Missing attachment file url`.
- La previsualización PDF embebida solo aplica en iOS y solo para adjuntos PDF detectados por tipo o extensión.
- Si faltan metadatos o el objeto almacenado, el backend responde `404 archivo no encontrado`; si el servicio de ficheros no está configurado, responde `501 servicio de ficheros no configurado`.
- `GET /api/app/files/{fileId}` exige autenticación, pero no revalida que el archivo pertenezca al `reportId`, al propietario, a la organización o al local.
- La acción es de solo lectura: no modifica tickets, mensajes, metadatos ni el archivo almacenado.
Resultado esperado
El usuario puede consultar el adjunto del ticket desde la conversación y Antylogic recupera el archivo autenticado con sus metadatos disponibles, sin alterar el ticket ni el contenido almacenado.