Integração JIRA
O nosso aplicativo gratuito para Jira permite que você rastreie o tempo das questões diretamente do Atlassian Jira com apenas um clique.
O plug-in Clockify para Jira está disponível nos aplicativos da Jira para Web, Android, iOS, bem como aplicativos desktop macOS.
Instale o aplicativo Clockify no Jira #
Para começar a rastrear o tempo, você precisará instalar o aplicativo Clockify no Jira.
Nuvem Jira + Nuvem Clockify
- Get the app from the Atlassian Marketplace (make sure you installed the app developed by CAKE.com)
- Clique no botão Obter agora e selecione Nuvem
- Escolha um site na lista suspensa onde você deseja instalar o aplicativo e clique no botão Instalar aplicativo app
JIRA Servidor + Nuvem
- Inicie sessão em sua instância do JIRA e vá para Gerenciar aplicativos
- Na página Administração, procure o Atlassian Marketplace para Jira e localize o aplicativo Clockify
- Click Install (make sure you’re installing the app developed by CAKE.com) and confirm installation by clicking Accept & Install
Você deve receber uma notificação assim que a instalação for concluída e o botão do cronômetro Clockify aparecerá em todas as atividades do Jira para que você possa começar a rastrear o tempo.
Observe que somente administradores do Jira podem gerenciar aplicativos no mesmo e instalar o aplicativo Clockify.
Servidor Nuvem JIRA + Servidor Clockify
Como este plug-in não está sendo instalado por meio do mercado do Jira, primeiro você terá que Habilitar o modo de desenvolvimento em seu Jira na nuvem acessando Gerenciar aplicativos/configurações. (Depois que a instalação estiver concluída, essa configuração pode ser desativada).
Depois Habilitar o modo de desenvolvimento, você pode instalar seu plug-in personalizado do Jira selecionando a opção Carregar URL e fornecer um URL público criado anteriormente.
Centro de Dados Jira + Nuvem/Servidor Clockify
- Vá para Administração > Gerenciar aplicativos
- Escolha Gerenciar aplicativos
- Digite o URL https://clockify-resources.s3.eu-central-1.amazonaws.com/downloads/clockify-jira-plugin.jar
- Clique no ícone de Carregar e instale
Se você estiver usando o Servidor Clockify, especifique o URL nas configurações do plug-in da sua conta Servidor Clockify.
Chave de API #
A primeira vez que você clicar no botão do cronômetro Clockify, será solicitada a chave de API do Clockify. Essa chave é usada para conectar sua conta Clockify à sua conta Jira.
- Faça login na sua conta Clockify e vá para a página Configurações de Perfil (ou clique no link Obter chave de API na sua questão do Jira e você será redirecionado automaticamente para as configurações do perfil Clockify).
- Na parte inferior desta página, clique no botão Gerar para gerar sua chave de API
- Copie a sua chave para o campo de chave de API em sua questão do Jira
Depois que você colocar a chave, você não precisará colocá-la novamente. No entanto, se você gerar uma nova chave de API para sua conta Clockify, precisará atualizá-la para corresponder ao Jira também, redefinindo-a.
Hospedagem de servidor regional #
Se você estiver usando um servidor regional, siga as instruções abaixo para integrar com sucesso o Clockify ao JIRA.
Nuvem JIRA + Clockify Servidor Regional
Se você estiver usando um servidor regional, depois de ativar Habilitar o modo de desenvolvimentodependendo da região em que você está hospedando seus dados, você precisa inserir um dos seguintes arquivos JSON no campo Carregar URL :
https://jira.use2.clockify.me/atlassian-connect.json EUA
https://jira.euc1.clockify.me/atlassian-connect.json UE
https://jira.euw2.clockify.me/atlassian-connect.json Reino Unido
https://jira.apse2.clockify.me/atlassian-connect.json – AU (Austrália)
Centro de Dados Jira + Nuvem/Servidor Clockify
- Vá para Administração
- Escolha Gerenciar aplicativos
- Clique em Carregar aplicativo
- Digite o URL https://clockify-resources.s3.eu-central-1.amazonaws.com/downloads/clockify-jira-plugin.jar
- Clique no ícone de Carregar e instale
Após a conclusão da instalação, selecione o aplicativo instalado e clique em Configurar Após a conclusão da instalação, selecione o aplicativo instalado e clique em Configurar para continuar.
Se você estiver usando um servidor regional, dependendo da região em que você está hospedando seus dados, você precisa inserir um dos seguintes arquivos JSON no campo URL:
https://jira.use2.clockify.me – EUA (Estados Unidos)
https://jira.euc1.clockify.me UE
https://jira.euw2.clockify.me Reino Unido
https://jira.apse2.clockify.me – AU (Austrália)
Rastreando o tempo #
Ao clicar no cronômetro do Clockify, você poderá escolher entre o modo de cronômetro e o manual, que você pode usar para rastrear seu tempo.
Modo de cronômetro #
Certifique-se de estar na guia Cronômetro e poderá iniciá-lo. Quando terminar, clique no botão Parar e sua entrada de tempo será registrada.
Se você tiver vários espaços de trabalho no Clockify, poderá selecionar o espaço de trabalho desejado antes de iniciar o cronômetro no Jira.
O cronômetro sincroniza com sua conta Clockify em todos os dispositivos e pode ser interrompido no Jira ou em qualquer aplicativo Clockify (navegador, celular ou desktop).
Se você começar a rastrear o tempo em outro ticket do Jira sem interromper o cronômetro anterior, o cronômetro da primeira questão será interrompido e salvo automaticamente e um novo cronômetro para a segunda questão será iniciado.
Modo manual #
Se você esquecer de iniciar o cronômetro ou preferir preencher todas as suas horas de trabalho de uma só vez, poderá usar o modo manual.
Certifique-se de estar na guia Manual e insira o tempo que você trabalhou na entrada de horas. Quando terminar, clique no botão Adicionar tempo e sua entrada de hora será registrada.
Se você tiver vários espaços de trabalho no Clockify, poderá selecionar o espaço de trabalho desejado antes de adicionar a entrada de tempo.
Observe que o limite atual para projetos exibidos no plug-in do Seletor de projetos é 790.
O que é registrado no Clockify #
Quando o cronômetro iniciar, o Clockify selecionará automaticamente o nome do problema, a tarefa, o projeto e a etiqueta do Jira se existirem questões correspondentes no Clockify.
Se não houver projeto, tarefa ou etiqueta do Jira correspondente ao Clockify, a integração poderá criá-lo automaticamente no Clockify. Para fazer isso, o usuário deve ter permissão para criar projetos, tarefas e etiquetas no Clockify. Essas permissões podem ser configuradas nas configurações do espaço de trabalho.
- Descrição – O Clockify pegará o número da chave e o nome da questão do Jira como uma descrição de entrada de tempo.
- Projeto – seu projeto no Jira será selecionado como um projeto no Clockify.
- Tarefa – a chave do problema do Jira onde você iniciou o cronômetro será selecionada como uma tarefa (subprojeto) no Clockify. Você pode alterar manualmente a tarefa na qual está trabalhando diretamente no Jira clicando no nome da tarefa e selecionando-a no menu suspenso.
O rastreamento de tempo em subproblemas no Jira será coletado como uma tarefa no Clockify rotulada como Subtarefa. - Etiquetas – correspondem aos tipos de questões (bug/tarefa/história) e etiquetas no Jira. Você pode adicionar mais etiquetas à sua entrada de tempo diretamente do Jira.
As informações sobre um Épico ou uma Sprint não serão registradas, no entanto, se você rastrear o tempo diretamente em um Épico no Jira, isso criará uma entrada de tempo no Clockify com a etiqueta Épico.
Para que a integração escolha o projeto/tarefa/etiqueta correto, ele deve existir no Clockify ou você deve definir as permissões corretas nas configurações do espaço de trabalho no Clockify e garantir que todos os usuários possam criar novos projetos/tarefas/etiquetas.
Registro de trabalho #
Quando você parar o cronômetro, a entrada será salva no Clockify e o registro de tempo será criado no log de trabalho do Jira (campo de tempo gasto). O registro de trabalho exibe uma linha do tempo de cada entrada registrada por todos para essa questão.
Se você editar/excluir uma entrada de tempo do registro de trabalho do Jira, observe que isso não será sincronizado com o Clockify, o que significa que uma entrada de tempo no Clockify não será atualizada/excluída. Da mesma forma, se você editar/excluir uma entrada de tempo no Clockify, essas alterações não aparecerão no Jira.
Somente as entradas de tempo interrompidas em questões do Jira serão adicionadas ao registro de trabalho.