Using Toad with Subversion

This file gives details of how to get your scripts, packages and so on under version control using SubVersion: specifically, using TortoiseSVN as the GUI - it integrates into Windows Explorer and is accessed via the right-click context menu.

There are two ways to use Tortoise SVN with Toad: Through Third party file based source control, or through the Team Coding interface.

File-based Source Control has integrated Tortoise support. You should be able to install Tortoise on your machine and select it as your Source Control Provider from the dropdown list in Toad|Options. If you wish to use the SCC interface, you will need to work through a bridging software as described in the Team Coding section below.

If you are using the Team Coding interface, you will need to integrate Tortoise with Toad using an SCC.dll.

Note: An SCC is a required interface between your IDE of choice (TOAD) and the Version Control system you wish to use. If you have a GUI like TortoiseSVN in use then you still cannot get TOAD to connect with your repositories until you install a separate SCC dll and register it. This can be done using the PushOK software or other bridging software.

Newer versions of Tortoise apparently do not provide direct SCC support. Therefore, a bridging software, such as PushOK SCC is required. NOTE: The following procedure is not guaranteed to be the best or most efficient way to connect, but it does work.

  a. Install TortoiseSVN-1.4.8.12137-win32-svn-1.4.6.msi (or the current version of TortoiseSVN).
  b. Create a directory to house the repository (we used D:\TSVN).
  c. Right click on the new directory, then TortoiseSVN. 
  d. Create a repository in the Native File System (FSFS).

A. TORTOISESVNSCC

   Download the zip file and unzip it to the c:\program files\TortoiseSVN folder 
   that you installed TortoiseSVN into. This will create a new folder named, 
   surprisingly, c:\program files\TortoiseSVN\TortoiseSVNSCC. Beneath this there 
   is a bin folder where the executables etc are stored.

   Open a DOS box, cd to the folder c:\program files\TortoiseSVN\TortoiseSVNSCC\bin 
   and run the command regsvr32 TortoiseSVNSCC.dll as per the readme file. That's it - 
   no reboot required.

Command Line Tools

   This is an optional step.

   Download the exe file for the correct version of SVN (the same version as 
   TortoiseSVN is the correct one) and run the installer. This installs a number 
   of command line tools, some documentation and all you need to administer SubVersion 
   repositories.

B. PushOK

  a. Install PushOK.

     Open the PushOK software, select SVNSCC and then Configure Plugin. 
     Ensure that the TortoiseSVN repository you created earlier is in the list of Known Roots.

  b. Create a working folder (for example: C:\work) and add some files to it.
  c. Right click on the new directory and select TortoiseSVN | Repo-browser:

     Right click and select Add Folder.
     Select the working folder.
     Ensure that the folder and the files contained are now visible in the repository.

C. Toad

  a. Launch Toad.
  b. From the View menu, select Toad Options and click on Source Control in the left hand 
     navigation panel.
  c. Click on VCS Provider Options and set the provider to PushOk SVNSCC (or Tortoise. 
  d. Check all prompts.
  e. Click OK to close Options

Note: unless otherwise noted, the following steps take place within Toad for Oracle.

1. In Editor, open a file from the working directory.

2. "Check Out" the file.

3. When prompted, configure project as follows:

  SVNURL:  file:///D:/TSVN (or the directory you created in step 1b above).
  SVN MODULE:  work (or the working folder you created in step 2b above. Do not
      enter the path here).
  LOCAL PATH:  c:\ (in the example we are using, this will make the working file c:\work).

4. Add a comment when prompted for check out comment.

5. Make a change to the file.

6. CHECK IN the file.

7. Save when prompted and add some check-in comment.

8. Open a new file from any location on your computer.

9. Add the new file to source control.

10. When prompted, add comment for add file.

11. Right click working directory in Windows Explorer, select TortoiseSVN | Repo-browser.

  Look for checked out file and look for comments and changes.
  Look for new file added to repository.