Настройка типов связей и управление ими

Статья
02/20/2013

Как и типы рабочих элементов, можно определить и изменить пользовательские типы ссылок.Однако нельзя сделать никаких изменений в типах связей, определенных системой.Перед добавлением нового типа связи в коллекцию командных проектов просмотрите типы связей, доступные для использования разработчиком.Дополнительные сведения см. в разделе Связывание рабочих элементов с объектами для обеспечения возможности трассировки.

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

deactivatelinktype: деактивирует указанный тип связи.Пользователи больше не смогут создавать связи данного типа.Существующие ссылки этого типа будут и далее работать нормально.
deletelinktype: окончательно удаляет указанный тип связи из базы данных.Также удаляются все ссылки, определенные с помощью этого типа связи.
exportlinktype: экспортирует определения типов связей.Экспортировать можно определение одного типа связи или всех типов связей, определенных для сервера.
importlinktype: импортирует определения типов связей из XML-файла.Если тип ссылки с таким же справочным именем уже существует, он будет обновлен таким образом, чтобы соответствовать импортированному типу ссылки.Если тип ссылки еще не существует, будет создан новый тип ссылки.
listlinktypes: приводит доступный набор типов связей на сервере.
reactivatelinktype: повторно активирует указанный тип связи и при необходимости назначает новое имя.

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

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

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

Требования

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

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

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

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

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

witadmin deactivatelinktype /collection:CollectionURL /n:LinkName

witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]

witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding] 

witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]

witadmin listlinktypes /collection:CollectionURL

witadmin reactivatelinktype /collection:CollectionURL /n:LinkName

Параметры

Параметр	Описание
/collection:CollectionURL	Задает универсальный код ресурса (URI) коллекции командных проектов.URI имеет следующий формат: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции Например: http: //ИмяСервера:8080/tfs/Collection0 Если виртуальный каталог не используется, то универсальный код ресурса (URI) имеет следующий формат: http://имя_сервера:порт/имя_коллекции
/n:LinkName	Имя или имя ссылки типа связи для отключения или удаления.
/f:FileName	XML-файл типов связей.Требуется для импорта, необязательно для экспорта.Если опустить этот параметр, то на экране появляется выходной результат команды.
/e:encoding	Имя формата кодирования .NET Framework 2.0.Указанное кодирование будет использоваться для экспорта или импорта XML-данных.Например, /e:utf-7 задает кодировку Юникод (UTF-7).Если этот параметр не указан, то witadmin пытается определить кодировку и в случае сбоя обнаружения witadmin использует UTF-8.
/v	Проверяет тип связи XML без ее импорта.
/noprompt	Отключает запрос подтверждения.
/? или help	Отображает справку по команде в окне командной строки.

Заметки

Структуру схемы определения типов связей см. в разделе Справочник по элементу "Тип ссылки".

Сведения о том, как можно ограничить типы ссылочных отношений, которые могут создавать члены команды, см. в разделах Связывание рабочих элементов, а также элементы управления и ограничения связей и Элементы LinksControlOptions.

Примеры

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

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

Список типов связей

Следующая команда отображает пользовательские типы связей, определенные для AdventureWorksServer Team Foundation.

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Список определений типов связей

В следующем примере отображается определение типа связи в окне командной строки:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Деактивация и повторная активация типа связи

В следующих примерах выполняется деактивация типа связи mylinktype, а затем повторная его активация.

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype

Экспорт определения типа связи.

Следующая команда экспортирует определение всех типов связей в файл mylinktype.xml:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Импорт определения типов связей

В следующем примере производится импорт определения типов связей, заданных в XML-файле:

witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

См. также

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

Справочник по элементу "Тип ссылки"

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

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

Связывание рабочих элементов с объектами для обеспечения возможности трассировки

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

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