--- title: "Widget - Feuille de route" slug: "widget-feuille-de-route" updated: 2026-05-17T19:13:35Z published: 2026-05-17T19:13:35Z canonical: "help.tuleap.com/widget-feuille-de-route" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.tuleap.com/llms.txt > Use this file to discover all available pages before exploring further. # Widget - Feuille de route Le widget **Feuille de route** permet de visualiser la planification temporelle de vos projets directement sur votre tableau de bord. Il offre une vue de type "Gantt" affichant la progression des artifacts (User Stories, Epics, Tâches, etc.) en les contextualisant par rapport à des itérations temporelles (Releases, Sprints). > [!WARNING] > Note d’installation > > Ce widget est utilisable uniquement sur le Tableau de bord projet. > > Également, le plugin **Feuille de route** doit être installé et activé sur votre instance de Tuleap. ## Prérequis Pour que ce widget fonctionne correctement, votre projet doit être configuré avec : - Des trackers **actifs**. - Une structure hiérarchique cohérente (ex: Release > Sprint > User Stories). - Des sémantiques configurées selon les fonctionnalités utilisées : | Fonctionnalité | Sémantiques requises | | --- | --- | | Affichage de base (Gantt, rubans, sous-tâches, liens) | **Titre** + **Timeframe** (obligatoire) | | Filtre **Afficher les éléments fermés** et filtrage des éléments obsolètes | **Status** | | Barre de progression (%) | **Progression** | | Contenu de l’infobulle au survol | **Infobulle** | ### Règles globales d’éligibilité des artifacts Ces règles s’appliquent à l’ensemble du widget (liste principale, sous-tâches, rubans, liens). - Sans sémantique **Titre** ou **Timeframe** configuré, les artifacts associés au tracker concerné **sont ignorés par le widget**. - Les artifacts **avec dates incohérentes (fin < début)** sont considérés invalides. - Les artifacts **sans date de début et sans date de fin** ne sont pas affichés (sauf en cas d’erreur de configuration Timeframe, où ils apparaissent en fin de liste). - Les artifacts **fermés depuis plus d’un an** ou **avec une date de fin passée de plus d’un an** sont automatiquement filtrés. ## Installation ![](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Screen Shot 2026-01-08 at 15.21.46.png) Plusieurs options de paramétrages sont à configurer au moment de l’ajout du widget sur votre tableau de bord. **Titre** *(Obligatoire)* - Donnez un nom explicite à votre widget - *Exemple :* "Roadmap Produit 2026" ou "Planning Q1 2026" **Afficher la progression de** *(Obligatoire)* - Sélectionnez un ou plusieurs trackers contenant les éléments à suivre - *Exemples :* Epics, User Stories, Features - 💡 Ces éléments apparaîtront comme barres principales dans le diagramme **Filtrer** *(Optionnel)* - Disponible uniquement si **un seul tracker** est sélectionné - Cette option vous permet de filtrer les artifacts affichés par rapport à un [rapport **public**](/help/docs/visualiser-les-resultats-de-recherche) du tracker sélectionné **Échelle de temps par défaut** - Choisissez le niveau de zoom initial - *Options :* Semaine / Mois (défaut) / Trimestre Une fois ces paramètres configurés, vous pourrez alors paramétrer les **rubans de plage de temps**. Ces rubans permettent d'afficher des bandes temporelles en haut du graphique pour contextualiser vos éléments (par exemple, montrer dans quelle Release ou quel Sprint se situe une tâche). > [!NOTE] > Information > > Un tracker utilisé pour afficher la progression ne peut pas être utilisé simultanément comme ruban de plage de temps (et inversement). Les listes de trackers disponibles sont automatiquement filtrées en conséquence. **Ruban niveau 1** *(ex: Releases, Versions)* - Représente la période la plus large - S'affiche juste sous l'axe temporel **Ruban niveau 2** *(ex: Sprints, Itérations)* - Représente une sous-division du niveau 1 - Nécessite que le niveau 1 soit configuré - Si le niveau 1 est vidé, le niveau 2 est automatiquement réinitialisé - Les dates doivent être incluses dans celles du niveau 1 > [!WARNING] > ⚠️ Important > > - Les artifacts ne doivent pas se chevaucher dans le temps > - Seules les itérations dont les dates sont comprises dans la plage temporelle visible sont affichées > - Respectez une ligne de temps continue pour une meilleure lisibilité ## Contenu ![](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Screen Shot 2026-01-08 at 16.16.32(2).png) La roadmap se compose de trois zones principales : **1. En-tête temporelle** - Ligne supérieure : Années avec décompte des unités de temps - Ligne inférieure : Semaines / Mois / Trimestres selon l'échelle **2. Rubans de plage de temps** *(si configurés)* - Niveau 1 : Périodes larges (ex: "Release 1", "Release 2") - Niveau 2 : Sous-périodes (ex: "Sprint 1", "Sprint 2") **3. Gantt** - Les barres horizontales colorées représentant vos artifacts - La ligne verticale rouge indique la date du jour - La longueur de la barre correspond à la durée de l’artifact ### Artifacts **Affichage** Les éléments sont automatiquement organisés selon cette logique : 1. **Tri principal** : Par date de début croissante (ou date de fin si pas de début) 2. **Artifacts invalides** : Les artifacts invalides (date de fin < date de début) sont affichés en fin de liste 3. **Artifacts sans dates** : Les artifacts n'ayant ni date de début ni date de fin ne sont pas affichés (sauf en cas d'erreur de configuration du timeframe, auquel cas ils apparaissent en fin de liste) > [!WARNING] > Attention > > Les artifacts dont le **parent** appartient à l'un des trackers sélectionnés dans la configuration du widget ne sont pas affichés directement dans la liste principale. Ils apparaissent en tant que sous-tâches. **Icônes et indicateurs** Différentes informations concernant vos artifacts sont affichées sur le Gantt par le biais d’indicateurs. | **Indicateur** | **Signification** | | --- | --- | | ![](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/image(88).png) : icône “attention” | Une erreur de configuration est présente sur votre artifact. cela peut être : - Les dates paramétrées sur votre artifact sont incohérentes (fin < début) - La progression de votre artifact ne peut pas être calculée La cause de l’erreur est affichée dans l’infobulle qui apparait au survol de votre artifact. | | ![](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Screen Shot 2026-01-08 at 15.57.15.png): Barre avec pourcentage % | La sémantique de progression est configurée sur le tracker associé à votre artifact | | ![](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Screen Shot 2026-01-08 at 15.52.39.png) : Losange | Milestone (jalon) : les dates de votre artifact sont identiques ou manquantes (pas de date de début ou de fin) | | Barre en pointillé (bordure tiretée) | Les dates de l'artifact sont **héritées d'un autre tracker** (dates implicites, calculées via la sémantique Timeframe "implied from another tracker"). L'artifact n'a pas ses propres champs de dates mais les obtient à partir des artifacts liés. | **Infobulle** - Survolez un élement pour afficher une infobulle, contenant des détails sur votre artifact - L’infobulle affiche les propriétés paramétrées dans la sémantique **Infobulle** de votre tracker **Sous-tâches** - Le chevron pour faire apparaitre les sous-tâches n'apparaît que si des sous-tâches existent : une fois cliqué, les sous-tâches s'affichent en retrait sous leur parent - Si la sous-tâche est associée à un autre projet : l'icône et le nom du projet s'affichent - Les sous-tâches suivent les mêmes règles d’éligibilité et de filtrage que la liste principale (voir **Règles globales d’éligibilité**) - Les sous-tâches sont également filtrées selon leur statut (ouvert/fermé) via le contrôle "Afficher les éléments fermés" ### Contrôles **Échelle** - Vous pouvez modifier la plage de temps affichée : Semaine / Mois / Trimestre - Modifier cette option ajuste l'affichage sans modifier la configuration - Cette option est **désactivée** si aucune donnée n'est présente **Liens** - Sélectionnez le type de lien à visualiser : les flèches apparaissent entre les artifacts liés - Les options affichées sont basées sur la configuration de vos types de liens - Ce contrôle est désactivé si aucun lien n'existe entre les artifacts affichés, ou si aucune donnée n'est visible à l'écran - Également, les liens `_is_child` ne sont pas dans le sélecteur de liens, car ils sont affichés via l’affichage des sous-tâches **Afficher les éléments fermés** - Cette option vous permet d'afficher / masquer les artifacts terminés (fermés) en fonction de la sémantique **Status** du tracker - Le filtrage s’effectue en temps réel sur l'affichage - Ce filtre s'applique à la fois aux tâches principales et à leurs sous-tâches ## FAQ --- ### FAQ #### Les utilisateurs de mon projet ne voient pas tous les artifacts dans le gantt. Vérifiez que vos utilisateurs ont bien les **permissions de lecture sur les trackers et champs** concernés. En particulier : - Le champ **Titre** doit être lisible - Les champs de la sémantique **Timeframe** (dates de début/fin ou durée) doivent être lisibles - Le champ **Status** doit être lisible (sinon l'artifact sera considéré comme obsolète et masqué) #### L’affichage des rubans de plage de temps est incohérent Vérifiez que : - la ligne de temps est bien continue (pas de chevauchement) - les dates entre les rubans de niveau 1 & 2 sont bien cohérentes #### Certains artifacts n'apparaissent pas alors qu'ils existent dans le tracker Plusieurs causes sont possibles : - L'artifact n'a **ni date de début, ni date de fin** renseignée - L'artifact est **fermé depuis plus d'un an** - La **date de fin** de l'artifact est passée de **plus d'un an** - Le **parent** de l'artifact appartient à un des trackers sélectionnés (l'artifact apparaîtra alors en sous-tâche) - Le tracker de l'artifact n'a pas la sémantique **Titre** ou **Timeframe** configurée #### Je ne peux pas sélectionner le même tracker pour la progression et les rubans de plage de temps C'est un comportement attendu. Un tracker ne peut pas être utilisé simultanément pour afficher la progression **et** comme ruban de plage de temps. Les listes de trackers disponibles sont automatiquement filtrées pour éviter cette situation. #### Les flèches de dépendance ne s'affichent pas entre certains artifacts Pour qu'une flèche de dépendance apparaisse, l'artifact lié doit : - Posséder les sémantiques **Titre** et **Timeframe** configurées sur son tracker - Être un lien **sortant** (forward link) de l'artifact source - Avoir ses dates valides et être visible dans le widget