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

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

  • Статья

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

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

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

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

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

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

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

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

cd %programfiles%\Microsoft Visual Studio 12.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

См. также

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

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

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

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

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