HOW TO：建立原始檔控制分析和移轉的設定檔

更新：2007 年 11 月

建立設定檔，以控制原始檔控制資料的分析方法或移轉至 Team Foundation 的方法。建立設定檔以分析移轉過程，首先辨認可能在移轉期間發生的問題，然後修改該設定檔以實際執行移轉。

建立設定檔之前，您必須先：

辨認 Visual SourceSafe 中您要移轉的資料夾。
針對移轉，辨認您要移轉 Visual SourceSafe 資料夾的位置：空資料夾或轉換器可在 Team Foundation 版本控制中建立資料夾的目的資料夾。如果資料夾在 Team Foundation 版本控制中是根資料夾 ($/)，則轉換器不會建立目的資料夾。
若要將 Visual SourceSafe 使用者對應至 Team Foundation Server 使用者，請使用分析期間所產生的使用者對應檔。如需詳細資訊，請參閱 HOW TO：編輯原始檔控制移轉使用者對應檔。

執行分析時的設定檔格式會和用於移轉的設定檔格式有些微不同。下列各節會強調這些不同點。

使用任何編輯器 (例如 [記事本]) 建立 XML 檔案。
將範例 VSS 轉換器設定檔中＜用於分析的設定檔格式＞這一節中的文字複製到 XML 檔案。
在 <VSSDatabase> 區段中，指定正在執行分析的 Visual SourceSafe 資料庫位置。
此外，您也可以在 <UserMap> 區段中指定使用者對應檔的名稱和位置。如果沒有提供檔案名稱，轉換器會在目前的資料夾中產生名稱為 UserMap.xml 的檔案。
在 <ProjectMap> 區段中，指定要分析的 Visual SourceSafe 資料夾。
在 <Settings> 區段下的 <Output> 區段中，可以指定分析報告的檔案名稱和位置。如果沒有指定檔案名稱，轉換器會產生名稱為 VSSAnalysisReport.xml 的檔案。
將設定檔另存為 XML 檔 (副檔名為 .xml)。

依下列步驟變更移轉設定檔。

在 <ProjectMap> 區段中，針對正在移轉的每個 Visual SourceSafe 資料夾，在 Team Foundation 版本控制中加入目的資料夾。使用下列格式以加入 Destination 區段：

<Project Source="$/FolderA" Destination="$/TeamProjectA"></Project>

注意事項：
如果專案來源為 $/FolderA，而目的端為 $/TeamProjectB/ProjectB，則 Visual SourceSafe 專案 $/FolderA/ProjectA 會在 Team Foundation 版本控制中變成 $/TeamProjectB/ProjectB/ProjectA，而非 $/TeamProjectB/ProjectB/FolderA/ProjectA。

在 <Settings> 區段下加入 <TeamFoundationServer> 區段，並指定要移轉至之 Team Foundation Server 的名稱、通訊埠和通訊協定。請使用下列格式：

<TeamFoundationServer name="TFS_server_name" port="port_number" protocol="http"></TeamFoundationServer>

例如：

<TeamFoundationServer name="My_TFS_server" port="8080" protocol="http"></TeamFoundationServer>

注意事項：
轉換器會在移轉期間使用 SQLExpress，以存放部分中繼資料 (Metadata)。這個中繼資料在移轉期間，通常只佔用極小的資料百分比。