Guía de Instalación
Instalar Portal Docs Hub for JSM en su instancia de Jira Cloud se realiza mediante un enlace de instalación directa de Atlassian Forge.
Portal Docs Hub for JSM aún no está publicada en el Atlassian Marketplace. La instalación actual se realiza exclusivamente a través del enlace oficial de desarrollador indicado a continuación.
Prerrequisitos
- Permisos de Administrador de Jira o Administrador del site para instalar aplicaciones Forge.
- Conexión a internet y acceso a su instancia (
su-dominio.atlassian.net). - Jira Service Management habilitado en el site.
Enlace de instalación directa
Instalar Portal Docs Hub for JSM
Pasos para la instalación (Administradores)
- Iniciar sesión en Jira Cloud con credenciales de administrador.
- Abra el enlace de instalación directa anterior.
- Seleccione su site de Jira Cloud si se le solicita.
- Revise los permisos (scopes) solicitados, incluido
write:jira-work, y confirme con Accept & install. - Espere a que Atlassian complete el despliegue de la aplicación Forge.
- Verifique en Apps → Manage apps que Portal Docs Hub for JSM aparece como instalada.
La aplicación solicita permisos de búsqueda en Confluence, lectura y escritura de issues de Jira (write:jira-work, para actualizar el campo Case Documentation) y almacenamiento en Forge KVS. Todos los permisos siguen el principio de mínimo privilegio de Forge. Consulte Permisos y requisitos.
¿No es Administrador?
Si no tiene privilegios de administración, comparta el enlace de instalación con su administrador de Jira y solicite que instale Portal Docs Hub for JSM en el site.
Verificar la instalación
- Abra cualquier ticket en un proyecto Jira Service Management.
- En la vista del agente, haga clic en el botón con el ícono de complemento, ubicado debajo del título del ticket.
- En la vista del agente, busque el panel Case Documentation.
- En el portal del cliente, busque el panel Shared Documentation.
Si los paneles se muestran correctamente, la instalación fue exitosa.
Checklist de pantallas
Para usar el campo Case Documentation (versión 1.5.0 o posterior), añádalo a las pantallas del proyecto:
| Pantalla | ¿Cuándo? | Para qué |
|---|---|---|
| Pantalla de transición | En cada transición donde el agente deba gestionar documentos | Editar la documentación del caso durante la transición |
| Pantalla de creación | Si se comparten documentos al crear el issue | Agregar documentos en el diálogo de creación |
| Pantalla de edición | Siempre que se use Automation for Jira | Que Automation vea las altas hechas desde el panel y la transición |
Si el campo no está en la pantalla de edición del tipo de issue, el documento se guarda igual en el caso, pero el campo no se actualiza y Automation no se dispara. Consulte Automation for Jira.
El campo y el validador de documentación solo están disponibles en proyectos company-managed.
Actualizaciones automáticas (Forge)
Las aplicaciones Forge se actualizan desde la infraestructura de Atlassian. Si una versión introduce nuevos scopes, Atlassian solicitará su aprobación antes de aplicarla.
Actualizar desde una versión anterior
La versión 1.5.0 añade el scope write:jira-work. Si su site ya tenía la app instalada:
- Vaya a Apps → Manage apps.
- Ubique Portal Docs Hub for JSM y acepte la actualización de permisos.
Hasta aceptar el upgrade, el site sigue con la versión anterior y no dispone del campo Case Documentation, del validador ni del origen para Automation.