View Build Status

Overview

Rally's connectors to your build and SCM (Source Code Management) systems enable you to connect your work items in Rally to your build and SCM artifacts. This connection allows you to identify changesets associated with stories and defects, and also provides analytics data that you can use to gain insights about your build health, file churn, and code quality.

View build status includes the following:

• Enabling Build and SCM traceability
• Build status
• Work item traceability to build and changeset data
• Displaying reports on your dashboard
• Analytics
• Scoping

Enabling Build and SCM traceability

The Build and SCM traceability feature is enabled or disabled for the workspace by the workspace or subscription administrator.

1. Click Setup mode.
2. Click the Workspaces & Projects tab.
3. Click the name of the workspace you want to administer.
4. Click the Actions drop-down button and select Edit.
5. On the General tab, check the option for Enable Build and Changeset.
6. Click Save & Close.

Build status

The build status indicator shows you the most recent status of all the build definitions associated with the project you've specified in your project scope settings:

• Build Failure:  At least one build has failed in your project scope.
• Build Success:  All builds in your project scope have succeeded.
• Build Unknown:  An indeterminate result has been associated with a build in your project scope.
• Build Incomplete:  At least one build in your project scope is incomplete.
• No Status Shown:  There are no builds associated with projects in your scope.

The build status indicator is located at the top right of the page, below the search form:

Work item traceability to build and changeset data

The work item detail page shows you which changesets are associated with a particular user story or defect.

Click the links in the Changeset details table to view the information in your SCM system.

Displaying reports on your dashboard

Create reports that show details related to your builds, changesets and repositories using custom grid panels in your dashboard.

Among the many objects to choose from, there are five that relate to Build and SCM traceability:

• Build
• Build Definition
• Change
• Changeset
• SCM Repository

For each panel, choose an object and select fields to display. Use a combination of these panels to present the information you want to track.

You may choose between Global Project and Specific Project scoping options. The Global Project setting follows the scoping you set using your Workspace and Project picker at the top left of the page. You may set specific Project scoping for a dashboard panel by choosing the Specific Project setting and indicating the desired project:

See the Scoping section below for more information about scoping in other contexts.

Analytics

The following charts help you identify possible issues around build and source code management:

• Build Health Chart
• Build Health by Iteration Chart
• Top Files by Changes Chart
• Top Files by Defects Chart

Scoping

Your scope settings (that default to the Workspace and Project picker settings) help Rally filter the data you see in pages, charts and reports. Analytics for build and SCM data sometimes require a departure from your project scoping so that charts provide you with meaningful information:

• Builds are identified by looking both up and down your project hierarchy regardless of your project scope setting. In the the Top Files by Changes Chart, files are scoped to all builds associated with the workspace.

• Builds that do not fall within an iteration are grouped with the last iteration that occurs before the build date.

• Build status reports the condition of builds associated only with the project in scope. It does not honor the up/down scope settings for the project hierarchy.