Problem:

How to use Dreamweaver and StarTeam.

Resolution:

• StarTeam 4.x
• Windows 95, NT, 2000

Overview:

Dreamweaver has no interface to the Microsoft Source Code Control (SCC) API, nor does it have an internal mechanism or capability for versioning files. Dreamweaver can copy files from a remote server to a local working directory. The files are modified and saved locally and then returned to the remote server.

From the Dreamweaver on-line help:

Using the check in/check out system

When working in a collaborative environment, you can check out and check in files when transferring them between a remote server and your local computer. See Checking in and checking out files on a remote server.

Checking out a file is the equivalent of declaring "I"m working on this file now?don"t touch it!" When a file is checked out, Dreamweaver displays a check mark next to the file"s icon in the Site window. A green check mark indicates that the file was checked out by you, and a red check mark indicates that the file was checked out by another team member. The name of the person who checked out the file is also displayed in the Site window.

Checking in a file makes the file available to other team members to check out and edit. The local version becomes read-only to prevent you from making changes to the file while someone else has it checked out.

Note: Although you don"t need to know this to use the check in/check out system, in case you"re curious, Dreamweaver keeps track of checked out files by placing a text file with the extension .lck on both the remote server and the local site. The .lck files are not visible in the Site window. Each .lck file contains the name of the user who currently has the file checked out.

Dreamweaver does not make checked-out files read-only on the remote server. If you transfer files with an application other than Dreamweaver, you can overwrite checked-out files. However, in applications other than Dreamweaver, the .lck file is visible next to the checked-out file in the file hierarchy to help prevent such accidents.

You can enable check in/check out for some sites and disable it for others. See Setting up the check in/check out system. For information about transferring files between local and remote sites without checking them in or out, see Getting files from a remote server and Putting files on a remote server.

A file that is checked out, modified and checked in to the server becomes the latest version of the file available for others to check out and modify. There is no historical record or version of the file.

Assumptions:

The User is familiar with Dreamweaver, StarDisk and StarTeam. Editor used cannot be from the Microsoft Office Suite, these tools follow a different Open and Save process than other tools.

Versioning Dreamweaver files

Within Dreamweaver the local working directory is displayed as a file structure (drive x:\xxx\xxx?). This file structure can also be a mapped drive using StarDisk.

Overview

1. The file is checked out from Dreamweaver, modified and saved locally.

2. The local file is then checked into Dreamweaver to become the latest file available to all.

3. After being saved the file is Checked In to StarTeam through StarDisk. Right mouse on the file name in the right hand window of Dreamweaver and selecting the StarDisk option?Check In.

If the file is determined to be unacceptable and wants an earlier version of the file, the user selects the file in the right hand window of Dreamweaver Selects StarDisk?Check out?History. The earlier version of the file now exists locally and can be checked into Dreamweaver.

1. Create an empty View or Project and map to a drive using StarDisk.

In this example "Removable Disk (K):" which points to the empty project "DreamWeaver_One."

2. Create a new site in Dreamweaver. The files to be retrieved may be on a web server, a network drive, or another location of the users choice. Enable the Check Out capabilities in Dreamweaver.

3. Point the local working directory to the mapped StarDisk drive.

Within Dreamweaver:

The file default.htm has been check out in Dreamweaver to the StarDisk drive:

The StarDisk K:\:

The default.htm.LCK file is created by Dreamweaver to denote that it is being modified by the user ?Jim?, and can be ignored. The file default.htm, has a status Not In View, and must be added to the StarTeam Repository. Secondary mouse on the file name, select StarDisk, Add to Project. For further information on adding files with StarDisk , please refer to the StarDisk User Guide.

After being Checked In to the StarTeam Repository:

Edit the file in Dreamweaver ( or using any editor):

Use the hot key to save the modified file or select Save.

***CAUTION***

It is recommended that for ease of use the new version of the file be checked into the remote location by Dreamweaver first. Once this is done the file is Checked into the StarTeam Repository.

Dreamweaver modifies the Date/Time stamp of the file upon check in to the remote location. The file statuses are based upon these time stamps, thus if the file were Checked into the StarTeam Repository first and then checked into the remote location by Dreamweaver the status would show correctly ?Modified? or different based on these file time stamps, even though the file is the same.

Checking into Dreamweaver first, then StarTeam will reduce the opportunity for confusion by the user.

Check into the remote location in Dreamweaver:

This file is now the current file in the remote location.

Within the editor select File | Save As

Secondary mouse the file name in the Save As window. Select StarDisk | Check In. The changed file is checked into the StarDraw Repository.

Inside StarDisk:

The StarTeam will now use the time stamp created by Dreamweaver upon check in to remote location to determine status.

Double primary mouse on the file in the right hand Dreamweaver window and selecting File | Open gives the following window displaying the correct status:

To place an earlier version of the file back in the remote location of Dreamweaver, double primary mouse on the file in the right hand window of Dreamweaver, select File | Open. Secondary mouse on the file name and select StarDisk | Check Out from History, select the version desired and then OK.

Select Open you will receive the following warning:

Select "Yes" and the older version of the file will open in the Dreamweaver editor. If desired make changes to the file and save (). Check the files back into the remote location for Dreamweaver. Select File | Open in the editor, secondary mouse on the file and you will see the following screen:

The user can Check In the file to the StarTeam Repository:

a) "Force Check In" will cause the saved, local version to become the latest version in the repository, and matching the file placed back on the remote server. The Merge occurred because an older version of the file was checked out and modified. If the older version of the file was Checked Out by StarDisk and then checked into the remote location of Dreamweaver, the user needs to do a "Force Check-In" to make the older version of the file the latest version in the Repository, matching the latest version of the file on the remote server/location of Dreamweaver.

b) Decide to complete the "Merge". This modified file would then become the latest version in the StarTeam Repository AND different from the latest one check into the remote location of Dreamweaver.

For more information on merging refer to the StarTeam users guide.