6.1.7. Commentaires

6.1.7.1. Obtention des commentaires

Ceci permet d'obtenir des données sur les commentaires en fonction d'un numéro de bogue ou de commentaire.

Requête

Pour obtenir tous les commentaires pour un bogue particulier en utilisant le numéro de bogue ou son alias :

GET /rest/bug/(id_or_alias)/comment

Pour obtenir un commentaire spécifique en se basant sur le numéro de commentaire :

GET /rest/bug/comment/(comment_id)
nom type description
id_or_alias mixed Un numéro de bogue unique (entier) ou son alias.
comment_id int Un numéro de commentaire (entier).
new_since datetime Si spécifié, la méthode ne renverra que les commentaires postérieurs à cet horodatage. Ceci n'affecte que les commentaires renvoyés par l'argument ids. Vous obtiendrez toujours tous les commentaires de l'argument comment_ids, même si ceux-ci sont antérieurs à cet horodatage.

Réponse

{
  "bugs": {
    "35": {
      "comments": [
        {
          "time": "2000-07-25T13:50:04Z",
          "text": "Bogue de test pour corriger un problème de suppression dans la liste Copie à.",
          "bug_id": 35,
          "count": 0,
          "attachment_id": null,
          "is_private": false,
          "tags": [],
          "creator": "user@bugzilla.org",
          "creation_time": "2000-07-25T13:50:04Z",
          "id": 75
        }
      ]
    }
  },
  "comments": {}
}

Deux éléments sont renvoyés :

bugs Ceci est utilisé pour les bogues spécifiés dans ids. Ceci est un objet dont les clés sont les numéros de bogues, et la valeur est un objet avec une seule clé, comments, qui est un tableau de commentaires. (Le format des commentaires est décrit ci-dessous).

Chaque bogue individuel ne sera renvoyé qu'une seule fois, donc, si vous indiquez un numéro plusieurs fois dans ids, il ne sera renvoyé qu'une seule fois.

comments Chaque commentaire individuel demandé dans comment_ids est renvoyé ici, dans un objet où le numéro de commentaire est la clé et la valeur est le commentaire lui-même. (Le format des commentaires est décrit ci-dessous).

Un commentaire, comme indiqué ci-dessus, est un objet qui contient deux éléments :

nom type description
id int Le numéro global unique du commentaire.
bug_id int Le numéro du bogue auquel se rapporte le commentaire.
attachment_id int Si le commentaire a été fait sur un fichier joint, ce sera le numéro du fichier joint. Sinon, il sera nul.
count int Le numéro d'ordre du commentaire dans le bogue. La description porte le numéro 0, les commentaires commencent à 1.
text string Le texte du commentaire.
creator string L'identifiant de connexion de l'auteur du commentaire.
time datetime L'horodatage (dans le fuseau horaire de Bugzilla) de l'ajout du commentaire.
creation_time datetime

C'est exactement la même chose que la clé time. Utilisez ce champ plutôt que time pour la cohérence avec les autres méthodes, comprenant Obtention d'un bogue et Obtention d'un fichier joint.

Pour des raisons de compatibilité, time est toujours utilisable. Cependant, veuillez noter que time pourrait être rendu obsolète et supprimé dans une future version.
is_private boolean true si ce commentaire est confidentiel (seulement visible par le groupe insidergroup), false dans le cas contraire.

6.1.7.2. Création de commentaires

Ceci permet d'ajouter un commentaire à un bogue dans Bugzilla.

Requête

Pour créer un commentaire sur un bogue existant :

POST /rest/bug/(id)/comment

{
  "comment" : "Ceci est un nouveau commentaire",
  "is_private" : false
}
nom type description
id int Le numéro ou l'alias du bogue auquel ajouter le commentaire.
comment string Le commentaire à ajouter au bogue. S'il est vide ou ne contient que des espaces, une erreur sera renvoyée indiquant que vous n'avez pas défini le paramètre comment.
is_private boolean Si défini à true, le commentaire est confidentiel, sinon, il est supposé être public.
work_time double Ajoute ce nombre d'heure dans les Heures travaillées du bogue. Si vous ne faites pas partie du groupe timetracking, cette valeur sera ignorée.

Réponse

{
  "id" : 789
}
nom type description
id int Numéro du commentaire nouvellement créé.

6.1.7.3. Recherche d'étiquette de commentaire

Recherche des étiquettes de commentaire contenant la chaîne.

Request

Pour rechercher des étiquettes de commentaire :

GET /rest/bug/comment/tags/(query)

Exemple :

GET /rest/bug/comment/tags/spa
nom type description
query string Seules les étiquettes contenant cette chaîne seront renvoyées.
limit int Si fourni, ne renverra pas plus que limit étiquettes. Par défaut limité à 10.

Réponse

[
  "spam"
]

Un tableau des étiquettes correspondantes.

6.1.7.4. Mise à jour des étiquettes de commentaires

Ajoute ou supprime les étiquettes d'un commentaire.

Requête

Pour mettre à jour les étiquettes de commentaire attachées à un commentaire :

PUT /rest/bug/comment/(comment_id)/tags

Exemple :

{
  "comment_id" : 75,
  "add" : ["spam", "bad"]
}
nom type description
comment_id int Le numéro du commentaire à mettre à jour.
add array Les étiquettes à attacher au commentaire.
remove array Les étiquettes à retirer du commentaire.

Réponse

[
  "bad",
  "spam"
]

Un tableau de chaînes contenant les étiquettes mises à jour du commentaire.

Cette documentation contient très probablement des bogues ; si vous en découvrez, veuillez les signaler ici.