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 Reglas y Apariencia del Campo.

---

Reglas y Apariencia por Contexto

Esta sección centraliza el comportamiento y la visualización de tu campo Dynamic Work Item Picker. En nuestra versión 2.4.0, hemos optimizado la gestión de Contextos, integrándola completamente con la configuración nativa de Jira para permitirte aplicar reglas precisas según el alcance de tu espacio.

¿Cómo gestionar los Contextos?

Ahora, la segmentación de la lógica del campo se realiza directamente desde la configuración de contextos nativa de Jira. Esto permite una mayor flexibilidad al vincular reglas a combinaciones específicas de espacios y tipos de actividades.

1. Añadir Contexto: En la pantalla de configuración del campo de Jira, haz clic en Añadir nuevo contexto.

   

2. Configurar Alcance: Define un nombre para el contexto y selecciona los Espacios y Tipos de actividades donde se aplicará esta configuración.

   

3. Acceder a la Configuración del Complemento: Una vez creado el contexto, verás una lista de los contextos configurados. Haz clic en Editar configuración de campo personalizado dentro del contexto que desees personalizar.

   

Cada contexto actúa como un contenedor independiente que encapsula su propia configuración de las pestañas Información General y Vista. Esto permite que el mismo campo se comporte de manera totalmente diferente en distintos espacios.

• Alcance Global: Se aplica por defecto a todos los espacios y tipos de actividades que no tengan una regla más específica definida. Es ideal para reglas generales de la compañía.
• Alcance Específico (Espacios y Tipos de Actividades): Puedes restringir la configuración para que solo funcione en espacios seleccionados o para tipos de actividades específicos (ej: solo para "Bugs" o solo para el espacio "Atención al Cliente").

Cuando defines un alcance específico, el campo Dynamic Work Item Picker adaptará su comportamiento automáticamente solo cuando se visualice dentro de ese contexto, permitiendo una personalización total por equipo. Ten en cuenta que solo puedes crear un contexto por espacio.

Compatibilidad multi-contexto por clave de espacio

A partir de la versión 2.10.1, la resolución de la configuración por contexto funciona correctamente tanto cuando Forge expone el ID numérico del espacio como cuando solo expone la clave del espacio. Esto garantiza que las configuraciones específicas por contexto (JQL, modo de selección, etc.) se apliquen de forma fiable en todas las instalaciones, sin importar cómo la plataforma identifique el espacio activo.

Estados de la Configuración por Contexto

Al ingresar a la pantalla de configuración de un contexto específico, un indicador visual en la parte superior derecha de la cabecera te mostrará su estado actual:

• USA CONFIGURACIÓN GLOBAL (Gris): El contexto no tiene una configuración propia y está heredando la configuración del Alcance Global.
• CONFIGURADO (Azul): El contexto tiene una configuración personalizada y específica (JQL, modo de selección, etc.) guardada por un administrador.

Nota: El indicador visual se actualizará automáticamente tras guardar cualquier cambio en el formulario (por ejemplo, pasando de gris a azul si acabas de aplicar una configuración personalizada).

Restablecer a la Configuración Global (Reset to Global)

Si deseas descartar las reglas específicas de un contexto y hacer que vuelva a heredar los valores predeterminados de la configuración global, puedes utilizar el botón Restablecer:

1. El botón de restablecimiento solo estará visible cuando el contexto se encuentre en el estado CONFIGURADO.

2. Al hacer clic en él, se abrirá un diálogo de confirmación para validar la acción.

   Esta acción es irreversible. Al restablecer el contexto, se eliminará permanentemente su configuración del almacenamiento y comenzará a heredar las configuraciones globales.

3. Tras confirmar, el contexto se actualizará y volverá instantáneamente al estado USA CONFIGURACIÓN GLOBAL.

4. Esta acción quedará registrada en el Registro de Auditoría para mantener la trazabilidad de los cambios.

Configuración por Contexto

Cada contexto (incluyendo el Global) cuenta con dos pestañas de configuración:

Pestaña Información General

Aquí defines las reglas de negocio de tu campo para el contexto seleccionado.

Limitar las actividades seleccionables con JQL

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

• Caso de uso: Si quieres que un campo solo permita vincular "Bugs" del espacio 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 actividades que ya no cumplen la nueva condición?
  • Las actividades que ya estaban seleccionadas en el campo se mantendrán, pero al editar la actividad, el usuario verá una advertencia encima del campo indicando qué actividades ya no son válidas.

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

Soportar Variables Dinámicas en JQL

Para hacer tus filtros JQL aún más potentes y contextuales, el campo soporta el uso de variables dinámicas. Estas variables se reemplazan automáticamente al ejecutar la consulta: unas toman valores de la actividad donde se muestra el campo; otras, del contexto del campo (espacio y tipo de actividad configurados).

Las variables soportadas son:

De la actividad actual:

• {{currentUser}}: Se reemplaza por el accountId del usuario que está viendo la actividad. Ideal para mostrar solo actividades asignadas al usuario actual.
• {{issue.key}}: Se reemplaza por la clave de la actividad actual (ej: PROJ-123).
• {{issue.issuetype}}: Se reemplaza por el nombre del tipo de actividad actual (ej: Bug, Story).
• {{issue.priority}}: Se reemplaza por el nombre de la prioridad de la actividad actual (ej: High, Medium).
• {{issue.project}}: Se reemplaza por la clave del espacio al que pertenece la actividad actual (ej: PROJ).
• {{issue.customfield_xxxxx}}: Se reemplaza por el valor de un campo personalizado en la actividad actual. Reemplaza xxxxx con el ID del campo personalizado (ej: {{issue.customfield_10001}}).

Del contexto del campo:

• {{context.project}}: Se reemplaza por la clave del espacio del contexto activo del campo (ej: TESTAB).
• {{context.issueType}}: Se reemplaza por el nombre del tipo de actividad del contexto activo del campo (ej: Task).

Ejemplo de uso (actividad actual):

Para mostrar solo actividades del mismo tipo y con la misma prioridad que la actividad actual, podrías usar:

issuetype = '{{issue.issuetype}}' AND priority = '{{issue.priority}}'

Ejemplo de uso (contexto del campo):

Para filtrar por el espacio y el tipo de actividad del contexto donde se aplica el campo:

project = {{context.project}} AND issuetype = {{context.issueType}}

Vista previa de JQL

En el tab General del contextConfig, el botón Validar te permite comprobar el JQL sin salir de la configuración. Esta vista previa resuelve los placeholders, ejecuta la consulta efectiva y muestra un resumen inmediato del resultado.

La validación te ayuda a revisar lo siguiente:

• El total de actividades que coinciden con el filtro.
• Una lista preview con las primeras actividades devueltas, mostrando key y summary.
• La consulta efectiva ejecutada.

Para placeholders como {{issue.*}}, puedes usar una actividad de ejemplo para resolver la consulta, por ejemplo PROJ-123. Si el contexto es global y no puede resolver {{context.project}}, la UI muestra un mensaje claro antes de ejecutar la búsqueda.

La vista previa también cubre los casos de error más habituales:

• Si no hay resultados, se muestra el mensaje Ninguna actividad coincide con este filtro.
• Si hay un error de sintaxis o quedan placeholders sin resolver, se muestra el error sin ejecutar la búsqueda.
• El resultado se limpia automáticamente cuando editas el JQL.

Habilitar selección múltiple

Por defecto, el campo solo permite seleccionar una actividad. Si necesitas vincular varias actividades, cambia el Selection type a Multiple selection.

Ignorar contexto del espacio

Por defecto, el selector limita la búsqueda de actividades al espacio actual para mantener la relevancia. Al marcar la opción Ignore Space context, permites que los usuarios busquen y seleccionen tickets en toda la instancia de Jira.

• Soporte JSM: Esta funcionalidad está totalmente operativa en espacios de Jira Service Management (JSM), permitiendo búsquedas globales tanto desde la vista del Agente como desde el Portal del Cliente.
• Comportamiento:
  • Desmarcado: La búsqueda se restringe al espacio actual (recomendado para mantener el foco).
  • Marcado: Habilita la búsqueda en todos los espacios de la instancia.

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 las actividades seleccionadas, dándole a tu equipo contexto de un vistazo sin necesidad de abrir la actividad en una nueva pestaña.

Enriquecer la visualización del campo

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

• Responsable: Muestra el avatar del responsable de la actividad.
• Estado: Muestra el estado actual de la actividad con su color correspondiente (ej: "En curso", "Finalizado").
• Prioridad: Muestra el icono de la prioridad de la actividad.
• Título de enlaces entrantes: Permite ingresar un título personalizado que se mostrará como encabezado en el panel de Enlaces Entrantes (Incoming Links). Si se deja vacío, se utilizará el nombre del campo en esta sección.

Al activar estas opciones, la información aparecerá directamente en la vista de la actividad 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 Guardar cambios.

---

Pestaña Valor predeterminado

Puedes establecer un valor predeterminado para tu campo, lo que te permite buscar y seleccionar una actividad directamente desde la pantalla de configuración del contexto.

---

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 una actividad en un campo Dynamic Work Item Picker, el campo almacena la key de esa actividad (por ejemplo, PROJ-123). Por lo tanto, tus búsquedas JQL deben usar las keys de las actividades 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.

---

Uso del Campo en Transiciones de Flujo de Trabajo

Si deseas utilizar el campo Dynamic Work Item Picker en una pantalla de transición de un flujo de trabajo (por ejemplo, al cerrar o resolver una actividad), es posible que necesites habilitar la nueva vista de transiciones de Jira, que actualmente se encuentra en modo "Labs".

Sigue estos pasos para activar la nueva experiencia de transición:

1. Inicia sesión en tu cuenta de Jira.
2. Haz clic en tu icono de perfil en la esquina superior derecha y selecciona Configuración de la cuenta.
3. En la página de configuración de la cuenta, ve a la pestaña Configuración de productos.
4. Localiza y selecciona la instancia de Jira que deseas modificar (cada instancia se presenta como un enlace).
5. Una vez en la configuración de la instancia, navega a la pestaña General.
6. Busca la sección Jira Labs y activa la opción Nueva experiencia de transición.

Una vez activada esta función, podrás añadir tu campo personalizado a las pantallas de transición y funcionará como se espera.