Udostępnij za pośrednictwem


Reporting Work Item Revisions

Ten interfejs API zapewnia dostęp do wszystkich poprawek elementów roboczych w projekcie lub kolekcji i umożliwia tworzenie magazynu.

Odpowiedź interfejsu API zawiera partię poprawek elementów roboczych("values"), adres URL następnej partii poprawek elementów roboczych("nextLink") i wartość logiczną, która informuje o tym, czy odczytano wszystkie obecnie dostępne poprawki elementów roboczych("isLastBatch").

Przepływ pracy do tworzenia magazynu jest następujący:

  1. Wysyłanie żądania do interfejsu API bez podawania parametru continuationToken
  2. Przetwarzanie poprawek elementów roboczych zwróconych przez interfejs API
  3. Utrwalanie ciągu "nextLink" i sprawdzanie ciągu "isLastBatch"
    • Jeśli wartość "isLastBatch" ma wartość true, wstrzymaj okres (różni się w zależności od opóźnienia docelowego)
  4. Wykonaj następne żądanie przy użyciu adresu URL z "nextLink"
  5. Przejdź do kroku 2

Uwaga

Wyniki tego interfejsu API mają wpływ na użycie funkcji Przenieś element roboczy i/lub Zmień typ elementu roboczego w połączeniu z "projektem" w adresie URL i/lub "typach" w ciągu zapytania.

  • Żądania o zakresie projektu będą zwracać tylko poprawki elementów roboczych z określonego projektu.
  • Żądania o zakresie typów będą zwracać tylko poprawki elementów roboczych określonych typów

Przykładowe projekty

Przykład języka C#

Operations

Read Reporting Revisions Get

Pobieranie partii poprawek elementów roboczych z opcją dołączania usuniętych elementów

Read Reporting Revisions Post

Pobierz partię poprawek elementów roboczych. To żądanie może być używane, jeśli lista pól jest wystarczająco duża, że może uruchomić adres URL przez limit długości.