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

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

  • Статья

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

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

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

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

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

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

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

ПримечаниеПримечание

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

Требования

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

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

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

Дополнительные сведения см. в разделах Разрешения Team Foundation Server и Группы по умолчанию, права и роли в Team Foundation Server.

ПримечаниеПримечание

Даже если вход в систему выполнен с разрешениями администратора, чтобы выполнить эту функцию на сервере с операционной системой Windows Server 2008, необходимо открыть окно командной строки с повышенными привилегиями.Чтобы открыть окно командной строки с повышенными привилегиями, выберите Пуск, откройте контекстное меню пункта Командная строка и выберите команду Запуск от имени администратора.Дополнительные сведения см. на следующей странице веб-сайта Майкрософт: Контроль учетных записей.

 
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:кодирование

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

/? или help

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

Заметки

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

Важное примечаниеВажно

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

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

Примеры

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

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

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

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

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

Dd273721.collapse_all(ru-ru,VS.110).gifСписок категорий типов рабочих элементов

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

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

Dd273721.collapse_all(ru-ru,VS.110).gifЭкспорт категорий типов рабочих элементов

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

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

Dd273721.collapse_all(ru-ru,VS.110).gifИмпорт категорий типов рабочих элементов

В следующем примере производится импорт категорий из XML-файла myCategories в проект AdventureWorks.

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

См. также

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

Настройка страниц невыполненной работы и доски с помощью конфигурации процессов

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

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

Ссылка на элемент "Категории типов рабочих элементов"

witAdmin. Настройка объектов для отслеживания рабочих элементов и управление этими объектами