Le module de recherche

Prev Next

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.

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.

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

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.

 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.

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.

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

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

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.

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.

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.

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. 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. : Date postérieure à celle configurée

  • Dropdown menu displaying options for selection in a user interface. : Date identique à celle configurée

  • Dropdown menu labeled 'Avant' indicating selection options for a user interface. : 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.

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.

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

Search query example demonstrating logical operators for database queries.

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)

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.

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.

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.

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

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