---
title: "Le module de recherche"
slug: "le-module-de-recherche"
updated: 2026-03-17T10:41:10Z
published: 2026-03-17T10:41:10Z
canonical: "help.tuleap.com/le-module-de-recherche"
---

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

# Le module de recherche

## Le mode de recherche classique

L'élément principal du rapport est le module de recherche qui va permettre de sélectionner et filtrer l'information.

![Bug report interface with fields for Artifact ID, Summary, Status, and Severity.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 10.47.26.png)

Vous pouvez sélectionner et modifier le rapport de votre choix en le choisissant avec le menu de sélection.

![Dropdown menu displaying options for bug reports in the application interface.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 10.50.24.png)

Vous pouvez ajouter ou supprimer des critères de recherche grâce au menu déroulant ![Dropdown menu displaying various criteria options for filtering content.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 10.52.26.png) sur la droite .

Pour valider les critères de recherche et obtenir un résultat, cliquez sur le bouton de recherche.

![Search button labeled 'Rechercher' for initiating a search action on a webpage.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 10.55.22.png)

Selon les types de champs, des recherches différentes peuvent être effectuées.

### Les champs de type “Texte”

![Summary section indicating a bug report for software or application issues.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.03.15.png)

Il est possible de rechercher des chaînes de caractères dans les champs de type “texte”. Ici nous recherchons le terme “Bug” dans le champs “Summary” des artifacts.

Laisser vide le critère revient à ne pas l’utiliser.

> [!NOTE]
> Info pratique
> 
> La recherche ignore les différences entre majuscules et minuscules.

### Les champs de type “Liste simple” ou “Liste à choix multiple”.

Les champs ci-dessous sont des listes à choix multiple, pour ces types de champs il est possible de choisir une valeur dans le menu déroulant, dans l'exemple ci-dessus, nous sélectionnerons tous les artifacts du trackers dont le statut est “New” et dont la sévérité est critique “Critical impact”.

![Status marked as 'New' with severity indicating 'Critical impact' for immediate attention.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.29.25.png)

**“Tous”** signifie n’importe quelle valeur, choisir cette option revient à ne pas utiliser de filtre sur ce champ en particulier.

![Dropdown menus for selecting status and severity options in a user interface.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.12.24(1).png)

**“Aucun”** signifie que le champs n’a pas été rempli ou est vide, en choisissant cette option, on sélectionne uniquement les artifacts dont les champs correspondants sont vides.

![Dropdown menus for selecting status and severity, both showing 'Aucun' option.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.12.57.png)

Le menu déroulant à côté du nom du champ, permet de sélectionner plusieurs valeurs de la liste :

![Status options include New and In Progress; Severity shows Major and Critical impact.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.38.08.png)

Les artifacts sont ainsi filtrés par leur statut “New” ou “In Progress’, et par leur sévérité “Major impact” ou “Critical Impact”.

![Table displaying bug artifacts with IDs, summaries, statuses, severities, and submission dates.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.41.57.png)

### Les champs de type “Date”

Il est possible de rechercher dans les champs date des artifacts.

![Submission date field with dropdown arrows for selecting date options.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.46.45.png)

Laisser la date vide signifie ne pas utiliser le critère.

Sur la droite, l'image qui représente un calendrier ![Calendar icon representing scheduling or planning events and activities effectively.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.48.49.png) permet de choisir une date.

Sur la gauche une liste déroulante permet de choisir le type de recherche :

- ![Dropdown menu labeled 'Après' with an upward arrow indicating selection options.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.49.05.png) : Date postérieure à celle configurée
- ![Dropdown menu displaying options for selection in a user interface.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.49.20.png) : Date identique à celle configurée
- ![Dropdown menu labeled 'Avant' indicating selection options for a user interface.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.49.30.png) : Date antérieure à celle configurée

Enfin, l’option fenêtre de date est accessible en dépliant le critère de sélection avec le “+” à gauche du nom du critère.

![Submission dates for a project, including start and end dates in a form.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.56.57.png)

Dans ce mode, il est donc possible de sélectionner une fenêtre de recherche entre une date de début et une date de fin.

![Table displaying bug artifacts with IDs, summaries, statuses, and severity levels.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 11.59.26.png)

### La recherche multi-critères

Il est bien entendu possible de sélectionner plusieurs critères en même temps dans un rapport.

Pour qu'un artifact soit sélectionné il faut qu'il remplisse tous les critères configurés dans le module de recherche.

## Le mode expert : les recherches avancées TQL

Si vous avez des recherches complexes à faire ou que vos rapports manquent en pertinence, il est préférable de **passer en mode expert** ![Diagram illustrating key concepts with highlighted sections for better understanding.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 12.24.36.png).

![Search query example demonstrating logical operators for database queries.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 12.25.40.png)

Ici, les recherches doivent se faire avec notre langage de requêtes TQL(Tuleap Query Language). La syntaxe pour un critère est : **CHAMP OPERATEUR ARGUMENT(S)**

> [!NOTE]
> Info pratique
> 
> Si vous avez un doute, pensez à utiliser la complétion (CTRL+Space) pour contrôler/compléter les noms des champs.

Sur la droite vous retrouvez la liste des champs utilisables dans vos requêtes.

![List of authorized fields including comments, assignments, attachments, and close date.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 12.30.49.png)

En haut, vous avez la possibilité de revenir au mode de recherche classique : ![User interface showing options for normal mode selection in a software application.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 12.33.42.png)

Comme dans le module classique, le bouton de recherche vous permet de valider votre recherche.

![Search button labeled 'Rechercher' for initiating a search action on a webpage.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 10.55.22(1).png)

### Les Champs :

Dans les requêtes, vous utiliserez les noms des champs.

Pour rappel le nom du champ est utilisé pour identifier de manière unique le champ du tracker alors que le label (titre du champ) est le texte qui est affiché dans l'interface graphique.

Par exemple le champ d'assignation :

- Le label est "Assigned to (multiple)"
- le nom est "multi_assigned_to"

Le menu de sélection des champs sur la droite vous liste les champs utilisables dans le mode expert (tous ne le sont pas). Ce sont les labels des champs qui sont affichés, mais quand vous en sélectionnez un ce sera son nom qui sera utilisé.

En fonction du type de champ choisi différents opérateurs seront utilisables.

### Les Opérateurs :

**Les opérateurs de comparaison**, utilisable pour comparer un champ avec une valeur (texte, entier, flottant, date, liste, ...)

- **=** “est égal”
- **<** “inférieur”
- **>** “supérieur”
- **!=** “est inégal”

**Les opérateurs logiques**, utilisables entre 2 critères différents

- **AND**
- **OR**

**L'opérateur de date**, utilisable pour définir une fenêtre

- **BETWEEN(valeur1, valeur2)**

**Les opérateurs de liste**, utilisable pour définir une liste de valeur à inclure ou exclure

- **IN(valeur1, valeur2, valeur3, ...)**, liste de valeurs à inclure
- **NOT IN(valeur1, valeur2, valeur3, ...)**, liste de valeurs à exclure

**Les opérateurs spéciaux : les valeurs d’assignement dynamique**

- **NOW()**, permet d'utiliser la date du jour comme valeur
- **MYSELF()**, permet d'utiliser l'utilisateur courant comme valeur de test

> [!NOTE]
> Info pratique
> 
> Pour rendre vos requêtes lisibles, il est fortement conseillé de **mettre des parenthèses autour de chaque critère**.

## Enregistrer un résultat de recherche

Vous pouvez enregistrer un résultat de recherche en choisissant d’enregistrer le nouveau rapport.

![Report modified by Tuly with options to save or cancel changes.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 14.40.22.png)

Il sera modifié avec les nouveaux critères de recherche, mais vous pouvez aussi l'enregistrer sous un autre nom. Et vous pourrez ainsi le retrouver dans la liste des rapports disponibles.

![Dropdown menu showing options for viewing personal bug reports in a software application.](https://cdn.document360.io/79854fff-060e-43bf-bca3-f7bb88550673/Images/Documentation/Capture d’écran 2025-12-04 à 14.44.15.png)

Il existe deux types de rapports :

- Les **rapports publics**
- Les **rapports personnels**

Chaque utilisateur peut créer ses rapports personnels et l'administrateur du tracker peut créer des rapports publics qui pourront être réutilisés par les membres du projet.

> [!NOTE]
> Info pratique
> 
> Il est fortement conseillé de créer des rapports publics pour simplifier l’usage des trackers dans son projet et éviter aux membres de créer les mêmes rapports pour leur usage personnel.

Sélection d'artefact qui pourra s'afficher de différentes façons, sous forme de graphique, de table ou de tableau de carte

Elément unitaire qui compose un artefact, les nombres et la configuration des champs se fait dans la description du tracker

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.

## Related

- [Introduction aux Trackers](/introduction-aux-trackers.md)