Integre o airfocus com o Jira.

Benefícios

Conecte seus fluxos de trabalho de gerenciamento de produtos, estruturas de priorização e roteiro com o desenvolvimento diário, sincronizando seus dados perfeitamente entre o airfocus e o Jira. A integração é compatível com Jira Cloud, Jira Server e Jira Data Center.

• Importe os problemas do Jira (como itens) para o airfocus.
• Envie os itens do airfocus para o Jira (como qualquer tipo de problema).
• Sincronização bidirecional e chave flexível (JQL personalizada).
• Mapeamento de campo flexível.
• Exiba suas pontuações de prioridade do airfocus no Jira para contextualizar o valor e as prioridades do negócio.
• Capacidade de visualizar a relação pai-filho diretamente no airfocus.

Requisitos

• No airfocus: O usuário precisa ter permissões "Completas" para o espaço de trabalho no qual deseja configurar a integração com o Jira.
• No Jira: são necessárias permissões de "Administrador" para estabelecer a conexão entre sua instância do Jira e o airfocus Equipe.
• Se a ligação entre a instância do Jira e o airfocus Equipe já tiver sido estabelecida, qualquer usuário do Jira com pelo menos a permissão "Criar_Problema" para um projeto poderá configurar uma nova integração com essa instância.
• Nossa integração com o Jira é compatível com o Jira Cloud, o Jira Server e o Jira Data Center. Oferecemos suporte a todas as versões do Jira Server listadas na Política de Fim de Vida Útil do Suporte da Atlassian. Versões anteriores às listadas atingiram o fim da vida útil (EOL) e podem funcionar, mas não são mais suportadas.

Configure a integração com o Jira.

1. Cadastre-se no airfocus ou faça login na sua conta existente. 
2. Crie um novo espaço de trabalho no airfocus ou selecione aquele com o qual deseja integrar o Jira.
   • Você precisa autorizar sua instância do Jira apenas uma vez por equipe do airfocus.
   • Você pode adicionar várias integração do Jira a um determinado espaço de trabalho (por exemplo, de diferentes projetos ou instâncias do Jira).
3. Clique em Extensões no canto superior direito do seu espaço de trabalho.
4. Selecione Gerenciar integração.
5. Clique em Conectar no bloco "Jira".
6. Selecione " Conectar uma nova instância do Jira"no menu suspenso que aparece.
7. Insira o URL base da sua instância do Jira (por exemplo, https://airfocustest.atlassian.net/ ou https://jira.mycompany.com).
8. Clique em Prosseguir.
9. Copie o “URL do aplicativo”. Você precisará disso para as próximas etapas no Jira.
10. Clique em Centro de links do aplicativo Jira para abrir o Centro de links do aplicativo Jira.
    • Você precisa ser um administrador do Jira para acessar esta página. 

Os próximos passos variam para o Jira Cloud e o Jira Server/Data Center. Confira a seção abaixo para sua instância para continuar.

Criar um link de aplicativo no Jira Cloud

1. No Jira Cloud, clique no ícone de Configurações no canto superior direito.
2. Selecione os aplicativos do Jira. 
3. Na seção “integração” no lado esquerdo, clique em links de aplicativos.
4. Clique no botão Criar link no canto superior direito da página.
5. Selecione a opção “Link direto para o aplicativo”.
6. Cole o URL do seu airfocus como "URL do aplicativo".
7. Clique em Avançar.
8. Digite um nome para o aplicativo e certifique-se de que o tipo de aplicativo esteja definido como "Aplicativo genérico".
9. Utilizando as informações fornecidas no airfocus, copie e cole o Nome do Provedor de Serviços, a Chave do Consumidor, o Segredo Compartilhado, URL do Token de Solicitação, URL do Token de Acesso e URL de Autorização no Jira.
10. Marque a caixa ao lado de “Criar link de entrada”.
11. Clique em Continuar.
12. Utilizando as informações fornecidas no airfocus, copie e cole a Chave do Consumidor, o Nome do Consumidor e a Chave Pública no Jira.
13. Clique em Continuar.
14. Volte ao airfocus e clique em Concluir configuração.

Iremos redirecioná-lo para a etapa de autorização OAuth, que permite que o airfocus use seu usuário do Jira para sincronizar itens entre os dois sistemas. Clique em Permitir para autorizar o airfocus a sincronizar com sua conta.

Crie um link de aplicativo no Jira Server ou no Jira Data Center.

1. Clique no link Criar, no canto superior direito.
2. Selecione o produto Atlassian.
3. Cole o URL do seu airfocus como "URL do aplicativo".
4. Clique em Continuar para confirmar.
   
5. Preencha os valores fornecidos na interface do airfocus.
6. Clique em Continuar.
7. Copie os valores da Etapa 3. 
8. Clique em Continuar. 
   • Você deverá ver agora uma confirmação no Jira.
9. Volte ao airfocus e clique em Concluir configuração.

Iremos redirecioná-lo para a etapa de autorização OAuth, que permite que o airfocus use seu usuário do Jira para sincronizar itens entre os dois sistemas. Clique em Permitir para autorizar o airfocus a sincronizar com sua conta.

Configurar filtros de integração

1. Selecione o projeto que deseja sincronizar. Você pode digitar para filtrar a lista de projetos.
   • Os projetos que você consegue visualizar, mas para os quais não possui as permissões CREATE_ISSUES, são marcados como tal (disponíveis apenas para o Jira Cloud).
   • O nome da sua integração é criado automaticamente com base no projeto. Você também pode alterar isso mais tarde.
2. Selecione o tipo de problema que deseja sincronizar. 
   • Como os campos podem variar entre os tipos de problema (dependendo da sua versão do Jira e do tipo de projeto, ou seja, gerenciado pela equipe ou pela empresa), isso restringe os campos que você pode mapear àqueles que estão realmente disponíveis no tipo de problema selecionado.
   • Se você deseja sincronizar vários tipos de problemas, recomendamos configurar uma integração cada, seja no mesmo espaço de trabalho ou em vários espaços de trabalho. Você pode conectar integração de outros espaços de trabalho (por exemplo, para Epics ou Sub-tarefas) através da hierarquia airfocus.
   • Você também pode filtrar ainda mais os problemas sincronizados fornecendo uma consulta JQL nos filtros de problemas (saiba mais sobre JQL aqui).

Mapear campos do airfocus e do Jira

Utilize o mapeamento para definir como as informações no Jira devem ser mapeadas para as informações no airfocus. Se você alterar um problema ou item em um sistema, o outro sistema será ajustado de acordo.

Você pode, por exemplo, definir como os status do Jira devem ser mapeados para os campos de seleção única do airfocus e/ou como os rótulos do Jira devem ser mapeados para os campos de seleção múltipla do airfocus.

Existem também muitas outras opções para mapear diferentes campos personalizados e de sistema do Jira para seus campos do airfocus.

Ao analisar as opções de mapeamento de campos, você verá que dois campos são sempre mapeados por padrão: nomes de itens e descrições de itens.

Você pode definir para cada um dos seus campos se deseja uma sincronização unidirecional ou bidirecional entre o campo no Jira e o airfocus.

Você pode definir as direções de mapeamento para todos os campos de uma só vez (dentro das possibilidades técnicas) com o botão “Definir direção”.

Por padrão, a direção do mapeamento está definida apenas do Jira para o airfocus, podendo ser alterada pelo usuário para qualquer outra opção disponível para mapeamento.

Ao configurar um novo mapeamento para um dos seus campos, você descobrirá que só é possível mapear um campo do Jira para um campo do airfocus se ambas as extremidades tiverem o mesmo tipo de campo.

Ao selecionar um campo na lista suspensa, somente os campos que corresponderem ao tipo de campo serão exibidos na lista suspensa do outro lado.

Após selecionar os dois campos que deseja mapear, você pode escolher as opções de campo e como eles devem ser mapeados.

Visão geral de todos os tipos de campos mapeáveis

Campos mapeáveis do sistema Jira:

⚠️ Aviso sobre a sincronização bidirecional do campo de descrição: O processo de sincronização bidirecional pode resultar em pequenas alterações no conteúdo e na formatação das suas descrições no Jira. Isso ocorre porque nem todos os estilos do Jira são suportados nativamente no airfocus ainda.

⚠️ Avisos sobre o mapeamento de campos de pessoas: A lógica de mapeamento é baseada nos nomes de exibição. Portanto, "Kirsten" no Jira NÃO corresponde a "Kirst" no airfocus, mesmo que ambas as contas usem o mesmo endereço de e-mail.

Caso o Jira permita apenas um valor em um campo de pessoa (por exemplo, só pode haver um responsável), a sincronização com o airfocus prioriza o primeiro valor do campo de pessoa mapeado no airfocus. Por exemplo, um ticket no Jira atribuído a "Julian" irá sobrescrever um item no airfocus que está atribuído a "Julian e Nikita". Nikita será removida do cargo e apenas Julian permanecerá alocado.

Jira campo mapeável personalizado:

Solução de problemas: Encontre o campo de intervalo de datas

Precisamos de pelo menos dois campos de data (além das versões corrigidas) para podermos mapeá-los para um campo de intervalo de datas do airfocus.

Nossa integração só consegue detectar campos de data se eles estiverem visíveis no tipo de problema (tela) sincronizado. Você precisa garantir que haja pelo menos dois campos de data no tipo de problema (tela) no Jira e que pelo menos um campo de intervalo de datas esteja disponível para mapeamento no seu espaço de trabalho do airfocus.

Como isso se parece no Jira:

• Para Jira Cloud gerenciado pela Equipe, acesse Configurações do projeto > Tipos de problema e arraste o campo da barra lateral direita para a lista de campos no meio.
• Para Jira Cloud gerenciado pela empresa (e Jira Server), acesse Configurações do projeto > Problemas > Telas e edite a tela do tipo de problema que você está sincronizando. Você pode adicionar campos de data adicionais na parte inferior.

Campos de mapeamento automático

Ao mapear campos com muitas opções, ative a opção "Mapear opções de campo automaticamente" para economizar tempo. Isso mapeia automaticamente os campos com os mesmos valores tanto no airfocus quanto no Jira.

Geração automática de valores de campo

Ative a opção "Criar campos automaticamente" para adicionar automaticamente ao airfocus os novos campos criados no Jira quando forem adicionados a um item. 

Observação: O gerador de campos de criação automática não diferencia maiúsculas de minúsculas.

Como mapear a pontuação de foco com o Jira

Com a integração do airfocus com o Jira, você pode usar o airfocus para priorização e planejamento estratégico, enquanto os desenvolvedores (e outros) usam o Jira para o planejamento diário do desenvolvimento.

Por padrão, já exibimos dados do airfocus, como pontuações de prioridade, raio, faixa e linhas do tempo no Jira. Este artigo de ajuda descreve como você pode mapear a pontuação de foco do airfocus com um campo personalizado do Jira (que você também pode filtrar no Jira).

Ao mapear a pontuação de foco do airfocus com seu projeto Jira, você poderá exibir sua métrica de prioridade número um exatamente onde as pessoas trabalham – em cada cartão de tarefa sincronizado do Jira e na capa do cartão de tarefa. Dessa forma, você conseguirá alinhar toda a sua equipe e mantê-la focada nas tarefas que realmente importam.

Para exibir a pontuação de foco do airfocus no Jira, você precisa mapeá-la com um campo personalizado do Jira. O campo personalizado deve ser do tipo "Campo numérico". A instalação leva cerca de 3 minutos.

Veja como:

1. Dentro do Jira, clique no ícone de engrenagem no canto superior direito para abrir as configurações.
2. Problemas com cliques.
3. Selecione "campo personalizado" no menu de navegação à esquerda.
4. Clique em Criar campo personalizado no canto superior direito.
5. Selecione Campo numérico como o tipo de campo.
6. Digite um nome e uma descrição (opcional).
7. Clique em Criar.
8. Associe o novo campo personalizado às telas (do seu projeto sincronizado).
   
9. Volte às configurações de integração do Jira no airfocus e selecione o campo personalizado recém-criado no menu suspenso.
   

A pontuação de foco do airfocus agora será exibida em suas tarefas do Jira.
 

Se você também quiser exibir a pontuação de foco nas capas dos seus cartões, siga estes passos:

1. Clique no ícone de três pontos no canto superior direito do seu mural.
2. Selecione as configurações do mural.
3. Clique em "Layout do cartão" no menu de navegação à esquerda.
4. Selecione o campo personalizado de pontuação de foco no menu suspenso.
5. Clique em Adicionar.
6. Agora você também encontrará a pontuação de foco no mural.
   

Configurar definições adicionais

• Quando a opção "Arquivar problemas desconhecidos" estiver ativada, os itens importados anteriormente serão arquivados no airfocus se não estiverem mais presentes no Jira (ou simplesmente não corresponderem mais aos filtros JQL).
• Quando a "Sincronização automática" estiver ativada, sua integração será sincronizada automaticamente a cada 10 minutos e sempre que você acessar o espaço de trabalho.
• Clique em visualizações logs para visualizar seus logs de atividades de integração do Jira e ver quais alterações foram feitas antes da última sincronização.

Tipos de links de itens do mapa

Você pode sincronizar tipos de links de itens — como "Blocos", "Duplicados" e "Relacionado a" — entre o Jira e o airfocus usando sincronização bidirecional ou unidirecional. Quando a sincronização bidirecional (de duas vias) está configurada para um tipo de link, qualquer atualização em uma plataforma é refletida automaticamente na outra, permitindo visualizar as dependências em cronogramas e roteiros sem duplicação manual. Para um fluxo de trabalho mais específico, você pode configurar sincronizações unidirecionais ou consolidar seus dados mapeando vários tipos de links do Jira para um único tipo de link do airfocus.

Para mapear os tipos de links de itens, siga estes passos:

1. Clique em Extensões no canto superior direito de qualquer página do airfocus.
2. Selecione Gerenciar integração.
3. Em “Integração ativa”, selecione Jira.
4. Em “Mapeamento de tipo de link do item”, clique em + Adicionar mapeamento de tipo de link.
5. Utilizando os menus suspensos, selecione um tipo de link para o Jira à esquerda e um tipo de link para o airfocus à direita.
6. Clique no ícone de seta abaixo de “Direção” para alterar se a sincronização é bidirecional ou unidirecional.
7. Opcionalmente, clique em + Adicionar tipo de link para adicionar um tipo de link adicional do Jira para mapear a um único tipo de link do airfocus.
   • Se você adicionar um tipo de link adicional, quando o airfocus sincronizar com o Jira, ele sincronizará apenas com o tipo de link principal.
8. Clique em Atualizar e sincronizar na parte inferior da página.

As relações e dependências entre itens agora serão sincronizadas entre o Jira e o airfocus de acordo com as configurações que você definiu.
 

Sincronização de hierarquia

A sincronização de hierarquia para Jira permite sincronizar automaticamente as relações pai-filho do seu projeto Jira para airfocus. Isso permite que você realize o trabalho de gerenciamento de produtos no airfocus enquanto mantém a hierarquia mais recente do Jira à vista, sem precisar alternar entre airfocus e o Jira.

Para configurar/ativar a sincronização de hierarquia no Jira, você precisará de:

• Dois ou mais espaços de trabalho com airfocus hierarquia ativada entre eles OU um espaço de trabalho que permite relações hierarquicas dentro do mesmo espaço de trabalho.
• Dois ou mais tipos de problemas do Jira sincronizados com o airfocus.
• Se você tiver duas interações em dois espaços de trabalho, sincronize um único tipo de item para cada espaço de trabalho.
• Se você tiver duas integrações em um espaço de trabalho, sincronize um único tipo de item para cada uma das integrações nesse espaço de trabalho.

Para alterar qualquer coisa na integração, o usuário precisa ter acesso total ao espaço de trabalho.

Para configurar a sincronização de hierarquia, siga estes passos:

1. Nas configurações do espaço de trabalho no airfocus, certifique-se de que a hierarquia de produtos do airfocus esteja habilitada, seja em outro espaço de trabalho ou dentro do seu espaço de trabalho atual.
   
2. Na parte inferior da página de configurações de integração com o Jira, ative o widget “Vinculação automática de itens”.
3. Você pode escolher qualquer espaço de trabalho que atenda aos seguintes requisitos:
   • O outro espaço de trabalho possui uma relação hierárquica com o atual.
   • O outro espaço de trabalho possui integração com o Jira na mesma instância do Jira.
   • O usuário tem acesso total ao outro espaço de trabalho.
   • O outro espaço de trabalho fica no mesmo airfocus Equipe.

Depois de ativar a sincronização de hierarquia, você poderá ver a relação pai-filho diretamente no airfocus.

Ao ativar a sincronização de hierarquia no Jira, observe o seguinte:

• A integração adiciona apenas as relações entre os itens sincronizados, não itens adicionais. Isso significa que os itens precisam ser sincronizados por suas respectivas integrações antes que os links de hierarquia sejam sincronizados.
• A API do Jira não revela os filhos de uma épica, o que impede o airfocus de detectar se uma épica do Jira possui algum problema filho. Para visualizar a relação entre os filhos no airfocus, o épico já precisa estar sincronizado com o airfocus ao sincronizar os problemas de nível dos filhos, para que todas as relações sejam refletidas corretamente no airfocus.

A sincronização de hierarquia para Jira também pode ser configurada no mesmo espaço de trabalho, se vários tipos de problemas do Jira estiverem sincronizados com o mesmo espaço de trabalho airfocus (seja por meio de uma integração única ou múltipla) e tiver ativado 'Permitir relações hierárquicas neste espaço de trabalho' no guia Hierarquia nas configurações do espaço de trabalho.

Para habilitar a sincronização de hierarquia no Jira, o usuário precisa ter pelo menos acesso de leitura ao projeto Jira conectado.

Observação sobre a sincronização de hierarquia para o usuário Jira data center/local:

• A hierarquia do airfocus não sincroniza com as iniciativas locais do Jira. Apenas épicos, histórias, tarefas e subtarefas.
• A hierarquia do airfocus sincroniza com todos os níveis do Jira Cloud, incluindo iniciativas, épicos, histórias, tarefas e subtarefas.

Informação adicional

Conecte vários projetos do Jira

Para conectar outro projeto do Jira da mesma instância do Jira ao seu espaço de trabalho, você não precisa passar pelo processo de autenticação novamente. Você pode adicionar outro Jira projeto integração na página integração a partir de agora. A configuração exigirá apenas a seleção da instância e o início imediato do mapeamento.

Endereços IP estáticos para adicionar à lista de permissões para a integração do seu servidor Jira.

Se você estiver integrando com um sistema de implantação local, como o Jira Server, sua equipe de TI pode precisar permitir o acesso do airfocus ao seu firewall para que ele possa se conectar ao servidor e criar registros. Você pode fazer a conexão através da porta 443.

As equipes em https://app.airfocus.com ou https://app.us.airfocus.com usam estes endereços IP:

• 46.101.71.101
• 46.101.69.142

Equipes em https://airfocus.app  Use estes endereços IP:

• 100.24.176.163
• 34.204.246.112
• 54.227.154.184
• 35.156.253.227
• 18.159.159.136
• 18.199.183.125

Solução de problemas

• Verifique se as permissões do usuário que está tentando conectar o airfocus ao Jira atendem aos requisitos.
• Verifique se há avisos ou campos ausentes na seção de mapeamento de campos.
• Clique no botão "depurar" na parte inferior das configurações de integração. Durante a sincronização, vários endpoints da API são chamados. Se um deles falhar, é difícil dizer qual. A caixa de diálogo depurar mostra todas as chamadas e seus resultados, para facilitar a localização de uma configuração incorreta.
• Exclua e reinstale a integração. Dica: A configuração do link do aplicativo para conectar o airfocus ao Jira permanece.
• Entre em contato com nossa adorável Equipe sucesso dos clientes para obter suporte adicional.

Dar feedback sobre este artigo