1. © CGI Group Inc. User Guide Subversion client TortoiseSVN

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

3. 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 http://tortoisesvn.net/support.html. http://tortoisesvn.net/support.html 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 http://tortoisesvn.net/support.html. http://tortoisesvn.net/support.html 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. General

4. 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. General

5. 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.here 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.here Installation

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

7. Select SVN 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. Checkout

8. 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). For #define: Go to section URL of repository #define URL of repository #define For PrimePortal: Go to section URL of repository PrimePortalURL of repository PrimePortal For #define: Go to section URL of repository #define URL of repository #define For PrimePortal: Go to section URL of repository PrimePortalURL of repository PrimePortal

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

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. Checkout - URL of repository PrimePortal Select Subversion URL in the actions menu of a folder. Copy the link displayed (in this case https://userguide.define.logica.com/svn/userguide/ PrimePortal/System/). https://userguide.define.logica.com/svn/userguide/ PrimePortal/System/ 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 https://userguide.define.logica.com/svn/userguide/ PrimePortal/ instead) https://userguide.define.logica.com/svn/userguide/ PrimePortal/ Copy the link displayed (in this case https://userguide.define.logica.com/svn/userguide/ PrimePortal/System/). https://userguide.define.logica.com/svn/userguide/ PrimePortal/System/ 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 https://userguide.define.logica.com/svn/userguide/ PrimePortal/ instead) https://userguide.define.logica.com/svn/userguide/ PrimePortal/

12. 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. 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. Checkout 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. 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.

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 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 http://tortoisesvn.net/support.html.http://tortoisesvn.net/support.html 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 http://tortoisesvn.net/support.html.http://tortoisesvn.net/support.html Browse to the file/folder you should work with and use TortoiseSVN->Get lock.

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. Add 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.SVN Update 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.SVN Update

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

23. Commit Enter a commit message for traceability. 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. 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. 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.

24. 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. Delete 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. Delete The file has now been removed from the web based file archive as well.

29. 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. 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. Show log 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. In the log dialog you can perform other operations as well such as compare files of different revisions for example. Visit http://tortoisesvn.net/support.ht ml to learn more about that. http://tortoisesvn.net/support.ht ml In the log dialog you can perform other operations as well such as compare files of different revisions for example. Visit http://tortoisesvn.net/support.ht ml to learn more about that. http://tortoisesvn.net/support.ht ml

30. Show log 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. 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. If you have any further questions feel free to contact us at: servicedesk@logica.com servicedesk@logica.com Questions?

34. Thank you! 34