|
The MS Visual SourceSafeTM 6.0 (VSS) integration with Studio facilitates users to perform VSS operations from within Studio. When coupled with desk, it works on the files present in that desk only. VSS supports only Windows platform in this version.
Studio VSS module cannot handle any hidden internal or meta files. This document describes how to configure VSS in Studio and use it to:
VSS tool is deployed in Studio by default if the platform is Windows. To configure, install MS Visual SourceSafe 6.0 client on the local machine. Select Tools > Configure. In the Configure dialog, select SourceSafe option; provide location of VSS tool JAR; click Import Tool. SourceSafe option appears in the Tools menu.
To configure VSS preferences in Studio, select File > IDE Options; in the dialog, SourceSafe node appears.
Set the following properties as per requirement:
To undeploy, select Tools > Configure. Uncheck SourceSafe from Available Tools list.
VSS maps working directories provided in the mapping with the VSS project. VSS project for operations on any local file is taken from this map. It is calculated recursively. For example, if c:/temp is mapped to $/jacob, c:/temp/com will be mapped to $/jacob/com.
To override this, provide explicit mapping. For example, to map c:/temp/com/pramati/test to $/test, you can directly do so.
The maximum length match which calls VSS project is calculated. Selecting SourceSafe in IDE Options panel displays:
The Display dialog option enables to execute VSS commands silently or using dialogs. Use the following options:
Whenever the desk is opened, VSS asks for all the passwords being used in this desk. These passwords are kept in memory for the entire studio session. If the passwords are not provided here, then the same is asked when the configuration is changed.
Check this field if the VSS is to use an external difference program. Browse for and enter the location of where the external program is installed. Keeping the option unchecked uses the default Studio Diff tool. Click here to know more about Studio Diff tool.
After configuring the VSS, start using it in Studio. The status of the files/folders is displayed in the Explore Panel with the help of different icons. The icons used are:
To create a new project on the VSS from the desk module, right click on the desk module, and select 'Create Module'. Enter the following information:
To get a module from VSS and create a desk module, enter the following information:
Under the section, VSS Project, enter the following information:
To checkout files from the VSS server into the local system, you can either select a module/item in the desk tree view, and right click to see the following options, or use the Visual SourceSafe > Checkout menu option for the file active in the editor dialog.
Bring up the Checkout dialog by right clicking on the desk/module (existing in Visual SourceSafe) > Checkout. The screenshot below displays how to checkout a new VSS module on the desk.
Fill in the following information to checkout the module or files as required:
After entering all the information required, click OK. This checks out the modules or the files under the desk or module, as required.
Use Checkin to check in the files from the local system into the VSS server. The following dialog is displayed:
Use this option to undo the most recent check out, which would prevent any changes from being made. The following dialog is displayed:
Folder/File > Right Click > SourceSafe > Add
Use this option from the main menu in Studio to add files stored locally into the VSS repository. The directory under which the files exist must already exist in the SourceSafe repository. When a file is added to the SourceSafe, the SourceSafe resolves the type of the file internally and adds it as a binary or text file. Files and folders can also be added to the SourceSafe on a right click. To do this, right click on the specific file/folder > SourceSafe > Add, and then commit them.
Use the SourceSafe Add from the main menu to add the active file (the file open in the Display Panel) to SourceSafe.
There are two ways to fetch a copy of the latest version. You can either select a module/item/folder in the desk tree view, and right click to see the following options, or use the SourceSafe > Get Latest Version. Clicking 'Get Latest Version' displays the following information:
'Recurse' and 'Add new files to desk options are not available for Editor menu options, and operations done on the desk Items.
In case if a file on the local system is writable, and you perform a 'Checkout' or a 'Get Latest Version', it displays the following message and options:
The SourceSafe integration currently supports removal of files only. There are two ways to remove a file from SourceSafe. Right click on the specific Item > SourceSafe > Remove, or use SourceSafe > Remove from the main menu to delete the currently active file. This option is used to mark the items/files to be removed from the SourceSafe repository. These files and folders have a black cross in their icon.
Use this option in Studio to compare the latest revision of the file in the SourceSafe repository with the file saved locally. Studio uses the Studio diff tool to display the differences, by default. To use an external difference program, configure it using the Preferences dialog. The default action used by SourceSafe is that it compares the working files with the revisions they were based on, and report any differences that are found.
If any file names are given, only those files are compared. If any directories are given, all files under them will be compared. Use SourceSafe > Show Differences from the main menu to compare the latest revision of the file in the SourceSafe repository with the file saved locally. The file referred above is the active file (the file open in the Display Panel).
The Studio Diff Tool can be used both with SourceSafe. Click on SourceSafe > Show Differences from the main menu, or right click on the required file and select SourceSafe and then Differences to bring up the Studio Diff tool. The Diff tool displays the selected files side-by-side in a splitter view, which is called the File Comparison view (or just the "diff view" for short).
Different colors are used to highlight the differences between the two files. Green areas indicate the lines that were aded to the modified file, and did not exist in the original file. Areas highlighted by blue lines indicate that the selected lines were modified in some way in the new file. Areas highlighted by red lines on both sides indicate that the selected lines were deleted in the modified file.
There are different ways of stepping through the differences in the two files. The gutter on the right hand side displays the summary of differences in the two files with the correct colors. Clicking on a specific color takes the cursor to the required difference.
Use the back and forward arrow keys, or the back and forward arrow buttons provided in the tool to move to the previous and next difference. Use Ctrl + back and Ctrl + forward arrow keys, or the arrow buttons provided in the tool for moving to the first and the last difference directly. Use Ctrl + up and Ctrl + down arrow keys to move between the previous and the next differences.
Once you have selected a difference (either by using the arrow or by clicking it with the mouse), synchronize one side with the other by either using the right and left arrow keys, or the scroll bars provided.
Use the Toggle SplitPane button to view the two files either vertically or horizontally. Clicking on the button, highlights the differences by underlining them with a red line in the original file. The state of this button is remembered after the tool is closed and re-opened.
Clicking on the button, displays the differences after ignoring the case of the letters. The state of this button is not remembered after the Diff tool is closed and re-opened.
Clicking on the button, displays the differences after ignoring the blank spaces. The state of this button is not remembered after the Diff tool is closed and re-opened.
This shows the History of SourceSafe operations done on the file/folder.
Use the SourceSafe > Show Status option to view the Status of a folder or a file in the SourceSafe repository. Based on the operations performed on a checked out file, and what operations others have performed to that file in the repository, a file can be classified in a number of states.
This option allows you to view the status of the active file (the file open in the Display Panel).
| Pramati Technologies © Copyright |
   
|