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


Отчет "Сводка построения"

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

Сведения о способах доступа к отчетам, их обновления и управления отчетами см. в разделе Отчеты (SQL Server Reporting Services).

Примечание

Для этого отчета требуется, чтобы коллекция командных проектов, в которой содержится нужный командный проект, была создана с поддержкой служб отчетов SQL Server.Если при запуске Team Explorer и развертывании узла командного проекта не отображается пункт ОтчетОтчеты, отчет недоступен.

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

  • Данные в отчете

  • Настройка длительности итерации

  • Интерпретация отчета

  • Фильтрация отчета

Этот отчет может использоваться для получения ответов на следующие вопросы:

  • Как со временем изменяется состояние всех построений?

  • Какие построения были успешными?

  • В каких сборках значительное количество изменений кода?

  • Какое количество кода было выполнено во время тестов?

  • Какие построения готовы к установке?

Необходимые разрешения

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

Данные в отчете

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

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

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

Пример отчета "Сводка построения"

В следующей таблице описаны сведения, которые отображаются для каждого индикатора качества:

Индикатор качества

Описание

Выполнение построения

Указывает состояние построения. Построение может иметь одно из следующих состояний:

  • Ошибка. Не удалось выполнить компиляцию построения или тесты.

  • Частично успешно. Успешно скомпилированы только несколько частей построения.

  • Остановлено. Построение было остановлено пользователем.

  • Успешно. Построение успешно скомпилировано, тесты выполнены.

Свойство построения

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

Если свойство построения не оценено, данный столбец остается пустым.

% тестов пройдено

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

% покрытия кода

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

% обработанного кода (строки)

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

Создание фильтров для отчета сводки построения можно выполнить следующими способами:

  • изменить начальную и конечную даты отчета;

  • отфильтровать определения построений, указав значения платформы, конфигурации, определения построения или выполнение построения, которые следует включить в отчет.

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

Необходимые действия по управлению построением

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

  • Настройка системы построения. Для использования приложения Team Foundation Build необходимо настроить систему построения.

    Дополнительные сведения см. в разделе Настройка системы сборки и управление ею.

  • Создание определений построения. Для получения кода для разных платформ можно создать несколько определений построения. Также каждое построение можно выполнить с использованием другой конфигурации.

    Дополнительные сведения см. в разделе Определение процесса сборки.

  • Определение тестов для автоматического запуска в качестве части построения. Как часть определения построения можно выбрать тесты, которые будут выполняться как часть построения или в случае ошибки будут остановлены.

    Дополнительные сведения см. в разделе Использование шаблона по умолчанию для процесса сборки.

  • Настройка тестов для сбора данных о покрытии кода. Чтобы данные о покрытии кода попали в отчет, члены команды должны инструментировать тесты для сбора этих данных.

  • Регулярное выполнение построений. Построение могут выполнятся в указанное время или после каждого возвращения. Используя запланированный триггер можно настроить регулярные построения.

    Дополнительные сведения см. в разделах Создание или изменение определения сборки и Запуск сборок, наблюдение за сборками и управление ими.

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

    Для получения дополнительной информации см. Оценка качества завершенной сборки.

Настройка длительности итерации

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

Изменение длительности итерации

  1. Щелкните значок календаря и выберите дату около поля Начало итерации (дата) или Конец итерации (дата).

  2. Нажмите кнопку Просмотр отчета.

Интерпретация отчета

Для получения ответов на вопросы по последним построениям, можно обратится к отчету сводки построения. В нем содержится больше сведений, чем в отчете "Успех построения за указанное время".

Вопросы, ответы на которые содержатся в отчете

В отчете можно найти ответы на следующие вопросы:

  • Как со временем изменяется состояние всех построений?

  • Какие построения были успешными?

  • В каких сборках значительное количество изменений кода?

  • Какие построения готовы к установке?

  • Какое количество кода было выполнено во время тестов?

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

Рабочая версия отчета

В рабочем отчете сводки построения содержатся следующие индикаторы:

  • Выполняется большинство построений.

  • Выполняется большинство тестов.

  • Высокое покрытие кода.

  • Несколько пиков обработки кода.

Нерабочая версия отчета

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

  • Ошибки при выполнении большинства построений. Установите причины ошибок во время выполнения построений.

  • Ошибки при выполнении большинства тестов. Установите и устраните причины, по которым тесты не выполняются.

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

  • Пики в обработке кода.. Проверьте учитываются ли необычные пики в обработке кода.

Фильтрация отчета

Создание фильтров для отчета сводки построения можно выполнить следующими способами:

  • изменить начальную и конечную даты отчета;

  • отфильтровать определения в отчете, указав значения платформы, конфигурации, определения построения, свойство построения или выполнение построения, которые следует включить в отчет.

    Примечание

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

На следующем рисунке показаны доступные фильтры.

Фильтры для отчета "Сводка построения"

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

Фильтрация построений отображаемых в отчете

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

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

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

  4. В списке Свойство построения установите флажки рядом с необходимыми качествами построения, чтобы отобразить их в отчете.

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

  6. Нажмите кнопку Просмотр отчета.

См. также

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

Отчеты (SQL Server Reporting Services)