Export (0) Print
Expand All

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

  1. 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. 

  2. 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.

  3. 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.

      NoteNote:

      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.

Community Additions

ADD
Show:
© 2014 Microsoft