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

Manage global lists for work item types [witadmin]

  • Статья

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

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

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

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

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

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

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

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

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE

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

Примечание

Создавать и изменять глобальные списки можно с помощью редактора процессов — эффективного средства для Visual Studio.Дополнительные сведения см. на странице Средства Team Foundation Server.

Требования

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

  • Чтобы экспортировать или перечислить глобальные списки, нужно быть членом группы Допустимые пользователи коллекции проектов или иметь разрешение Просмотр информации на уровне коллекции со значением Разрешить.

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

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

Сведения см. в разделе Справочник по разрешениям Team Foundation Server.

Примечание

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

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

См. также

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

Define global lists

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

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

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