Integre o airfocus com o Atalho.

Benefícios

Utilize a integração flexível do airfocus com Atalhos para priorizar suas histórias e épicos e criar um roteiro mais eficaz. Colabore na sua avaliação de prioridades para garantir que as tarefas certas sejam realizadas. Nossa integração com o Shortcut mantém a estratégia de alto nível em sincronia com o desenvolvimento do dia a dia.

• Importe épicos e histórias do Shortcut (como itens) para o airfocus.
• Adicione itens priorizados ao Atalho para desenvolvimento e acompanhe o status deles diretamente do airfocus.
• Crie um fluxo de trabalho flexível de filtros e mapeamento, por exemplo. Mapear vários estados de atalho para o mesmo estado de airfocus.
• Mantenha os campos sincronizados entre os dois sistemas, incluindo título, descrição, estado/raia, faixa e etiqueta (sincronização bidirecional).

Configuração inicial

Navegue até o espaço de trabalho do airfocus no qual você deseja configurar a integração do Atalho. Vá em “Extensões ” e depois em “Adicionar integração ”. Localize a integração do Atalho e clique em "Conectar".

Insira um token da API Shortcut. Para gerar um, abra o app Atalhos, vá em Configurações > Sua conta > Tokens de API e gere um token de API. Clique em "Prosseguir".

Observações:

• Ao configurar a integração do Shortcut no airfocus, você precisa escolher se deseja importar e sincronizar épicos ou histórias do Shortcut com o airfocus.
• Você só pode integrar um fluxo de trabalho do Atalho por vez. Se você deseja integrar a) vários fluxos de trabalho do Shortcut ou b) tanto o fluxo de trabalho (com seu projeto e histórias) quanto as épicas no mesmo espaço de trabalho do airfocus, configure várias integrações.

integração

Primeiro, você precisa escolher se deseja sincronizar seus épicos ou histórias do Atalho.

Se você selecionou histórias, pode refinar ainda mais a seleção de itens para sincronização da seguinte forma:

• Opcionalmente, você pode escolher um projeto se ainda estiver usando esse recurso antigo no Atalho.
• Opcionalmente, é possível escolher rótulos para limitar a importação. Se você deixar este campo vazio, todas as histórias que corresponderem aos filtros restantes serão consideradas.

Se você selecionou itens épicos, pode refinar ainda mais a seleção de itens para sincronização, escolhendo opcionalmente rótulos para limitar a importação.

Mapeamento de campo

Use o mapeamento para definir como as informações no Atalho devem ser mapeadas para o airfocus (e vice-versa). Os nomes das histórias/épicos (obrigatórios) e as descrições (opcionais) são sempre mapeados por padrão ao configurar uma nova integração.

Como definir as direções do mapa

Você pode definir para cada um dos seus campos se deseja uma sincronização unidirecional ou bidirecional entre o campo no Shortcut 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 de Atalho para 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 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.

Opções de mapeamento de campos para histórias

Opções de mapeamento de campos para épicos

⚠️ AVISO: o usuário agora pode ativar a sincronização bidirecional para o campo de descrição. No entanto, o processo de sincronização bidirecional pode resultar em pequenas alterações no conteúdo e na formatação das descrições dos seus Atalhos. Isso ocorre porque nem todos os estilos de atalho são suportados nativamente no airfocus ainda.

Notas

• Os campos do airfocus que são mapeados de forma unidirecional do Atalho para o airfocus tornam-se campos somente leitura no airfocus, pois quaisquer alterações feitas pelo usuário serão sobrescritas na próxima sincronização.
• Se um dos campos de data no Atalho não estiver definido ou se uma épica do Atalho tiver uma data de vencimento definida para antes da data de Início, o airfocus preencherá a data de Início com uma data um dia antes da data de vencimento.
• Você pode definir qual rótulo deseja anexar aos itens de trabalho do Atalho sincronizados por padrão, caso tenha pelo menos um mapeamento de campo de seleção múltipla configurado. (A configuração aparecerá como uma subseção desse mapeamento).

Outras configurações

Quando a opção "Arquivar itens desconhecidos" estiver ativada, os itens importados anteriormente serão arquivados no airfocus, caso não estejam mais presentes no Atalho ou não se enquadrem mais nos filtros definidos para a integração.

Quando a opção "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.

Ao clicar em "visualizações logs", você pode visualizar seus logs de atividades de integração do Shortcut e ver quais alterações foram feitas antes da última sincronização.

Para salvar suas configurações e importar suas histórias/épicos para o airfocus, clique em Atualizar e sincronizar.

Dar feedback sobre este artigo