Uso del campo de Adjuntos

Esta guía describe cómo trabajar con un campo personalizado de tipo Adjuntos (Attachment Field) ya configurado por su administrador. Si todavía no ve el campo en sus pantallas de issue, consulte con su administrador de Jira: probablemente solo falte añadirlo a la pantalla correspondiente.

Los archivos que sube a través del campo se guardan como adjuntos nativos de Jira. Para usted como usuario, la forma de adjuntar, ver, descargar y quitar archivos es la misma en todas las pantallas donde aparece el campo.

Adjuntar archivos al campo

Cuando el campo de Adjuntos forma parte de la pantalla de Creación, Edición o Transición de un issue, o del formulario de solicitud del portal JSM, aparece como una zona de carga de archivos.

1. Abra el formulario de creación, edición o transición del issue (o la solicitud en el portal).
2. Localice el campo de Adjuntos (el nombre exacto lo define el administrador, por ejemplo "Facturas" o "Evidencia fotográfica").
3. Arrastre y suelte los archivos sobre el campo, o pulse examine para elegirlos.
4. Espere a que termine la subida: verá el indicador "Subiendo…" mientras los archivos se cargan.
5. Guarde los cambios (o envíe la solicitud, si está en el portal).

El propio selector muestra los límites vigentes configurados por su administrador: "Máx. N archivo(s)", "Tipos: …" y "Máx. … por archivo".

Espere a que termine la subida

No es posible guardar el issue (ni crear la solicitud) mientras haya una subida en curso. Si lo intenta, Jira mostrará el aviso "Espere a que terminen de subir los archivos antes de guardar o crear el issue.". Cuando la subida termine, podrá guardar con normalidad.

En la creación del issue y en el portal de JSM todavía no existe el issue al que se adjuntan los archivos: la subida se completa igualmente y los archivos quedan asociados al campo en cuanto el issue se crea.

Mensajes de error posibles

Si un archivo no cumple las restricciones configuradas para el campo, se rechaza en el momento de seleccionarlo con un mensaje que indica la causa:

• Se alcanzó el número máximo de archivos: el campo ya tiene el máximo permitido ("Demasiados archivos. Máximo permitido: N."). Quite alguno de los existentes para poder subir uno nuevo.
• Tipo de archivo no permitido: "{archivo} tiene un tipo de archivo no permitido. Permitidos: …". El archivo no pertenece a ninguna de las categorías o extensiones configuradas para este campo.
• Archivo demasiado grande: "{archivo} supera el tamaño máximo de archivo de …". El archivo supera el tamaño máximo configurado para este campo.

Si recibe alguno de estos mensajes, verifique el tipo y el tamaño del archivo que intenta subir, o consulte con su administrador los límites vigentes.

Ver los archivos en el issue

Una vez guardados, cada archivo aparece dentro del campo como una tarjeta, con:

• Una miniatura si es una imagen compatible (jpg, jpeg, png, gif, webp, bmp) o un icono de tipo con la extensión (por ejemplo PDF, DOCX) en el resto de casos.
• El nombre original del archivo y una línea con su tipo y tamaño.
• Un icono de vista previa (ojo) si el archivo se puede previsualizar, o de descarga si no. Son controles sin texto: pase el cursor sobre el icono para ver su función.

Cuando el campo tiene varios archivos, las tarjetas se muestran apiladas, una debajo de otra.

Ver un archivo (vista previa)

Haga clic en el icono de vista previa (ojo) de la tarjeta del archivo. Se abre un visor integrado sin necesidad de descargar el archivo.

• Se pueden previsualizar imágenes raster (jpg, jpeg, png, gif, webp, bmp) y archivos de texto (txt, csv, tsv, md, json, xml, log).
• No se previsualizan PDF, documentos de Office, svg, tiff ni otros formatos: esos archivos solo muestran el icono de descarga.
• Los archivos de más de 8 MB tampoco se previsualizan.
• En los archivos de texto, la vista previa muestra el contenido recortado a 20.000 caracteres.

Si la previsualización no puede cargarse, el visor muestra "No se pudo cargar la vista previa.".

Descargar un archivo

Haga clic en el icono de descarga de la tarjeta del archivo que desea obtener. El archivo se descarga con su nombre original. Este es el único control disponible para los formatos que no admiten vista previa.

Quitar un archivo

Abra el issue en edición (o la pantalla de creación / transición, si el campo está en esa pantalla) y use el control Quitar de la tarjeta del archivo que desea eliminar. Se le pedirá confirmación: "¿Quitar {archivo}? Se eliminará de forma definitiva al guardar.", con la opción Conservar para cancelar.

Esta acción es permanente

Al quitar un archivo y guardar, se elimina de forma definitiva el adjunto nativo correspondiente del issue. No es posible recuperarlo una vez eliminado.

Para sustituir un archivo, quite el antiguo y adjunte el nuevo en la misma edición.

Independencia entre campos

Los archivos de un campo de Adjuntos son específicos de ese campo en ese issue concreto:

• Distintos campos de Adjuntos del mismo issue almacenan archivos por separado y no se mezclan entre sí, aunque todos ellos se guarden como adjuntos nativos del mismo issue.
• El campo de un issue padre no incluye los archivos de sus subtareas, y viceversa.
• Si dos campos de Adjuntos comparten un mismo límite de archivos, el límite se aplica por campo, no sobre el total del issue.

Mostrar el campo en el portal de Jira Service Management

Si su instancia tiene Jira Service Management y el administrador habilitó la casilla "Mostrar este campo en el portal de clientes de Jira Service Management" en el contexto del campo, los clientes podrán:

• Adjuntar archivos al crear una solicitud, con las mismas restricciones de cantidad, tipo y tamaño del campo.
• Ver, previsualizar y descargar los archivos en el detalle de la solicitud, con la misma vista de tarjetas que en la vista del agente.

Jira Service Management es opcional

Si su instancia no usa Jira Service Management, el campo funciona con normalidad en las pantallas de issue; simplemente no hay portal de clientes donde mostrarlo.

Diferencias con el panel de adjuntos nativo

El campo de Adjuntos es una vista filtrada sobre los adjuntos nativos del issue: los archivos que suba a través del campo también aparecen en el panel Attachments del issue. La diferencia está en qué muestra cada uno:

Aspecto	Campo de Adjuntos (Admin Essentials)	Panel Attachments nativo
Qué muestra	Solo los archivos subidos a través de ese campo concreto	Todos los adjuntos del issue, vengan de donde vengan
Restricciones al subir	Configurables por el administrador (cantidad, tipo y tamaño)	Sin restricciones por campo
JQL	"Nombre del campo" is not EMPTY / is EMPTY	attachments is not EMPTY

Si busca issues que tengan archivos en un campo de Adjuntos concreto mediante JQL, use el nombre del campo:

"Facturas" is not EMPTY

attachments is not EMPTY sí detecta los archivos subidos a través del campo (porque son adjuntos nativos), pero no permite distinguir de qué campo provienen.

No se puede buscar por nombre de archivo

No es posible filtrar por el nombre, la extensión ni el tipo de un archivo concreto mediante JQL, ni en el campo ni en el panel nativo. Solo se puede filtrar por la presencia o ausencia de archivos.

Cuando el campo está vacío

Si el campo no tiene archivos, Jira muestra el placeholder vacío habitual en la vista del issue. Si el campo no está marcado como obligatorio en el proyecto, puede guardarlo vacío sin que se produzca ningún error.