Отчет "Сводка построения"
Сводка построения отображает список построений и сведения о результатах теста, покрытии теста, обработки кода, и заметки относительно качества для каждого построения.
Сведения о способах доступа к отчетам, их обновления и управления отчетами см. в разделе Отчеты (SQL Server Reporting Services).
Примечание
Для этого отчета требуется, чтобы коллекция командных проектов, в которой содержится нужный командный проект, была создана с поддержкой служб отчетов SQL Server.Если при запуске Team Explorer и развертывании узла командного проекта не отображается пункт .png "Отчет"){kind=icon}
Отчеты, отчет недоступен.
В этом разделе
|
Этот отчет может использоваться для получения ответов на следующие вопросы:
|
Необходимые разрешения
Для просмотра отчета пользователь должен входить в группу, которой была предоставлена роль Обозреватель в службах отчетов. Дополнительные сведения см. в разделе Добавление пользователей в командные проекты.
Данные в отчете
Сведения отчета сводки построения получены из хранилища данных. В отчете содержится графическое отображение процента проводимых тестов, тестируемого кода, а также изменения в коде в нескольких построениях.
Можно просматривать результаты автоматического и ручного построений, последние построения, текущие и частые построения. В начале отчета размещены последние построения, результаты построений, полученные за указанный период времени для всех выполненный построений, отобранные в соответствии с фильтром, указанным для отчета.
Как показано на следующей иллюстрации, это позволяет с первого взгляда определить успешность для нескольких определений построений за рассматриваемый период времени.
.png "Пример отчета \"Сводка построения\"")
В следующей таблице описаны сведения, которые отображаются для каждого индикатора качества:
Индикатор качества |
Описание |
|---|---|
Выполнение построения |
Указывает состояние построения. Построение может иметь одно из следующих состояний:
|
Свойство построения |
Указывает введенную вручную оценку качества построения. Качества построения, определенные для командного проекта можно добавлять и удалять. Дополнительные сведения см. в разделе Добавление и удаление значений качества сборки. Если свойство построения не оценено, данный столбец остается пустым. |
% тестов пройдено |
Отображает линейчатую диаграмму с накопителем, на которую в виде зеленого отрезка наносится процент пройденных тестов. Остальная часть линейки отображается красным цветом, указывая процент тестов, во время которых были сбои. Общая длина диаграммы всегда равна ширине столбца. |
% покрытия кода |
Отображает линейчатую диаграмму с накопителем, на которую в виде зеленого отрезка наносится процент покрытия кода. Остальная часть линейки отображается светло-синим цветом, указывая процент кода, который не был протестирован во время выполнения построения. Общая длина диаграммы всегда равна ширине столбца. |
% обработанного кода (строки) |
Отображает линейчатую диаграмму, на которую в виде серого отрезка наносится процент обработанного кода. Количество обработанного кода определяется путем деления количества строк кода, которые команда добавила, удалила и изменена на общее количество строк в построении. Длина отрезка пропорциональна числу процентов в масштабах отчета, поэтому максимальное количество обработанного кода во всех построениях равняется ширине столбца. |
Создание фильтров для отчета сводки построения можно выполнить следующими способами:
изменить начальную и конечную даты отчета;
отфильтровать определения построений, указав значения платформы, конфигурации, определения построения или выполнение построения, которые следует включить в отчет.
Дополнительные сведения см. в разделе Фильтрация отчета далее в этом разделе.
Необходимые действия по управлению построением
Чтобы сделать отчет сводки построения эффективным, участники команды должны выполнять следующие действия для управления построениями:
Настройка системы построения. Для использования приложения Team Foundation Build необходимо настроить систему построения.
Дополнительные сведения см. в разделе Настройка системы сборки и управление ею.
Создание определений построения. Для получения кода для разных платформ можно создать несколько определений построения. Также каждое построение можно выполнить с использованием другой конфигурации.
Дополнительные сведения см. в разделе Определение процесса сборки.
Определение тестов для автоматического запуска в качестве части построения. Как часть определения построения можно выбрать тесты, которые будут выполняться как часть построения или в случае ошибки будут остановлены.
Дополнительные сведения см. в разделе Использование шаблона по умолчанию для процесса сборки.
Настройка тестов для сбора данных о покрытии кода. Чтобы данные о покрытии кода попали в отчет, члены команды должны инструментировать тесты для сбора этих данных.
Регулярное выполнение построений. Построение могут выполнятся в указанное время или после каждого возвращения. Используя запланированный триггер можно настроить регулярные построения.
Дополнительные сведения см. в разделах Создание или изменение определения сборки и Запуск сборок, наблюдение за сборками и управление ими.
(Необязательно) Оценка выполненных построений. Используя Обозреватель сборки любой участник команды может оценить построение.
Для получения дополнительной информации см. Оценка качества завершенной сборки.
Настройка длительности итерации
Для отслеживания хода выполнения работ в рамках текущей итерации, даты начала и окончания в отчете должны совпадать с текущим циклом итерации.
Изменение длительности итерации
Щелкните значок календаря и выберите дату около поля Начало итерации (дата) или Конец итерации (дата).
Нажмите кнопку Просмотр отчета.
Интерпретация отчета
Для получения ответов на вопросы по последним построениям, можно обратится к отчету сводки построения. В нем содержится больше сведений, чем в отчете "Успех построения за указанное время".
Вопросы, ответы на которые содержатся в отчете
В отчете можно найти ответы на следующие вопросы:
Как со временем изменяется состояние всех построений?
Какие построения были успешными?
В каких сборках значительное количество изменений кода?
Какие построения готовы к установке?
Какое количество кода было выполнено во время тестов?
Отчет сводки построения не содержит причин неполадок, но подсказывает, где можно найти их основную причину. В отчете также не указывается информация о размере или важности неполадок построения.
Рабочая версия отчета
В рабочем отчете сводки построения содержатся следующие индикаторы:
Выполняется большинство построений.
Выполняется большинство тестов.
Высокое покрытие кода.
Несколько пиков обработки кода.
Нерабочая версия отчета
Нерабочая версия отчета сводки построения содержит как минимум один из следующих индикаторов. Осуществите проверки, используя следующие подсказки:
Ошибки при выполнении большинства построений. Установите причины ошибок во время выполнения построений.
Ошибки при выполнении большинства тестов. Установите и устраните причины, по которым тесты не выполняются.
Большая часть покрытия кода отображается светло-синим цветом. Возможно, следует использовать больше автоматических тестов.
Пики в обработке кода.. Проверьте учитываются ли необычные пики в обработке кода.
Фильтрация отчета
Создание фильтров для отчета сводки построения можно выполнить следующими способами:
изменить начальную и конечную даты отчета;
отфильтровать определения в отчете, указав значения платформы, конфигурации, определения построения, свойство построения или выполнение построения, которые следует включить в отчет.
Примечание
Для определений построения можно задать необходимость прохождения отдельных тестов, всех тестов, или отсутствие необходимости проходить какие-либо тесты.В зависимости от конфигурации определений построения, полученные отчеты могут сильно отличаться.
На следующем рисунке показаны доступные фильтры.
.png "Фильтры для отчета \"Сводка построения\"")
Фильтры следует применять в соответствии с последовательностью, продемонстрированной в следующей процедуре. Параметры, доступные для некоторых фильтров зависят от ранее установленных фильтров.
Фильтрация построений отображаемых в отчете
В списке Платформа установите флажки рядом с необходимыми платформами, чтобы отобразить их в отчете.
В списке Конфигурация установите флажки рядом с необходимыми конфигурациями, чтобы отобразить их в отчете.
В списке Определение построения установите флажки рядом с необходимыми определениями построения, чтобы отобразить их в отчете.
В списке Свойство построения установите флажки рядом с необходимыми качествами построения, чтобы отобразить их в отчете.
В списке Выполнение установите флажки рядом с необходимыми значениями, чтобы отобразить их в отчете.
Нажмите кнопку Просмотр отчета.