--- title: "La gestion des artifacts" slug: "la-gestion-des-artifacts" tags: ["Identifiants Uniques", "Liens Inter Artifacts", "Références Artifacts"] updated: 2026-05-15T09:52:28Z published: 2026-05-15T09:52:28Z canonical: "help.tuleap.com/la-gestion-des-artifacts" --- > ## 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. # La gestion des artifacts ## Les références des artifacts Chaque artifact possède un identifiant unique visible en haut à gauche de la fiche. Dans l'exemple ci-dessous la tâche porte l'identifiant "402866". ![Task management interface showing start and end date fields with no entries.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-13 à 00.29.51.png) Considérant l'unicité des identifiants, il est possible de trouver un artifact précis sur la plateforme en utilisant la boîte de recherche ![Button labeled 'Accéder à...' indicating an action or navigation option.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-13 à 10.27.35.png) dans la barre en haut. ![Task details including recent elements and search results for project management.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-13 à 00.32.40.png) Pour référencer cet artifact, trois chaînes de caractères fonctionnent : - artifact #123 - art #123 - task #123 > [!NOTE] > Info pratique > > Le nom court du Tracker est utilisé pour référencer ses artifacts, c'est pourquoi il doit être choisi correctement pour que l'information soit explicite Ici le nom court de notre tracker de tâches est "task" ce qui permet de référencer l'artifact de cette façon : task #123 , à la vue de la référence, nous savons exactement ce qu'il y a derrière le lien. Bien sûr cette recherche tient compte des permissions et l'artifact vous sera présenté uniquement si vous avez les droits de consulter cet artifact. Vous pouvez consulter les références qui existent dans votre projet, dans la section d'administration du projet, dans le sous-menu "References", On retrouve toutes les références système dans la partie haute et notamment **art** et **artifact**. Dans la partie basse on retrouve les modèles de références du projet qui sont implicitement créés avec vos trackers et celles créés par l'administrateur du projet. ### L’utilisation des références Les références s'utilisent en mode texte par exemple : - **Dans mediawiki**, elles peuvent s'utiliser dans le texte directement - **Dans les trackers**, elles peuvent s'utiliser dans les commentaires, dans les champs texte ou chaîne de caractère - **Dans les messages de commit** GIT ou SVN > [!NOTE] > Info pratique > > L’utilisation d’une référence permet de **relier un artifact à un autre élément de Tuleap**, qu’il s’agisse d’un document, d’une page wiki, d’une livraison ou de tout autre artifact. Ces liens sont **visibles dans les deux sens**, ce qui permet d’identifier facilement tous les éléments qui référencent un artifact grâce aux **champs cross-reference**. ## Les liens inter-artifact (artifact link) Les liens inter-artifact sont un moyen plus efficace encore de lier deux artifacts entre eux. Voici la procédure : ### 1. Ajouter le champ “Lien vers des artifacts” au tracker ![Administration interface displaying various fields for bug management and artifact links.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 17.18.29.png) > [!NOTE] > Pour savoir comment ajouter et configurer un champ dans un tracker, consultez [cet article](/help/docs/tracker-champs). ### 2. Créer les liens vers d’autres artifacts Les artifacts peuvent être du même type ou d'un type différent (c'est à dire d'un autre tracker) mais aussi dans un projet différent. La seule condition pour lier deux artifacts entre eux est d'avoir la possibilité d'éditer le champ artifact link du premier et d'avoir une visibilité sur le second. Il y a trois cas de figure pour ajouter un lien vers un artifact : - **Cas 1** : vous connaissez les identifiants des artifacts cibles ; saisissez alors directement les identifiants, séparés par des virgules, dans le champ. - **Cas 2** : l’artifact existe mais vous ne connaissez pas son identifiant ; utilisez le **bouton de recherche** pour sélectionner un ou plusieurs artifacts cibles. Dans ce mode, il faut dans un premier temps sélectionner le tracker qui contient les artifacts à lier ainsi qu'un rapport. Par défaut c'est le tracker courant qui est sélectionné mais vous pouvez changer pour sélectionner n'importe quel tracker auquel vous avez accès. Le tracker peut être dans un autre projet dont vous êtes membre. Ensuite vous pouvez sélectionner un rapport du tracker pour filtrer les artifacts. Une fois la sélection des deux valeurs faite, il reste à cocher les artifacts que l'on souhaite relier et valider. ![Interface displaying links and references for creating new artifacts in a project.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-13 à 02.30.40.png) - **Cas 3** : l’artifact n’existe pas encore ; utilisez le bouton de création pour le créer immédiatement puis établir le lien. il faut dans un premier temps sélectionner le tracker dans lequel le nouvel artifact sera créé, il sera automatiquement ajouté à la liste des artifacts à lier une fois créé. Une fois le tracker sélectionné, il suffit de remplir les champs, comme pour n'importe quelle création d'artifact dans ce tracker. ![Form for linking tasks to projects, including fields for title and project selection.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-13 à 02.30.22.png) L'opération de liaison effectuée alors il suffit de cliquer sur ou de soumettre les modifications. ## **Visualisation des artifacts liés :** Par la suite les artifacts cibles seront listés dans un tableau à plusieurs onglets. Les artifacts seront classés par tracker comme ci-dessous : ![Task management interface displaying linked artifacts and their statuses for development tasks.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-13 à 11.14.40.png) Ici l'artifact est relié à trois autres artifacts du tracker de tâches (Tasks) . Depuis un des trois artifacts il est possible de connaitre les artifacts qui les lient. Il suffit pour cela de cliquer sur le bouton : "Afficher les artifacts qui référencent cet artifact" pour les connaitre. ![Overview of an artifact with details like ID, project, and status information.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-01-13 à 11.16.07.png) ## Suppression d’artifacts > [!CAUTION] > La suppression d’artifacts dans Tuleap est fortement déconseillée. En effet, lorsque l'on supprime un élément, on perd inévitablement en traçabilité, ne serait-ce que parce que l'on perd l'information que cette entrée a un jour existé. Cela devient d'autant plus complexe lorsque cet artifact était par exemple lié à d'autres, on perd alors une partie du contexte. On préfèrera donc éviter de supprimer un artifact, mais plutôt de le marquer comme "obsolète", "incorrect" et de filtrer ces artifacts via les rapports de Trackers. La suppression d’un artifact est néanmoins accessible directement **depuis le menu “Action” de l’artifact.** > [!NOTE] > Info pratique > > Seuls les administrateurs du tracker verront cette option apparaître. ![Task details for project Tuly, including artifact ID and submission date.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2026-02-20 à 16.22.46.png) > [!WARNING] > Attention ! > > Il y a une limitation au nombre d'artifacts que vous pouvez supprimer. > > Cette limitation journalière est définie par **l'administrateur de plateforme**. Par défaut, elle est réglée à zéro. Dans l'écosystème Tuleap, un artifact est l'unité de base pour suivre le travail. C'est un élément géré dans un "tracker", et englobe tout ce que vous pourriez traditionnellement appeler un "ticket", une "tâche", un "bug", une "exigence", etc. Un Tracker est un outil de suivi d'un type d'information qui permet de créer, gérer et suivre un ensemble d'artifacts partageant une même nature. Une référence est un lien court (par exemple : bug #123, task #123) formé par un mot clé et un identifiant précédé du caractère '#'. Chaque artefact a un identifiant unique et possède une référence propre qui peut être utilisé dans l'ensemble de la plateforme Tuleap pour créer un lien vers cet élément Elément unitaire qui compose un artefact, les nombres et la configuration des champs se fait dans la description du tracker ## Related - [Champs](/tracker-champs.md)