Integre o airfocus com o GitHub

Benefícios da integração com o GitHub

• Importe os problemas do GitHub (como itens) para o airfocus.
• Envie os itens do airfocus para o GitHub (como issues do GitHub).
• Exibir alterações de status de problemas do GitHub (aberto/fechado) no airfocus
• Mantenha os campos dos seus itens sincronizados entre os dois sistemas, incluindo título, descrição, marcador/etiqueta e status (aberto/fechado).
• Escolha uma integração unidirecional em vez de bidirecional se não quiser permitir alterações em tarefas do GitHub a partir do airfocus, mas ainda assim quiser ver o progresso das suas tarefas do GitHub dentro do airfocus.

Limitações atuais

• Atualmente não é possível mapear os status do GitHub para airfocus raia, faixa. O status (aberto/fechado) das tarefas importadas e sincronizadas do GitHub será exibido nas visualizações do item.
• Ainda não é possível exibir sua pontuação do airfocus em sua issue do GitHub.
• Atualmente, não é possível integrar com o GitHub em um ambiente local.

Configurando sua integração com o GitHub

Para configurar a integração no GitHub, o usuário deve ter a função de Administrador no airfocus e a função de Administrador do repositório no GitHub. Navegue até o espaço de trabalho do airfocus no qual você deseja configurar a integração com o GitHub.

Acesse a página de integração, localize a integração com o GitHub e clique em Conectar.

Você precisará autorizar sua conta do GitHub, concedendo acesso a todas as organizações do GitHub que deseja que sejam acessíveis pelo airfocus. Após a autorização, você poderá configurar sua integração. Selecione um nome para sua integração (o nome não afeta muito o funcionamento, mas ajudará você a identificar qual integração é, já que você pode conectar cada espaço de trabalho a um repositório diferente do GitHub).

Use o menu suspenso para selecionar o repositório associado à sua conta do GitHub do qual você deseja importar os problemas. Além disso, você também pode filtrar seus problemas por etiqueta. Por padrão, todos os problemas serão importados e sincronizados. Observação: você só poderá ver os locais onde tiver permissão explícita para acessar, com pelo menos permissões de leitura. As permissões podem ser concedidas em uma organização do GitHub em “Configurações > Privilégios de membros > Permissões básicas” ou em cada repositório específico em “Configurações > Colaboradores e Equipe > Gerenciar acesso”.

Opcional: mapeie suas etiquetas do GitHub com as etiquetas do airfocus para garantir uma sincronização perfeita das etiquetas. Não se esqueça de clicar em "Adicionar" depois de conectar as etiquetas.

Opcional: defina se uma etiqueta de sua escolha deve ser anexada a cada item do GitHub que for importado e sincronizado com o airfocus.

Escolha integração de 1 ou 2 vias e se itens desconhecidos devem ser Arquivar.

Depois de clicar em Salvar e sincronizar, você terminou. Parabéns, você configurou com sucesso a integração com o GitHub. 🎉

Enviando itens do airfocus para o GitHub

Quando seu épico ou recurso estiver pronto para desenvolvimento, você pode enviá-lo para o GitHub com três cliques:

1. Clique no item que deseja selecionar para abrir a caixa de diálogo do item (detalhes do item).
2. Clique no botão "Push to integração" no canto inferior direito e
3. Selecione GitHub (ou escolha entre vários GitHubs se você tiver configurado mais de uma integração com o GitHub).
   

Todas as funcionalidades ou épicos (itens do airfocus) enviados para o GitHub se tornam problemas. Observe que, por padrão, as tarefas criadas não são atribuídas a nenhum projeto do GitHub e, portanto, não aparecerão diretamente no seu mural do GitHub.

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

Dar feedback sobre este artigo