Как получить пользовательскую историю для задачи с помощью Visual Studio REST API

Я пытаюсь использовать API Visual Studio для сбора информации о рабочих элементах для команды Visual Studio Online в документе Excel. Я могу получить информацию о рабочих элементах, а также о том, является ли каждый элемент пользовательской историей, задачей или ошибкой, используя вызовы API для извлечения его полей json. Однако я не могу понять, как получить «родительскую» пользовательскую историю для задачи или ошибки. Например. задача будет находиться в разделе User Story на моей рабочей доске, но я не вижу поля, соответствующего этой истории, в возможных json-ключах рабочего элемента.

Ключи, которые я вижу для рабочего элемента, следующие:

['System.AuthorizedDate',
 'System.WorkItemType',
 'System.Title',
 'System.IterationLevel1',
 'System.IterationLevel2',
 'System.History',
 'System.AreaId',
 'System.NodeName',
 'Microsoft.VSTS.Common.ActivatedDate',
 'System.IterationId',
 'System.IterationPath',
 'System.PersonId',
 'System.AssignedTo',
 'System.AuthorizedAs',
 'System.Id',
 'System.Reason',
 'System.CreatedBy',
 'Microsoft.VSTS.Common.StateChangeDate',
 'Microsoft.VSTS.Common.Priority',
 'System.Watermark',
 'Microsoft.VSTS.Common.ActivatedBy',
 'System.AreaPath',
 'System.State',
 'System.ChangedDate',
 'System.AreaLevel1',
 'System.CreatedDate',
 'System.TeamProject',
 'System.Rev',
 'System.ChangedBy',
 'System.RevisedDate']

Ни одно из их значений не соответствует чему-либо, что соответствует тексту пользовательской истории или предоставляет URL-адрес json пользовательской истории.

Кто-нибудь знает, как получить родительскую (User Story) задачу или ошибку с помощью вызовов API?


person Elliptica    schedule 30.12.2015    source источник


Ответы (1)


Добавьте «expand = all» или «expand = Relations» в URL-адрес вашего запроса, чтобы отобразить связанные рабочие элементы, а тип «System.LinkTypes.Hierarchy-Reverse» указывает на родительский рабочий элемент.

Пример:

https://xxxxx.visualstudio.com/defaultcollection/_apis/wit/workitems?ids=47&$expand=relations&api-version=1.0

введите здесь описание изображения

person Eddie Chen - MSFT    schedule 30.12.2015
comment
Большое спасибо! Вы не представляете, как долго я искал URL-адрес для одновременного расширения нескольких рабочих элементов. :) Вы знаете, в чем разница между System.LinkTypes.Hierarchy-Reverse и System.LinkTypes.Related? Оба они отображаются в отношениях для меня, но они для разных карточек (на самом деле, это тот же URL-адрес, что и исходная карточка. Я не понимаю, почему VSO имеет все эти самореферентные петли). - person Elliptica; 01.01.2016
comment
Hierarchy-Reverse - это Parent (от Parent-Child) сверху моей головы. Связанные - это просто тип Связанных ссылок. Любая ссылка появляется в отношениях. VSO (и TFS) всегда имели длинный список типов ссылок, каждый для собственного использования и часто связанных с конкретными функциями. Большинство объяснено здесь: msdn.microsoft.com/en-us/library/dd293527 .aspx - person jessehouwing; 02.01.2016