Configuración del Campo

Acceso rápido: También puedes llegar a esta misma página de configuración desde el Dashboard de Campos, que centraliza todos tus campos de Dynamic Work Item Picker.

La configuración del campo Dynamic Work Item Picker se integra directamente en la administración de Jira Cloud, permitiéndote gestionar su comportamiento desde el mismo lugar donde administras el resto de tus campos personalizados.

¿Dónde encontrar la configuración?

Para empezar a configurar tu campo, sigue estos pasos:

1. Desde la navegación principal de Jira, dirígete a Configuración (⚙️) y luego a Actividades.
2. En la barra lateral izquierda, en la sección CAMPOS, haz clic en Campos.
3. Busca tu campo de tipo Dynamic Work Item Picker en la lista. A la derecha, haz clic en el menú de acciones (•••) y selecciona Contextos y valores predeterminados.

4. Dentro de la configuración de contexto del campo, encontrarás el enlace para Editar configuración de campo personalizado. Al hacer clic, se abrirá el modal de configuración específico del complemento.

---

El modal de configuración te permite personalizar tanto la lógica como la apariencia del campo a través de dos pestañas: General y Vista.

Pestaña General

Aquí defines las reglas de negocio de tu campo.

Limitar los items de trabajo seleccionables con JQL

Usa el campo JQL Filter para crear una consulta que filtre los items de trabajo que los usuarios pueden encontrar y seleccionar. Esto es ideal para asegurar que solo se vinculen items de trabajo relevantes.

• Caso de uso: Si quieres que un campo solo permita vincular "Bugs" del proyecto actual que no han sido cerrados, podrías usar un JQL como:

  project = currentProject() AND issuetype = Bug AND status != Closed

Validación de JQL al Editar

El campo Dynamic Work Item Picker incluye una validación inteligente para mantener la integridad de los datos cuando se cambia el filtro JQL.

• ¿Qué sucede si cambio el JQL y hay items de trabajo que ya no cumplen la nueva condición?
  • Los items de trabajo que ya estaban seleccionados en el campo se mantendrán, pero al editar el items de trabajo, el usuario verá una advertencia encima del campo indicando qué items de trabajo ya no son válidos.

Esto evita la pérdida de datos históricos y, al mismo tiempo, asegura que las nuevas selecciones se adhieran a las reglas que has definido.

Habilitar selección múltiple

Por defecto, el campo solo permite seleccionar un item de trabajo. Si necesitas vincular varios items de trabajo, cambia el Selection type a Multiple selection.

Añadir una nota de ayuda

El campo Nota te permite escribir un texto corto como una ayuda visual para los usuarios que ingresen a configurar el campo.

---

Pestaña Vista

Aquí personalizas la información que se muestra para los items de trabajo seleccionados, dándole a tu equipo contexto de un vistazo sin necesidad de abrir el item de trabajo en una nueva pestaña.

Enriquecer la visualización del campo

Además del icono, la clave y el resumen del item de trabajo (que se muestran siempre), puedes elegir mostrar:

• Responsable: Muestra el avatar del responsable del item de trabajo.
• Estado: Muestra el estado actual del item de trabajo con su color correspondiente (ej: "En curso", "Finalizado").
• Prioridad: Muestra el icono de la prioridad del item de trabajo.

Al activar estas opciones, la información aparecerá directamente en la vista del item de trabajo donde se use el campo, como se ve en la siguiente imagen:

Una vez que termines de ajustar la configuración, no olvides hacer clic en Save Changes.

Búsqueda por JQL

Todos los campos de tipo Dynamic Work Item Picker son indexados por Jira y su contenido puede ser buscado a través de JQL. Esto te permite crear consultas avanzadas, filtros y dashboards basados en los valores de tus campos Dynamic Work Item Picker.

¿Cómo funciona?

Cuando seleccionas un item de trabajo en un campo Dynamic Work Item Picker, el campo almacena la key de ese item de trabajo (por ejemplo, PROJ-123). Por lo tanto, tus búsquedas JQL deben usar las keys de los items de trabajo para filtrar.

Operadores Soportados

Puedes usar los operadores estándar de JQL para campos de texto, como:

Operador	Ejemplo de Búsqueda
=	"My Dynamic Work Item Picker Field" = "PROJ-123"
!=	"My Dynamic Work Item Picker Field" != "PROJ-123"
IN	"My Dynamic Work Item Picker Field" IN ("PROJ-123", "PROJ-456")
NOT IN	"My Dynamic Work Item Picker Field" NOT IN ("PROJ-123", "PROJ-456")
IS	"My Dynamic Work Item Picker Field" IS EMPTY
IS NOT	"My Dynamic Work Item Picker Field" IS NOT EMPTY

Recuerda reemplazar "My Dynamic Work Item Picker Field" con el nombre real de tu campo personalizado.

---