Use Build Explorer to View and Manage Queued, Ongoing, and Completed Builds

You can use Build Explorer to view ongoing and completed builds.

Required Permissions

To perform this procedure, you must have the Team Foundation Server View builds, View build definition, and View build resources permissions set to Allow. For more information, see Team Foundation Server Permissions.

To view information about ongoing and completed builds in Build Explorer

  1. In Team Explorer, locate and click the Builds node.

  2. On the Build menu, click View Builds.

Tip

To view summary information for a specific build definition, expand the Builds node, right-click a specific build definition, and click View Builds. The Completed tab displays a summary of all completed builds. The Queued tab displays the in-progress builds.

  1. To view the in-progress builds, click the Queued tab.

    The toolbar includes the following filters to filter the in-progress builds:

    • Build Definition

      Click a build definition name in the 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

      Click a status in the list to filter the in-progress builds by status. You can specify Any Status, Queued, In Progress, or Postponed.

    • Controller Filter

      Click a build controller in the list to filter the in-progress builds by build agent. You can specify a particular build controller or Any Build Controller. For more information about build controllers, see Create and Work with Build Agents.

    The following table describes the summary data shown for queued builds.

    Column

    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 status icons include the following:

    • In Progress

    • Succeeded

    • Stopped

    • Postponed

    • Failed

    • Queued

    Priority

    Indicates the current build priority. For build definitions that are active, the priority can be edited by right-clicking the specific build and clicking the appropriate priority.

    Date Queued

    Displays the date on which the build was queued.

    Requested By

    Displays the name of the user who requested this build. The name appears in the Domain\User or Workgroup\User format. Only the user name appears if the domain of the current user is the same as the domain of the user who requested the build.

    Build Controller

    Displays the name of the build controller that was used for this build.

  2. To view the completed builds, click the Completed tab.

    The toolbar includes the following filters to filter the completed builds:

    • Build Definition

      Click a build definition name in the list to filter the completed builds on a build definition. All the build definitions that belong to the team project are listed.

    • Quality Filter

      Click a build quality in the list to filter the completed builds by build quality. You can specify any previously added or specified build quality values. You can show all build quality values by clicking <Any Build Quality>.

    • Date Filter

      Click a date filter in the 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 the summary data shown for completed builds.

    Column

    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

    • Partially Succeeded

    • Stopped

    • Failed

    Build Definition

    Displays the build definition name that is used for the build.

    Build Quality

    Indicates the current build quality. To edit this value, right-click the completed build, click Edit Build Quality, and then click a value in the menu that appears.

    Date Completed

    Displays the date and time when the build completed. By default, the completed builds are sorted by this column.

    Requested By

    Displays the name of the user who requested this build. The name appears in the Domain\User or Workgroup\User format. Only the user name appears if the domain of the current user is the same as the domain of the user who requested the build.

  3. Double-click any build, in-progress or completed, to view details about it.

See Also

Tasks

Create a Basic Build Definition

Concepts

Queue a Build