Добавление и изменение полей рабочих элементов для поддержки отчетов

Статья
02/20/2013

Поля рабочих элементов используются для отслеживания данных типов рабочих элементов, определения критериев фильтрации запросов и построения отчетов.Любое поле (за исключением системных полей), которое должно присутствовать в отчете, должно быть определено в файле определения для типов рабочих элементов, для отслеживания которых оно предназначено.Системные поля для каждого типа рабочих элементов определяются автоматически.Однако для обеспечения возможности ввода данных их необходимо включить в форму рабочего элемента.

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

Содержание раздела

Рекомендации
Использование существующего поля
Получение списка полей, определенных для коллекции командных проектов
Атрибуты полей, включаемых в отчеты
Изменение включаемого в отчеты атрибута поля
Добавление полей для поддержки отчетности
Проверка изменений, внесенных в атрибуты включаемого в отчеты поля
Рекомендации по присвоению отчетных ссылочных имен

Полный список включаемых в отчеты полей, определенных в шаблонах процессов по умолчанию, см. в разделе Справочник по включаемым в отчеты полям для Visual Studio ALM.

Примечание
Полям, определенным в шаблонах процессов Microsoft Solutions Framework, не присвоены ни отчетные имена, ни отчетные ссылочные имена.По умолчанию используются атрибуты ссылочного имени и имени.

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

Использование существующего поля

Если какое-либо уже определенное поле соответствует сведениям, которые требуется отслеживать и включать в отчеты, следует использовать это поле.Чтобы использовать существующее поле, выполните следующие действия.

Определите поле, которое требуется использовать.С помощью команды witadmin listfields получите список полей, определенных для всех коллекций проектов, и их атрибутов.Дополнительные сведения см. в подразделе Получение списка полей, определенных для коллекции командных проектов далее в данном разделе.
Определите, является ли поле включаемым в отчеты, и соответствуют ли вашим потребностям его атрибуты включения в отчеты.
Если поле не является включаемым в отчеты, с помощью команды witadmin changefield измените его атрибут включения в отчеты для коллекций проектов, в которых оно используется.Дополнительные сведения см. в подразделе Изменение включаемого в отчеты атрибута поля далее в данном разделе.
Для коллекции проектов, где это поле не определено, добавьте его в XML-файлы определений для типов рабочих элементов, которые требуется использовать для отслеживания данных.Дополнительные сведения см. в подразделе Добавление полей для поддержки отчетности далее в данном разделе.

Получение списка полей, определенных для коллекции командных проектов

Команда witadmin listfields позволяет вывести список полей и их атрибутов.Можно вывести заданное поле или все поля, определенные в коллекции проектов.Команда witadmin listfields имеет следующий синтаксис:

witadmin listfields /collection:CollectionURL /n:RefName

Для получения дополнительной информации см. Управление полями рабочих элементов [witadmin].

Атрибуты полей, включаемых в отчеты

Включаемые в отчеты поля имеют атрибут reportable со значением Detail, Dimension или Measure.Следующие атрибуты определяют способ экспорта полей рабочих элементов в базы данных хранилища данных и их обработки в этих базах данных.

reportingtype.Для включения поля в отчеты необходимо присвоить атрибуту reportable одно из следующих значений.
- Detail: при присвоении этого значения поле экспортируется в реляционную базу данных хранилища, но не в куб.Как показано в следующем примере, тип Detail используется только для полей типа Integer, Double, String или DateTime:
```
<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">
```
- Dimension: при присвоении этого значения поле экспортируется и в реляционную базу данных хранилища, и в куб.Как показано в следующем примере, значение Dimension используется только для полей типа Integer, Double, String или DateTime:Этим значением удобно пользоваться для включения полей, используемых для фильтрации отчетов (например, полей, имеющих списки допустимых значений).
```
<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">
```
- Measure: присвоение этого значения обеспечивает обработку предварительно вычисленных значений в кубе.Тип Measure используется только для полей Integer и Double.
  
  При присвоении атрибуту reportingtype значения Measure необходимо присвоить значение sum атрибуту formula, как показано в следующем примере:
```
<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">
```
reportingrefname.Полю, помеченному как включаемое в отчеты, можно назначить другое ссылочное имя.Если этот атрибут не задан, используется значение, присвоенное атрибуту refname;

С помощью этого атрибута можно объединять или разделять входящие в отчеты поля.Чтобы объединить два поля с разными ссылочными именами, которые определены в разных коллекциях проектов, присвойте этим полям одинаковое значение атрибута reportingrefname.Чтобы разделить два поля с одинаковым ссылочным именем, которые определены в разных коллекциях проектов, присвойте этим полям разные значения атрибута reportingrefname.

Объединять поля следует всегда, когда этого возможно, в целях минимизации количества полей в хранилище и во избежание превышения предельного допустимого количества включаемых в отчеты полей (1024).Можно формировать межгрупповые отчеты с объединенными полями.

reportingname.Можно назначить другую метку полю, которое используется для отображения данных в отчетах.Если этот атрибут не задан, используется понятное имя, присвоенное атрибуту name.Значение, присвоенное атрибуту reportingname, отображается в кубе.Значение, присвоенное атрибуту reportingrefname, в кубе не фигурирует.

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

При присвоении меток отчетным полям следуйте рекомендациям, призванным обеспечить группировку полей в отчетах сводных таблиц.Дополнительные сведения см. в подразделе Рекомендации по присвоению отчетных ссылочных имен.

Изменение включаемого в отчеты атрибута поля рабочего элемента

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

Изменить назначения атрибутов поля можно с помощью следующих действий.

Изменить назначение атрибута полю можно с помощью команды witadmin changefield.Эта команда применяется на уровне коллекции командных проектов.Используется следующий синтаксис:
```
witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]
```
Чтобы сделать существующее поле включаемым в отчеты, измените его атрибут reportingtype.Например, чтобы поле AW.Common.TeamPriority можно было использовать для фильтрации отчетов, присвойте ему значение Dimension:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension 
```
Дополнительные сведения см. в разделе Управление полями рабочих элементов [witadmin].
(Необязательно) При наличии нескольких коллекций проектов может потребоваться внести аналогичные изменения в поле рабочего элемента, определенное в других коллекциях.Во избежание конфликтов схемы при экспорте данных в базы данных хранилища и их обработки необходимо присваивать во всех коллекциях одинаковые значения следующим атрибутам:
- тип поля (для существующего поля значение этого атрибута изменить нельзя);
- отчетный тип;
- отчетное имя.
Дополнительные сведения см. в разделе Разрешение конфликтов схемы, возникающих в хранилище данных.
После внесения всех изменений в поля рабочих элементов, которые требуется использовать в отчетности, необходимо обработать базы данных хранилища данных.Сделать это можно с помощью веб-служб ProcessWarehouse и ProcessAnalysis, доступных через веб-службу WarehouseControlWebService.

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

Дополнительные сведения см. в разделе Управление полями рабочих элементов [witadmin].

Добавление полей для поддержки отчетности

В определение типа рабочего элемента (или типов рабочих элементов) можно добавлять поля.Добавляя поле, необходимо добавить такое же определение элемента поля во все типы рабочих элементов, в отчетности по которым будет использоваться это поле.Если требуется, чтобы поле поддерживало межпроектную отчетность, это поле необходимо добавить во все типы рабочих элементов во всех командных проектах, которые будут фигурировать в отчетности.

Дополнительные сведения см. в разделе Работа с полями рабочих элементов.

Проверка изменений, внесенных в атрибуты включаемого в отчеты поля

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

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

Обработайте по запросу реляционное хранилище данных с помощью операции ProcessWarehouse WarehouseControlWebService.
Обработайте по запросу куб с помощью операции ProcessAnalysisDatabase WarehouseControlWebService.
Убедитесь в том, что отчеты обновляются.Просмотрите отчет через панель мониторинга или диспетчер отчетов.Дополнительные сведения см. в разделе Панели мониторинга (гибкая разработка) или Отчеты (гибкая разработка).

Рекомендации по присвоению отчетных ссылочных имен

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

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

Поля рабочих элементов, имеющие отчетный тип Dimension, соответствуют атрибутам измерений в кубе.Атрибуты измерений организуются в папки на основании отчетного ссылочного имени, присвоенного в шаблоне процесса или определении типа рабочего элемента.Имеют место следующие типы сопоставлений:

поля с префиксом "System" являются встроенными полями и содержатся непосредственно в измерении "Рабочий элемент"; их имена предваряются словами "Рабочий элемент";
остальные поля помещаются в папки, имена которых соответствуют префиксам ссылочных имен этих полей.Например, поля с префиксом "Microsoft.VSTS.Common" содержатся в папке с именем "Microsoft VSTS Common".

Как показано на следующем рисунке, для каждой группы полей, имеющих общий префикс, добавляется по папке:

Структура папок в кубе данных OLAP

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

Примечание
Развертывания, в которых не используется выпуск Enterprise служб аналитики SQL Server, не имеют доступа к функциям перевода, обеспечиваемым этим выпуском.В таких развертываниях поля в кубе обозначаются своими полными ссылочными именами, в которых символ точки (.) заменяется символом подчеркивания (_) (например, "System_Id" and "System_Title").

Развертывания, в которых не используется выпуск Enterprise служб аналитики SQL Server, не имеют доступа к функциям перевода, обеспечиваемым этим выпуском.В таких развертываниях поля в кубе обозначаются своими полными ссылочными именами, в которых символ точки (.) заменяется символом подчеркивания (_) (например, "System_Id" and "System_Title").

Имя в отчете сводной таблицы и в кубе	Ссылочное имя	Тип данных
Рабочий элемент.Путь области	System.AreaPath	TreeType
Рабочий элемент.Кому назначено	System.AssignedTo	Строка.
Рабочий элемент.Кем изменено	System.ChangedBy	Строка.
Рабочий элемент.Дата изменения	System.ChangedDate	DateTime
Рабочий элемент.Кем создано	System.CreatedBy	Строка.
Рабочий элемент.Дата создания	System.CreatedDate	DateTime
Рабочий элемент.Идентификатор	System.Id	Integer
Рабочий элемент.Путь итерации	System.IterationPath	TreeType
Рабочий элемент.Предыдущее состояние	System.PreviousState	Строка.
Рабочий элемент.Причина	System.Reason	Строка.
Рабочий элемент.Вер	System.Rev	Integer
Рабочий элемент.Состояние	System.State	Строка.
Рабочий элемент.Название	System.Title	Строка.
Рабочий элемент.Тип рабочего элемента	System.WorkItemType	Строка.

В следующей таблице перечислены поля, присутствующие в отчете сводной таблице в папке с именем "Microsoft.VSTS.Common" в измерении "Рабочий элемент".Ссылочные имена этих полей начинаются с "Microsoft.VSTS.Common".

Имя в отчете сводной таблицы и в кубе	Ссылочное имя	Тип данных
Рабочий элемент.Активировал	Microsoft.VSTS.Common.ActivatedBy	Строка.
Рабочий элемент.Дата активации	Microsoft.VSTS.Common.ActivatedDate	DateTime
Рабочий элемент.Кем закрыто	Microsoft.VSTS.Common.ClosedBy	Строка.
Рабочий элемент.Дата закрытия	Microsoft.VSTS.Common.ClosedDate	DateTime
Рабочий элемент.Кем создано	Microsoft.VSTS.Common.CreatedBy	Строка.
Рабочий элемент.Дата создания	Microsoft.VSTS.Common.CreatedDate	DateTime
Рабочий элемент.Кем разрешено	Microsoft.VSTS.Common.ResolvedBy	Строка.
Рабочий элемент.Дата разрешения	Microsoft.VSTS.Common.ResolvedDate	DateTime
Рабочий элемент.Разрешенная причина	Microsoft.VSTS.Common.ResolvedReason	Строка.
Рабочий элемент.Приоритет	Microsoft.VSTS.Common.Priority	Integer
Рабочий элемент.Важность	Microsoft.VSTS.Common.Severity	Строка.
Рабочий элемент.Ранг стека	Microsoft.VSTS.Common.StackRank	Double

См. также

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

Добавление и изменение полей рабочих элементов для поддержки отчетов

Рекомендации

Использование существующего поля

Получение списка полей, определенных для коллекции командных проектов

Атрибуты полей, включаемых в отчеты

Изменение включаемого в отчеты атрибута поля рабочего элемента

Добавление полей для поддержки отчетности

Проверка изменений, внесенных в атрибуты включаемого в отчеты поля

Рекомендации по присвоению отчетных ссылочных имен

См. также

Ссылки

Основные понятия

Другие ресурсы

Дополнительные ресурсы