通过

如何：为源代码管理分析和迁移创建设置文件

  • 项目

更新：2007 年 11 月

可以创建一个设置文件来控制如何分析源代码管理数据以及如何将这些数据迁移到 Team Foundation。您可以创建一个设置文件来分析迁移过程，首先找出迁移过程中可能发生的任何问题，然后修改该设置文件来实际执行迁移过程。

创建设置文件之前，您必须执行以下操作：

  • 标识 Visual SourceSafe 中要迁移的文件夹。

  • 对于迁移过程，标识要将 Visual SourceSafe 文件夹迁移到何处：Team Foundation 版本控制中的空文件夹或者转换器可在其中创建文件夹的目标文件夹。如果迁移到的文件夹位于 Team Foundation 版本控制中的根文件夹 ($/) 下，则转换器不会创建目标文件夹。

  • 若要将 Visual SourceSafe 用户映射为 Team Foundation Server 用户，请使用分析期间生成的用户映射文件。有关更多信息，请参见 如何：编辑源代码管理迁移用户映射文件。

运行分析时使用的设置文件格式与用于迁移的设置文件格式稍有不同。下面的部分说明了其中的不同之处。

创建用于分析的设置文件

  1. 使用任意编辑器（例如“记事本”）来创建一个 XML 文件。

  2. 复制VSS 转换器设置文件示例中“分析的设置文件格式”一节的内容。

  3. 在 <VSSDatabase> 节中，指定要对其运行分析的 Visual SourceSafe 数据库的位置。

  4. 可选步骤，在 <UserMap> 节中指定用户映射文件的名称和位置。如果不提供文件名，则转换器将在当前文件夹中生成名为 UserMap.xml 的文件。

  5. 在 <ProjectMap> 节中，指定要分析的 Visual SourceSafe 文件夹。

  6. 在 <Settings> 节下的 <Output> 节中，可以指定分析报告的文件名和位置。如果不指定文件名，则转换器将生成名为 VSSAnalysisReport.xml 的文件。

  7. 将设置文件另存为 XML 文件（即具有 .xml 文件扩展名）。

创建用于迁移的设置文件

  1. 复制您为该分析创建的设置文件，并以新名称保存。有关参考信息，请参见 VSS 转换器设置文件示例 中的揝ettings File Format for Migration

  2. 按下面的步骤更改迁移设置文件。

    • 在 <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>

    • 可选步骤，在 <Settings> 节下的 <Output> 节中，指定分析报告的文件名和位置。如果不提供文件名，则转换器将生成名为 VSSMigrationReport.xml 的文件。

      说明：

      在迁移过程中，转换器使用 SQLExpress 来存储某些元数据。这种元数据通常只占迁移数据中的很小一部分。

      在极少数情况下，迁移会因为 SQLExpress 的 4GB 限制而失败，在这种情况下，可在设置文件的 <Source name="VSS"> 节中添加以下行，将转换器设置为 SQLServer：<SQL Server="SQL_Server_name"></SQL>。例如：

      <Source name="VSS">
   <VSSDatabase name="c:\VSSDatabase"></VSSDatabase>
   <SQL Server="MySQLServer"></SQL>
</Source>

  3. 将设置文件另存为 XML 文件（即具有 .xml 文件扩展名）。

请参见

任务

演练：准备从 Visual SourceSafe 迁移到 Team Foundation

演练：从 Visual SourceSafe 迁移到 Team Foundation

如何：创建团队项目

如何：向版本控制添加项目或解决方案

概念

VSS 转换器设置文件示例

用于源代码管理迁移的 VSSConverter 命令行实用工具