Les options de sémantique
Pour donner du sens aux informations stockées dans les artifacts, la configuration des sémantiques est essentielle.
Par exemple, il est nécessaire d’indiquer à quel moment une tâche doit être considérée comme ouverte ou, au contraire, comme terminée. Les champs de statut sont souvent utilisés pour représenter l’état d’un élément (tâche, bug, release, fonctionnalité, etc.).
Ces champs enregistrent une valeur, mais Tuleap ne peut pas en déduire automatiquement leur signification. Il faut donc définir explicitement le rôle et la portée de chaque valeur afin que la plateforme puisse les interpréter correctement.
Dans un gestionnaire de tâches contenant les statuts « À faire », « En cours » et « Fini », une tâche peut être considérée comme ouverte si son statut est « À faire » ou « En cours ». Cette distinction est importante, car de nombreux outils s’appuient sur la notion d’élément « ouvert ».
Le widget « Mes artifacts » affiche uniquement les artifacts ouverts assignés à l’utilisateur. Le Backlog, le Kanban ou encore le Test Management utilisent également cette information pour alimenter leur éléments et organiser les éléments en cours.
La configuration des sémantiques s’effectue dans la section « Sémantiques » de l’administration du Tracker.
Les options de sémantiques concernent :
Le "Titre" :
La sémantique de titre permet de définir quel est le champ du tracker qui va contenir le titre de l'artifact, c'est le champ qui doit résumer l'artifact. En fonction de la nature du tracker, on utilisera le champ (chaîne de caractères ou texte) qui sera le plus pertinent.
Attention !
Un mauvais choix rend la navigation et la recherche plus difficiles.
Le titre sera affiché sur la page d’édition de l’artifact, à côté de son identifiant et dans le widget Mes artifacts.
La "Description" :
La sémantique de description s'appuie sur un champ de type texte pour décrire l'artifact.
Elle permet d’identifier clairement où se trouve l’information descriptive principale et elle garantit une lecture cohérente de l’artifact, quel que soit le tracker.
L’"Etat" :
Cette sémantique permet de configurer la notion d'artifact ouvert. A partir d'un champ sélectionné de type liste (généralement le statut), il faut choisir les valeurs de ce champ qui implique que l'artifact est "ouvert".
Pourquoi c’est important :
Tuleap utilise cette information pour filtrer les artifacts affichés.
Les widgets et outils ne travaillent que sur les artifacts ouverts.
Sans cette sémantique, les notions d’avancement et de suivi perdent leur sens.
L’état "Fini" :
Cette sémantique permet de configurer la définition de Fini pour un type d'artifact. Elle utilise le même champ que la sémantique d’état, mais avec des valeurs différentes.
Pourquoi c’est important :
Elle est utilisée pour calculer les graphiques de burnup et de vélocité.
Elle permet de masquer les artifacts terminés dans certains outils.
Elle sert de référence pour les intégrations, notamment Git et GitLab.
Info pratique
Sans cette sémantique, les indicateurs de progression ne peuvent pas être calculés correctement.
Le "Contributeur" :
La sémantique de contributeur permet d’indiquer qui est responsable d’un artifact.
Elle s’appuie sur un champ de type liste d’utilisateurs.
Elle permet d’affecter clairement le travail.
Elle alimente le widget Mes artifacts.
Elle est utilisée par les notifications et certaines règles de permission.
La “Plage De Temps”
La sémantique de plage de temps définit la période pendant laquelle un artifact est actif. Elle est utilisée par le Taskboard, le Planning, la Roadmap et les graphiques.
Elle permet de positionner les artifacts dans le temps et elle rend possible une planification cohérente des jalons.
Info pratique
La plage de temps peut être définie à partir de champs ou héritée d’un autre tracker, ce qui garantit une cohérence entre parents et enfants.
La “Progression”
La sémantique de progression permet de calculer l’avancement réel d’un artifact. Elle transforme des données brutes en indicateurs visuels et permet de suivre l’avancement dans la Roadmap.
Ce calcul peut se faire de deux manières : soit à partir de l’effort total et de l’effort restant, soit en fonction de l’état des artifacts enfants, en comparant le nombre d’éléments terminés au nombre total d’éléments liés.
L’"Infobulle"
La sémantique d’infobulle permet de définir les informations affichées lors du survol d’un artifact avec le curseur. Cela évite d’ouvrir chaque artifact pour obtenir une information clé et améliore la lisibilité et la navigation.
Info pratique
Tous les champs du tracker peuvent être affichés sur l’infobulle mais en pratique on en sélectionnera 3 ou 4 importants qui permettent d'afficher l'information utile en 1 coup d'oeil.
.png?sv=2022-11-02&spr=https&st=2026-02-16T00%3A47%3A23Z&se=2026-02-16T01%3A02%3A23Z&sr=c&sp=r&sig=gIAUbioXDvbyuYaT4H6imxDL1EcdqazjS1sdm%2FhSpMc%3D)
Les "Cartes"
La sémantique des cartes définit les champs visibles sur les cartes du Backlog, du Kanban et du Cardwall.
Vous pouvez aussi définir un champ utilisé pour la couleur de fond des cartes.
Seuls les champs de type liste ou bouton radio avec des valeurs statiques peuvent être utilisés.
Chaque valeur doit être associée à une couleur nommée ou être transparente.
Un motif est automatiquement ajouté pour les utilisateurs ayant activé le mode accessibilité.
Un aperçu des cartes est affiché pour visualiser le rendu final.
Attention !
Si vous utilisez le même champ pour le statut et la couleur de fond, la couleur ne se met pas à jour automatiquement lors d’un glisser-déposer en Kanban.
Pour voir la couleur correcte, ouvrez l’artifact ou rechargez la page.
.png?sv=2022-11-02&spr=https&st=2026-02-16T00%3A47%3A23Z&se=2026-02-16T01%3A02%3A23Z&sr=c&sp=r&sig=gIAUbioXDvbyuYaT4H6imxDL1EcdqazjS1sdm%2FhSpMc%3D)
L'"Effort Estimé"
La sémantique d’effort initial représente l’estimation de travail pour un artifact.
Elle permet de comparer l’effort estimé et la capacité et est utilisée dans la planification des releases et des sprints.
