Перемещение рабочих элементов может понадобиться в различных случаях:
- Рабочий элемент не там изначально зарегистрировали.
- Для команды создали новый командный проект и необходимо забрать ее требования и ошибки.
- И т.д.
Сама операция переноса не очень сложная (Move a work item to another project), но если необходимо перенести тысячи рабочих элементов, то ручная работа займет много времени.
Для переноса рабочего элемента необходимо обновить всего три поля:
- Командный проект
- Путь итерации
- Путь области
В эти поля нужно установить наименование нового командного проекта. Пример будет базироваться на статьях Выполнение запросов по рабочим элементам и Создание и редактирование рабочих элементов.
Пример для обновления одного рабочего элемента очень прост:
static
int MoveWorkItem(int WIId, string NewTeamProject)
{
Dictionary<string, object> fields = new Dictionary<string, object>();
fields.Add(«System.TeamProject», NewTeamProject);
fields.Add(«System.AreaPath», NewTeamProject);
fields.Add(«System.IterationPath», NewTeamProject);
var editedWI = UpdateWorkItem(WIId, fields);
Console.WriteLine(«Work item has been moved: « + editedWI.Id.Value);
return editedWI.Id.Value;
}
static WorkItem UpdateWorkItem(int WIId, Dictionary<string, object> Fields)
{
JsonPatchDocument patchDocument = new JsonPatchDocument();
foreach (var key in Fields.Keys)
patchDocument.Add(new JsonPatchOperation()
{
Operation = Operation.Add,
Path = «/fields/» + key,
Value = Fields[key]
});
return WitClient.UpdateWorkItemAsync(patchDocument, WIId).Result;
}
Если же нам необходимо перенести большое количество рабочих элементов, то предварительно необходимо создать запрос по рабочим элементам, который выберет их все (Create and save managed queries with the query editor). Далее запрос можно выполнить и получить все идентификаторы и выполнить обновление каждого рабочего элемента:
List<int> wis = RunStoredQuery(teamProjectOld, queryPath);
foreach (int wiId in wis) MoveWorkItem(wiId, teamProjectNew);
В истории рабочего элемента будет соответствующая запись:
Пример тестового приложения можно посмотреть здесь:
https://github.com/ashamrai/TFRestApi/tree/master/11.TFRestApiAppMoveWorkItems
Заметки консультанта 