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

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

  • Статья

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

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

В этом разделе

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

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

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

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

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

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

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

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

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

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

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

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

  • Укажите, можно ли использовать поле, которое уже определено в другой коллекции проектов в развертывании Visual Studio Team Foundation Server. Использование существующих полей обеспечивает возможность межпроектной отчетности.

  • В каждой коллекции проектов может быть не более 1024 полей, а во всех коллекциях проектов в пределах развертывания Team Foundation Server — не более 1024 уникальных включаемых в отчеты полей. Объединенные поля засчитываются как одно включаемое в отчеты поле.

  • Разработайте стандартную процедуру и процесс анализа для добавления и изменения полей в шаблонах процессов, командных проектах или коллекциях проектов.

  • При именовании полей для отчетности придерживайтесь систематических правил именования. Систематический подход к присвоению ссылочных имен во всех коллекциях командных проектов в пределах развертывания Team Foundation Server обеспечивает получение более согласованной и удобной в использовании схемы хранилища и куба, позволяя избежать конфликтов схемы в хранилище. Для получения дополнительной информации см. Разрешение конфликтов схемы, возникающих в хранилище данных.

    Полю рабочего элемента можно назначить до четырех атрибутов меток:

    Примечание

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

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

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

      Требования и ограничения в отношении понятных имен и ссылочных имен для полей см. в разделе Соглашения об именовании объектов отслеживания рабочих элементов.

    • reportingname. Необязательный атрибут. Имя, используемое для идентификации поля в отчетах. Если этот атрибут не задан явно, используется значение, присвоенное атрибуту name.

    • reportingrefname. Необязательный атрибут. Уникальная метка, присвоенная включаемому в отчеты полю, которая отличает его от всех остальных включаемых в отчеты полей, определенных во всех коллекциях командных проектов. Если этот атрибут не задан явно, используется значение, присвоенное атрибуту refname. Рекомендуемые правила именования см. в подразделе Рекомендации по присвоению отчетных ссылочных имен ниже.

      Примечание

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

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

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

  • Определите поле, которое требуется использовать. С помощью команды 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, 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, в кубе не фигурирует.

    Важно!

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

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

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

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

  1. Изменить назначение атрибута полю можно с помощью команды 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].

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

    • тип поля (для существующего поля значение этого атрибута изменить нельзя);

    • отчетный тип;

    • отчетное имя.

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

  3. После внесения всех изменений в поля рабочих элементов, которые требуется использовать в отчетности, необходимо обработать базы данных хранилища данных. Сделать это можно с помощью веб-служб ProcessWarehouse и ProcessAnalysis, доступных через веб-службу WarehouseControlWebService.

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

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

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

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

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

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

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

Примечание

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

  1. Обработайте по запросу реляционное хранилище данных с помощью операции ProcessWarehouse WarehouseControlWebService.

  2. Обработайте по запросу куб с помощью операции ProcessAnalysisDatabase WarehouseControlWebService.

  3. Убедитесь в том, что отчеты обновляются. Просмотрите отчет через панель мониторинга или диспетчер отчетов. Дополнительные сведения см. в разделе Панели мониторинга или Отчеты (SQL Server Reporting Services).

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

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

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

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

  • поля с префиксом "System" являются встроенными полями и содержатся непосредственно в измерении "Рабочий элемент"; их имена предваряются словами "Рабочий элемент";

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

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

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

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

Примечание

Развертывания, в которых не используется выпуск 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

Целое

Рабочий элемент.Путь итерации

System.IterationPath

TreeType

Рабочий элемент.Предыдущее состояние

System.PreviousState

Строковое

Рабочий элемент.Причина

System.Reason

Строковое

Рабочий элемент.Вер

System.Rev

Целое

Рабочий элемент.Состояние

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

Целое

Рабочий элемент.Важность

Microsoft.VSTS.Common.Severity

Строковое

Рабочий элемент.Ранг стека

Microsoft.VSTS.Common.StackRank

Double

См. также

Ссылки

Управление полями рабочих элементов [witadmin]

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

Разрешение конфликтов схемы, возникающих в хранилище данных

Справочник по полям рабочих элементов для Visual Studio ALM

Создание и настройка отчетов для Visual Studio ALM и управление ими

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

Изменение или добавление полей для поддержки запросов, отчетов и рабочего процесса