Поделиться через


Reporting Work Item Revisions

Этот API предоставляет доступ ко всем редакциям рабочих элементов в проекте или коллекции и позволяет создать хранилище.

Ответ API содержит пакет исправлений рабочих элементов ("значения"), URL-адрес следующего пакета исправлений рабочих элементов("nextLink") и логическое значение, указывающее, прочитаны ли все доступные в настоящее время редакции рабочих элементов("isLastBatch").

Рабочий процесс создания хранилища выглядит следующим образом:

  1. Отправка запроса к API без указания параметра continuationToken
  2. Обработка исправлений рабочих элементов, возвращенных API
  3. Сохранение nextLink и проверка isLastBatch
    • Если "isLastBatch" имеет значение true, сделайте паузу на период времени (зависит от целевой задержки)
  4. Выполните следующий запрос, используя URL-адрес из nextLink
  5. Перейдите к шагу 2

Примечание

Результаты этого API влияют при использовании функций перемещения рабочего элемента и (или) изменения типа рабочего элемента в сочетании с "project" в URL-адресе и /или "типами" в строке запроса.

  • Запросы на уровне проекта будут возвращать только редакции рабочих элементов из указанного проекта.
  • Запросы с областью действия типов будут возвращать только редакции рабочих элементов указанных типов

Образцы проектов

Пример для C#

Operations

Read Reporting Revisions Get

Получение пакета исправлений рабочих элементов с возможностью включения удаленных элементов

Read Reporting Revisions Post

Получение пакета исправлений рабочих элементов. Этот запрос может использоваться, если список полей достаточно велик, чтобы он мог выполнять URL-адрес сверх предельной длины.