Defining releases in the web client

Releases are the products of a team's work. The releases that you identify appear in the list that is associated with the Found In field of a work item.

About this task

You can define releases in the project administration interface. You can also create a release in the build results editor and associate the completed build with the release. For more information, see Associating builds with releases.

Procedure

  1. To define releases in the web client, click the home menu in the Change and Configuration Management section. Select All Projects from the list of projects.
  2. Click Manage Project next to the Project area for which you want to define releases.
  3. To view the Releases page, click Releases.
    Releases table
  4. To add a release, click the Add Release icon Add Release icon..
    Add release
    1. Enter a name and brief description for the release.
    2. Optional: Click the Iteration icon Iteration icon.. Select an iteration that you want to associate with the release.
      Choose iteration
      Tip: To support linking work items to versioned artifacts that belong to configurations in Configuration Management-enabled project areas in applications such as Requirements Management and Quality Management, you must associate the release with an iteration. For more information, see Enabling linking of work items to versioned artifacts.
    3. Optional: Select the Release Date to specify when the release is expected to be complete and available.
      Note: If you associate an iteration with the release, Release Date is read-only. In this case, the release date is calculated based on the selected iteration.
    4. To limit visibility of the release to members of this project area team, select the Hide Release Visibility from All but Members of the Team checkbox. Click OK.
  5. To enable linking of work items to versioned artifacts, make sure that the releases are associated with the global configurations. Release associations are now managed in the Global Configuration Management (GCM) application. For more information, see Associating Releases with global configurations.
  6. Optional: To add one or more Predecessors to the release, click the Actions column icon Actions column icon. and click Predecessors. Select the appropriate values in the left pane and click Add. Click Add all to add all the values in the left pane as Predecessors to the current release. Click OK. Adding a predecessor allows global configurations to inherit the associations from the previous releases.
    Predecessors window.
  7. To edit an existing release, click the Actions column icon Actions column icon., then click Edit Release. You can make the required changes, click OK.
  8. To remove an old release from the table, select the checkbox for the release in the Actions column, then click Archive Selected. To view archived releases, select Show Archived. Archived releases appear unavailable. To restore an archived release, select the checkbox for the release and click Unarchive Selected.
  9. To adjust the order in which releases appear in the Found In field list of a work item, select a release in the table, click the Actions column icon, and click Move Up or Move Down.
  10. When you finish defining releases, click Save to save your changes.