Вопросы API TFS 11 2012: количество запросов и выходные дни

Эти значения доступны только из серверной объектной модели (на данный момент нет эквивалентной клиентской объектной модели). Все интерфейсы и объекты сделаны Internal, поэтому даже на сервере вы не можете получить доступ к этим значениям.

internal TeamCapacity GetTeamIterationCapacity(Guid teamId, Guid iterationId);

Тип объявления: Microsoft.TeamFoundation.Server.WebAccess.WorkItemTracking.Common.DataAccess.TeamConfigurationComponent

Сборка: Microsoft.TeamFoundation.Server.WebAccess.WorkItemTracking.Common, Version=12.0.0.0

На данный момент единственный способ получить данные — через службу json (/tfs/{ProjectCollection}/{Team Project}/_api/_teamcapacity/updateteamcapacity/{Team}/{Iteration/Path}?__v=4), которую использует страница Team Capacity, или напрямую из базы данных ProjectCollection из таблиц, упомянутых Джеймсом Таппером.

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

Обязательный отказ от ответственности:

Серверные базы данных TFS не предназначены для расширения, любые прямые запросы к ним не поддерживаются, и модель может изменяться без предварительного уведомления даже между пакетами обновлений. Прямые запросы к базам данных TFS не поддерживаются. Изменение значений в базах данных TFS с помощью любых других средств, кроме официального API, приведет к тому, что ваш сервер TFS перейдет в неподдерживаемое состояние и может вызвать серьезные проблемы при последующем обновлении до более новой версии.

Это не поддерживаемый подход, и он может сломаться в будущем, если вы обновитесь до более новой версии TFS, но если вы хотите только читать данные, вы можете перейти непосредственно к базе данных SQL для вашей TFS. сервер.

Конкретные значения, которые вам нужны, находятся в (при условии, что вы используете DefaultCollection)

• [Tfs_DefaultCollection].[dbo].[tbl_TeamConfigurationCapacity]
• [Tfs_DefaultCollection].[dbo].[tbl_TeamConfigurationCapacityDaysOffRange]

Они имеют ссылки на итерации и пользователей через GUID.

• GUID итерации можно найти в [Tfs_Warehouse].[dbo].[DimIteration]
• GUID пользователя можно найти, выполнив поиск по имени пользователя/SSID в [Tfs_Configuration].[dbo].[tbl_Identity].

Вот краткий пример, который запрашивает мою производительность в часах в день для нашей январской итерации:

select Capacity from [Tfs_DefaultCollection].[dbo].[tbl_TeamConfigurationCapacity] as _cap
inner join [Tfs_Configuration].[dbo].[tbl_Identity] as _user
    on _user.[Id] = _cap.[TeamMemberId]
inner join [Tfs_Warehouse].[dbo].[DimIteration] as _iter
    on _iter.[IterationGUID] = _cap.[IterationId]
        where _iter.[IterationPath]='\Code\Current\401-Jan'
        and _user.[DisplayName]='Williams, Jason'

Вы можете использовать аналогичный подход для чтения диапазонов дат начала и окончания каждого праздника из файла tbl_TeamConfigurationCapacityDaysOffRange. Однако это несколько сложнее, так как есть выходные дни команды и выходные дни индивидуально.

Вот запрос, который я использую для достижения этой цели. (Кажется, работает, хотя после 6 месяцев работы для всех наших пользователей один из наших пользователей внезапно исчез из запроса, и я обнаружил, что без видимой причины мне теперь нужно искать его идентификатор в таблице IdentityMap. Радости реверс-инжиниринга из недокументированных источников :-(

select [StartTime],[EndTime] from [Tfs_DefaultCollection].[dbo].[tbl_TeamConfigurationCapacityDaysOffRange] as _cap1
    inner join [Tfs_Warehouse].[dbo].[DimIteration] as _iter1
      on _iter1.[IterationGUID] = _cap1.[IterationId]
          where _iter1.[IterationPath]='\Code\Current\401-Jan'
              and _cap1.[TeamMemberId]='00000000-0000-0000-0000-000000000000'
union
    select [StartTime],[EndTime] from [Tfs_DefaultCollection].[dbo].[tbl_TeamConfigurationCapacityDaysOffRange] as _cap2
        inner join [Tfs_DefaultCollection].[dbo].[tbl_IdentityMap] as _map
            on _map.[localId] = _cap2.[TeamMemberId]
        inner join [Tfs_Configuration].[dbo].[tbl_Identity] as _user2
            on _user2.[Id] = _map.[masterId]
        inner join [Tfs_Warehouse].[dbo].[DimIteration] as _iter2
            on _iter2.[IterationGUID] = _cap2.[IterationId]
                where _iter2.[IterationPath]='\Code\Current\401-Jan'
                    and (_user2.[DisplayName]='Williams, Jason')

Вам просто нужно будет заменить соответствующие значения для двух мест, в которых упоминается путь итерации и имя пользователя для запроса.

Есть еще одна неподдерживаемая возможность. Посмотрите на сайте http://{tfs-server}:8080/tfs/DefaultCollection/{project}/_backlogs/Capacity/{iterationpath}. Данные позади содержат информацию о емкости в формате JSON (данные о емкости команды).

https://onedrive.live.com/redir?resid=88F0C013A4398D9B%21129