VSS 转换器设置文件示例

项目
08/18/2008

更新：2007 年 11 月

VSS 转换器设置文件是一个 XML 文件，在该文件中提供分析或迁移的配置。本主题的后面部分将描述该设置文件的各个节，后跟一个您可用以创建自己的设置文件的分析和迁移设置文件示例。

设置文件的节

基于 XML 的 VSS 转换器设置文件包含几个节，这些节指定在分析 Visual SourceSafe 数据库以进行迁移或迁移到 Team Foundation 时必须提供的配置。本主题将对这些节进行详细介绍。

<ConverterSpecificSetting>

<ConverterSpecificSetting> XML 节包含有关您要迁移的 Visual SourceSafe 数据库的设置信息。转换器将使用该信息进行迁移。

<VSSDatabase> 元素中的 name 设置具有包含 srcsafe.ini 文件的文件夹的路径。
<UserMap> 元素中的 name 设置包含用户映射文件。有关更多信息，请参见如何：编辑源代码管理迁移用户映射文件。

在 <ProjectMap> 节下的 <Project> 元素中指定以下内容：

分析或迁移的 Visual SourceSafe 文件夹
对于迁移，是指在 Team Foundation 版本控制中要迁移到的文件夹。

可以添加多个 <Project> 元素以分析或迁移多个 Visual SourceSafe 文件夹。

说明：
迁移期间转换器使用 SQL Express。如果 SQL Express 的 4GB 限制导致迁移失败，则可以通过将以下行添加到 <Source name="VSS"> 节来将转换器设置为改用 SQL Server：<SQL Server="SQL_Server_name"></SQL>。

<Settings>

在 <Settings> 节下，在 <Output> 元素的 file 设置中，可以指定分析或迁移报告的文件名和位置。如果不指定文件名，转换器将在分析期间生成使用名称 VSSAnalysisReport.xml 的文件，在迁移期间生成使用名称 VSSMigrationReport.xml 的文件。

XML 编码

<?xml encoding> 标记必须与用于保存 settings.xml 文件的编码相匹配。例如，如果文件以 Unicode 保存，则 <?xml encoding> 标记应是：

<?xml version="1.0" encoding="unicode">

而不是：

<?xml version="1.0" encoding="utf-8">.

分析的设置文件格式

设置文件包含 Visual SourceSafe 转换器必须具有的信息，用以分析要迁移的 Visual SourceSafe 数据库。可以复制本主题后面部分中显示的 XML 并对它进行编辑，以创建您自己的设置文件。

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

说明：
如果缺少前面各节中的任何一个，您会收到 XML 验证错误。

迁移的设置文件格式

设置文件包含 Visual SourceSafe 转换器必须具有的信息，用以将 Visual SourceSafe 数据库迁移到 Team Foundation 版本控制。可以复制本主题后面部分中显示的 XML 并对它进行编辑，以创建您自己的设置文件；或使用本主题前面部分中的过程来更改您为分析所创建的设置文件。

<?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
<ConverterSpecificSetting>
     <Source name="VSS">
          <VSSDatabase name="c:\VSSDatabase"></VSSDatabase>
          <UserMap name="c:\Migrate\Usermap.xml"></UserMap>
     </Source>
     <ProjectMap>
          <Project Source="$/FolderA" Destination="$/TeamProjectA"></Project>
          <Project Source="$/FolderB" Destination ="$/TeamProjectB/ProjectB"></Project>
     </ProjectMap>
</ConverterSpecificSetting>
<Settings>
     <TeamFoundationServer name="My_TFS_Server" port="8080" protocol="http"></TeamFoundationServer>
     <Output file="Migration.xml"></Output>
</Settings>
</SourceControlConverter>

说明：
如果项目源是 $/FolderA 并且目标是 $/TeamProjectB/ProjectB，则在 Team Foundation 版本控制中 Visual SourceSafe 项目 $/FolderA/ProjectA 是 $/TeamProjectB/ProjectB/ProjectA，而不是 $/TeamProjectB/ProjectB/FolderA/ProjectA。

请参见

任务

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

通过