Jira : intégration bidirectionnelle avec Clockify
Notre appli Jira gratuite vous permet de suivre le temps passé sur les tickets directement depuis Atlassian Jira en un seul clic.
Le plugin Clockify pour Jira est disponible dans l’appli web Jira, l’appli mobile Jira pour Android et iOS, ainsi que dans l’appli de bureau Jira pour macOS.
Installer l’appli Clockify pour Jira #
L’administrateur Jira doit installer l’appli Clockify depuis l’Atlassian Marketplace officiel.
Pour installer Jira depuis l’Atlassian Marketplace :
- Accédez à la fiche de l’appli Clockify : Time Tracking & Timesheet 2-Way Sync sur l’Atlassian Marketplace
- Cliquez sur le bouton bleu Obtenir maintenant situé dans le coin supérieur droit
- Connectez-vous à votre compte Atlassian (si ce n’est pas déjà fait) et assurez-vous de disposer des droits d’administrateur de site pour votre instance Jira
- Sélectionnez l’URL Jira Cloud spécifique (p. ex. votreentreprise.atlassian.net) sur laquelle vous souhaitez installer l’appli
- Cliquez sur Vérifier
- Vérifiez les autorisations et les conditions d’utilisation de l’appli
- Cliquez sur Obtenir maintenant
Une fois l’installation terminée, vous êtes redirigé vers la page de l’appli, où s’affiche un message confirmant que l’appli a bien été installée.
Connecter son compte Clockify #
Now that the app is in your Jira instance, you must link it to your actual Clockify data by following these steps:
- Connectez-vous à Jira Data Center
- Accédez à la page Mon profil
- Sélectionnez Jetons d’accès personnels dans la barre latérale gauche
- Cliquez sur Créer un jeton
- Collez le jeton dans les paramètres de l’appli Clockify
- Cliquez sur Téléverser le jeton
Installer Jira depuis Clockify #
Vous pouvez également installer Jira depuis Clockify.
- Accédez aux paramètres de l’espace de travail
- Cliquez sur Intégrations
- Cliquez sur le menu déroulant de l’extension Jira
- Cliquez sur Installer le plug-in Jira
Jira Cloud + Clockify Cloud
- Rendez-vous sur l’Atlassian Marketplace et recherchez Clockify (assurez-vous d’installer l’appli développée par CAKE.com)
- Cliquez sur Obtenir maintenant
- Sélectionnez le site sur lequel vous souhaitez installer l’appli dans la liste déroulante
- Suivez les instructions pour vérifier les autorisations et terminer l’installation
Jira Data Center (Jira Server) + Clockify Cloud
La fonctionnalité de suivi du temps pour Jira Data Center via Clockify sera bientôt disponible.
Jira Cloud + Clockify
Dans votre instance Jira Cloud :
- Accédez à Gérer les applis > Paramètres
- Sélectionnez Activer le mode développement, puis cliquez sur Appliquer
- Accédez à Gérer les applis > Installer une appli privée
- Sélectionnez Jira dans le menu déroulant
- Dans le champ URL du descripteur de l’appli, saisissez l’URL de votre plugin Clockify, puis cliquez sur Installer l’appli
Bien démarrer #
Une fois l’appli installée, le bouton du chronomètre Clockify apparaîtra sur toutes les tâches Jira.
Connecter ses comptes #
La première fois que vous cliquerez sur le bouton du chronomètre Clockify, vous serez invité à vous connecter.
Gérer son appli #
Vous recevrez une notification une fois l’installation terminée.
Dans la notification, cliquez sur Gérer l’appli, puis sur Accéder à la page pour accéder à la page d’administration où vous pouvez gérer les détails et les paramètres de l’appli.
Seuls les administrateurs Jira peuvent gérer les applis dans Jira et installer l’appli Clockify.
Hébergement de serveurs régionaux #
Outre l’hébergement mondial, vous pouvez choisir d’héberger vos données dans d’autres régions spécifiques.
Jira Cloud + Clockify sur un serveur régional
Si vos données Clockify sont hébergées sur l’un des centres régionaux, suivez ces étapes pour intégrer Clockify à Jira :
- Commencez par terminer le processus d’installation (lien vers Jira Cloud + Clockify Cloud)
- Ensuite, lors de la connexion, sélectionnez dans le menu déroulant la région spécifique où vos données Clockify sont hébergées :
- Une fois connecté, vous verrez s’afficher la liste de tous les espaces de travail hébergés dans cette région
- Sélectionnez maintenant l’espace de travail Clockify que vous souhaitez intégrer
Suivre le temps #
Lorsque vous cliquez sur le bouton du minuteur Clockify dans une tâche, vous pouvez choisir entre le mode Minuteur et le mode Manuel.
Mode minuteur #
Le minuteur vous aide à suivre le temps que vous consacrez à vos tâches en mesurant des intervalles de temps précis.
Pour démarrer le minuteur :
- Sélectionnez une tâche
- Cliquez pour développer le module Clockify dans la description de la tâche
- Assurez-vous d’être dans l’onglet Minuteur et démarrez le minuteur
- Cliquez sur le bouton Arrêter lorsque vous avez terminé
Le minuteur est synchronisé avec votre compte Clockify sur tous vos appareils et peut être arrêté dans Jira ou depuis n’importe quelle appli Clockify (navigateur, mobile ou ordinateur).
Si vous lancez un nouveau minuteur sur un autre ticket Jira, le minuteur précédent s’arrêtera automatiquement et un nouveau démarrera.
Mode manuel #
Si vous avez oublié de lancer le minuteur ou si vous préférez saisir toutes vos heures de travail en une seule fois, vous pouvez utiliser le mode manuel.
Les propriétaires/administrateurs peuvent désactiver le mode manuel et activer l’option Forcer le minuteur dans les paramètres de l’espace de travail Clockify.
Pour ajouter du temps manuellement :
- Sélectionnez une tâche
- Cliquez pour développer le module Clockify dans la description de la tâche
- Assurez-vous d’être dans l’onglet Manuel
- Saisissez la plage horaire et cliquez sur Ajouter du temps
Si vous avez plusieurs espaces de travail dans Clockify, vous pouvez sélectionner l'espace de travail souhaité avant d'ajouter la saisie des temps.
Ce qui est enregistré par Clockify #
Lorsque vous lancez le chronomètre, Clockify récupère automatiquement les informations suivantes depuis Jira et les synchronise avec votre saisie de temps :
- Description : Le numéro d’identification et le titre de la tâche Jira sont utilisés comme description de la saisie de temps.
- Projet : Votre projet dans Jira est associé à un projet dans Clockify.
- Tâche : Le numéro d’identification de la tâche Jira est utilisé comme tâche dans Clockify.
- Tags : Les types de tâches (bug/tâche/story) et les étiquettes dans Jira sont convertis en tags dans Clockify.
Modifiez manuellement la tâche en cours directement dans Jira via le menu déroulant. Le temps passé sur une sous-tâche Jira sera enregistré dans Clockify avec le tag « Sous-tâche ».
For the integration to work correctly, a corresponding project or task needs to already exist in Clockify, is accessible to the user and not private, or the user has permission to create new projects and tasks in Clockify Workspace settings.
Important à noter #
- Les saisies de temps interrompues dans Jira seront ajoutées au journal de travail de Jira. De même, les modifications que vous apportez au journal de travail de Jira seront synchronisées avec Clockify, et inversement.
- Les informations relatives à un Epic ou à un Sprint ne seront pas enregistrées. Cependant, le suivi du temps directement sur un Epic créera une saisie de temps avec le tag Epic.
Lorsque le « Forcer le minuteur » est activé, les modifications apportées à la durée des saisies ne seront pas prises en compte dans le journal de travail. Si les saisies sont verrouillées, les utilisateurs non administrateurs ne peuvent modifier aucune information.
FAQ #
Are custom fields in Jira synced to Clockify? #
No, the integration does not currently map Jira custom fields to Clockify. The automatic sync is limited to standard data points: the issue key, title, project, task, and default tags/labels. If you use custom fields in Clockify, you will need to update those manually within the Clockify interface.
What happens to my tracked time if I uninstall the Jira integration? #
Your existing data is safe. Disconnecting or uninstalling the Clockify app from Jira will not delete any of your previously recorded time entries in Clockify or the Jira work log. However, you will no longer be able to track time directly from Jira issues, and the two-way sync for any future edits will be disabled.
Why is Jira not picking up projects automatically? #
There are a few reasons this might happen. Check the following:
- Ensure the user has access to the project in both platforms and that it isn’t set to private.
- Verify the user has permission to create new projects and tasks in the Clockify Workspace settings.
- Refresh your connection by checking for an expired Personal Access Token (Jira Data Center) or by reconnecting your Clockify account (Jira Cloud).
- Refresh your browser or clear your cache to resolve any temporary sync delays.