1. User Guide Subversion client TortoiseSVN

2. Index General Installation Checkout URL of repository #define
URL of repository PrimePortal
Update
Get lock
Add
Commit
Delete
Show log
Status icon legend
No. 2

3. General
The web based file archive of PrimePortal and #define is designed to support basic functions like viewing documents, uploading files and creating folders. If you are an advanced user that works frequently with files it is more efficient to download an external tool (Subversion Client). With a Subversion Client you will get access to more advanced file operation features.
TortoiseSVN is a popular Subversion client for the Windows platform. This user guide will walk you through the most common TortoiseSVN operations. If you are interested to learn more visit

4. General
With TortoiseSVN you will work against the web based file archive via a local working copy. This means that you for example can work with your files offline and once you get online again send (commit) your changes back to the web based file archive.

5. Installation
Download and install TortoiseSVN here. Select 32-bit or 64-bit installation depending on your operating system. Note! You need Administrator privileges to install TortoiseSVN.

6. Checkout
Create a folder somewhere on your computer. Note! Don’t create it in a folder structure mirrored to a remote server.

7. Checkout
In order to get started working with files in a local working copy you need to perform an initital checkout from the web based file archive. During the checkout you will point your local folder to the web file archive and do an initial download of files and folders.
Select SVN Checkout.

8. Checkout For #define: Go to section URL of repository #define
For PrimePortal: Go to section URL of repository PrimePortal
Add the URL of the repository you want to check out. The way to fetch the repository URL differs depending on which tool you use (#define/PrimePortal).

9. Select Subversion URL from the header section.
Checkout - URL of repository #define
Login to the #define project where you want to work with files and folders through a local working copy.
Go to Files.
Select Subversion URL from the header section.
Copy the link displayed (in this case

10. Checkout - URL of repository PrimePortal
Login to PrimePortal and go to the file archive where you want to work with files and folders through a local working copy.

11. Select Subversion URL in the actions menu of a folder.
Checkout - URL of repository PrimePortal
Copy the link displayed (in this case
Note! If you want to checkout all files and folders in this file archive don’t copy the folder name (in this case the url would be instead)
Select Subversion URL in the actions menu of a folder.

12. Checkout
If this is the first time you perform a checkout against this file archive you will see a login window.
Add the same login details you use for #define or PrimePortal, select Save authentication if you want TortoiseSVN to remember your login information and select OK.
The checkout will now start and all files and folders will be downloaded to your local working copy folder. Select OK once the checkout is finished.
Select the button “…” to use the Repository browser to browse the web file archive. If you instead want to checkout against another folder you select that here.

13. Checkout
After the checkout is done you have all folders and files in your local working copy and can now start to work with them. In the following sections we will go through how to perform the most common file operations through TortoiseSVN.

14. Update
The first action to start with each time you should perform actions through your local working copy is to get the latest updates from the web based file archive. That action is called SVN Update in TortoiseSVN.
Browse to the folder/file where you want to perform an action/s. Right-click and select SVN Update. Latest updates in that folder structure will now be downloaded.

15. Update
Updates have now been downloaded. In this case the file Database interface.docx has been update since the latest update. Select OK.

16. Get lock
Browse to the file/folder you should work with and use TortoiseSVN->Get lock.
In order to be sure that no one else will work with the file/folder when you are you should lock the file via the TortoiseSVN action Get Lock.
For more advanced settings such as Require Lock visit

17. Get lock
Enter a message describing why you are locking the file(s)/folder(s) (optional).
Select OK.

18. Get lock
Enter a message describing why you are locking the file(s)/folder(s) (optional).
The file is now locked. You can start work with the file certain that no one else can override your changes.
Select OK.

19. Add
If you created new files and/or files in your folder structure you need to add them to source control too. In this case a new file Permissions.docx has been created.

20. Select the file(s) and/or folder and use TortoiseSVN->Add.

21. Commit
Sending the changes you made to your working copy is known as committing the changes. But before you commit you have to make sure that your working copy is up to date. Go to section SVN Update to read more about that.

22. Select the file(s) and/or folder and use TortoiseSVN->Commit.

23. Commit Enter a commit message for traceability.
This means that if you instead would have done the commit operation on the parent folder for this file the commit dialog would have recognized an unversioned file and you would have been able to both add and commit that file through this dialog directly.
The commit dialog will show you every changed file, including added, deleted and unversioned files.
In this case we have one added file in this list.
Select OK.

24. The file is now sent to the web based file archive.
Commit
The file is now sent to the web based file archive.

25. Delete
It is important to use TortoiseSVN -> Delete if you want to delete a file or a folder in the web based file archive through your local working copy.

26. Select the file(s) and/or folder and use TortoiseSVN ->Delete.

27. Delete
Due to the fact that this file is no longer present in your folder you have to perform the commit from the parent folder of this file (in this case System).
Select TortoiseSVN->Commit. Enter a suitable Commit message and select OK.
The file or folder is now removed from your local working copy but in order to have it removed from the web based file archive you need to commit your changes as well.

28. The file has now been removed from the web based file archive as well.
Delete
The file has now been removed from the web based file archive as well.

29. Show log
The log retrieves all log messages and shows them to you. The display is divided into 3 sections.
The top section shows a list of revisions where changes to the file/folder have been committed. Date and time, the person who committed the revision and the start of the log message is included.
The middle section shows the full log message for the selected revision.
The bottom section shows a list of all files and folders that were changed in the selected revision.
In the log dialog you can perform other operations as well such as compare files of different revisions for example. Visit to learn more about that.
For every change you make and commit, you should provide a log message for that change. That way you can later find out what changes you made and why.

30. Select the file or folder and use TortoiseSVN ->Show log.

31. Status icon legend
Now that you have checked out a working copy from the web based file archive you can see your files in the windows explorer with changed icons.
On the following slide you will see a list of the most common status icons that can occur in your local working copy.

32. Status icon legend
A fresh checked out working copy has a green checkmark as overlay. That means the status is normal.
As soon as you start editing a file, the status changes to modified and the icon overlay changes to a red exclamation mark. That way you can easily see which files were changed since you last updated your working copy and need to be committed.
If a conflict occurs during an update the icon changes to a yellow exclamation mark.
If you hold a lock on a file this icon overlay is shown.
This icon shows you that some files or folders inside the current folder have been scheduled to be deleted from the web file archive (repository).
The plus sign tells you that a file or folder has been scheduled to be added to the web file archive (repository).

33. Questions?
If you have any further questions feel free to contact us at:

34. Thank you!