Promote preview

You can view file status, files that will or will not be promoted, and files with conflicts. The actions you can perform depend on the file status and your security permissions.

1. Click Preview on the Promote Branch or Promote Files dialog box.

The Promote Preview dialog box opens.

2. Select a file and click a button to perform an action.

Button	Action	More information
Differences	Compare the file versions in the specified From branch and To branch file.	Viewing file differences
History	View the file history.	Viewing file history
Properties	View the file properties.
Attach	Attach the file to an item in Helix ALM or an external issue tracking tool. You can only attach successfully promoted files that changed the version number on the destination branch. Files removed, renamed, or in broken shares cannot be attached.	Attaching source files to Helix ALM items and Attaching source files to external issues
Add to Code Review	Add the file to a code review. You can only add successfully promoted files that changed the version on the destination branch. Files removed, renamed, or in broken shares cannot be added to reviews.	Adding files to code reviews
Promote File	Promote the file. You can view files that were promoted or were not promoted, and files with conflicts. You can also perform actions to resolve conflicts and promote files.	Promoting files
Merge Locally	Manually merge the files.	Merging files
Remove Parent	Remove the file from the parent branch. If you promote a file that was removed from the child branch, you may need to remove it from the parent branch.	Removing files
Break Share	Unshare a file.	Breaking shares
Force Promotion	Promote the file and overwrite the parent branch file.

3. Select Label promoted files in destination to label 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 successfully promoted, 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.

4. Click Promote All to promote all files.

The Promote Status dialog box opens. You can view files that were promoted, files that were not promoted, and files with conflicts. See Promote actions. You can also resolve file conflicts.

5. Click Save As to save the results list or click Print to print it.

6. Click Close when you finish.