How to: View Build Summary Status
Team Foundation Build uses build definitions to manage the build parameters to build a team project. The Build Explorer lets you view a summary status of completed and running builds. Before you can view build definition summary status information in the Build Explorer, you must create and run a build definition. For more information, see How to: Create a Build Definition and How to: Queue or Start a Build Definition.
Required Permissions
To perform this procedure, you must have the Team Foundation Server View project-level information permission set to Allow. For more information, see Team Foundation Server Permissions.
To view build type summary status information in Build Explorer
In Team Explorer, locate and select the Builds node and click View Builds on the Build menu.
To view summary information for a specific build definition, expand the Builds node, select a specific build definition and click View Builds on the Build menu. The Completed tab displays a summary of all completed builds. The Queued tab of Build Explorer displays the in-progress builds.
To view the in-progress builds, click the Queued tab.
The queued pane of the Build Explorer appears.
The toolbar includes the following filters to filter the in-progress builds:
Build Definition
Select a build definition name from the drop-down list to filter the in-progress builds on a build definition. All the build definitions that belong to the team project are listed.
Status Filter
Select a status from the drop-down list to filter the in-progress builds on status. You can select from Any Status, Queued, In Progress, Postponed, Completed, or Cancelled.
Agent Filter
Select a build agent from the drop-down list to filter the in-progress builds on build agent. You can select a specific build agent or Any Build Agent. For more information about build agents, see How to: Create and Manage Build Agents.
The following table describes summary report items that are included for queued builds.
Build Explorer Summary Report Item
Description
Build Definition
Displays the build definition name.
An icon next to the build definition name displays an updated status as the build proceeds. The values for the icons include the following:
In Progress
Succeeded
Stopped
Paused
Failed
Active
Priority
Indicates the current build priority. For build definitions that are active, the priority can be edited by right-clicking the specific build and selecting the desired priority.
Date Queued
Displays the date on which the build was queued. By default, the summary report is sorted on this report time.
Requested By
Displays the name of the user who requested this build. It appears in the domain\user or workgroup\user format. If the domain of the current user is the same as the domain of the user who requested the build, only the username is shown.
Build Agent
Displays the name of the build agent used for this build.
To view the completed builds, click the Completed tab.
The completed pane of the Build Explorer appears.
The toolbar includes the following filters to filter the completed builds:
Build Definition
Select a build definition name from the drop-down list to filter the completed builds on a build definition. All the build definitions that belong to the team project are listed.
Quality Filter
Select a build quality from the drop-down list to filter the completed builds on build quality. You can select from any previously added or selected build quality values. You can show all build quality values by selecting <Any Build Quality>.
Date Filter
Select a date filter from the drop-down list to filter the completed builds by the date on which they completed.
Note
Click the column headers to sort the columns alpha-numerically.
The following table describes summary report items that are included for completed builds.
Build Explorer Summary Report Item
Description
Name
Displays the build name with an icon that indicates the build status at completion. The values for the icons include the following:
Succeeded
Stopped
Failed
Build Definition
Displays the build definition name used for the build.
Build Quality
Indicates the current build quality. Build quality can be edited by right-clicking the specific build and selecting the desired quality. The user can add and remove the build quality values. For more information, see How to: Set Build Quality.
Date Completed
Displays the date and time the build completed. By default, the summary report is sorted on this report time.
Requested By
Displays the name of the user who requested this build. It appears in the domain\user or workgroup\user format. It displays only the username if the domain of the current user is the same as the domain of the user who requested the build.
For instruction about how to view individual build reports, see How to: View a Build Report.