Пример файла параметров преобразователя VSS

Статья
11/05/2008

Обновлен: Ноябрь 2007

Файл параметров преобразователя VSS — это XML-файл, задающий конфигурацию анализа или миграции. Разделы файла параметров описаны ниже в данном разделе справки. Также предоставлен пример файла параметров анализа и миграции, который можно использовать для создания собственного файла параметров.

Разделы файла параметров

XML-файл параметров преобразователя VSS содержит несколько обязательных разделов, определяющих конфигурацию процедуры анализа базы данных Visual SourceSafe перед миграцией или самой миграции в среду Team Foundation. Эти разделы описаны более подробно далее в этом разделе справки.

<ConverterSpecificSetting>

Раздел кода XML <ConverterSpecificSetting> содержит сведения о базе данных Visual SourceSafe, миграцию которой требуется произвести. Эти сведения используются преобразователем для выполнения миграции.

Параметр name элемента <VSSDatabase> содержит путь к папке, содержащей файл srcsafe.ini.
Параметр name в элементе <UserMap> содержит имя файла сопоставления пользователей. Дополнительные сведения см. в разделе Практическое руководство. Редактирование файла сопоставления пользователей для миграции системы управления версиями.

Задайте в элементе <Project> раздела <ProjectMap> следующее:

Папка Visual SourceSafe для анализа или миграции
Для процесса миграции: папка, в которую выполняется миграция в средство Team Foundation (подсистема контроля версий).

Можно добавлять множество элементов <Project> для анализа или миграции множества папок Visual SourceSafe.

Примечание.
Преобразователь использует SQL Express во время миграции. Если миграция завершится неудачно из-за 4-гигабайтного ограничения SQL Express, можно указать преобразователю использовать вместо этой системы SQL Server, добавив следующую строку в раздел <Source name="VSS">: <SQL Server="SQL_Server_name"></SQL>

Преобразователь использует SQL Express во время миграции. Если миграция завершится неудачно из-за 4-гигабайтного ограничения SQL Express, можно указать преобразователю использовать вместо этой системы SQL Server, добавив следующую строку в раздел <Source name="VSS">: <SQL Server="SQL_Server_name"></SQL>

<Settings>

В разделе <Settings> в параметре file элемента <Output> можно задать имя файла и расположение отчета об анализе или миграции. Если имя файла не задано, преобразователь генерирует файл VSSAnalysisReport.xml во время анализа и VSSMigrationReport.xml во время миграции.

Кодирование XML

Тег <?xml encoding> должен совпадать с кодированием, используемым для сохранения файла settings.xml. Например, если файл сохранен в кодировании Юникод, то тег <?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, то проект Visual SourceSafe$/FolderA/ProjectA в Team Foundation (подсистема контроля версий) будет расположен в папке $/TeamProjectB/ProjectB/ProjectA, а не $/TeamProjectB/ProjectB/FolderA/ProjectA.

Если исходный код проекта находится в папке $/FolderA, а папка назначения —$/TeamProjectB/ProjectB, то проект Visual SourceSafe$/FolderA/ProjectA в Team Foundation (подсистема контроля версий) будет расположен в папке $/TeamProjectB/ProjectB/ProjectA, а не $/TeamProjectB/ProjectB/FolderA/ProjectA.

См. также

Задачи

Практическое руководство. Создание файла параметров для анализа и миграции системы управления версиями

Поделиться через