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

Управление глобальными списками для типов рабочих элементов [witadmin]

  • Статья

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

Глобальный список можно определить в своем собственном файле определения, в файле определения для типа рабочего элемента или в глобальном рабочем процессе. При использовании определения глобального списка управлять глобальными списками, определенными для коллекции, можно с помощью следующих команд в программе командной строки witadmin:

  • destroygloballist: уничтожает глобальный список.

  • exportgloballist: экспортирует глобальные списки в XML-файл или в окно командной строки.

  • importgloballist: импортирует глобальные списки из XML-файла. При попытке импорта глобального списка, который уже существует на сервере, будет выдано предупреждение с вопросом, действительно ли следует переопределить глобальный список на сервере. При попытке импорта глобального списка, который еще не существует, команда создает новый глобальный список.

  • listgloballist: отображает имя каждого глобального списка, определенного на сервере.

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

Программа командной строки witadmin, находящуюся в папке диск:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE на компьютере, на котором выполняется Сред. Командный обозреватель. На 64-разрядных компьютерах программа расположена в папке диск:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

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

Примечание

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

Необходимые разрешения

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

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

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

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

Примечание

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

witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]

witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding] 

witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]

witadmin listgloballist /collection:CollectionURL

Параметры

Параметр

Описание

/collection:CollectionURL

Задает универсальный код ресурса (URI) коллекции командных проектов. URI имеет следующий формат: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции

Если виртуальный каталог не используется, URI имеет следующий формат:

http://ИмяСервера:Порт/ИмяКоллекции.

/n:GlobalListName

Имя глобального списка для удаления.

/f:FileName

Путь и имя XML-файла определения глобального списка для экспорта или импорта.

ПримечаниеПримечание
Если на клиентском компьютере работает Windows Vista, то возможно пользователь не имеет разрешений на доступ к определенным папкам.При попытке экспорта глобального списка в расположение, для доступа к которому у пользователя отсутствуют разрешения, технология виртуализации реестра автоматически перенаправит экспортируемый файл и сохранит его в виртуальном хранилище.Дополнительные сведения см. на страницах Виртуализация реестра (страница может быть на английском языке) и Типовые проблемы виртуализации файлов и реестра в Windows Vista (страница может быть на английском языке) веб-сайта корпорации Майкрософт.Во избежание перенаправления файл можно экспортировать в расположение, для которого имеются права доступа.

/e:Encoding

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

/noprompt

Отключает запрос подтверждения.

/? либо help

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

Заметки

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

Примеры

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

  • URI коллекции командного проекта: http://AdventureWorksServer:8080/AWTeam/Collection1

  • Номер порта веб-сайта сервера: 8080

Отображение имен глобальных списков

В следующем примере показаны глобальные списки, определенные на сервере. В примере осуществляется экспорт глобального списка с использованием кодировки UTF-8:

witadmin listgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Экспорт определения глобальных списков

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

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml

В следующем примере выполняется экспорт тех же глобальных списков на тот же сервер, но используется кодировка Юникод (UTF-7):

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml /e:utf-7

Импорт определения глобальных списков

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

witadmin importgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml

В следующем примере выполняется импорт тех же глобальных списков на тот же сервер, но используется кодировка Юникод (UTF-7):

witadmin importgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml /e utf-7

См. также

Задачи

Добавление, использование глобальных списков и управление ими

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

Определение глобальных списков

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

Настройка глобального рабочего процесса

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

Журнал изменений

Дата

Журнал

Причина

Январь 2011

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

Улучшение информации.