You are here: Getting and Viewing Files > Getting files

Getting files

Get files when you want to view a file but do not need to make any changes. A read-only copy of the file is created in the specified directory.

After you get a file, the local copy does not stay in sync with the file on the Surround SCM Server. For example, if you get a copy of a file on Monday and another developer changes it on Wednesday, the server copy and local copy are out of sync. You have to get the file again to get the updates.

1. Select the files or repository and choose Activities > Get.

The Get Files dialog box opens.

2. Select the Location you want to retrieve the files to.

The working directory is the default location. Click Browse to select a different directory.

3. Select Recursive to include all child repositories.

Files in the selected repository and any child repositories are copied to the working directory.

4. Optionally expand the Get based on area to select options for retrieving files based on version, timestamp, label, or workflow state.

5. Optionally expand the Advanced options area to select advanced get options.

6. Select Make files writable to get the files in read-write mode.

7. Select Force file retrieval from server to get the server copy.

Surround SCM checks the local copy of the file to determine if the file is current. Select this option if you want to retrieve a new copy of the file from the server even if the local copy is current.

8. Select Merge should first attempt auto-merge to enable auto-merges.

You are only prompted to manually merge files if auto-merge fails.

9. Select an Overwrite option to specify what to do if the local file and server file are different or how to handle modified files in the working directory that were removed from the server.

10. Select a File timestamp option. The timestamp is set on the local files when they are retrieved from the server.

11. Click OK to get the files.

The files are copied to the specified directory.

Tip: If the local directory does not exist, you are prompted to create it. See Creating local directories.

 

Additional documentation  Knowledgebase  |  Blog  |  Technical support