TechNote

Integrating multiple users with Microsoft Visual SourceSafe via HomeSite or Studio 4.5.1

The following procedure takes you through the steps on how to have multiple users integrate with a VSS Project via a HomeSite or ColdFusion Studio 4.5 Project.

Step One: Review Development Environment


The Purple computer represents the Visual Source Safe server. VSS Shared Database Server must be installed on this machine. For demonstration purposes we will name this machine *"MacDaddy"*	The Green computers represents all the users that will be integrating the VSS project via HomeSite/Studio. VSS Stand-Alone must be installed on each machine. For demonstration purposes we will name these machines"Machine_A"&"*Machine_B*."

Step Two: Create a HomeSite/Studio Project on "Machine_A"

Tip: Before creating the Allaire project, copy the existing files and folders/directory structure from the VSS Shared Database Server to your local machine. For example, grab C:\Inetpub\wwwroot\MyWebSite fromMacDaddy and copy to Machine_A's C:\Inetpub\wwwroot\MyWebSite.

Click the Projects Tab to display the project tools.
Click the New Project button.
New Project dialog box will appear.
1. Enter a name for the project in the project Name box. In this case we named the Project "MyWebSite".
2. Click the Browse button to locate the directory using the Select Directory dialog box.
  In this case we browsed toC:\Inetpub\wwwroot\MyWebSite.
3. Check the option "Add all subfolders and files of types."
4. Select "ok."
Next, we need to change the project folders folder Properties.
1. Right-click on the yellow project folder and selectProperties.
2. Make sure Auto Include Files and Subfolders is checked and make sure your folder is bulleted as a Physical Folder

Step Three: Integrate the Allaire Project you just created with the VSS Project "Machine_A"

Choose a Source Control Provider.
All the source control commands are available by right-clicking on the Project root (the globe)
Map to Source Control.
(Right-click on the Project root)

Browse to the VSS Shared Database srcsafe.ini file. Probably found here on MacDaddy C:\Program Files\Microsoft Visual Studio\VSS\srcsafe.ini

Please Note: The srcsafe.ini file points to all the available VSS projects on that machine.

In this example we browsed to MacDaddy server.

Once you've browsed to the Visual Source Safe Server (MacDaddy) and find the srcsafe.ini file, you will be prompted to log in.
You should now see the VSS projects on the MacDaddy server. Make sure the path to the working folder is correct. In this step we are pointing the Allaire Project to where the actual source protected files are located. Select OK.
Select OK. Your Allaire Project is now integrated with the VSS.The Check in/out option is available when you right click on the file.

Step 5: Managing and Maintaining your Allaire Project.

Adding files and folders:
If you save a file anywhere under the root of the Allaire Project you will be asked, "Would you Like to Add the File to Your Project," then you will be asked "Would you like to Add this File to Source Control." Select yes for both.

If you manually add the files to the folders via Windows Explorer, you will have to manually add the files to the Project and Source Control. To add the file to the Allaire Project, right-click on the project folder and select "Add File". Once the file is added to the project folder, right-click on the file and select "Add the file to Source Control."
Getting latest versions and maintaining the master directory structure/tree:
Right-click on the Project root (Globe) and select "Run Source Control Application."

Once VSS is opened, right-click on the Project and select "Get latest Version."

This box will appear.

Check Recursive and Build Tree option.

This should be done every time you open the Allaire Project. This will update your local working directory so it will mirror the VSS database. Good practice is to have all developers (Machine_A and Machine_B) do this frequently or at scheduled times.