Suivi des éléments de travail

Article
07/14/2023

Ressources de suivi des éléments de travail

Obtenez, créez et mettez à jour des bogues, des tâches et d’autres éléments de travail pour votre équipe. Des requêtes vous permettent d’exploiter toute la puissance du langage de requête d’élément de travail pour rechercher et filtrer des éléments de travail. Vous pouvez utiliser le langage de requête d’élément de travail pour accéder à chaque élément de travail correspondant à la requête. Les éléments de travail conservent un historique complet. Vous pouvez obtenir chaque révision complète de l’élément de travail ou uniquement les mises à jour effectuées dans chaque révision. Des éléments de travail peuvent également être marqués d’une balise.

Tâches courantes

Obtenir des éléments de travail à l’aide d’une requête

Recherchez la requête que vous souhaitez utiliser.
Obtenez les résultats de cette requête.
Obtenez chacun des éléments de travail par ID.

Mettre à jour des éléments de travail dans le lot

Utilisez l’api Batch WorkItem Update pour mettre à jour vos éléments de travail dans batch.

Mettre à jour les champs d’un élément de travail

Obtenez l’ID de l’élément de travail que vous souhaitez mettre à jour.
Mettez à jour les champs de l’élément de travail.

Lier deux éléments de travail

Obtenez l’ID des éléments de travail que vous souhaitez lier.
Ajoutez un lien entre les éléments de travail.

Créer deux éléments de travail et les lier

Utilisez la commande Créer un élément de travail et ajouter une API de lien dans un appel par lots.

Joindre un fichier à un élément de travail

Obtenez l’ID de l’élément de travail que vous souhaitez mettre à jour.
Chargez la pièce jointe dans le magasin de pièces jointes.
Ajoutez la pièce jointe à l’élément de travail.

Créer un élément de travail

Créez un élément de travail. Veillez à fournir au moins un titre. Certains types d’éléments de travail nécessitent des valeurs pour d’autres champs.

Obtenir l’historique complet d’un élément de travail

Obtient l’ID de l’élément de travail.
Obtenir la liste des mises à jour apportées à un élément de travail.
Obtenez l’élément de travail entier tel qu’il apparaît dans n’importe quelle révision.

Supprimer un élément de travail

Obtient l’ID de l’élément de travail.
Supprimez l’élément de travail.

Obtenir les champs utilisés dans un projet d’équipe

Obtenez les types d’éléments de travail utilisés dans un projet d’équipe.
Obtenez chaque type d’élément de travail pour voir les champs qu’il utilise. (Passez au-delà de la forme xml pour fieldinstances.)

Obtenir des catégories d’éléments de travail

Utilisez des catégories d’éléments de travail pour obtenir les types d’éléments de travail utilisés dans un projet d’équipe pour différentes fonctions. Par exemple, pour voir les éléments de travail qui s’affichent dans le backlog, obtenez la catégorie d’exigences.

Obtenir des zones et des itérations

Obtenez la hiérarchie de zones ou la hiérarchie d’itération pour votre projet d’équipe.

Obtenir des types de relations d’élément de travail

Obtenez les types disponibles de liens d’éléments de travail disponibles dans votre collection de projets.

Ressources de métadonnées d’élément de travail

Les éléments de travail sont régis par les métadonnées. Certaines métadonnées sont limitées à un projet d’équipe spécifique, et d’autres métadonnées sont limitées à une collection de projets (comme la collection par défaut de votre compte Azure DevOps Services).

Métadonnées étendues au projet

Votre projet d’équipe comporte un ensemble de types d’éléments de travail. Chaque type d’élément de travail peut appartenir à une catégorie telle que « exigence » ou « bogue » pour définir son rôle dans le projet. Les nœuds de classification définissent l’ensemble de valeurs qui peuvent être utilisées dans les champs de zone et d’itération pour les éléments de travail du projet d’équipe.

Catégories
Nœuds de classification (zones et itérations)
Types d’éléments de travail

Métadonnées étendues à la collection

Les types d’éléments de travail partagent des champs et des types de relation (liens et pièces jointes) avec d’autres types d’éléments de travail.

API de mise à jour par lot d’éléments de travail

Effectue plusieurs demandes de mise à jour d’élément de travail. La réponse contient des réponses individuelles pour chacune des demandes du lot. Les demandes ayant échoué n’affectent pas les demandes suivantes dans le lot.

SÉMANTIQUE DE L’API REST

PATCH https://dev.azure.com/{organization}/_apis/wit/$batch?api-version=6.1

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	Chemin d’accès	True	string	Nom de l’organisation Azure DevOps.
api-version	query		string	Version de l’API à utiliser.
bypassRules	query		boolean	N’appliquez pas les règles de type d’élément de travail sur cette mise à jour.
suppressNotifications	query		boolean	Ne déclenchez aucune notification pour cette modification.

Corps de la demande

Le corps de la demande est composé en tant que liste des demandes de mise à jour de l’élément de travail. Chaque élément de cette liste contient toutes les informations sur une seule demande de mise à jour, y compris la méthode REST, le chemin d’accès, les en-têtes et le corps.

Vous pouvez case activée documentation de mise à jour de l’élément de travail pour obtenir des informations détaillées sur une requête unique.

Exemple de mise à jour par lot

Requête

PATCH https://dev.azure.com/fabrikam/_apis/wit/$batch?api-version=6.1

Corps de la requête

[
  {
    // Add priority and test rev on work item with id 1
    "method": "PATCH",
    "uri": "/_apis/wit/workitems/1?api-version=6.1",
    "headers": {
      "Content-Type": "application/json-patch+json"
    },
    "body": [
      {
        "op": "test",
        "path": "/rev",
        "value": 3
      },
      {
        "op": "add",
        "path": "/fields/Microsoft.VSTS.Common.Priority",
        "value": "1"
      }
    ]
  },
  {
    // Replace tags on work item with id 299x   
    "method": "PATCH",
    "uri": "/_apis/wit/workitems/299?api-version=6.1",
    "headers": {
      "Content-Type": "application/json-patch+json"
    },
    "body": [
      {
        "op": "replace",
        "path": "/fields/System.Tags",
        "value": "Tag1; Tag2"
      }
    ]
  },
  {
    // You can also use Work Item Create format
    "method": "PATCH",
    "uri": "/mytestprojectname/_apis/wit/workitems/$Bug?api-version=4.1",
    "headers": {
        "Content-Type": "application/json-patch+json"
    },
    "body": [
        {
            "op": "add",
            "path": "/id",
            "value": "-1"
        },
        {
            "op": "add",
            "path": "/fields/System.Title",
            "from": null,
            "value": "Sample 1"
        }
    ]
  },
]

Réponse

La réponse se compose de réponses individuelles pour chaque demande de mise à jour par lot.

count : nombre de réponses de mise à jour par lot retournées
value : liste des objets de réponse avec son code de réponse, ses en-têtes et son corps

{
  "count": 2,
  "value": [
    {
      "code": 200,
      "headers": {
        "Content-Type": "application/json; charset=utf-8"
      },
      "body": "{work item object}"
    },
    {
      "code": 200,
      "headers": {
        "Content-Type": "application/json; charset=utf-8"
      },
      "body": "{work item object}"
    }
  ]
}