Jira

No LaunchCal, um lançamento pode acompanhar o épico do Jira, ou qualquer item, em que o trabalho dele é registrado. O status dele muda quando o do item muda, ele mostra quantos itens filhos de um épico estão concluídos, e os comentários do item aparecem no lançamento.

Um projeto inteiro do Jira não tem status próprio, então um link para um fica guardado como link simples: vincule um dos épicos ou itens dele para acompanhá-lo.

O Taktoria só lê do Jira (itens com o status, os itens filhos e os comentários, e os nomes de quem os escreveu): nunca cria, altera nem comenta nada lá.

Só um proprietário ou administrador do espaço de trabalho pode conectar o Jira.

1. Abra Configurações → Integrações.
2. Em Sistemas de tickets, selecione Conectar o Jira.
3. Faça login na Atlassian, escolha os sites do Jira a conectar e aprove.

O Taktoria lê o Jira como a conta da Atlassian que o conecta. Qualquer item que essa conta possa ver pode ser vinculado a um lançamento, e seus comentários mostrados nele, por qualquer pessoa que possa editar o lançamento, mesmo alguém que não consiga abrir o item no Jira. Por isso, conecte o Jira com uma conta reservada para o Taktoria, que veja só os projetos que seus lançamentos acompanham, em vez da sua. Uma conexão feita com a conta de uma pessoa também para de sincronizar quando ela sai ou perde o acesso.

Qualquer pessoa que possa editar um lançamento pode vinculá-lo, sincronizá-lo ou desvinculá-lo.

1. Abra a aba Detalhes do lançamento.
2. Em Projeto de tickets, cole em Link do projeto o endereço do épico ou item: a página dele, ou um quadro ou lista com ele aberto.
3. Selecione Vincular projeto.

O item precisa estar em um site do Jira conectado, e ser um que a conta que o conectou consiga ver. Ele sincroniza na hora. Um link colado antes de o Jira ser conectado fica guardado como link simples, e começa a sincronizar assim que ele for conectado.

Um assistente de IA conectado ao LaunchCal, e a API REST, também podem vincular, sincronizar e desvincular um lançamento, com as mesmas regras.

Um lançamento vinculado é sincronizado uma vez por dia até ser lançado, e sempre que alguém seleciona Sincronizar agora.

• Status: quando o status do item muda, o do lançamento acompanha: a fazer vira Escopo, em andamento vira Em desenvolvimento (um lançamento que já está em Design ou Testes continua lá), e um item concluído como “não será feito” ou duplicado vira Em espera. Um status que você escolhe no LaunchCal vale até o do item mudar de novo.
• Progresso: a parcela dos itens filhos do épico que estão concluídos.
• Comentários: cada comentário do item vira um comentário na aba Atividade do lançamento, marcado Do Jira com um link para ele. Um comentário restrito a algumas pessoas no Jira nunca é trazido. Edite um no Jira e a próxima sincronização traz a mudança.
• Concluído: quando o item é concluído, o lançamento avisa que está pronto e os responsáveis são notificados.

O que uma sincronização altera aparece como feito pelo Jira, no histórico do lançamento, no que é enviado aos responsáveis e no log de auditoria. O log de auditoria registra que um comentário chegou ou mudou, nunca o que ele diz nem quem ele menciona.

• Nunca lança nada. Um item concluído deixa o lançamento pronto; alguém ainda precisa selecionar Aperte para lançar! quando as revisões obrigatórias forem decididas.
• Nunca altera um lançamento que já foi lançado.
• Nunca escreve no Jira.
• Nunca traz um comentário restrito a algumas pessoas.
• Nunca desfaz um status que você escolheu no LaunchCal, a menos que o status do item mude de novo.

Desvincular, na aba Detalhes do lançamento, interrompe a sincronização desse lançamento; o que já foi trazido continua.

Desconectar, em Configurações → Integrações, interrompe a sincronização de todos os lançamentos com o Jira. Os lançamentos mantêm o que vinculam e tudo o que foi sincronizado até então, e voltam a sincronizar assim que o Jira é conectado de novo. Desconectar o Jira também remove os nomes dos usuários do Jira dos comentários que ele trouxe, como a Atlassian exige: um comentário mantém o texto, mas não o nome de quem o escreveu, e uma menção aparece como @someone. O mesmo acontece com os nomes de uma pessoa quando a Atlassian informa que a conta dela foi encerrada.

A Atlassian não oferece ao Taktoria nenhuma forma de retirar o próprio acesso ao Jira: para removê-lo por completo, remova também o Taktoria dos apps conectados na sua conta da Atlassian.

• O item não foi encontrado: ele foi excluído, movido ou está em um lugar que a conta que o conectou não vê. Dê a essa conta acesso ao projeto dele, ou vincule o endereço atual.
• O Jira recusou a conexão: um proprietário ou administrador do espaço de trabalho conecta o Jira de novo em Configurações → Integrações. Isso acontece quando a conta que o conectou sai ou perde o acesso.
• O Jira não respondeu na última sincronização: a próxima tenta de novo, ou selecione Sincronizar agora mais tarde.
• Um projeto inteiro não é sincronizado: ele não tem status próprio. Vincule um dos épicos ou itens dele.
• Falta um comentário: comentários restritos a algumas pessoas no Jira nunca são trazidos.