Jira Server

Resumen

Asana para Jira Server es una integración que permite la colaboración y la visibilidad entre los equipos que trabajan con Asana y Jira.

Esta integración acerca lo valioso de la integración con Jira Cloud a los usuarios de Jira Server.

Ofrece la posibilidad de que los equipos de Productos y Negocios (que dedican la mayor parte del tiempo a planificar y trabajar en Asana) colaboren y den seguimiento sin problemas al trabajo de los equipos técnicos (que planifican y trabajan en Jira). El propósito es optimizar la programación mediante el seguimiento de sprints y, en consecuencia, aportar a los usuarios de Asana visibilidad con respecto a la etapa de desarrollo en Jira.

Asana para Jira Server tiende puentes entre las etapas de planificación en Asana y las de desarrollo en Jira, de la ejecución a la entrega.

Crea y supervisa el estado de las incidencias de Jira dentro de las tareas de Asana.

Requisitos para la instalación

Requisitos de Asana:

La integración de Asana para Jira Server está disponible para todos los clientes con planes Premium, Business y Enterprise.

El administrador de Jira debe tener:

• Una cuenta de Asana
• Un plan pago
• Disponibilidad para los primeros pasos de la instalación

Requisitos de Jira:

Las instancias de Jira Software Server o Data Center son compatibles y se configuran según los requisitos asociados a continuación. Para recibir asistencia específica de la versión, consulta la oferta en Jira Marketplace.

Si usas Jira Cloud, trabaja con la integración de Asana para Jira Cloud.

Cómo instalarla

El administrador de Jira debe crear el enlace de la aplicación al instalar el complemento desde el Marketplace de Jira Server. Para ello, debe instalar el archivo de complemento provisto por Asana. El administrador de Jira deberá efectuar los primeros pasos. Después, los usuarios finales podrán agregar la integración en Asana a cualquier proyecto al que tengan acceso.

Instalación del administrador de Jira:

• Dirígite a este repositorio de GitHub para obtener más información sobre las configuraciones compatibles de Jira Server para permitir conexiones externas.
• Una vez que hayas configurado tu instancia de Sever como corresponde, ve a Jira Sever Marketplace, busca el complemento de [Asana para Jira Server'] (https://marketplace.atlassian.com/apps/1223378/asana-for-jira-server ? hosting = server & tab = overview) e instálalo.

A continuación, el administrador de Jira debe hacer clic en "Connect to Asana" (Conectar con Asana) para autenticar la aplicación.

• Aparecerá una pantalla para que autorices a Asana
• Una vez que hayas otorgado la aprobación, elige el dominio adecuado de Asana al cual conectar la integración nueva
• Cuando veas una confirmación en Jira, los pasos que se necesitan efectuar desde Server habrán finalizado y al resto lo pueden completar usuarios de Asana.

Usuarios de Asana:

1. En Asana, ve al proyecto al que desees agregar la integración
2. En el extremo superior derecho de tu pantalla haz clic en Personalizar, desplázate hacia abajo y haz clic en la opción Agregar aplicación.

Durante la autenticación, si recibes el mensaje de que “Tu instancia de Asana no se ha agregado a Jira Server” vuelve al paso de instalación con el administrador de Jira y asegúrate de que la organización de Asana esté autenticada, que se hayan seleccionado los espacios de trabajo necesarios y que aparezca en la Administración de Jira Server.

Cuando hayas terminado, la aplicación se habrá agregado al proyecto y los usuarios deberían ver un campo llamado Jira Server en las tareas. Así podrán agregar o crear incidencias de Jira directamente en Asana.

Si es la primera vez que intentas agregar la aplicación a un proyecto, pasarás por una serie de flujos de autenticación tanto de Jira como de Asana. Después de terminar, podrás vincular las incidencias con las tareas en los proyectos que correspondan.

OAuth 2.0 para Jira Server y Jira Data Center

OAuth 2.0 es compatible con Jira Server y Jira Data Center en la versión 8.22 y posteriores.

Existen dos formas de instalar una integración para Jira Server y Jira Data Center. El proceso de instalación de OAuth 1.0 requiere que los clientes instalen el complemento Asana para Jira Server desde el Marketplace de Atlassian.

Si usas OAuth 2.0, no necesitas realizar este paso para iniciar el proceso de instalación. Los administradores de Jira podrán realizar todo el proceso de instalación directamente desde su instancia de Jira.

Instrucciones de instalación paso a paso

Este proceso solo lo pueden realizar los administradores de Jira.

1. Genera las credenciales del enlace de la aplicación:

• Haz clic en el ícono de ajustes y abre el menú desplegable Aplicaciones
• En el menú desplegable, selecciona Enlaces de aplicaciones
• Crea un enlace entrante nuevo para la aplicación con los siguientes parámetros:
  • Tipo de aplicación: aplicación externa
  • Dirección: entrante
  • URL de redireccionamiento: https://jira-api.integrations.asana.plus/setup/callback/jira
  • Permiso: escritura

2. Después de hacer clic en Guardar, la página resultante te proporcionará las credenciales: ID de cliente y Secreto de cliente. Mantén esta página abierta ya que necesitarás esta información en el paso 5.
3. Abre la página de configuración ingresando https://jira-api.integrations.asana.plus/setup en una pestaña separada en tu navegador.
4. Inicia sesión con tu cuenta de Asana y haz clic en Permitir para confirmar tu aprobación para otorgar permisos. Luego de iniciar sesión, selecciona un espacio de trabajo de Asana para integrar tu instancia de Jira.
5. Se te pedirá que ingreses la siguiente información:

• Dominio de Jira: el dominio de Jira al que quieres conectarte. Tu instancia de Jira debe ser accesible desde la red pública. Este procedimiento no funcionará si solo se puede acceder a tu instancia de Jira a través de la red corporativa o una VPN.
• ID del cliente: ver paso 2.
• Secreto de cliente: ver paso 2.
• Haz clic en Guardar.

6. A continuación, se te pedirá que otorgues permiso a Asana para que acceda a tu dominio de Jira. Haz clic en Permitir si deseas continuar.

Funciones

La integración ahora se puede usar para vincular una tarea de Asana a una incidencia de Jira o para crear una incidencia nueva.

Vincula las tareas de Asana a incidencias de Jira

Desde el menú desplegable del campo Jira Server puedes agregar una incidencia de Jira.

Después, ingresa la URL de la incidencia de Jira o simplemente escribe el nombre de la incidencia en el campo de texto.

Desde aquí puedes abrir una incidencia de Jira, aportar comentarios o eliminar incidencias de una tarea.

Crea una incidencia de Jira desde una tarea de Asana

Selecciona Crear una incidencia nueva en el campo de Jira Server dentro de la tarea de Asana.

Aparecerá una ventana emergente para que la completes. Intenta completar todos los campos (específicamente los de tipo de incidencia y proyecto). También puedes adjuntar archivos desde la tarea de Asana.

Haz clic en Crear incidencia.

Asana cargará los detalles relevantes de los campos completados para crear la incidencia.

Después de haber creado o vinculado una incidencia, verás los detalles actualizados de esa incidencia dentro de la tarea de Asana. Solamente puedes agregar una incidencia de Jira por cada tarea de Asana.

Una vez que se haya creado la incidencia de Jira surgirá un widget que aporta en tiempo real el estado, la prioridad y el responsable de la incidencia de Jira. Haz clic en él para ver más.

Cualquier cambio que se haga a una incidencia en Jira, se verá reflejado en Asana la próxima vez que se vuelva a cargar la página.

Funcionalidad clave

• Cierra la brecha entre la etapa de planificación y el traspaso del trabajo: Los gerentes de proyectos pueden crear a la perfección incidencias de Jira desde Asana cuando las tareas están técnicamente listas. La planificación ya se ha producido en Asana y el gerente de Productos está listo para transferirla al departamento técnico fácilmente para que hagan la planificación del sprint en Jira. Con esta integración se ahorra tiempo y se evitan las inconsistencias entre los datos.

• Automatiza la creación de incidencias de Jira con las Reglas de Asana para ahorrar tiempo y optimizar tu flujo de trabajo. Descubre cómo hacerlo.

• La transparencia en trabajos de desarrollo en Jira: Los usuarios de Asana tienen visibilidad del trabajo que se produce en Jira, así que pueden mantener a los demás involucrados y a los clientes actualizados con respecto a las fechas de los lanzamientos, los errores corregidos, etc. Del mismo modo, el gerente de Productos aprovechará la flexibilidad para poder dar seguimiento, planificar y ejecutar el trabajo de Jira en Asana. Todos ganan.

Preguntas frecuentes sobre Jira Server

Para explorar una lista de preguntas frecuentes sobre la integración de Asana para Jira, sigue leyendo.

¿Cómo funciona el modelo de autorizaciones?

• Para la integración se usa OAuth como estándar de autorizaciones. Los usuarios permanecerán autenticados hasta que venza el token OAuth o hasta que alguien cancele ese token.

• Para asociar las incidencias que ya existen en Jira con las tareas de Asana o para crear una incidencia nueva de Jira desde Asana, necesitarás contar con la autorización de tu cuenta de Jira.

Cómo comprobar si estás usando Jira Server

• Ve a la URL que usas para iniciar sesión en tu cuenta de Jira.

• Si tu URL tiene esta estructura: "<el nombre de tu organización>.atlassian.net” entonces estás usando Jira Cloud y no cumples con los requisitos para usar la integración con la versión Server. Deberás usar la versión Cloud.

• Si tu URL no tiene esta estructura: "<el nombre de tu organización>.atlassian.net” entonces estás usando Jira Server y cumples con los requisitos para usar esta integración.

¿Quién inicia la primera integración con Jira?

Un administrador de Jira tiene que crear el enlace a tu instancia de Server para poder conectarlo con Asana. Esta es una acción que se hace una sola vez. Una vez hecha, los usuarios dentro de Asana podrán autenticarse individualmente para agregar los proyectos.

¿Es una integración en una sola dirección o en ambas?

• Cuando un usuario crea una incidencia nueva en Jira o asocia una incidencia ya existente de Jira desde Asana, enviamos la siguiente información de Asana a Jira:

1. Nombre de la tarea
2. Descripción
3. Archivos adjuntos

• Esta información se vuelve parte de la nueva incidencia de Jira. Sin embargo, esta transferencia de datos de Asana a Jira se produce una sola vez, durante la creación de una incidencia nueva en Jira. También es la única vez que se extraen datos de Asana y se incorporan en Jira.

• Después de que se crea la incidencia en Jira, en el widget de Jira se muestra información de solo lectura de la incidencia asociada de Jira. Es decir, en términos técnicos, el widget solo sincroniza los datos directamente de Jira a Asana. El widget de Jira también funciona en la misma dirección cuando se asocia una incidencia de Jira con una tarea de Asana.

¿Cómo funcionan los permisos?

• Cuando creas una incidencia nueva de Jira desde Asana, la integración sigue el modelo de permisos de Jira. Entonces, un usuario solamente puede crear una incidencia de Jira si tiene el permiso de esa aplicación. Este es el único caso en que un usuario puede escribir información en Jira (para crear una incidencia nueva de Jira). Del mismo modo, este también es el único caso en que la integración lee los datos de Asana.

1. La integración lee los datos de Asana y crea una incidencia nueva en Jira al transcribir (opcional) parte de la información de la tarea de Asana (el nombre de la tarea, la descripción y los archivos adjuntos) en los campos (nombre de la incidencia, etc.) de la nueva incidencia de Jira.

• De un modo similar, los usuarios solamente pueden asociar incidencias de Jira a tareas de Asana si se da lo siguiente:

1. Tienen la autorización para acceder a su cuenta de Jira.

2. Tienen acceso a esas incidencias específicas en Jira.

• Una vez que una incidencia se ha asociado con una tarea de Asana, los permisos de lectura se controlan bajo el modelo de permisos de Asana. Por ejemplo, si un usuario asocia una incidencia de Jira con una tarea XYZ, los demás usuarios de Asana con acceso a la tarea XYZ solamente podrán ver (solo lectura) la información asociada con esa incidencia de Jira. Si deseas que la información de Jira sea privada en Asana, tienes la opción de convertir tus tareas o proyectos en privados.

¿Podemos crear o asociar en Jira tareas de Asana con incidencias de Jira?

No.

Para realizar la integración debes crear una tarea en Asana y después asociarla a una incidencia de Jira.

Cómo quitar la autorización de acceso para la integración o cómo cambiar la cuenta de Jira

Los usuarios pueden revocar el acceso a la integración de Asana para Jira Server en Jira, si desean quitar la autorización.

1. Ve a Account Settings > Connected Apps (Ajustes de la cuenta > Aplicaciones conectadas) y haz clic en Revoke Access (Revocar acceso).

La próxima vez que un usuario intente adjuntar o crear una incidencia nueva de Jira se les pedirá que vuelvan a otorgar la autorización.

Para conectar una instancia diferente de Jira Server con tu espacio de trabajo de Asana, comunícate con el equipo de Asistencia de Asana.