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 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 con el valor correspondiente del item de trabajo actual en el que se muestra el campo.

Las variables soportadas son:

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

Ejemplo de uso:

Para mostrar solo issues del mismo tipo y con la misma prioridad que el issue actual, podrías usar:

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

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.

---

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 un item de trabajo), 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.