Integración de Jira Server y Data Center para Viva Goals

Jira Server y Jira Data Center permiten el seguimiento automático de los resultados clave y el progreso de la iniciativa en Viva Goals de historias de usuario y epopeyas de Jira. Las actualizaciones sobre historias de usuario, epopeyas o proyectos vinculados de Jira actualizarán automáticamente el progreso de los Viva Goals resultados e iniciativas clave vinculados. Esto garantiza que el proceso de OKR no esté esperando las verificaciones manuales y que cualquier progreso se actualice en tiempo real en Viva Goals.

Nota: Un administrador de inquilinos debe habilitar la integración de Jira y Jira Server desde Viva Goals configuración de inquilino antes de que sea visible en la sección de integración de Viva Goals para la organización de Viva Goals.

Configuración de una conexión de Jira Server o Data Center

1. En el panel de navegación izquierdo de Viva Goals, seleccione Administración>Integraciones.

2. En la página Integraciones, vaya a Jira y seleccione Habilitar. Una vez habilitada Jira, o si ya está habilitada, seleccione Administrar.

3. Seleccione Nueva conexión y agregue los siguientes detalles en el cuadro de diálogo emergente:

   • Nombre de conexión: Asigne un nombre a la conexión.

   • Servidor: Agregue la dirección URL del servidor jira.

   • ¿Cómo se hospeda esta instancia de Jira?: Seleccione la opción Jira Server .

   

4. Para guardar la conexión, seleccione Siguiente.

5. Para abrir la conexión, seleccione Editar.

6. Cambie a Jira Server o Data Center para instalar y configurar Microsoft Viva Goals para Jira.

   Nota:

   Tendrá que usar el UUID de cuenta y el token de acceso en la configuración de Jira después de instalar el Microsoft Viva Goals para la aplicación Jira desde Atlassian Marketplace.

Instalación y configuración de Microsoft Viva Goals para Jira desde Atlassian Marketplace

1. Como administrador de Jira Server o Data Center, busque el Microsoft Viva Goals para la aplicación Jira en la página Buscar nuevas aplicaciones en Jira.

2. Seleccione Instalar junto a Microsoft Viva Goals para Jira y siga los pasos del menú emergente "Confirmar instalación de la aplicación".

3. Una vez finalizada la instalación, seleccione Introducción.

4. Escriba el UUID de la cuenta y el token de acceso copiado de Viva Goals, así como los detalles de la cuenta de servicio de Jira y, a continuación, seleccione Conectar. La cuenta de servicio jira es necesaria para que el Microsoft Viva Goals para la aplicación Jira pueda acceder a los detalles del proyecto de Jira en nombre de Viva Goals. Agregue estos dos fragmentos de información para la cuenta de servicio:

   • Nombre de usuario de Jira: Nombre de usuario jira de la cuenta de servicio.

   • Contraseña de Jira: La contraseña de Jira correspondiente.

   

   

   Importante

   El usuario de la cuenta de servicio de Jira debe tener acceso a los proyectos de Jira con los que desea conectarse con Viva Goals para que el Microsoft Viva Goals para la aplicación Jira tenga acceso a los detalles del proyecto jira server o data center. El JQL especificado durante la configuración de integración considerará esta cuenta de usuario de servicio para su ejecución.

5. Vuelva a Viva Goals y confirme que la configuración de la conexión se realizó correctamente; para ello, compruebe si se ha comprobado en el elemento emergente de la conexión.

Uso de la integración de Jira

Para obtener información sobre cómo conectar una integración de Jira a un objetivo, consulte Integración de Jira.

Sincronizar manualmente el progreso de todos los objetivos integrados con un servidor Jira específico

Para sincronizar manualmente el progreso de todos los objetivos integrados con un servidor Jira específico:

1. Vaya a la aplicación Jira Server.

2. Vaya a la aplicación Viva Goals en ese servidor.

3. Seleccione Sincronizar.

Limitaciones actuales de la integración de Jira Server y Data Center

• El progreso no se sincroniza inmediatamente, pero la primera sincronización se realizará automáticamente en los 10 minutos posteriores a la conexión de Jira con un objetivo específico. Sin embargo, puede actualizar manualmente para extraer todas las actualizaciones seleccionando el botón Sincronizar de la aplicación Jira Server.

• La integración de Jira Server y Data Center admite el cálculo del progreso en función del recuento de vales y los puntos de historia.

• Una instancia de Jira Server solo se puede conectar a una Viva Goals organización a la vez. Si necesita conectar la misma instancia de Jira Server a otra organización de Viva Goals, primero deberá desconectar la instancia de la organización Viva Goals actual.

Puede encontrar más información sobre las últimas actualizaciones de la versión de Jira Server aquí.

Versiones compatibles

La aplicación de complemento Jira Microsoft Viva Goals para Jira admite actualmente hasta la versión 10.1.2 de Jira. Si tiene previsto actualizar la versión de Jira, genere una solicitud de compatibilidad con Jira o póngase en contacto con Microsoft para obtener soporte técnico.

Preguntas frecuentes

¿Qué debo hacer si recibo un error de credenciales no válidas a pesar de usar las credenciales correctas?

Compruebe los permisos de la cuenta de servicio.

1. Inicie sesión como usuario de la cuenta de servicio en Jira y asegúrese de que los proyectos de Jira que desea consultar sean accesibles.

2. Compruebe los permisos invocando la siguiente consulta desde uno (o todos) de los nodos Jira. Tenga en cuenta que el siguiente comando es un comando curl de ejemplo: use las credenciales reales de la cuenta de servicio o el usuario adecuado. Reemplace también por https://test.com/rest/api/2/search?jql=project=ATP la dirección URL del servidor Jira y el JQL del proyecto.

   curl -u username:password -X GET -H "Content-Type: application/json" https://test.com/rest/api/2/search?jql=project=ATP

Importante

Se recomienda habilitar el registro detallado para el complemento Microsoft Viva Goals siguiendo estos pasos:

1. En Jira Server, vaya a Sistema de administración>.
2. Seleccione Registro y generación de perfiles.
3. Desplácese hacia abajo hasta la sección Registradores predeterminados .
4. Seleccione Configurar el nivel de registro para otro paquete.
5. Escriba "io.ally" como nombre del paquete y TRACE como nivel de registro.
6. Reinicie los nodos jira.
7. Grep the logs using the following string: tail –f log/atlassian-jira.log | grep "io\.ally"

¿Por qué el complemento Jira no puede validar las credenciales después de restablecer la contraseña de la cuenta de servicio de Jira?

Siga estos pasos al restablecer la contraseña para evitar este problema:

1. Desconecte la conexión en la aplicación del complemento Jira.
2. Restablezca la contraseña.
3. En la aplicación del complemento Jira, vuelva a establecer la conexión. Esto reanudará la conexión del complemento Jira y la sincronización automática con Viva Goals.