Integre o airfocus com o Azure DevOps.

Benefícios de usar a integração do Azure DevOps

• Importe itens de trabalho do Azure DevOps para o airfocus.
• Envie itens do airfocus para o Azure DevOps (como qualquer tipo de item de trabalho).
• Filtros flexíveis (via Pesquisa de Problemas do Azure DevOps).
• Mapeamento flexível para sistema e campo personalizado com direções de sincronização configuráveis por campo.
• Mapeie diretamente as descrições do Azure DevOps para as descrições do airfocus.
• Exiba suas iterações (sprints) no airfocus para contextualizar o valor e as prioridades do negócio.

Configure a integração.

A integração na airfocus sempre se conecta a um espaço de trabalho específico da airfocus. Você pode adicionar várias integração do Azure DevOps a um determinado espaço de trabalho (por exemplo, de diferentes projetos do Azure DevOps ou para diferentes tipos de itens de trabalho).

Para configurar a integração Azure DevOps, siga estas etapas:

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 Azure DevOps.
3. Clique em Extensões no canto superior direito da página.
4. Selecione Gerenciar integração.
   
5. Clique em Conectar no bloco "Azure DevOps".

A partir daqui, os passos variam dependendo do tipo de instância. Leia as seções abaixo para obter instruções sobre cada uma delas.

Conecte-se à sua conta do Azure DevOps Cloud.

Para continuar a configuração da integração para uma conta do Azure DevOps Cloud, siga estes passos:

1. Selecione Azure Cloud no seletor de tipo de instância.
2. Clique em Prosseguir.

Você será redirecionado para o Azure DevOps para autenticar suas permissões de acesso e, após fazer login em sua conta, será redirecionado para a página de integração do airfocus em seu espaço de trabalho.

Para garantir uma integração bem-sucedida, certifique-se de que a configuração "Acesso a aplicativos de terceiros via OAuth" esteja ativada na tela de políticas da organização no Azure DevOps.

Conecte-se à sua conta do Azure DevOps Server (local).

Para continuar a configuração da integração para uma conta do Azure DevOps Cloud, siga estes passos:

1. Selecione Azure On-Premise no seletor de tipo de instância.
2. Clique em Prosseguir.
3. Insira os detalhes para se conectar à sua instância do Azure DevOps Server.
   • URL base: Insira a primeira parte da URL do seu servidor Azure DevOps (tudo o que vem antes do final do seu domínio/endereço IP e antes da primeira barra invertida). Por exemplo: https://198.254.533.325. O URL precisa ser acessível pelos nossos servidores, portanto, você não pode usar URL hospedado localmente aqui.
   • Token de acesso pessoal: Obtenha seu token de acesso pessoal acessando a seção de tokens de acesso pessoal nas configurações de segurança do seu usuário do Azure DevOps. Para obter mais detalhes, consulte a seção "Obter um token de acesso pessoal" abaixo.
   • Nome da organização: Insira o nome exato da organização do Azure DevOps que você deseja sincronizar com o airfocus.
4. Clique em Prosseguir para conectar seu airfocus Equipe à sua organização do Azure DevOps.

Obtenha um token de acesso pessoal

Para obter seu token de acesso pessoal no Azure DevOps, siga estas etapas:

1. Abra as configurações de segurança do ADO.
2. Selecione "Tokens de acesso pessoal" no menu de navegação à esquerda da página.
3. Clique em + Novo Token na parte superior da página.
4. Crie um novo token com, no mínimo, as seguintes permissões:
   • Tarefas (ler e escrever)
   • projeto e Equipe (leia)
   • Os tokens de acesso pessoal podem ser configurados para terem uma validade máxima de 1 ano. Lembre-se de manter a validade do seu token atualizada para garantir que sua integração com o airfocus funcione sem interrupções.
5. Clique em Criar.
6. Copie o token e cole-o nas configurações de integração do airfocus.

Configure seus filtros de integração

Para configurar seus filtros de integração:

1. Selecione o projeto do Azure DevOps com o qual você deseja integrar. Adicione as seguintes informações para que o airfocus saiba para onde enviar os dados:
   • Organização
   • Projeto
   • Área
2. Opcionalmente, inclua os itens de trabalho de todas as subáreas da área selecionada marcando a caixa ao lado de "Incluir itens de trabalho de todas as subáreas da área selecionada".

Você pode especificar ainda mais quais itens de trabalho deseja sincronizar usando o campo de pesquisa de problemas do Azure DevOps nas configurações de integração. Ele oferece uma busca rápida e flexível em todos os seus itens de trabalho em todos os seus projetos (por exemplo, t:epic AND s:new).

Comum

• Para filtrar por tipo de item de trabalho do Azure DevOps:
  • t:épico
  • t:recurso
  • t:história
  • t:0s

Para incluir itens com um marcador específico do Azure DevOps

• marcador:marcador abc

Para incluir itens com uma iteração específica do Azure DevOps.

• iteração:iteração abc

Leia mais sobre pesquisa avançada aqui.

Configure o mapeamento de seus campos.

Use o mapeamento para definir como as informações no Azure DevOps devem ser mapeadas para o airfocus (e vice-versa). Os nomes dos itens (obrigatórios) e as descrições dos itens (opcionais) são sempre mapeados por padrão ao configurar uma nova integração.

Como definir as direções do mapa

Defina para cada um dos seus campos se deseja uma sincronização unidirecional ou bidirecional entre o campo no Azure DevOps e o airfocus.

Defina as direções de mapeamento para todos os campos de uma só vez com o menu suspenso "Definir direção".

Por padrão, a direção do mapeamento é definida do Azure DevOps para o airfocus apenas e pode ser alterada pelo usuário para qualquer outra opção disponível para mapeamento.

Como adicionar um novo mapeamento de campo

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

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

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 Azure DevOps.

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 Azure DevOps 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.

Visão geral de todas as opções de mapeamento de campo atualmente disponíveis.

Notas

1. ⚠️ Se a descrição estiver sincronizada em ambas as direções, isso pode fazer com que o airfocus faça pequenas alterações no conteúdo e na formatação das descrições do Azure DevOps. Isso ocorre porque nem todos os estilos do Azure DevOps são suportados nativamente no airfocus ainda.
2. O mapeamento nessa direção não é compatível se o campo de destino no ADO estiver configurado como somente leitura.
3. Isso inclui apenas campos numéricos personalizados do ADO. Embora quaisquer campos numéricos do sistema precisem ser implementados separadamente (como, por exemplo, Prioridade ou Esforço). Portanto, se um campo numérico do sistema não for mencionado explicitamente nesta tabela, significa que ainda não é suportado.
4. Listas de opções com valores personalizados permitidos não são adequadas para mapeamento em campos de seleção do airfocus, pois a quantidade de opções de seleção, nesse caso, é dinâmica e pode mudar frequentemente ao longo do tempo, o que exigiria a reconfiguração do mapeamento de integração sempre que um novo valor aparecesse na lista de opções. É por isso que mapeamos essas listas de opções para campos de texto ou numéricos comuns no airfocus, para que quaisquer novos valores no lado do ADO sejam sempre sincronizados automaticamente com o lado do airfocus.
5. Isso inclui campos personalizados de data e hora, bem como campos do sistema como Data de Início, Data Alvo, Data de Vencimento, Data de Resolução e Data de Alteração de Estado.
6. ⚠️ No momento, o airfocus não suporta campos de data e hora (com a parte da hora), apenas campos de data. Portanto, mapear campos de data e hora do ADO para campos de data do airfocus em ambas as direções resulta na perda da parte da hora no lado do ADO - a hora será redefinida pelo airfocus para 00:00:00.
7. Atualmente, o ADO não possui campos de intervalo de datas integrados. No entanto, é possível mapear um par de quaisquer campos de data e hora ADO compatíveis em um campo airfocus de intervalo de datas.
8. Mapear o campo Stack Rank do airfocus de volta para Microsoft Azure DevOps pode levar a um comportamento inesperado. A documentação da Microsoft recomenda não atualizar esse campo manualmente, pois Microsoft Azure DevOps calcula dinamicamente a classificação da pilha em segundo plano para manter as prioridades do backlog. É melhor utilizado como uma sincronização unidirecional do ADO para airfocus.

Sincronização de hierarquia

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

Para configurar/habilitar a sincronização de hierarquia para o Azure DevOps, você precisará de:

• Dois ou mais espaços de trabalho com hierarquia airfocus habilitada entre eles OU um espaço de trabalho que permite relações de hierarquia dentro do mesmo espaço de trabalho.
• Dois ou mais tipos de itens de trabalho do Azure DevOps 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 configuração de 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 do Azure DevOps, ative o widget "Vinculação automática de itens".
   
3. Para garantir a manutenção da hierarquia, certifique-se de que o espaço de trabalho atenda aos seguintes requisitos:
   • O outro espaço de trabalho possui integração com a mesma organização do Azure DevOps.
   • 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.

Observe o seguinte ao habilitar a sincronização de hierarquia para o Azure DevOps:

• 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 sincronização de hierarquia para Azure DevOps também pode ser configurada no mesmo espaço de trabalho, se vários tipos de itens de trabalho do Azure DevOps estiverem sincronizados com o mesmo espaço de trabalho airfocus (por meio de uma integração única ou múltipla) e tiver habilitado 'Permitir relações de hierarquia dentro deste espaço de trabalho' no guia Hierarquia nas configurações do espaço de trabalho.

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

Outras configurações

• Quando a opção "Arquivar problemas desconhecidos" está habilitada, os itens importados anteriormente são arquivados no airfocus se não estiverem mais presentes no Azure DevOps ou se não se enquadrarem mais nos filtros definidos para a integração.
• Quando a opção "Sincronização automática" está ativada, sua integração é sincronizada automaticamente a cada 10 minutos e sempre que você acessa o espaço de trabalho.
• Clique em visualizações logs para visualizar seus logs de atividade de integração do Azure DevOps e ver quais alterações foram feitas antes da última sincronização.
  

Para salvar suas configurações e importar seus itens para o airfocus, clique em Atualizar e sincronizar.

Endereços IP estáticos para adicionar à lista de permissões para sua integração com o Azure DevOps.

Equipes em https://app.airfocus.com ou https://app.us.airfocus.com  Use 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

Informações importantes

• Para criar/autenticar uma nova integração com o Azure DevOps, a conta do Azure DevOps utilizada deve ter acesso de Administrador.
• Modificar uma integração existente no airfocus requer apenas que o usuário tenha permissões totais no espaço de trabalho.
• Mesmo que o usuário do airfocus não tenha acesso à conta do Azure DevOps usada para a configuração inicial, a conta do Azure DevOps deve manter as mesmas permissões para garantir que a integração funcione sempre.
• Se uma sincronização bidirecional já tiver sido ativada, ela será aplicada a todos os mapeamentos sempre que possível. Caso contrário, a conexão será configurada como unidirecional, do Azure DevOps para o airfocus.
• Se a opção "Exibir descrição do Azure DevOps" estiver ativada, a integração sincronizará a descrição com o campo especial somente leitura até 31 de março de 2023. Os usuários precisam migrar manualmente para o novo mapeamento de campos de descrição na seção de mapeamento de campos de sua integração. A partir de 1º de abril de 2023, o campo de descrição especial (e sua opção de ativação/desativação) não estará mais disponível.

Dar feedback sobre este artigo