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.