Reporting Work Item Revisions

  • Referenz
Service:
Work Item Tracking
API Version:
4.1

Diese API bietet Zugriff auf alle Überarbeitungen von Arbeitselementen in Ihrem Projekt oder Ihrer Sammlung und ermöglicht Ihnen das Erstellen eines Warehouses.

Die Antwort der API enthält einen Batch von Arbeitselementrevisionen("Values"), eine URL zum nächsten Batch von Arbeitselementrevisionen ("nextLink") und einen booleschen Wert, der Ihnen mitteilt, ob Sie alle derzeit verfügbaren Arbeitselementrevisionen gelesen haben ("isLastBatch").

Der Workflow zum Erstellen Ihres Lagers sieht wie folgt aus:

  1. Stellen Sie eine Anforderung an die API, ohne einen continuationToken-Parameter bereitzustellen.
  2. Verarbeiten der von der API zurückgegebenen Arbeitselementrevisionen
  3. Beibehalten von "nextLink", und aktivieren Sie "isLastBatch".
    • Wenn "isLastBatch" true ist, halten Sie für einen bestimmten Zeitraum an (variiert je nach Ziellatenz).
  4. Stellen Sie die nächste Anforderung mithilfe der URL von "nextLink"
  5. Wechseln Sie zu Schritt 2.

Hinweis

Die Ergebnisse dieser API wirken sich auf die Verwendung der Features "Arbeitselement verschieben" und/oder "Arbeitselementtyp ändern" in Verbindung mit "project" in der URL und/oder "types" in der Abfragezeichenfolge aus.

  • Projektbezogene Anforderungen geben nur Überarbeitungen von Arbeitselementen aus dem angegebenen Projekt zurück.
  • Typbezogene Anforderungen geben nur Arbeitselementrevisionen des angegebenen Typs zurück.

Beispielprojekte

C#-Beispiel

Operations

Read Reporting Revisions Get

Abrufen eines Batches von Überarbeitungen von Arbeitselementen mit der Option zum Einschließen gelöschter Elemente
Read Reporting Revisions Post

Rufen Sie einen Batch von Arbeitselementrevisionen ab. Diese Anforderung kann verwendet werden, wenn Ihre Liste der Felder groß genug ist, um die URL über die Längenbegrenzung auszuführen.