You are here: Merging Files Between Branches > Promoting files

Promoting files

Files can be promoted without affecting other items in the branch. When you finish making changes, promote changes back to the parent branch. See Promoting branches.

1. Select the files you want to promote and choose Branch > Promote File.

The Promote Files dialog box opens.

2. Select an Ancestor to promote to. You can promote changes to any ancestor branch.

3. Enter any Comments, such as the reason for promoting the files.

4. Select a Promote files based on option.

5. Select Skip server auto-merge to promote changes and overwrite changes in the parent branch.

6. Select Recursive to promote the file to the selected repository and all subrepositories.

7. Click Preview.

The Promote Preview dialog box opens. Files that will be promoted, files that will not be promoted, and files with conflicts are displayed. You can resolve conflicts based on the file status and your security permissions. See Promote preview.

8. Select a file and click Attach to attach it to an item in TestTrack or an external issue tracking tool. See Attaching source files to TestTrack items or Attaching source files to external issues.

You can only attach files that were successfully promoted and changed the version number on the destination branch. Files removed, renamed, or in broken shares cannot be attached.

9. Select Label promoted files in destination to label the files in the ancestor branch. Select a label or select <New label> to create a new label. See Creating labels. Click Select to view label details or search for a label. See Selecting labels.

Labels are only added to files that are promoted successfully, force promoted, or merged locally. Files removed, renamed, or in broken shares are not labeled. Any promote comments you entered are also added to the label history.

10. Select a file and click Promote File to promote it or click Promote All to promote all files.

The Promote Status dialog box opens. You can perform many of the same actions available in the Promote Preview dialog box.

 

Additional documentation  Knowledgebase  |  Blog  |  Technical support