Jira: integração bidirecional com o Clockify

Nosso aplicativo gratuito para o Jira permite acompanhar o tempo gasto em tarefas diretamente do Atlassian Jira com apenas um clique.

O aplicativo do Clockify para o Jira está disponível na versão web do Jira, nos aplicativos móveis do Jira para Android e iOS e também no aplicativo para desktop do Jira para macOS.

Como instalar o aplicativo do Clockify para o Jira #

O administrador do Jira precisa instalar o aplicativo do Clockify a partir do Atlassian Marketplace.

Para instalar o aplicativo Clockify a partir do Atlassian Marketplace:

1. Acesse a página do Clockify: Controle de tempo e sincronização bidirecional de planilhas no Atlassian Marketplace
2. Clique no botão azul Obter agora no canto superior direito
3. Faça login na sua conta da Atlassian (caso ainda não tenha feito) e verifique se possui permissões de administrador do site na sua instância do Jira
4. Escolha a URL específica do Jira Cloud (por exemplo, suaempresa.atlassian.net) na qual deseja instalar o aplicativo
5. Clique em Revisar
6. Revise as permissões e os termos do aplicativo
7. Clique em Obter agora

Conectar sua conta Clockify #

Como conectar sua conta do Clockify:

1. Faça login no Jira Data Center
2. Acesse a página Meu perfil
3. Selecione Tokens de acesso pessoal no menu lateral esquerdo
4. Clique em Criar token
5. Cole o token nas configurações do aplicativo do Clockify
6. Clique em Enviar token

Como instalar o Jira a partir do Clockify #

Você também pode instalar a integração com o Jira a partir do Clockify.

1. Acesse o Atlassian Marketplace e pesquise por Clockify (certifique-se de instalar o aplicativo desenvolvido pela CAKE.com)
2. Acesse Configurações do espaço de trabalho
3. Clique em Integrações e complementos na barra lateral
4. Expanda o menu suspenso do complemento do Jira
5. Clique em Instalar plug-in do Jira

Jira Cloud + Clockify Cloud

1. Acesse o Atlassian Marketplace e encontre o Clockify (certifique-se de instalar o aplicativo desenvolvido pela CAKE.com).
2. Clique em Obter agora
3. Selecione o local onde deseja instalar o aplicativo na lista suspensa. 
4. Siga as instruções para rever as permissões e concluir a instalação.

Jira Data Center(Servidor do Jira) + Clockify Cloud

Jira Cloud + Clockify

Na sua instância do Jira Cloud:

1. Acesse Gerenciar aplicativos > Configurações
2. Ative o Modo de desenvolvimento e clique em Aplicar
3. Acesse Gerenciar aplicativos >Instalar aplicativo privado

• Selecione Jira no menu suspenso.
• Em URL do descritor do aplicativo, insira a URL do seu plugin do Clockify e clique em Instalar aplicativo.

Primeiros passos #

Após a instalação do aplicativo, o botão do cronômetro do Clockify aparecerá em todas as tarefas do Jira.

Como conectar suas contas #

Na primeira vez em que clicar no botão do cronômetro do Clockify, você precisará fazer login.

Como gerenciar seu aplicativo #

Você receberá uma notificação assim que a instalação for concluída.

Acesse Gerenciar app na notificação e, em seguida, Leve-me até lá para ir à página Administração, onde é possível gerenciar os detalhes e as configurações do aplicativo.

Hospedagem em servidor regional #

Além da hospedagem global, você pode optar por hospedar seus dados em regiões específicas.

Jira Cloud + Clockify em servidor regional

Se os seus dados do Clockify estiverem hospedados em um dos centros regionais, siga estas etapas para integrar o Clockify ao Jira:

1. Primeiro, conclua o processo de instalação (consulte as instruções em Jira Cloud + Clockify Cloud).
2. Em seguida, ao fazer login, no menu suspenso, escolha a região específica onde seus dados do Clockify estão hospedados:

• EUA (Estados Unidos)
• UE (União Europeia)
• Reino Unido (United Kingdom)
• AU (Austrália)

3. Após fazer login, você verá uma lista com de todos os espaços de trabalho hospedados nessa região.
4. Agora, escolha o espaço de trabalho do Clockify que deseja integrar. 

Como registrar o tempo #

Ao clicar no botão do cronômetro do Clockify em uma tarefa, você pode escolher entre o modo Cronômetro e o modo Manual.

Modo Cronômetro #

O cronômetro ajuda a registrar o tempo gasto em tarefas, medindo intervalos específicos.

Para iniciar o cronômetro:

1. Selecione a tarefa
2. Clique para expandir o Cronômetro Clockify na descrição da tarefa
3. Certifique-se de estar na aba Cronômetro e inicie o cronômetro
4. Clique no botão Parar quando terminar

O cronômetro é sincronizado com sua conta do Clockify em todos os dispositivos e pode ser interrompido no Jira ou em qualquer aplicativo do Clockify (no navegador, celular ou computador).

Se você iniciar um novo cronômetro em uma tarefa diferente no Jira, o cronômetro anterior será parado automaticamente e o novo será iniciado.

Modo manual #

Caso se esqueça de iniciar o cronômetro ou prefira inserir todas as suas horas de trabalho de uma só vez, você pode usar o modo manual.

Para isso, acesse Configurações do espaço de trabalho > Rastreamento de tempo e ative a opção Forçar cronômetro na seção Regras de rastreamento.

Para adicionar tempo manualmente:

1. Selecione a tarefa
2. Clique para expandir o Cronômetro Clockify na descrição da tarefa
3. Certifique-se de estar na aba Manual
4. Insira o intervalo de tempo e clique em Adicionar tempo

O que é registrado no Clockify #

Ao iniciar o cronômetro, o Clockify coleta automaticamente as seguintes informações do Jira e as sincroniza com o seu registro de tempo:

• Descrição: a chave da tarefa no Jira e o título da tarefa são usados ​​como descrição do registro de tempo.
• Projeto: seu projeto no Jira está mapeado para um projeto no Clockify.
• Tarefa: a chave do item do Jira é usada como uma tarefa no Clockify. 
• Etiquetas: os tipos de item (bug, tarefa ou história) e as etiquetas no Jira são convertidos em etiquetas no Clockify.

Observações importantes  #

• Os registros de tempo interrompidos no Jira serão adicionados ao registro de trabalho do Jira. Além disso, as alterações feitas no registro de trabalho do Jira serão sincronizadas com o Clockify e vice-versa.
• As informações sobre Epics ou Sprints não serão registradas. No entanto, o registro de tempo feito diretamente em um Epic criará uma entrada de tempo com a etiqueta Epic.

Perguntas frequentes #

Os campos personalizados do Jira são sincronizados com o Clockify? #

Os campos personalizados do Jira são sincronizados com o Clockify? # Não, a integração não mapeia campos personalizados do Jira para o Clockify. A sincronização automática limita-se aos seguintes dados padrão: chave do item, título, projeto, tarefa e etiquetas padrão. Se você utiliza campos personalizados no Clockify, precisará atualizá-los manualmente na interface do Clockify.

O que acontece com o meu tempo registrado se eu desinstalar a integração com o Jira? #

Seus dados existentes permanecem seguros. Desconectar ou desinstalar o aplicativo do Clockify no Jira não excluirá nenhum registro de tempo feito anteriormente no Clockify nem no registro de trabalho do Jira. No entanto, você não poderá mais registrar tempo diretamente das tarefas do Jira e a sincronização bidirecional para alterações futuras será desativada.

Por que o Jira não está importando projetos automaticamente? #

Existem alguns motivos para que isso aconteça. Verifique o seguinte:

• Certifique-se de que o usuário tenha acesso ao projeto em ambas as plataformas e de que ele não esteja definido como privado.
• Verifique se o usuário tem permissão para criar novos projetos e tarefas nas configurações do espaço de trabalho do Clockify.
• Atualize a conexão verificando se o token de acesso pessoal (Jira Data Center) expirou ou reconectando sua conta do Clockify (Jira Cloud).
• Atualize o navegador ou limpe o cache para resolver eventuais atrasos temporários de sincronização.