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).

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 :

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

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 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).

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

⚠️ 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

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)

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.

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