Импорт и экспорт категорий [witadmin]

Статья
06/09/2015

Импорт и экспорт категорий, определенными для командного проекта, осуществляется с помощью следующих команд witadmin:

exportcategories: экспортирует XML-определение категорий, заданных на сервере, на котором запущен Team Foundation Server.
importcategories: импортирует XML-файл определения типа рабочего элемента в командный проект на сервере, на котором работает Team Foundation Server.

Если категория с тем же именем уже существует, эта команда перезаписывает существующее определение. Если тип рабочего элемента еще не существует, эта команда создает новую категорию.

Дополнительные сведения о категориях по умолчанию и о способах их использования см. здесь.

Для запуска инструмента командной строки witadmin откройте окно командной строки там, где установлено либо Visual Studio, либо Team Explorer, и введите:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

В 32-разрядной версии Windows замените %programfiles(x86)% на %programfiles%.

Примечание

Создавать и изменять категории позволяет редактор процессов, мощное средство для Visual Studio.Это инструментальное средство не поддерживается.Дополнительные сведения см. на следующей странице веб-сайта Майкрософт: Team Foundation Server Power Tools.

Требования

Для командного проекта, для которого определены категории, необходимо иметь следующий набор разрешений:

Чтобы экспортировать категории типов рабочих элементов, необходимо, чтобы разрешение Просмотр сведений на уровне проекта имело значение Разрешить.
Для импорта категорий типов рабочих элементов необходимо быть членом группы безопасности Администраторы проекта или иметь разрешение Изменить сведения на уровне проекта со значением Разрешить.

witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding] 

witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding]

Параметры

Параметр	Описание
/collection:CollectionURL	Задает универсальный код ресурса (URI) коллекции командных проектов. URI необходимо указать в следующем формате: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции. Если виртуальный каталог не используется, URI имеет следующий формат: http://ИмяСервера:Порт/ИмяКоллекции.
/p:Project	Имя командного проекта, из которого экспортируются категории или в который они импортируются.
/f:ИмяФайла	Путь и имя XML-файла определения, содержащего категории для экспорта или импорта. Если опустить этот параметр при использовании команды exportcategories, команда выводит список категорий в окне командной строки.
/e:Кодировка	Имя формата кодирования .NET Framework 2,0. Указанное кодирование будет использоваться для экспорта или импорта XML-данных. Например, /e:utf-7 задает кодировку Юникод (UTF-7). Если этот параметр не указан, witadmin пытается определить кодировку, а в случае неудачи witadmin использует UTF-8.
/? или help	Отображает справку по команде в окне командной строки.

Заметки

Если при импорте файла категорий они еще не существуют, категории создаются. Если категории уже существуют, команда witadmin importcategories предупредит о перезаписи текущего списка. Можно написать собственную программу для обновления существующего набора категорий или самостоятельно обновить категории, используя новые данные.

Важно!

Изменения, внесенные в категории, могут повлиять на процесс конфигурации.См. раздел Настройка средств планирования Agile для командного проекта.

Сведения о структуре XML-файла категорий см. в разделе Справочник по XML-элементам категорий.

Примеры

Если не указано иначе, во всех примерах применяются следующие значения:

URI-адрес коллекции командных проектов: http://AdventureWorksServer:8080/tfs/DefaultCollection
Имя проекта: AdventureWorks
Имя входного или выходного файла: myCategories.xml
Кодировка по умолчанию: UTF-8

Список категорий

Следующая команда отображает список категорий типов рабочих элементов, определенных для проекта AdventureWorks.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks

Добавление категории в категорию скрытых типов

Категории добавляются в список категорий скрытых типов, чтобы пользователи не могли создавать типы рабочих элементов в этой категории.

Импортируйте файл определения для категорий командного проекта.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

Откройте файл категорий в удобном текстовом редакторе и найдите элемент CATEGORY для "Hidden Types Category".

<CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
   <DEFAULTWORKITEMTYPE name="Code Review Request" />
   <WORKITEMTYPE name="Code Review Response" />
   <WORKITEMTYPE name="Feedback Request" />
   <WORKITEMTYPE name="Feedback Response" />
   <WORKITEMTYPE name="Shared Steps" />
</CATEGORY>

Добавьте элемент WORKITEMTYPE, который задает понятное имя типа добавляемого рабочего элемента.

Например, следующий синтаксис добавляет пользовательский тип рабочего элемента "Сборка интеграции" в категорию "Категория скрытых типов".
```
<CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
   <DEFAULTWORKITEMTYPE name="Code Review Request" />
   <WORKITEMTYPE name="Code Review Response" />
   <WORKITEMTYPE name="Feedback Request" />
   <WORKITEMTYPE name="Feedback Response" />
   <WORKITEMTYPE name="Shared Steps" />
   <WORKITEMTYPE name="Integration Build" />
</CATEGORY>
```

Импортируйте файл определений для категорий в командный проект.

witadmin importcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

См. также

Основные понятия

Настройка средств планирования Agile для командного проекта

Другие ресурсы

Использование категорий для группировки типов рабочих элементов

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