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

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

  • Статья

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

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

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

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

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

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

cd %programfiles(x86)%\Microsoft Visual Studio 14.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:FileName

Путь и имя XML-файла определения, содержащего категории для экспорта или импорта. Если опустить этот параметр при использовании команды exportcategories, команда выводит список категорий в окне командной строки.

/e:Encoding

Имя формата кодирования .NET Framework 2.0. Указанное кодирование будет использоваться для экспорта или импорта XML-данных. Например, /e:utf-7 задает кодировку Юникод (UTF-7). Если этот параметр не указан, witadmin пытается определить кодировку, а в случае неудачи witadmin использует UTF-8.

/? или help

Отображает справку по команде в окне командной строки.

Заметки

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

Важно!

Изменения, внесенные в категории, могут повлиять на процесс конфигурации.См. раздел Configure and customize Agile tools for a team project.

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

Примеры

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

  • URI-адрес коллекции командных проектов: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Имя проекта: AdventureWorks

  • Имя входного или выходного файла: myCategories.xml

  • Кодировка по умолчанию: UTF-8

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

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

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

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

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

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

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

  2. Откройте файл категорий в удобном текстовом редакторе и найдите элемент 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>

  3. Добавьте элемент 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>

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

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

См. также

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

Configure and customize Agile tools for a team project

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

Use categories to group work item types