Jira Server

Visão geral

Asana para Jira Server consiste em um integração que possibilita a colaboração e a visibilidade entre as equipes que trabalham na Asana e no Jira.

Ela traz a conveniência da integração com o Jira Cloud para os usuários do Jira Server.

A integração permite que as equipes comerciais e de produto (que gastam a maior parte do tempo planejando e organizando o trabalho na Asana) colaborem e acompanhem o trabalho de forma perfeitamente integrada com as equipes de engenharia (que planejam e realizam o trabalho no Jira). Ela tem a finalidade de otimizar o agendamento ao acompanhar os Sprints e proporcionar visibilidade aos usuários Asana sobre o estágio de desenvolvimento no Jira.

A integração Asana para Jira Server faz a ponte entre as etapas de planejamento na Asana e os estágios de desenvolvimento no Jira - desde a execução até a entrega.

Além disso, ela cria e monitora os status de problemas do Jira dentro de tarefas na Asana.


Requisitos para instalação

Requisitos da Asana:

A integração Asana para Jira Server está disponível para todos os clientes Premium, Business e Enterprise.

Requisitos necessários ao Administrador do Jira para as primeiras etapas de instalação:

  • Ter uma conta na Asana
  • Um plano pago

Procurando uma maneira melhor de gerenciar o seu trabalho? Comece uma avaliação gratuita de 30 dias da Asana. Experimente gratuitamente.

Requisitos
do Jira:

As instâncias do Jira Software Server ou Data Center são suportadas, com configuração de acordo com os requisitos acessíveis pelos links a seguir. Consulte a listagem do Jira Marketplace para informações de suporte específicas para cada versão.

Caso use a Jira Cloud, escolha a integração da Asana para Jira Cloud


Como instalar

O Administrador do Jira deve criar um link do aplicativo instalando o plug-in obtido no Jira Server Marketplace. Após o Administrador do Jira concluir as primeiras etapas, os usuários na Asana poderão adicionar a integração a qualquer projeto a que tenham acesso.

Instalação feita pelo Administrador do Jira:

Agora, o Administrador do Jira precisa autenticar o aplicativo clicando em Connect to Asana (Conectar à Asana).

  • Você será solicitado a autenticar com a Asana.
  • Após autenticar, escolha o domínio Asana apropriado que será conectado à nova integração.
  • Com a confirmação no Jira, todas as etapas necessárias no Server estarão concluídas, e o restante pode ser executado pelos usuários na Asana.

Usuários Asana:

  1. Na Asana, vá para o projeto ao qual deseja adicionar a integração
  2. No canto superior direito da tela, clique em Personalizar, role o menu para baixo e clique em Adicionar aplicativo.
     
add apps

Durante a autenticação, se você receber a mensagem de que a sua conta Asana não foi adicionada ao Jira Server, volte à etapa de instalação pelo Administrador do Jira e verifique se a organização Asana está autenticada e se o espaço de trabalho relevante está selecionado e exibido na seção “Administration” (Administração) do Jira Server.


Jira server

Uma vez concluído, o aplicativo será adicionado ao projeto, e os usuários deverão ver nas tarefas um campo do Jira Server, onde será possível adicionar problemas já existentes ou criar novos problemas do Jira a partir da Asana.

Jira Server field

Se esta é a primeira vez que você tenta adicionar o aplicativo a um projeto, haverá uma série de autenticações referentes ao Jira e à Asana. Após concluí-las, você poderá vincular os problemas às tarefas do projeto relevante.


OAuth 2.0 para Jira Server e Jira Data Center

O OAuth 2.0 é compatível com o Jira Server e o Jira Data Center a partir da versão 8.22 e superiores.

Há duas formas de instalar uma integração para o Jira Server e o Jira Data Center. Com o processo de instalação do OAuth 1.0, os clientes são obrigados a instalar o complemento Asana para Jira Server a partir do Atlassian Marketplace.

O uso do OAuth 2.0 não requer essa etapa para habilitar o processo de instalação, o que significa que um administrador do Jira pode concluir todo o processo de instalação diretamente de sua instância do Jira.


Instruções de instalação passo a passo

Este processo só pode ser realizado por Administradores do Jira.

  1. Gere as credenciais do link do aplicativo:
  • Abra o menu suspenso Aplicativos clicando no ícone de engrenagem
  • Abra os links do aplicativo no menu suspenso
  • Criar um novo link de aplicativo de entrada com os seguintes parâmetros:
  1. Depois de clicar em Salvar, a página resultante fornece as credenciais: ID do cliente e Segredo do cliente. Mantenha esta página aberta, pois você precisará dessas informações na etapa 5.
  2. Abra a página de configuração inserindo https://jira-api.integrations.asana.plus/setup em uma guia separada no seu navegador.
  3. Inicie sessão com sua conta Asana e confirme sua aprovação para conceder permissões clicando em Permitir. Após o login, selecione um espaço de trabalho Asana com o qual você deseja integrar a instância do Jira.
  4. Você deve inserir as seguintes informações:
  • Domínio do Jira: o domínio do Jira ao qual você deseja se conectar. A sua instância do Jira precisa estar acessível a partir da Internet pública; se a sua instância do Jira só estiver acessível através da sua rede corporativa ou de uma VPN, isso não funcionará.
  • ID do cliente: a partir da etapa 2.
  • Segredo do cliente: a partir do passo 2
  • Clique em Salvar
  1. Em seguida, é-lhe pedido que conceda permissão à Asana para aceder ao seu domínio Jira. Clique em Permitir se quiser continuar.

Funcionalidades

A integração pode agora ser usada para vincular uma tarefa já existente na Asana a um problema já existente do Jira, ou para criar um novo problema.

Vincular uma tarefa Asana a um problema já existente do Jira

No menu suspenso do campo Jira Server, é possível adicionar um problema já existente.

add field

Em seguida, insira o URL do problema do Jira, ou digite o nome do problema no campo de texto.

url

A partir daí, você pode abrir um problema do Jira, dar feedback e remover um problema de uma tarefa.


Criar um problema no Jira a partir de uma tarefa na Asana

Selecione Create new issue (criar novo problema) no campo Jira Server da tarefa na Asana.

create issue

Será exibida uma nova pop-up de diálogo. Por favor, tente preencher todos os campos (especialmente os campos Projeto e Tipo de problema). Você também pode anexar arquivos a partir da tarefa Asana.

create issue

Clique em Create issue (Criar problema).

A Asana carregará os detalhes relevantes com base nos campos concluídos para criar o problema.

Depois de criar ou vincular um problema, os detalhes atualizados sobre o problema serão exibidos na tarefa Asana. Só é possível adicionar um problema do Jira para cada tarefa Asana.


Uma vez criado o problema do Jira, um widget do Jira fornece em tempo real o status, a prioridade e o responsável pelo problema. Clique nele para ver mais informações.

asana changes


Todas as alterações feitas ao problema no Jira serão refletidas na Asana ao atualizar a página.


Funcionalidade principal

  • Fazer a ponte entre a etapa de planejamento e a transferência: os gerentes de projeto podem criar facilmente um problema do Jira a partir da Asana quando as tarefas estão prontas para o estágio de engenharia. O planejamento já ocorreu na Asana, e o gerente de produto está pronto para fazer a transferência para o departamento de engenharia para que o planejamento do Sprint seja realizado no Jira. Essa integração poupa tempo e evita inconsistências nos dados.

  • Para pular etapas e otimizar o seu fluxo de trabalho, automatize a criação de problemas do Jira usando o nosso recurso de Regras. Saiba como.

Adding rules jira

A partir do pop-up Adicionar regra:

  1. Na seção Jira Server, clique em Criar um novo problema
  2. Preencha todos os campos da caixa Criar um novo problema 
  3. Clique em Criar regra para automatizar a criação de problemas no Jira Server
  • Transparência no trabalho de desenvolvimento no Jira: os usuários da Asana têm visibilidade do trabalho que ocorre no Jira para que possam atualizar as partes interessadas e clientes importantes sobre as principais datas de lançamento, correções de bugs, etc. Da mesma forma, o gerente de produto quer ter a flexibilidade de acompanhar, planejar e executar o trabalho do Jira dentro da Asana. É uma decisão que beneficia a todos.

Veja a seguir uma lista com as perguntas mais comuns sobre a integração Asana para Jira Server.

  • A integração utiliza o OAuth como padrão de autorização. Os usuários continuarão autenticados até que o token OAuth expire ou alguém o cancele.

  • Para vincular problemas já existentes no Jira a uma tarefa na Asana ou para criar um novo problema no Jira a partir da Asana, é necessário estar autorizado na própria conta do Jira.

Como conferir se você está usando um Jira Server

  • Acesse o link que você usa para iniciar sessão na sua conta do Jira.

  • Se o seu URL tiver a seguinte estrutura: “.atlassian.net”, significa que você está usando o Jira Cloud, portanto, não está apto a usar a integração com o Server. Será necessário usar a versão Cloud.

  • Se o seu URL não tiver a estrutura “.atlassian.net”, você estará usando o Jira Server e poderá usar essa integração.

Quem inicia a integração inicial com o Jira?

Um administrador do Jira precisa criar um link de aplicativo para que a instância do seu servidor possa se conectar à Asana. Esta é uma ocorrência única. Uma vez feito isso, os usuários dentro da Asana poderão se autenticar individualmente para adicionar aos projetos.

Essa integração é unidirecional ou bidirecional?

  • Quando um usuário cria um novo problema ou vincula um problema já existente no Jira a partir da Asana, enviamos os seguintes detalhes da Asana para o Jira:
  1. Nome da tarefa
  2. Descrição
  3. Anexos

  • Esses dados se tornam parte do novo problema do Jira. Contudo, essa transferência de dados da Asana para o Jira é uma ocorrência única que se dá durante a criação de um novo problema do Jira, sendo, também, a única vez em que enviaremos dados da Asana para o Jira.

  • Depois da criação do problema do Jira, o widget to Jira mostrará dados somente de leitura do problema conectado. Assim, tecnicamente, o widget estará apenas sincronizando dados diretamente do Jira para a Asana. O widget do Jira também funcionará da mesma maneira quando um problema existente do Jira for conectado a uma tarefa Asana.

Como são determinadas as permissões?

  • Ao criar um novo problema no Jira a partir da Asana, a integração segue o modelo de permissão do Jira. Portanto, um usuário só pode criar um problema no Jira se tiver permissão para fazê-lo. Esse é o único cenário no qual um usuário pode escrever dados no Jira (com o objetivo de criar um novo problema no Jira). Do mesmo modo, a integração só lê os dados da Asana nesse tipo de situação.

  • A integração lê os dados da Asana e cria um novo problema no Jira escrevendo (opcionalmente) alguns dos dados da tarefa Asana (nome da tarefa, descrição e anexos) nos campos do novo problema no Jira, como o nome do problema, entre outros detalhes.

  • De forma semelhante, os usuários somente poderão conectar problemas existentes do Jira a uma tarefa Asana se:

  • Tiverem dado autorização para o acesso à sua conta do Jira

  • Tiverem acesso no Jira a esses problemas do Jira específicos

  • Após um problema ser vinculado a uma tarefa na Asana, o modelo de permissões da Asana passa a controlar as permissões de leitura. Por exemplo, se um usuário vincula um problema no Jira a uma tarefa XYZ, os usuários da Asana que têm acesso à tarefa XYZ somente podem ver (somente leitura) os dados do problema vinculado no Jira. Caso queira manter a privacidade dos dados do Jira na Asana, você tem a opção de definir seus projetos ou tarefas como privados.

É possível criar ou conectar tarefas Asana a problemas do Jira no Jira?

Não. A integração exige que a tarefa seja criada na Asana e, então, conectada a um problema do Jira já existente.

Como remover a autorização da integração ou mudar a conta do Jira

Os usuários podem remover a autorização ao revogar o acesso à Asana para a integração com o Jira Server no Jira.

  1. Ir para Account Settings (configurações da conta) > Connected Apps (aplicativos conectados) > clicar em Revoke Access

Da próxima vez que o usuário tentar anexar ou criar um novo problema do Jira, ele precisará solicitar autorização novamente.

Para conectar outra instância do Jira Server ao espaço de trabalho da Asana, entre em contato com o suporte da Asana.