# Intégration Jira et Jira Tempo

> Connectez Jira à Workload : temps saisis dans Tempo, projets et epics importés en lecture seule, synthèse de capacité publiée dans Jira. Étapes de mise en place et FAQ.

- HTML: https://www.simpleworkload.com/fr/integrations/jira
- Markdown: https://www.simpleworkload.com/fr/integrations/jira.md

## Comment connecter Jira à Workload ?

Workload se connecte à Jira de deux façons complémentaires. Les temps saisis dans Jira Tempo sont synchronisés avec un jeton d'API Tempo pour alimenter le planifié vs réel. Les projets et epics Jira sont importés en lecture seule via l'intégration Jira, avec une publication optionnelle de la synthèse de capacité sous forme de commentaire. Aucune des deux ne modifie vos tickets existants.

Disponible à partir du plan Professional. Le jeton Tempo se configure dans Paramètres > Intégrations timesheet.

## Ce qui est synchronisé

- Jira Tempo → Workload : les worklogs (date, heures, description, projet, auteur) pour le planifié vs réel
- Jira → Workload : projets, epics et dépendances, en lecture seule
- Workload → Jira (optionnel) : une synthèse de capacité planifiée publiée en commentaire sur le premier ticket du projet associé

## Prérequis

- Un compte Workload sur le plan Professional ou supérieur
- Un jeton d'API Tempo (pour les temps) et, pour l'intégration Jira, un jeton d'API Atlassian associé à votre e-mail, ou une connexion OAuth
- Côté Jira : droits « Browse projects » et, pour la publication optionnelle, « Add comments »

## Mise en place pas à pas

1. Dans Workload, ouvrez Paramètres > Intégrations timesheet et choisissez Jira Tempo.
2. Dans Tempo, ouvrez Settings > Data Access > API Integration, cliquez sur New Token (durée de validité au choix, accès en lecture aux worklogs), puis collez le jeton dans l'assistant et validez la connexion.
3. Lancez une première synchronisation : les worklogs arrivent dans Workload.
4. Faites correspondre les projets Tempo à vos projets Workload. Le rapprochement automatique se base sur la ressemblance des noms ; vous pouvez le corriger à la main.
5. Pour importer projets et epics, ouvrez Paramètres > Intégrations, ajoutez Jira et testez la connexion.
6. Associez les projets Jira aux projets Workload, puis lancez la synchronisation (lecture seule).
7. Optionnel : activez la publication des allocations vers Jira pour poster la synthèse de capacité hebdomadaire.

## À savoir

- Les intégrations timesheet sont synchronisées automatiquement toutes les 4 heures, ou à la demande depuis la page de l'intégration.
- Un rapprochement de projet confirmé à la main n'est jamais écrasé par le rapprochement automatique.
- Un jeton Tempo expire (30 jours par défaut) : choisissez une durée adaptée ou renouvelez-le, sinon l'intégration passe en erreur.
- La publication vers Jira est en lecture seule côté Workload : un seul sens, de Workload vers un commentaire, sans modifier les champs de vos tickets.
- Des entrées sans projet associé restent importées mais non rattachées : pensez à compléter le mapping.
- Tempo ne fournit que l'identifiant de compte Atlassian de l'auteur. Pour rattacher le temps à un membre, Workload retrouve son nom et son e-mail via l'intégration Jira de l'organisation (si elle est active), puis le rapproche d'un membre par e-mail ou par nom exact. Sans intégration Jira, ou si l'utilisateur masque son e-mail et que le nom ne correspond pas, le temps reste rattaché au projet mais pas à un membre.

## Questions fréquentes

### Faut-il Jira pour utiliser Workload ?

Non. Workload fonctionne en autonomie avec un import CSV. Jira et Tempo sont des intégrations optionnelles, disponibles à partir du plan Professional.

### Workload modifie-t-il mes tickets Jira ?

Non. Les projets et epics sont importés en lecture seule. La seule écriture possible, optionnelle, est un commentaire de synthèse de capacité sur le premier ticket du projet associé.

### À quelle fréquence les temps Tempo sont-ils mis à jour ?

Toutes les 4 heures pour les intégrations actives, et à la demande avec la synchronisation manuelle.

### Que se passe-t-il si un projet Tempo n'existe pas dans Workload ?

L'entrée est importée sans projet associé. Vous pouvez ensuite créer le projet ou corriger le mapping ; le rapprochement automatique propose un projet dont le nom ressemble.

### Comment comparer le planifié et le réel ?

Une fois les temps synchronisés et rattachés aux projets, le planifié vs réel apparaît dans les rapports et le pack comité.

## Sitemap

- [Markdown sitemap](https://www.simpleworkload.com/sitemap.md)
- [XML sitemap](https://www.simpleworkload.com/sitemap.xml)
- [llms.txt](https://www.simpleworkload.com/llms.txt)
- [llms-full.txt](https://www.simpleworkload.com/llms-full.txt)
