Campo Personalizado Adjuntos (Attachment Field)

El campo personalizado Attachment Field permite adjuntar archivos directamente a un campo concreto del work item — por ejemplo, Facturas, Fotos de evidencia o Documentos PQR — con independencia del panel nativo de adjuntos de Jira. Cada campo almacena sus propios archivos de forma independiente: distintos campos del mismo work item no comparten adjuntos, y el campo de un work item padre no mezcla sus archivos con los de sus subtareas.

Crear el campo de Adjuntos

1. En Jira, abra Configuración (rueda dentada) → Work items.

2. En la barra lateral, dentro de Fields, abra Custom fields.

3. Haga clic en Create field (Crear campo).

4. En el desplegable Field type (Tipo de campo), busque y seleccione Campo de Adjuntos (Attachment Field).

   

5. Introduzca un Name (Nombre) para el campo (por ejemplo, "Facturas", "Evidencia PQR", "Fotografías") y, si lo desea, una Description.

6. Haga clic en Create.

7. Asociar a pantallas: Marque las pantallas donde aparecerá el campo (creación, edición, transición, vista) y haga clic en Update.

A partir de este momento el campo está disponible para su uso en los work items del espacio o tipo de work item asociado.

Configuración por contexto

Cada contexto del campo puede tener sus propias restricciones de archivo. Para configurarlas:

1. En Jira, vaya a Configuración → Work items → Custom fields.
2. Localice el campo Attachment Field y haga clic en el menú ⋯ → Contexts and default value.
3. Seleccione el contexto que desea configurar.
4. Complete los parámetros disponibles (ver tabla a continuación) en la sección de configuración del campo.
5. Haga clic en Save.

Parámetros de configuración

Parámetro	Descripción	Ejemplo
Máximo de archivos	Número máximo de archivos que puede contener el campo en un work item. El valor mínimo es 1.	5
Tipos permitidos	Categorías de archivo aceptadas: imágenes, hojas de cálculo, documentos, vídeos, comprimidos. Se pueden seleccionar varias. Si no marca ninguna, se acepta cualquier tipo.	Imágenes + Documentos
Extensiones personalizadas	Extensiones adicionales permitidas, separadas por coma y sin punto.	dwg, step, dxf
Tamaño máximo por archivo	Tamaño máximo por archivo individual (KB, MB o GB). Si se deja vacío, no hay límite.	10 MB

Contextos independientes por espacio

Puede tener varios contextos para el mismo campo — uno por espacio o tipo de work item — y aplicar restricciones distintas en cada uno. Por ejemplo, el campo "Facturas" puede admitir solo PDF y hojas de cálculo en el contexto de espacios de contabilidad, y también imágenes en el contexto de espacios de soporte.

Superficies disponibles

El campo de Adjuntos está disponible en las siguientes superficies de Jira:

• Vista del work item: muestra los archivos con nombre, icono de tipo, vista previa y descarga.
• Pantalla de creación: permite subir archivos al crear el work item.
• Pantalla de edición: permite añadir o eliminar archivos en issues existentes.
• Pantalla de transición: permite adjuntar archivos durante una transición de workflow.
• Jira Service Management: el campo se comporta como el resto de campos personalizados de Admin Essentials: vista del agente y portal del cliente (formulario de solicitud y detalle), si está asociado a las pantallas correspondientes.

Mensajes de validación

Si un usuario intenta subir un archivo que no cumple las restricciones configuradas, el campo muestra un mensaje indicando la causa:

• Número máximo alcanzado: el campo no acepta más archivos hasta que el usuario borre alguno de los existentes.
• Tipo de archivo no permitido: el archivo no pertenece a ninguna categoría ni extensión configurada para el campo.
• Archivo demasiado grande: el tamaño del archivo supera el máximo definido en el contexto.

Búsqueda JQL

El campo de Adjuntos admite los operadores is EMPTY e is not EMPTY en JQL:

"Facturas" is not EMPTY
"Evidencia PQR" is EMPTY

Búsqueda por nombre de archivo no disponible

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

Limitaciones importantes

Diferencias con los adjuntos nativos de Jira

Los archivos del campo Attachment Field no forman parte del panel nativo Attachments del work item. Esto implica que:

• Los archivos no aparecen en la sección Attachments de la vista del work item.
• La consulta JQL attachments is not EMPTY no detecta archivos del campo de Adjuntos; use el operador is not EMPTY sobre el nombre del campo.
• Los archivos del campo no se incluyen en exportaciones o migraciones que solo consideren adjuntos nativos de Jira.

Forge Object Store (Preview)

El almacenamiento de archivos usa Forge Object Store, que está actualmente en estado Preview de la plataforma Atlassian Forge. Tenga en cuenta:

• Borrar un archivo en el campo elimina el objeto del almacén de forma definitiva. Esta acción no es reversible.
• Borrar el work item no limpia automáticamente el Object Store: los objetos asociados al work item permanecen en el almacén hasta que sean borrados explícitamente desde el campo. Se recomienda borrar los archivos del campo antes de borrar el work item si desea evitar objetos huérfanos.
• Por tratarse de un módulo en Preview, las capacidades, límites y comportamiento están sujetos a cambios en versiones futuras de Forge.