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

Статья
02/20/2013

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

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

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

destroygloballist: уничтожает глобальный список.
exportgloballist: экспортирует глобальные списки в XML-файл или в окно командной строки.Экспортируется отдельный файл, который содержит все глобальные списки, определенные для коллекции командного проекта.
importgloballist: импортирует глобальные списки из XML-файла.При попытке импорта глобального списка, который уже существует на сервере, будет выдано предупреждение с вопросом, действительно ли следует переопределить глобальный список на сервере.При попытке импорта глобального списка, который еще не существует, команда создает новый глобальный список.
listgloballist: отображает имя каждого глобального списка, определенного на сервере.

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

Для запуска инструмента командной строки 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.

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

Требования

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

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

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

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

Даже если вход в систему выполнен с разрешениями администратора, чтобы выполнить эту функцию на сервере с операционной системой 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 предупредит об опасности перезаписи текущего списка.Можно написать собственную программу для обновления существующего глобального списка или самому обновить глобальный список, используя новые данные.

Чтобы создать новый глобальный список, запустите следующий код и измените его при необходимости.Этот пример определяет глобальный список дисциплин, которые можно назначать задачам.

<?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

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

<FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
     <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

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

Сведения об экспорте и импорте определений типов см. в разделе Настройка типов рабочих элементов и управление ими [witadmin].

Примеры

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

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

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

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

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

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

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

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

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

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

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

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

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

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

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

См. также

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

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

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

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

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

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