了解 VSS 升級工具轉換資料的方式

Visual SourceSafe 升級工具是便利的一次性單向升級方法，可用來將程式碼庫從 Visual SourceSafe 升級至 Team Foundation Server (TFS)。只有在您準備好要在 Visual SourceSafe 中停止進行存取，並開始在 TFS 中進行維護時，才應該使用這個工具來升級資料。

TFS 和 Visual SourceSafe 在功能上有顯著的差異。因此，Visual SourceSafe 升級工具會在升級期間修改特定種類的資料。

本主題內容

• 變更集的建立方式

• 共用及釘選項目的升級方式

• 記錄資料的移植方式

  • 如何移植有關使用者名稱和時間戳記的資料

  • 如何轉換特定類型的事件

• 版本控制繫結的移植方式

變更集的建立方式

TFS 版本控制會在使用者簽入一組變更時，將多個檔案的變更分組成一個單位。這個單位稱為變更集。

Visual SourceSafe 並沒有相當於變更集的功能。但是在轉換程序期間，只要下列條件成立，每一組變更都會分組為變更集：

• 變更彼此不衝突。例如，不會有兩個動作影響同一個檔案或資料夾。

• 彼此變更發生的時間不超過幾分鐘。

• 變更是由相同的使用者簽入。

• 變更有相同的簽入註解。

共用及釘選項目的升級方式

在 Visual SourceSafe 中，可以跨多個資料夾共用檔案。在共用檔案中進行的變更會橫跨共用檔案的資料夾進行複寫。TFS 版本控制沒有同等功能。在升級期間，Visual SourceSafe 專案中的共用檔案是藉由在您用於 TFS 版本控制的伺服器上建立項目的其他獨立複本來進行升級。

TFS 版本控制也沒有任何功能相當於 Visual SourceSafe 中的釘選功能。在升級期間，Visual SourceSafe 專案中的釘選項目會在您用於 TFS 版本控制的伺服器上轉換成加上標籤的項目。如需詳細資訊，請參閱下一章節。

記錄資料的移植方式

Visual SourceSafe 資料庫中項目歷程記錄內的每個事件都會當做變更集傳輸到 Team Foundation Server 上。升級完成之後，您可以在 [記錄] 視窗中檢視此資料。如需詳細資訊，請參閱取得項目的歷程記錄。

資料的某些變更會在升級期間發生。

如何移植有關使用者名稱和時間戳記的資料

當 Visual SourceSafe 資料庫中項目歷程記錄內的每個項目升級至到 Team Foundation Server 上的變更集時，將會發生以下變更：

• 變更集上的時間戳記會設定為升級項目時的日期和時間。

• 原始時間戳記會儲存在變更集的 [註解] 欄位中。

• 使用者名稱會儲存在變更集的 [使用者] 欄位或 [註解] 欄位中 (視使用者對應程序的結果而定)。

  注意事項
  如果您想要使用者名稱如何指派給記錄資料，則必須使用 VssUpgrade。請參閱指定如何升級使用者名稱。

如何轉換特定類型的事件

事件 (例如編輯、重新命名和刪除) 會以直接的方式從您的 Visual SourceSafe 資料庫升級至 Team Foundation Server 上的變更集中。但是，升級工具轉換某些事件的方式可能不是您所預期的方式，如下表所示。

Visual SourceSafe 事件	其升級至 TFS 版本控制的方式
加入檔案或資料夾	此變更集是每個升級檔案及資料夾記錄內的第一個事件。不會針對其所包含之每一個子項目的父代記錄任何事件，與 Visual SourceSafe 不同。
分支	共用是 Visual SourceSafe 中的分支前置條件，但是 TFS 版本控制不支援共用。因此，升級分支的檔案會在目的資料夾中建立檔案的複本。 Visual SourceSafe 資料庫中的共用檔案會升級到 TFS 版本控制，其方式是複製共用檔案時已存在之檔案的版本，並將該複本放在目的資料夾中。之後，每一個變更集都會在這兩個檔案複本中複寫，直到發生分支事件為止。
Label	隱含標籤的項目：在 Visual SourceSafe 中，當您為資料夾加上標籤時，其包含的項目也會隱含地加上標籤。升級程序會明確為 Team 專案中所有升級的項目加上標籤。 明確標記的檔案：Visual SourceSafe 會在您明確標記個別檔案時，建立檔案的新版本。升級程序會將標籤移植到 TFS 版本控制中的適用版本，但不會建立新的版本。 注意事項 如果您的 Visual SourceSafe 資料庫包含許多會套用到許多檔案的標籤，升級程序的作業時間可能會延長。如果您想要排除此資料，就必須使用 VssUpgrade，並將其設定為忽略標籤。請參閱 <Label migrate="false" />。
移動資料夾	移動資料夾事件會在 TFS 版本控制中建立資料夾的新版本。 如果您使用的是 VssUpgrade，它只有在同時升級來源資料夾和目的資料夾時，才會升級已移動之資料夾內的完整項目記錄。請參閱檢閱及解決分析功能找到的問題。 注意事項 如果移動資料夾事件與還原事件結合在一起，則可能不會正確升級記錄資料。
還原	沒有升級任何在還原事件之前產生的記錄資料。
PIN 和 UNPIN	TFS 版本控制不支援釘選功能。升級工具會建立兩個標籤以升級釘選的檔案。 PINNED_LATEST 標籤會套用至固定檔案的固定版本以及未固定檔案的最新版本。而 PINNED 標籤則只會套用至固定檔案的固定版本。升級之後，PINNED_LATEST 標籤會擷取與 Visual SourceSafe 中的 Get Latest 相同的檔案。但是有一個例外，如果在釘選檔案之後發生簽入以外的事件 (例如重新命名或刪除檔案)，則 PINNED_LATEST 標籤可能會傳回不同的檔案。
共用	TFS 版本控制不支援共用功能。Visual SourceSafe 資料庫中的共用檔案會升級到 TFS 版本控制，其方式是複製共用檔案時已存在之檔案的版本，並將該複本放在目的資料夾中。之後，每一個變更集都會在這兩個檔案複本中複寫。
取消刪除檔案或資料夾	在升級檔案或資料夾的取消刪除事件期間，此工具會重新執行事件，以便在 TFS 版本控制中建立檔案和資料夾的新版本。 升級工具會建立變更集，其中包含檔案或資料夾名稱、取消刪除檔案或資料夾的日期與時間以及使用者名稱。

版本控制繫結的移植方式

升級工具會移植每個方案的版本控制繫結。

下一個步驟

Visual SourceSafe 升級準備工作