Migrar do Jira para o Jalonio, passo a passo.

CSV ou API: que método escolher?

• Exportação CSV: disponível para os responsáveis de projeto (para o respetivo projeto) e para as pessoas autorizadas a criar projetos. Prática para um primeiro ensaio, ou se o seu Jira só for acessível na sua rede interna.
• Ligação pela API: reservada aos administradores da organização. Mais completa: traz também os sprints, todos os comentários e os anexos, sem ficheiros para manusear. Funciona com o Jira Cloud e o Jira Data Center.

Antes de começar

• Convide primeiro a sua equipa para o Jalonio: as pessoas do Jira são associadas às contas existentes pelo endereço de e-mail ou pelo nome.
• Anote a chave do projeto Jira (por exemplo PORT): ao reutilizá-la no Jalonio, PORT-12 continua a ser PORT-12.
• Para a API, verifique se a conta Jira utilizada pode consultar o projeto. Um acesso só de leitura basta.
• Avise a equipa: após a importação, o Jalonio passa a ser a referência.

Método 1: importar uma exportação CSV

1. Exportar do Jira. Nos filtros do Jira, pesquise os tickets do projeto e exporte a pesquisa em CSV (todos os campos). Para os anexos, prepare se necessário um arquivo ZIP com os seus ficheiros.
2. Abrir o ecrã de importação. No Jalonio: «Projetos» e depois «Importar do Jira».
3. Ficheiro e projeto. Largue o ficheiro CSV (50 MB no máximo; a codificação e o separador são detetados) e o arquivo ZIP dos anexos, se o tiver: os ficheiros são associados pelo nome. Escolha «Novo projeto» ou «Projeto existente».
4. Correspondências. «Analisar o ficheiro»: o Jalonio propõe uma correspondência para cada coluna, cada estado, tipo e prioridade, e cada pessoa. Tudo pode ser alterado. As exportações do Jira em inglês e em francês são ambas reconhecidas. As colunas do título («Summary») e da chave («Issue key») são obrigatórias.
5. Simulação. A simulação não escreve nada. Verifique os números (tickets a criar, a atualizar, ignorados), os problemas linha a linha e a pré-visualização dos 10 primeiros tickets.
6. Importação. «Iniciar a importação»: o progresso é apresentado e é notificado quando termina.
7. Relatório. Tickets criados, atualizados, ignorados, anexos não importados. «Transferir o relatório detalhado (CSV)» guarda um registo da migração.

Método 2: ligar ao Jira pela API

1. Criar um token no Jira. Jira Cloud: a página de tokens de API da sua conta Atlassian, «Create API token», com uma duração curta. Jira Data Center: o seu perfil, «Personal Access Tokens», com uma data de expiração.
2. Escolher a origem. No Jalonio: «Projetos», «Importar do Jira» e depois «Ligação ao Jira (API)».
3. Testar a ligação. Escolha Cloud ou Data Center, cole o endereço do Jira, o endereço de e-mail da conta (Cloud) e o token, e depois «Testar a ligação». Qualquer erro é explicado em linguagem simples: credenciais recusadas, permissão em falta, endereço não encontrado, certificado inválido.
4. Escolher os projetos. O projeto Jira e o projeto Jalonio de destino: por predefinição, um novo projeto com o mesmo nome e a mesma chave, para manter os números.
5. Ler os tickets. «Ler os tickets do Jira» mostra o progresso. Se o Jira limitar o número de pedidos, a leitura abranda e depois retoma sozinha.
6. Terminar como no CSV. Correspondências (sprints incluídos), simulação, importação e relatório.

O token é guardado cifrado durante a importação e depois apagado: no fim, em caso de falha, ou se clicar em «Cancelar e apagar as credenciais». Revogue-o também no Jira quando a importação terminar.

O que é transferido, e o que não é

O tempo despendido não é transferido porque o Jalonio não oferece registo de tempo. A chave original do Jira continua visível em cada ticket e pode ser encontrada pela pesquisa.