Preguntas Frecuentes (FAQ)

P: ¿Dónde encuentro la página de configuración del campo?

R: A diferencia de otros complementos que añaden su propia página de administración, la configuración de Dynamic Work Item Picker se integra con Jira. Puedes encontrarla navegando a Configuración > Actividades > Campos, buscando tu campo, y haciendo clic en Contextos y valores predeterminados > Editar configuración de campo personalizado.

Puedes encontrar una guía más detallada aquí.

P: ¿Quién puede configurar el campo y quién puede usarlo?

R: Desde la versión 5.9.0, la configuración del campo (JQL, contextos, vista, totalizadores, tipo de selección) requiere permiso de Administrador de Jira. Los usuarios estándar con permisos Jira habituales pueden seguir editando el valor del campo en actividades (creación, transición, portal) sin necesidad de ser administradores. Esta distinción no afecta la experiencia del picker para usuarios finales.

P: ¿Por qué no puedo encontrar una actividad específico al buscar?

R: Esto puede deberse a dos razones principales:

1. Permisos de Jira: Solo puedes buscar y seleccionar actividades que tengas permiso para ver en Jira. Asegúrate de tener acceso al espacio de la actividad que buscas.
2. Filtro JQL: El administrador puede haber configurado un filtro JQL en el campo que restrinja los resultados. Por ejemplo, el campo puede estar limitado a mostrar solo actividades de un tipo o estado específico.

P: ¿Cuál es la diferencia entre la versión Cloud y la de Data Center?

R: Ambas versiones cubren el mismo objetivo principal: vincular work items de Jira mediante un campo personalizado configurable. La versión Cloud está construida sobre Atlassian Forge y se distribuye a través del Atlassian Marketplace, mientras que la versión Data Center se instala manualmente como plugin (.jar). Las capacidades actuales de Cloud incluyen selección simple/múltiple, filtro JQL por contexto, personalización de la vista, panel de Enlaces Entrantes, dashboard de administración, registro de auditoría y totalizadores por contexto. La experiencia de usuario final es equivalente; las diferencias se concentran en los flujos de instalación, licenciamiento, configuración y actualización.

P: ¿Qué versión tengo instalada?

R: En complementos Cloud (Forge), la versión que puede verificar un administrador es la que aparece en Apps → Manage apps (por ejemplo, 5.4.0). Esa es la versión Forge.

En este sitio de documentación, el selector de versión puede mostrar:

• La versión Forge (post-Forge), cuando la release ya está publicada en producción.
• El sufijo (pre) (por ejemplo, 2.0.1 (pre)), para releases internas MB Group aún sin versión visible en Manage apps.

Consulte la tabla de mapeo en el changelog para relacionar cada release MB Group con su versión Forge.

P: ¿Por qué no veo el botón de comentarios (💬) en las filas del campo?

R: El botón de comentarios es una función opcional que debe activar el administrador. Si no lo ves, comprueba con tu administrador si el toggle Comentarios está habilitado en la pestaña Vista de la configuración del campo. Recuerda también que el botón solo aparece en modo vista (solo lectura); no se muestra mientras editas el campo.

P: ¿Por qué el icono 💬 aparece resaltado en azul?

R: El icono se resalta cuando hay comentarios publicados en ese ticket después de la última vez que abriste el modal para ese mismo ticket. Es el indicador de comentarios no leídos: significa que hay actividad nueva que aún no has revisado. Al abrir el modal, el estado se actualiza y el icono vuelve a su apariencia normal.

P: ¿Por qué no veo las imágenes dentro de los comentarios?

R: Las imágenes embebidas en comentarios de Jira se muestran como el marcador [media] en el modal. Esta es una limitación del entorno de ejecución de Atlassian Forge (UI Kit). El texto, las tablas, las listas y los demás elementos del formato ADF sí se muestran correctamente.

P: ¿Por qué no veo la barra de progreso en el campo?

R: La barra de progreso es una función opcional que debe activar el administrador por contexto. Comprueba con tu administrador si el toggle Barra de progreso está habilitado en la pestaña Vista de la configuración del campo. Ten en cuenta también que si el campo está vacío, la barra no se muestra aunque el toggle esté activo.

P: Un issue está en estado "Done" pero no cuenta como resuelto en la barra de progreso. ¿Por qué?

R: La barra de progreso calcula el porcentaje a partir de la Resolution, no del estado. Un issue en Done sin Resolution no cuenta como resuelto. Para que un issue cuente como resuelto, debe tener una Resolution establecida en Jira (por ejemplo, Fixed, Done, Won't Fix, etc.), independientemente del color de su estado.

P: Activé la sincronización con Issue Links pero los enlaces no aparecen. ¿Qué puede estar pasando?

R: Comprueba los siguientes puntos: (1) El usuario que modifica el campo debe tener el permiso Link Issues en Jira. Sin ese permiso, el campo se actualiza pero los enlaces nativos no se crean ni eliminan. (2) Verifica que hayas seleccionado un tipo de enlace en la configuración del campo. (3) La sincronización es unidireccional: añadir un enlace nativo desde el panel de Jira no añade el work item al campo DWIP.

P: Tengo varios campos DWIP que sincronizan el mismo tipo de enlace en el mismo issue. ¿Qué ocurre si quito un work item de uno de ellos?

R: El enlace nativo se comparte entre todos los campos que sincronizan el mismo tipo de enlace hacia ese work item. El enlace solo se elimina cuando ningún campo DWIP del issue sigue conteniendo ese work item con ese tipo de enlace. Para evitar comportamientos inesperados, se recomienda configurar un tipo de enlace distinto para cada campo.