Sharing files between repositories

When you share a file, one copy of the file exists in multiple repositories. The file used to create the share is the base file and the copies created in other repositories are share links. When the base file is updated, all repositories reflect the updates simultaneously. Actions performed on the share links are applied to the base file.

When a file is shared, the file history, filename, custom field values, and workflow state are maintained. Only the file location is different. If a file or repository is shared in a branch, any subsequent branches maintain the defined shared files.

Sharing is a useful feature with many applications. For example, if a EULA file is identical across several projects, the EULA text file or Word document can be shared in each project repository. If an update is made to the EULA file then those updates are automatically included in the next release of any of the projects that contain the shared document.

See Shares Explained for more information about sharing.

1. Select the file or repository to share and choose Activities > Share Files.

The Share Files dialog box opens.

2. Select the repository to share the files with.

Expand the repositories tree to view subrepositories.

3. Select Recursive to recursively share all files in a repository.

4. Enter any Comments, such as the reason for sharing the files.

5. Click OK.

The files are shared. The file is displayed in each repository.