6. Utilisation de Bugzilla¶

6.4.1. Cycle de vie d'un bogue Bugzilla¶

6.5.1. Tableaux booléens¶

Les recherches avancées sont faites à l'aide de tableaux booléens.

Les tableaux booléens affinent encore plus l'ensemble de résultats renvoyés par une requête. Il est possible de rechercher des bogues vaec des combinaisons élaborées de critères.

La plus simple des recherches booléennes n'a qu'un seul terme. Ces recherches permettent au champ sélectionné à gauche d'être comparé en utilisant un opérateur ayant une valeur spécifique. En utilisant les boutons Et, Ou et Ajouter un autre tableau booléen, des termes supplémentaires peuvent être ajoutés à la requête, affinant ainsi encore la liste des bogues renvoyés par la requête.

Il y a trois champs pour chaque ligne d'une recherche booléenne.

• Champ : les éléments recherchés
• Opérateur : l'opérateur de comparaison
• Valeur : la valeur à laquelle le champ est comparé

6.5.2. Recherche rapide¶

La recherche rapide est un outil de recherche sous la forme d'une simple boîte de texte pouvant utiliser les méta-caractères pour indiquer ce que l'on cherche. Par exemple, en saisissant "toto|titi" dans la boîte de texte, cele effectuera une recherche de toto ou titi dans les champs Résumé et Tableau blanc d'un bogue ; en ajoutant ":ProduitX", la recherche s'effectuera seulement dans ce produit. Vous pouvez l'utiliser pour trouver un bogue par son numéro ou son alias aussi.

La boîte de recherche rapide se trouve dans le pied des pages de Bugzilla. Sur la page d'accueil de Bugzilla, se trouve un lien Aide qui détaille son utilisation.

6.5.3. Sensibilité à la casse dans les recherches¶

Les recherches dans Bugzilla sont insensibles à la casse et aux accents, avec l'utilisation de systèmes de gestion de bases de données MySQL ou Oracle. Cependant, lorsque Bugzilla est utilisé avec PostgreSQL, certaines recherches sont sensibles à la casse. Ceci est dû à la façon dont PostgreSQL traite la sensibilité à la casse et aux accents.

6.5.4. Listes des bogues¶

Si vous lancez une recherche, une liste des bogues correspondant sera renvoyée.

Le format de cette liste est configurable. Par exemple, elle peut être triée en cliquant sur les en-têtes de colonnes. D'autres fonctionnalités utiles peuvent être accédées en utilisant les liens au bas de la liste :

Format long :

Ceci donne une grande page avec les champs Résumé non modifiables de chaque bogue.

XML :

Produit la liste de bogues au format XML.

CSV :

Produit la liste de bogues comme des valeurs séparées par des virgules, pour l'importer par exemple dans un tableur.

Flux :

Produit la liste de bogues sous forme de flux Atom. Copiez ce lien dans votre lecteur de flux préféré. Si vous utilisez Firefox, vous pouvez aussi enregistrer la liste sous forme de marque-page dynamique en cliquant sur l'icône de marque-page dynamique dans la barre d'adresse. Pour limiter le nombre de bogues dans le flux, ajouter un paramètre limit=n à l'URL.

iCalendar :

Produit la liste sous forme de fichier iCalendar. Chaque bogue est représenté sous forme de tâche dans l'agenda importé.

Changer les colonnes :

Modifie les attributs des bogues apparaissant dans la liste.

Changer plusieurs bogues à la fois :

Si votre compte a suffisamment de droits et qu'il apparaît plus d'un bogue dans la liste, ce lien est affiché et vous permet d'apporter le même changement sur tous les bogues de la liste. Par exemple, changer leur responsable.

Envoyer un courriel aux responsables des bogues :

Si plus d'un bogue apparaît dans la liste et qu'il y a au moins deux responsables distincts, ce lien est affiché pour permettre d'envoyer facilement un courriel à tous les responsables de ola liste de bogues.

Modifier la recherche :

Si vous n'obtenez pas exactement les résultats que vous escomptiez, vous pouvez revenir à la page de requête par ce lien et faire des ajustements sur la requête pour obtenir de meilleurs résultats.

Enregistrer sous :

Vous pouvez donner un nom à la requête et l'enregistrer ; un lien apparaîtra dans votre pied de page et vous permettra d'y accéder et de l'exécuter rapidement plus tard.

6.5.5. Ajout/suppression de marqueurs¶

Vous pouvez ajouter ou supprimer des marqueurs dans chaque bogue, qui vous permettent de les trouver et de les gérer plus facilement. Les marqueurs sont propres à un utilisateur et ne peuvent être affichés ou modifiés que par l'utilisateur qui les a créés. Vous pouvez alors lancer des requêtes en utilisant des marqueurs comme critère, en utilisant soit le formulaire de recherche avancée, soit en saisissant tag:mon_nom_de_marqueur dans la boîte de recherche rapide en haut (ou en bas) de la page. Pour activer cette fonctionnalité, vous devez activer la préférence utilisateur Activer l'utilisation des marqueurs pour les bogues, voir Préférences utilisateur. Cette fonctionnalité est désactivée par défaut.

Cette fonctionnalité est utile pour suivre plusieurs bogues mais pour des raisons différentes. Plutôt que de vous ajouter à la liste Copie à de tous ces bogues et de mélanger toutes ces raisons, vous pouvez maintenant les stocker dans des listes séparées, par exemple Ne pas oublier, Bogues intéressants ou Triage. Un des gros avantages de ce moyen de gérer les bogues est que vous pouvez facilement ajouter ou enlever les marqueurs des bogues un par un.

6.6.1. Rapporter un nouveau bogue¶

Des années d'expérience dans l'écriture de bogues ont été distillées pour votre satisfaction dans les recommandations d'écriture de bogue. Bien que certains des conseils soient spécifiques à Mozilla, les principes de base (reproductibilité, spécificité, isolation du produit utilisé, version du produit, le composant incriminé, la plateforme matérielle, et le système d'exploitation utilisé au moment du bogue) assurent des correctifs appropriés pour le bogue que vous avez rencontré.

La procédure pour ouvrir un bogue est la suivante :

1. Cliquez sur le lien Rapporter disponible dans le pied des pages ou sur le lien Rapporter un nouveau bogue affiché sur la page d'accueil de l'installation de Bugzilla.

   Note

   Si vous voulez rapporter un bogue pour tester le fonctionnement de Bugzilla, vous pouvez le faire sur nos installations de test sur Landfill.

2. Vous devez d'abord sélectionner le produit dans lequel vous avez trouvé un bogue.

3. Vous voyez maintenant un formulaire où vous pouvez indiquer le composant (la partie du produit affectée par le bogue que vous avez découvert ; si vous n'en avez aucune idée, sélectionnez Général si un tel composant existe), la version du programme que vous utilisez, le système d'exploitation et la plateforme sur laquelle vous exécutez le programme, et la gravité du bogue (si le bogue que vous avez trouvé plante le programme, c'est probablement un bogue major ou critical; s'il s'agit d'une coquille quelque part, c'est un bogue minor; s'il s'agit de quelque chose que vous voudriez voir mis en œuvre, choisissez enhancement).

4. Vous devez maintenant fournir un résumé court mais descriptif du bogue que vous avez trouvé. Mon programme plante tout le temps est un résumé très pauvre et n'aide pas du tout les développeurs. Essayez quelque chose de plus significatif ou votre bogue sera probablement ignoré à cause du manque de précision. L'étape suivante est de donner une liste très détaillée des étapes pour reproduire le problème que vous avez rencontré. Essayez de limiter ces étapes au minimum nécessaire pour reproduire le problème. Cela facilitera la vie aux développeurs et la probabilité qu'ils traitent votre bogue dans un délai raisonnable sera beaucoup plus grande.

   Note

   Assurez-vous que tout ce qui se trouve dans le résumé figure aussi dans le premier commentaire. Les résumés sont souvent mis à jour et cela assurera que les informations d'origine soient facilement accessibles.

5. Lorsque vous rapportez le bogue, vous pouvez également joindre un document (un jeu de test, un correctif, ou une copie d'écran du problème).

6. Suivant l'installation de Bugzilla que vous utilisez et le produit pour lequel vous rapportez le bogue, vous pouvez aussi demander aux développeurs de considérer votre bogue de différentes manières (comme demander la revue du correctif que vous venez de joindre, demander que votre bogue bloque la prochaine version du produit et beaucoup d'autres requêtes spécifiques au produit).

7. C'est maintenant le bon moment pour relire votre rapport de bogue. Retirer toutes les fautes d'orthographe, sans quoi votre bogue pourrait ne pas être trouvé par les développeurs qui exécutent des requêtes sur des mots spécifiques, et par conséquent, votre bogue ne serait pas porté à leur attention. Assurez-vous aussi de n'avoir pas oublié d'informations importantes que les développeurs devraient savoir pour reproduire le problème et que la description du problème est suffisamment claire et explicite. Si vous pensez que votre rapport de bogue est prêt, la dernière étape est de cliquer sur le bouton Soumettre pour ajouter votre rapport à la base de données.

Vous n'avez pas besoin d'ajouter toutes ou des mots similaires dans le champ URL. S'il n'y a pas d'URL spécifique associée au bogue, laissez ce champ vide.

Si vous pensez qu'un bogue que vous avez rapporté a été incorrectement marqué comme DOUBLON d'un autre, veuillez poser votre question dans votre bogue et non dans celui à cause duquel votre boque a été marqué comme doublon. Vous pouvez ajouter à la liste Copie à la personne qui a marqué votre bogue comme doublon, si elle n'y figure pas déjà.

6.6.2. Clonage d'un bogue existant¶

À compter de la version 2.20, Bugzilla a une fonctionnalité qui vous permet de cloner un bogue existant. Le bogue nouvellement créé héritera de la plupart des paramètres de l'ancien bogue. Ceci vous permet de reporter plus facilement dans un nouveau bogue des problèmes similaires. Pour utiliser cette fonctionnalité, rendez-vous dans le bogue que vous voulez cloner, puis cliquer sur le lien Cloner ce bogue sur la page du bogue. Ceci vous amènera à la page Rapporter un bogue qui sera pré-remplie avec les valeurs de l'ancien bogue. Vous pouvez changer ces valeurs et/ou en ajouter d'autres si nécessaire.

6.7.1. Visionneuse de correctifs¶

L'affichage et la revue des correctifs dans Bugzilla sont souvent difficiles à cause du manque de contexte, d'un format incorrect et des problèmes de lisibilités inhérents que les correctifs en texte brut présentent. La visionneuse de fichiers est une amélioration de Bugzilla conçue pour corriger cela en offrant un contexte amélioré, des liens vers les sections et l'intégration à Bonsai, LXR et CVS.

La visionneuse de fichiers vous permet :

• De voir les correctifs en couleurs, avec une vue côte-à-côte plutôt que d'essayer d'interpréter le contenu du correctif.
• De voir les différences entre deux correctifs.
• D'obtenir un contexte plus étendu dans un correctif.
• De réduire et de développer des sections dans un correctif pour une lecture facile.
• De faire un lien vers une section particulière d'un correctif pour une discussion ou une revue.
• D'aller dans Bonsai ou LXR pour voir plus de contexte, le responsable d'une ligne de code et les références croisées pour la partie du correctif que vous regardez.
• De créer un diff au format unifié à partir de n'importe quel correctif, quel que soit son format d'origine.

6.8.1. Hyperlien automatique¶

Les commentaires dans Bugzilla sont en texte brut : saisir <U> produira <, U, > plutôt que du texte souligné. Cependant, Bugzilla fera automatiquement des hyperliens pour certaines parties du texte des commentaires. Par exemple, le texte http://www.bugzilla.org sera transformé en hyperlien : http://www.bugzilla.org. D'autres chaînes peuvent être transformées en lien :

• bogue 12345
• commentaire 7
• bogue 23456, commentaire 53
• attachment 4321
• mailto:georges@exemple.com
• georges@exemple.com
• ftp://ftp.mozilla.org
• La plupart des autres types d'URL

Le corollaire ici, c'est que si vous saisissez un numéro de bogue dans un commentaire, vous devez mettre le mot bogue devant pour qu'il soit transformé en hyperlien pour la commodité des autres.

6.8.2. Commentaires¶

Si vous changez les champs d'un bogue, ne faites de commentaire que si vous avez quelque chose de pertinent à dire ou que Bugzilla impose que vous le fassiez. Dans le cas contraire, vous spammeriez les gens inutilement avec des courriels de bogues. Pour prendre un exemple : un utilisateur peut définir ses préférences pour filtrer les messages pour ne pas recevoir de courriel quand quelqu'un s'ajoute dans la liste Copie à d'un bogue (ce qui arrive souvent). Si vous vous ajouter à la liste Copie à et que vous ajouter un un commentaire disant Je m'ajoute dans la liste Copie à, alors cette personne recevra un courriel sans intérêt qu'elle n'aurait pas reçu autrement.

N'utilisez pas de signature dans les commentaires. Signer avec votre prénom (Jean) est acceptable, si vous le faites par la force de l'habitude, mais des signatures complètes de style courriel ou liste de diffusion avec quatre lignes d'ASCII art ne le sont pas.

6.8.3. Formatage des commentaires du côté du serveur¶

Bugzilla stocke les commentaires sous forme non formatée et les formate lors de leur affichage. Ceci permet d'assurer un formatage correct dans tous les navigateurs. Les lignes commençant par le caractère > sont traitées comme des citations et ne sont pas formatées.

6.8.4. Arbre de dépendance¶

sur la page Arbre de dépendance liée à partir de chaque page de bogue, vous pouvez voir les relations de dépendances du bogue sous forme de structure arborescente.

Vous pouvez modifier la profondeur à afficher et vous pouvez masquer les bogues résolus dans cette page. Vous pouvez aussi réduire ou développer les dépendances pour chaque bogue dans la vue arborescente, en utilisant les boutons [-] ou [+] qui apparaissent avant son résumé. Cette option n'est pas disponible pour les bogues terminaux de l'arbre (qui n'ont pas d'autres dépendances).

6.10.1. Préférences générales¶

Cet onglet vous permet de modifier plusieurs paramètres par défaut de Bugzilla.

• Apparence générale de Bugzilla - Sélectionne le thème à utiliser. Bugzilla gère l'ajout de thèmes personnalisés.
• Citer le commentaire associé lors du clic sur son lien de réponse - Définit le comportement du lien répondre dans les commentaires. Les options permettent de citer le commentaire complet, d'indiquer seulement le numéro du commentaire ou de désactiver le lien.
• Langue utilisée dans les courriels - Sélectionne la langue dans laquelle les courriels envoyés seront écrits, dans la liste des langues disponibles.
• Après avoir changé un bogue - Permet de contrôler quelle page est affichée après la soumission de changements sur un bogue. Les options permettent : d'afficher le bogue juste modifié, d'afficher le bogue suivant de votre liste, ou de ne rien faire du tout.
• Activer l'utilisation des marqueurs pour les bogues - Active ou désactive les marqueurs.
• Agrandir les champs de texte lorsqu'on écrit dedans (requiert JavaScript) - Active ou désactive l'extension automatique des zones de texte quand on y saisit du texte.
• Séparateur de champ dans les fichiers CSV - Permet de choisir entre une virgule ou un point-virgule pour l'export des listes de bogues en format CSV.
• M'ajouter automatiquement à la liste « Copie à » des bogues que je modifie - Définit le comportement par défaut de la liste Copie à. Les options sont : Toujours, Jamais et Seulement si ne ne joue pas déjà un rôle.
• En visionnant un bogue, afficher les commentaires dans cet ordre - Contrôle l'ordre d'affichage des commentaires. Les options sont Du plus ancien au plus récent, Du plus récent au plus ancien et Du plus récent au plus ancien, mais après la description.
• Afficher une citation en haut de chaque liste de bogues - Définit si une citation sera affichée dans la liste de bogues.

6.10.2. Préférences de messagerie¶

Cet onglet permet d'activer ou de désactiver la notification par courriel en fonction d'événements spécifiques.

En général, les utilisateurs ont pratiquement tout contrôle sur la quantité de courriels que Bugzilla leur envoie. si vous voulez recevoir le maximum de courriels possible, cliquez sur le bouton Activer tous les courriels. Si vous ne voulez pas recevoir de courriels du tout de la part de Bugzilla, cliquez sur le bouton Désactiver tous les courriels.

Il y a deux options globales : Envoyer un courriel quand quelqu'un me demande de définir une étiquette et Envoyer un courriel quand quelqu'un a défini une étiquette que j'avais demandée. Celles-ci définissent la réception de courriels en fonction des étiquettes. Leur utilisation est simple ; sélectionnez les cases à cocher si vous voulez que Bugzilla vous envoie des courriels pour l'une ou l'autre des conditions.

Si vous voulez paramétrer votre courriel de bogues pour quelque chose entre Tous les courriels et Aucun courriel, le tableau Options spécifiques du champ/destinataire vous permet de faire cela. Les lignes du tableau définissent les événements qui peuvent arriver à un bogue -- des choses comme : un fichier a été joint, de nouveaux commentaires ont été faits, la priorité à changé, etc. Les colonnes du tableau définissent votre relation avec le bogue :

• Rapporteur -Où vous êtes la personne qui a initialement rapporté le bogue. Votre nom/compte apparaît dans le champ Rapporteur :.
• Responsable - Où vous êtes la personne qui a été désignée comme responsable du bogue. Votre nom/compte apparaît dans le champ Assigné à : du bogue.
• Contact QA - Vous êtes le contact QA désigné pour le bogue. Votre compte apparaît dans le champ Contact QA : du bogue.
• En copie- Vous êtes dans la liste Copie à du bogue. votre compte apparaît dans la boîte de texte Copie à : du bogue.
• Votant - Vous avez placé un ou plusieurs votes sur le bogue. Votre compte apparaît seulement si quelqu'un clique sur le lien Afficher les votes pour ce bogue dans le bogue.

Pour affiner la gestion de la quantité de courriels de bogues, décidez des événements pour lesquels vous voulez recevoir des courriels de bogues ; décidez ensuite si vous voulez les recevoir tout le temps (cochez alors la case dans chaque colonne), ou seulement lorsque vous avez une certaine relation avec un bogue (cochez la case pour ces colonnes seulement). Par exemple : si vous ne voulez pas recevoir de courriel quand quelqu'un s'ajoute à la liste Copie à, vous pouvez décocher toutes les cases dans la ligne Le champ ``Copie à : est modifié``. Comme autre exemple, si vous ne voulez jamais recevoir de courriel sur les bogues que vous avez rapportés à moins qu'ils ne soient résolus, vous devez décocher toutes les acses de la colonne Rapporteur sauf celle sur la ligne Le bogue est résolu ou rouvert.

Bugzilla a une fonctionnalité appelée Surveillance d'utilisateurs. Quand vous saisissez un ou plusieurs comptes utilisateurs séparés par des virgules (généralement des adresses électroniques) dans la boîte de texte, vous recevez une copie de tous les courriels de bogues envoyés à ces utilisateurs (en fonction des paramètres de sécurité). Cette fonctionnalité puissante permet des transitions en douceur lorsque les développeurs changent de projet ou lorsque les utilisateurs partent en vacances.

Tous les utilisateurs indiqués dans le champ Utilisateurs vous surveillant vous ont ajoutés dans leur liste Surveillance d'utilisateur et peuvent obtenir des courriels de bogues en fonction de votre relation avec le bogue et leurs paramètres Options spécifiques du champ/destinataire.

La section Ignorer les bogues vous permet d'indiquer une liste de bogues séparés par des virgules pour lesquels vous ne voulez recevoir aucune notification par courriel. Supprimer un bogue de cette liste réactivera la notification par courriel pour ce bogue. Ceci est particulièrement utile par exemple si vous êtes le rapporteur d'un bogue générant beaucoup de commentaires et pour lequel vous n'êtes plus intéressé ou si vous surveillez quelqu'un recevant des notifications pour un tel bogue.

6.10.3. Recherches enregistrées¶

Dans ce volet, vous pouvez voir et exécuter toutes recherches enregistrées que vous avez créées, et aussi toutes autres recherches enregistrées partagées par d'autres membres du groupe défini par le paramètre querysharegroup. Les recherches enregistrées peuvent être ajoutées au pied de page à partir de cet écran. Si quelqu'un partage une recherche avec un groupe, il sera autorisé à y assigner des utilisateurs. La personne qui partage la recherche peut choisir de faire afficher la recherche dans le pied de page des membres directs du groupe par défaut.

6.10.4. Information de compte¶

Sur cet onglet, vous pouvez changer les informations de base de votre compte, y compris votre mot de passe, votre adresse électronique et votre vrai nom. Pour des raisons de sécurité, pour modifier quelque chose sur cette page, vous devez saisir votre mot de passe actuel dans le champ Mot de passe au sommet de la page. Si vous tentez de modifier votre adresse électronique, un courriel de confirmation est envoyé sur l'ancienne et la nouvelle adresses, contenant un lien pour confirmer le changement. Ceci aide à empêcher le piratage de compte.

6.10.5. Permissions¶

C'est une page purement informative qui souligne vos permissions actuelles sur cette installation de Bugzilla.

Vous trouverez une liste complète des permissions ci-dessous. Seuls les utilisateurs ayant des privilèges editusers peuvent modifier les permissions d'autres utilisateurs.

admin

Indique que l'utilisateur est un administrateur.

bz_canusewhineatothers

Indique que l'utilisateur peut configurer les rapports de notifications pour d'autres utilisateurs.

bz_canusewhines

Indique que l'utilisateur peut configurer les rapports de notifications pour lui-même.

bz_quip_moderators

Indique que l'utilisateur peut modérer les citations.

bz_sudoers

Indique que l'utilisateur peut accomplir des actions à la place d'autres utilisateurs.

bz_sudo_protect

Indique d'autres utilisateurs ne peuvent pas se faire passer pour cet utilisateur.

canconfirm

Indique que l'utilisateur peut confirmer un bogue ou le marquer comme doublon.

creategroups

Indique que l'utilisateur peut créer ou détruire des groupes.

editbugs

Indique que l'utilisateur peut modifier tous les champs d'un bogue.

editclassifications

Indique que l'utilisateur peut créer, détruire et modifier des classements.

editcomponents

Indique que l'utilisateur peut créer, détruire et modifier des composants.

editkeywords

Indique que l'utilisateur peut créer, détruire et modifier des mots-clés.

editusers

Indique que l'utilisateur peut modifier ou désactiver des utilisateurs.

tweakparams

Indique que l'utilisateur peut modifier les Paramètres.

6.11.1. Rapports¶

Un rapport est une vue de l'état actuel de la base de données.

Vous pouvez obtenir des rapports sous forme de tableaux HTML ou sous forme graphique avec des diagrammes linéaires, circulaires ou des histogrammes. Ils ont chacun une page distincte pour leur paramètrage, mais ce sont de proches cousins. Une fois que vous avez défini et affiché un rapport, vous pouvez basculer entre les différentes vues à volonté.

Les deux types de rapport sont basés sur l'idée d'une définition d'un ensemble de bogues en utilisant l'interface de recherche standard et en choisissant certains aspects de cet ensemble à tracer sur les axes horizontal et/ou vertical. Vous pouvez aussi obtenir une forme de rapport en trois dimensions en choisissant d'avoir de multiples images ou tableaux.

Vous pouvez par exemple utiliser le formulaire de recherche pour choisir Tous les bogues du produit ContrôleDuMonde et tracer leur gravité en fonction de leur composant pour voir quel composant a eu a eu le plus grand nombre de bogues critiques rapportés.

Quand vous avez défini vos paramètres et que vous cliquez sur Générer le rapport, vous pouvez basculer entre les formats HTML, CSV, histogramme, linéaire et circulaire. (Note : les diagrammes circulaires ne sont disponibles que si vous n'avez pas défini d'axe vertical car les diagrammes circulaires n'en ont pas). Les autres contrôles s'expliquent d'eux-mêmes ; vous pouvez changer la taille de l'image si vous trouvez que les textes se superposent ou si les barres d'histogrammes sont trop fines.

6.11.2. Graphiques¶

Un graphique est une vue de l'état de la base de données en fonction du temps.

Bugzilla dispose actuellement de deux systèmes de graphiques. Les Anciens graphiques et les Nouveaux graphiques. Les anciens graphiques font partie de Bugzilla depuis longtemps ; ils tracent chaque état et résolution pour chaque produit et c'est tout. Ils sont obsolètes et vont bientôt disparaître. Nous n'en dirons pas plus à leur sujet. Les nouveaux graphiques sont le futur. Ils vous permettent de tracer tout ce que vous pouvez définir comme recherche.

Une ligne individuelle sur un rapport est appelé collection. Toutes les collections sont organisées en catégories et sous-catégories. Les collections que définit automatiquement Bugzilla utilisent le nom de produit comme catégorie et les noms de composants comme sous-catégories, mais il n'est pas obligatoire pour vous de suivre cette norme de nommage avec vos rapports si vous ne le voulez pas.

Les collections peuvent être publiques ou privées. Tout le monde peut voir les collections publiques dans la liste, mais les collections privées ne peuvent être vues que par leurs créateurs. Seuls les administrateurs peuvent rendre les collections publiques. Il ne peut y avoir deux collections, même privées, ayant le même ensemble de catégorie, sous-catégorie et nom. Donc, si vous créez des collections privées, une idée est d'avoir la catégorie qui s'intitule comme votre nom d'utilisateur.

6.13.1. Événement¶

Le système de notifications définit un événement comme une ou plusieurs requêtes exécutées à intervalles réguliers, dont les résultats (s'il y en a) sont envoyées par courriel à l'utilisateur. Les événements sont créés en cliquant sur le bouton Ajouter un événement.

Quand le nouvel événement est créé, la première chose à faire est de définir la Ligne de sujet du courriel. Le contenu de ce champ sera utilisé dans le sujet de tous les courriels générés par cet événement. En plus du paramétrage de la ligne du sujet, un emplacement est prévu pour saisir un description qui sera incluse au début de chaque message (pour indiquer pourquoi vous recevez ce courriel).

L'étape suivante consiste à indiquer quand l'événement doit être exécuté (Programmation) et quelles recherches doivent être faites (Requêtes).

6.13.2. Programmation des notifications¶

Chaque événement de notification est associé à zéro ou plus programmations. Une programmation est utilisée pour indiquer quand la requête (spécifiée dessous) doit être exécutée. Un nouvel événement est créé sans programmation (ce qui signifie qu'il ne sera jamais exécuté, car il n'est pas programmé). Pour ajouter une programmation, cliquez sur le bouton Ajouter une nouvelle programmation.

Chaque programmation utilise un intervalle que vous utilisez pour dire à Bugzilla quand l'événement doit être exécuté. Un événement peut être exécuté certains jours de la semaine, certains jours du mois, pendant les jours ouvrables (du lundi au vendredi) ou chaque jour.

Quand vous avez spécifié le ou les jours pendant lesquels l'événement doit être exécuté, vous devez alors indiquer l'heure de l'exécution de l'événement. Vous pouvez exécuter l'événement à une certaine heure du ou des jours spécifiés, ou chaque heure, demie-heure ou quart d'heure du ou des jours spécifiés.

Si une programmation ne s'exécute pas aussi souvent que vous le voudriez, vous pouvez créer une autre programmation pour le même événement. Par exemple, si vous voulez exécuter un événement les jours dont les dates sont divisible par sept, vous devrez ajouter quatre programmations à l'événement, déclenchées les 7, 14, 21 et 28 du mois (un jour par programmation) à l'heure ou à chaque intervalle de temps choisi.

6.13.3. Requêtes de notifications¶

Chaque notification est associée à zéro ou plus requêtes. Une requête est toute recherche enregistrée à exécuter dans la programmation spécifiée (voir plus haut). Un nouvel événement est créé sans requête associée (ce qui signifie que l'événement ne sera jamais exécuté car il n'y aura jamais de résultats à renvoyer). Pour ajouter une requête, cliquez sur le bouton Ajouter une nouvelle requête.

Le premier champ à examiner dans votre nouvelle requête ajoutée est le champ Ordre. Les requêtes sont exécutées et les résultats inclus dans l'ordre indiqué par le champ Ordre. Les requêtes ayant des valeurs faibles pour le champ Ordre seront exécutées avant celles ayant des valeurs élevées pour ce champ.

Le champ suivant à examiner est le champ Requête. C'est l'endroit où vous choisissez la requête à exécuter. Plutôt que de définir les paramètre de recherche ici, il vous est demandé de choisir dans la liste des recherches enregistrées (la même liste apparaît dans le pied de chaque page de Bugzilla). Vous n'êtes autorisé à choisir que les recherches que vous avez enregistré vous-même (le recherche enregistrée par défaut, Mes bogues n'est pas un choix valide). Si vous n'avez pas de recherches enregistrées, profitez de cette opportunité pour en créer une (voir Listes des bogues).

Quand vous avez choisi la recherche enregistrée à exécuter, donnez à la requête un titre descriptif. Ce titre apparaîtra dans le courriel, au-dessus des résultats de la requête. Si vous choisissez Un message par bogue, le titre de la requête apparaîtra en haut de chaque courriel qui contient un bogue correspondant à votre requête.

Enfin, décidez si les résultats de votre requête doivent être envoyés dans un seul courriel ou si chaque bogue doit apparaître dans son propre courriel.

6.13.4. Enregistrement des modifications¶

Quand vous avez terminé de définir une programmation et de créer au moins une recherche enregistrée, cliquez sur le bouton Mettre à jour/Appliquer. Ceci enregistrera votre événement et le rendra disponible pour une exécution immédiate.