Share via

Manage Your Builds in Build Explorer

  • Article

In most cases, the Builds page in Team Explorer provides the best way to manage your builds during your day-to-day work. However, you can use Build Explorer to access deep and customized build data. You can query for older builds and builds requested by other team members, and restrict results to specific status or quality values.

Required Permissions

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

To view information about queued, ongoing, and completed builds in Build Explorer

  1. If you are not already connected to the team project that you want to work in, then connect to the team project.

  2. Choose Home iconHome, and then choose Builds IconBuilds.

  3. On the Builds page, choose Actions, Manage Queue.

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

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

    • Build Definition

      Choose 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

      Choose 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

      Choose 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

    Reason

    The trigger for the build. For more information, see Specify Build Triggers and Reasons.

    Status

    Displays an updated status as the build proceeds. The values for the status icons include the following:

    • In Progress

    • Succeeded

    • Partially Succeeded

    • Stopped

    • Postponed

    • Failed

    • Queued

    ID

    A unique identifier for the build.

    Build Definition

    Displays the build definition name.

    Build Name

    Displays the name of the build. For more information on how this data is created and stored, see Work with Build Numbers.

    Priority

    Indicates the current build priority. You can modify the priority of a queued build by selecting it, opening its shortcut menu, and then choosing Set 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 serves this build.

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

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

    • Build Definition

      Choose 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

      Choose 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 choosing <Any Build Quality>.

    • Date Filter

      Choose a date filter in the list to filter the completed builds by the date on which they completed.

      Note

      Choose the column headers to sort the columns alpha-numerically.

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

    Column

    Description

    Retained Indefinitely

    Displays whether the build will be retained indefinitely. To change this value, select a build, open its shortcut menu, and choose Retain Indefinitely.

    Reason

    The trigger for the build. For more information, see Specify Build Triggers and Reasons.

    Status

    Displays the build status at completion. The values for the icons include the following:

    • Succeeded

    • Partially Succeeded

    • Stopped

    • Failed

    Name

    Displays the name of the build. For more information on how this data is created and stored, see Work with Build Numbers.

    Build Definition

    Displays the build definition name.

    Build Quality

    Indicates the current build quality. To edit this value, select a build, open its shortcut menu, and then choose Edit Build Quality. Then, choose a value from 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. To get more information about a build, double-click it (or open its shortcut menu and choose Open).