逐步解說：準備從 Visual SourceSafe 移轉至 Team Foundation

發行項
08/21/2008

更新：2007 年 11 月

Team FoundationVisual SourceSafe 轉換器工具會將檔案、資料夾、版本歷程記錄和使用者資訊從 Visual SourceSafe 資料庫傳輸至 Team Foundation 版本控制伺服器。將檔案和歷史資訊移至 Team Foundation 之前，您應該分析並製作資料庫的備份複本、盡可能簽入較多的檔案，並了解無法從 Visual SourceSafe 傳輸至 Team Foundation 的資訊為何。

本逐步解說將說明如何準備要轉換的 Visual SourceSafe 資料庫，以及如何使用 VSSConverter 有效規劃實際的來源移轉。

在這個逐步解說中，您將完成下列工作：

備份 Visual SourceSafe 資料庫。
使用 Visual SourceSafe Analyze 工具來識別及解決現有資料庫中的資料完整性問題。
執行轉換器工具來識別可能的資訊來源遺失問題。
指定要移轉哪些 Visual SourceSafe 資料夾。
建立使用者對應檔，將 Visual SourceSafe 使用者對應到 Team Foundation 使用者。

必要條件

若要完成本逐步解說，您需要在打算執行 VSSConverter.exe 的電腦上安裝下列軟體：

Team 總管
使用管理認證登入到電腦
SQL Server Express

注意事項：

根據預設，SQL Server Express 是在 Visual Studio 2005 或 Visual Studio 2008 安裝期間所安裝。
Visual SourceSafe 2005 (含) 以後版本

注意事項：
根據預設，SQL Server Express 是在 Visual Studio 2005 或 Visual Studio 2008 安裝期間所安裝。

您想要分析的 Visual SourceSafe 資料庫。此資料庫的格式必須是 6.0 (含) 以後版本。您必須在與 Visual SourceSafe 資料庫相同的電腦上執行轉換器，才能完成這個逐步解說。

此外，您還需要：

Visual SourceSafe 資料庫的系統管理員密碼 (此資料庫包含您想分析的專案)。

注意事項：
其他使用者不應該在分析過程當中存取 Visual SourceSafe 資料庫。但是，請勿鎖定資料庫，因為鎖定會使得轉換器無法存取此資料庫來進行移轉。

必要的使用權限

您必須擁有即將移轉之 Visual SourceSafe 資料庫的系統管理權限，才能執行此逐步解說。如需詳細資訊，請參閱 Microsoft 網站 https://msdn2.microsoft.com/zh-tw/library/ms181065.aspx (英文) 中的＜HOW TO: 指派專案權限＞。

準備 Visual SourceSafe 資料庫

在您將原始檔控制的檔案從 Visual SourceSafe 傳輸至 Microsoft Visual Studio Team System 之前，請先完成下列 Visual SourceSafe 工作。

要求所有資料庫使用者簽入他們的檔案。
備份要移轉的 Visual SourceSafe 資料庫。如需詳細資訊，請參閱 Microsoft 網站中的＜如何備份 Visual SourceSafe 資料庫＞(https://support.microsoft.com/kb/244016/zh-tw)。
使用 Visual SourceSafe Analyze 公用程式來尋找及修正資料庫中的資料完整性問題。如需如何使用這項工具的詳細資訊，請參閱＜ANALYZE 公用程式＞(https://msdn2.microsoft.com/zh-tw/library/ysxsfw4x.aspx) (英文) 以及＜HOW TO：偵測並修正 Visual SourceSafe 中的資料庫損毀錯誤＞(https://support.microsoft.com/kb/133054/zh-tw)。

分析專案

VSSConverter.exe 是一個需要下列輸入的命令列工具：

包含要移轉的 Visual SourceSafe 資料庫之 srcsafe.ini 檔的資料夾路徑。
包含設定的 XML 檔案。
VSSConverter.exe 儲存在 <root>:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE 中，但是會從 Visual Studio 命令提示字元叫用。

本逐步解說假設您的 Visual SourceSafe 資料庫位於 c:\VSSDatabase。

當您決定要分析哪些專案之後，請建立一個包含這些設定的檔案，這個檔案會列出您希望轉換器分析的專案。

若要建立設定檔來進行分析

依序按一下 [開始]、[所有程式]，並依序指向 [Microsoft Visual Studio 2008]、[Visual Studio Tools]，然後按一下 [Visual Studio 2008 命令提示字元]。
在命令提示字元中輸入 mkdir %DriveLetter%\VSS2TeamFoundation，其中 %DriveLetter% 是目前的磁碟機。請按 ENTER 鍵。
在命令提示字元下輸入 cd %DriveLetter%\VSS2TeamFoundation。請按 ENTER 鍵。
輸入 notepad settings.xml，然後按 Enter。
選取 [是]，即可建立檔案。

複製下列 XML 程式碼，其中 $/FolderA 和 $/FolderB 表示包含要移轉之專案的資料夾名稱。

<?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
      <ConverterSpecificSetting>
            <Source name="VSS">
                  <VSSDatabase name="c:\VSSDatabase"></VSSDatabase>
            </Source>
            <ProjectMap>
            <Project Source="$/FolderA"></Project>
            <Project Source="$/FolderB"></Project>
            </ProjectMap>
      </ConverterSpecificSetting>
      <Settings>
       <Output file="Analysis.xml"></Output>
     </Settings>
</SourceControlConverter>

注意事項：
若要移轉整個資料庫，請使用 <Project Source="$/"></Project>。

若為 <VSSDatabase name> 標記，請輸入 Visual SourceSafe 資料庫的路徑。

儲存您的變更，然後關閉 [記事本]。

接下來，請從 Visual Studio 命令提示字元執行轉換器工具以分析專案，如下列步驟所示。

執行分析的使用者必須是 SQLExpress 的系統管理員；根據預設，安裝 Visual Studio 的使用者將會得到 SQLExpress 的必要權限。

當您準備好移轉設定檔及授與的系統管理員權限之後，就可以執行轉換器工具來分析專案。

若要使用轉換器分析專案

在 Visual Studio 命令提示字元中，輸入下列命令。

VSSConverter Analyze settings.xml
當您看到提示時，請提供 Visual SourceSafe 系統管理員密碼。

轉換器工具會顯示預先轉換分析的狀態；當完成時，它會產生一份報告 (VSSAnalysisReport.xml) 和一個使用者對應檔 (usermap.xml)，並將這兩者儲存到目前的目錄。您可以利用使用者對應檔，將 Visual SourceSafe 使用者對應到 Team Foundation 使用者。如需詳細資訊，請參閱 HOW TO：編輯原始檔控制移轉使用者對應檔。

後續步驟

您現在就可以將 Visual SourceSafe 資料庫中的資訊移轉到 Team Foundation 版本控制伺服器。如需詳細資訊，請參閱逐步解說：從 Visual SourceSafe 移轉至 Team Foundation。

請參閱

共用方式為