Solución de problemas
¿El cliente necesita licencia JSM para ver los documentos compartidos?
No. El panel Shared Documentation en el portal del cliente está disponible sin necesidad de licencia JSM. Sin embargo, el contenido de las páginas de Confluence enlazadas depende de los permisos que el cliente tenga sobre esos espacios.
¿Por qué el cliente no ve los documentos nuevos sin recargar?
No hay sincronización en tiempo real entre el panel del agente y el portal del cliente. Los documentos se almacenan en Forge KVS y el portal los lee al cargar. Si el agente agrega o modifica documentos, el cliente debe recargar el portal para ver los cambios.
¿Puedo marcar más de un documento como principal?
No. Solo puede haber un documento destacado por ticket. Al destacar otro documento, el anterior pierde automáticamente el flag de documento principal.
¿Qué pasa si se elimina o archiva una página de Confluence?
El documento permanece en la lista del portal con el enlace original. Si el cliente hace clic, Confluence mostrará un error indicando que la página no existe o no tiene acceso. Es responsabilidad del agente mantener los enlaces actualizados.
¿Puedo compartir la misma página de Confluence en varios tickets?
Sí. No hay restricción sobre reutilizar la misma página de Confluence en múltiples tickets. Cada ticket gestiona su propia lista de documentos de forma independiente.
¿La búsqueda de Confluence es en tiempo real?
Sí. Cada vez que el agente escribe en el campo de búsqueda, se realiza una consulta a la API de Confluence. Los resultados se ordenan por fecha de última modificación (más recientes primero).
¿Se actualiza automáticamente la fecha de modificación en el portal?
Sí. Cada vez que el cliente carga el portal, la aplicación consulta la fecha de última modificación de cada página en Confluence. Si la página fue modificada después de compartirla, el portal mostrará la fecha actualizada.
¿Qué permisos necesita el agente en Confluence?
El agente necesita acceso a los espacios y páginas de Confluence que desee buscar y compartir. Los permisos exactos dependen de la configuración de Confluence en cada organización. En Confluence, la aplicación solo solicita scopes de lectura (search:confluence, read:confluence-space.summary, read:space:confluence).
¿El cliente puede ver páginas de Confluence que no tiene permisos de ver?
No. El enlace al documento se comparte, pero el acceso al contenido depende de los permisos de Confluence del propio cliente. Si el cliente no tiene permiso para ver la página, Confluence le denegará el acceso.
¿Cómo quito el documento destacado?
Haz clic nuevamente en el botón de estrella del documento que está marcado como principal. El flag se remueve y ningún documento aparecerá en la sección de documento principal del portal.
¿Quién puede ver quién agregó o eliminó un documento?
Solo los agentes en el panel Case Documentation. El portal del cliente (Shared Documentation) no muestra metadatos de auditoría ni historial de cambios.
¿Por qué solo veo 20 entradas en el historial de cambios?
El historial de eliminaciones está limitado a los últimos 20 eventos por ticket. Cuando se supera este límite, los eventos más antiguos se descartan automáticamente (FIFO).
¿Se auditan todas las acciones sobre documentos?
En esta versión solo se auditan las acciones de agregar y eliminar documentos. Acciones como reordenar la lista o cambiar el documento destacado no generan entradas en el historial.
Cancelé la transición y los documentos siguen
Es el comportamiento esperado. En el campo Case Documentation, agregar, quitar y destacar se guardan en el caso al momento, no al confirmar la transición. Cancelar la transición, o que un validador la rechace, no deshace esos cambios. Si no querías el cambio, quita o vuelve a destacar el documento desde el panel. Consulte Documentación en la transición y al crear el issue.
El campo en Details no me deja editar
En la sección Details de la vista del issue, y en la edición masiva, el campo Case Documentation es de solo lectura. Para gestionar documentos desde la vista del issue usa el panel Case Documentation, o edítalos durante una transición.
La transición no pasa por la documentación del caso
Un validador de documentación está configurado en esa transición y el caso no cumple la regla. El mensaje indica el motivo:
- Cantidad: faltan documentos para llegar al mínimo.
- Espacio: los documentos son de espacios de Confluence no permitidos o no tienen espacio.
- Destacado: no hay documento destacado, o el destacado es de un espacio no permitido.
- Documento mal formado: algún documento está incompleto (falta página, título o enlace).
Corrige la documentación (en el campo de la transición o en el panel) y vuelve a intentarlo. Los cambios ya guardados se mantienen.
El mensaje del validador sale en inglés
El validador usa el idioma guardado en el perfil de Atlassian del usuario, no el del navegador. Si en Configuración personal → Idioma está en automático, el mensaje se muestra en inglés. Selecciona Español explícitamente.
El validador rechaza siempre la transición de creación
El validador no debe configurarse en la transición que crea el issue: en ese momento la lista del caso todavía no existe. Quita el validador de esa transición y, si necesitas documentos al crear el issue, añade el campo Case Documentation al diálogo de creación.
Agregué un documento y Automation no se disparó
Revisa, en este orden:
- Pantalla de edición: el campo Case Documentation tiene que estar en la pantalla de edición del tipo de issue. Si no está, el documento se guarda en el caso pero el campo no cambia, sin aviso en el panel.
- Permiso del agente: el agente necesita el permiso de editar el issue.
- Condición de la regla: la regla tiene que exigir que
originseacreacion,transicionoedicion. - Trigger: para documentos agregados al crear el issue usa Issue created; Field value changed no se dispara en la creación.
- Upgrade de permisos: el site tiene que haber aceptado el scope
write:jira-work.
Si el alta falló (por ejemplo, el documento ya estaba en la lista), Automation no se dispara por esa inclusión. Consulte Automation for Jira.
¿Funciona en proyectos team-managed?
El panel Case Documentation y el portal sí. El campo de la transición y el validador de documentación solo están disponibles en proyectos company-managed.