Defining releases

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

About this task

With 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 details, see Associating builds with releases.
Note: If you intend to support linking work items to versioned artifacts in Configuration Management-enabled project areas in applications such as Requirements Management and Quality Management, you need to associate releases with global configurations, and you might also need to associate releases with iterations. To perform these tasks, you need to use the web client. See Linking work items to artifacts in Configuration Management-enabled project areas and Defining releases in the web client for details.

Procedure

  1. In the Eclipse client, in the Team Artifacts view, right-click the project area and select Open.
  2. Create a release:
    1. Click the Releases tab.
    2. Click Add.
    3. Enter a name and brief description for the release.
    4. Optional: Select a release date.
    5. To limit the visibility of the release to members of this project area team, select Show only to members of project teams.
    6. Click OK.
    The release is displayed in the Releases table. If you limit the visibility of the release, the value in the Visibility column cell for that release is Project Internal. If you do not limit the visibility, the value is Public, meaning that all users in the Jazz® repository can see it.
  3. To remove a release from the table, select the release and click Archive. To view archived releases, click Show Archived. Archived releases are gray. To restore an archived release, select it or right-click it and select Unarchive.
  4. To adjust the order in which releases are displayed in the Found In list, select a release in the table and click Up or Down.
  5. When you finish defining releases, click Save to save your changes.