Partager via


Reporting Work Item Revisions

Cette API fournit l’accès à toutes les révisions d’éléments de travail dans votre projet ou collection et vous permet de créer un entrepôt.

La réponse de l’API contient un lot de révisions d’élément de travail(« valeurs »), une URL vers le lot suivant de révisions d’élément de travail(« nextLink ») et une valeur booléenne qui vous indique si vous avez lu toutes les révisions d’élément de travail actuellement disponibles(« isLastBatch »).

Le flux de travail pour la création de votre entrepôt est le suivant :

  1. Envoyer une requête à l’API sans fournir de paramètre continuationToken
  2. Traiter les révisions d’élément de travail retournées par l’API
  3. Conserver « nextLink » et case activée « isLastBatch »
    • Si « isLastBatch » a la valeur true, suspendez pendant une période (varie en fonction de la latence de votre cible)
  4. Effectuer la requête suivante à l’aide de l’URL de « nextLink »
  5. Passer à l’étape 2

Notes

Les résultats de cette API sont impactés lors de l’utilisation des fonctionnalités Déplacer l’élément de travail et/ou Modifier le type d’élément de travail conjointement avec « project » dans l’URL et/ou « types » dans la chaîne de requête.

  • Les demandes délimitées au projet retournent uniquement les révisions d’éléments de travail du projet spécifié.
  • Les demandes délimitées aux types retournent uniquement les révisions d’élément de travail du ou des types spécifiés

Exemples de projet

Exemple C#

Operations

Read Reporting Revisions Get

Obtenir un lot de révisions d’éléments de travail avec la possibilité d’inclure des éléments supprimés

Read Reporting Revisions Post

Obtenir un lot de révisions d’élément de travail. Cette requête peut être utilisée si votre liste de champs est suffisamment grande pour qu’elle puisse exécuter l’URL au-dessus de la limite de longueur.