Documentation

Create a new local copy of a repository by retrieving files from source control.

1. Right-click in the white space (any blank area) in the Current Folder browser and select Source Control > Manage Files.

2. In the Manage Files Using Source Control dialog box, select the source control interface from the Source control integration list. To use SVN, leave the default Built-In SVN Integration.

3. Click Change to browse for and validate the repository path. (If you know your repository location, you can paste it into the Repository Path box and proceed to step 8.)

4. In the Specify Repository URL dialog box, specify the repository URL by entering a URL in the box, using the list of recent repositories, or by using the Generate URL from folder button .

   

   Caution   Use file:// URLs only for single-user repositories. For more information, see Share a Subversion Repository.

5. Click Validate to check the repository path.

   If the path is invalid, check the URL against your source control repository browser.

6. If you see an authentication dialog box for your repository, enter login information to continue.

7. If necessary, select a deeper folder in the repository tree. You might want to check out from trunk or from a branch folder under tags, if your repository contains tagged versions of files. You can check out from a branch, but the built-in SVN integration does not support branch merging. Use an external tool such as TortoiseSVN to perform branch merging. The example shows trunk selected, and the Selected URL displays at the bottom of the dialog box. The retriever uses this URL when you click OK.

   

8. When you have finished specifying the URL path you want to retrieve, click OK.

9. In the Manage Files Using Source Control dialog box, select the sandbox folder where you want to put the retrieved files, and click Retrieve.

   Caution   Use local sandbox folders. Using a network folder with SVN slows source control operations.

   

   The Manage Files Using Source Control dialog box displays messages as it retrieves the files from source control.

Note:   To update an existing sandbox from source control, see Update SVN File Status and Revision.

Retrieve Tagged Version of Repository

To use tags with SVN, you need the standard folder structure in your repository. For more information, see Standard Repository Structure.

1. Right-click in the white space in the Current Folder browser, and select Source Control > Manage Files.

2. In the Manage Files Using Source Control dialog box, select the source control interface from the Source control integration list. To use SVN, leave the default Built-In SVN Integration.

3. Click Change to select the Repository Path that you want to retrieve files from.

4. In the Specify Repository URL dialog box:

   1. Select a recent repository from the Repository URL list, or click the Generate URL from folder button to browse for the repository location.

   2. Click Validate to show the repository browser.

   3. Expand the tags folder in the repository tree, and select the tag version you want. Navigate up a level in the repository if the URL contains the trunk.

   4. Click OK to continue and return to the Manage Files Using Source Control dialog box.

5. Select the sandbox folder to receive the tagged files. You must use an empty sandbox folder or specify a new folder.

6. Click Retrieve.