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

Статья
08/11/2011

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

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

Примечание

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

Ниже приведены процедуры, объясняющие, как создать глобальный список с именем Disciplines для типа рабочего элемента "Задача".

Требуемые разрешения

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

Добавление глобального списка в коллекцию командных проектов

В Visual Studio в меню Файл выберите команду Создать, а затем выберите пункт Файл.
В области Категории щелкните Общие.
В области Шаблоны выберите Файл XML, а затем нажмите кнопку Открыть.

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

<?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>

Чтобы сохранить изменения в XML-файле, нажмите кнопку Сохранить на панели инструментов.

Откроется диалоговое окно Сохранить файл как.
В диалоговом окне Сохранение файла в области Сохранить в перейдите в расположение, где нужно сохранить файл. Присвойте файлу имя и нажмите кнопку Сохранить.

Примечание

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

witadmin importgloballist /collection:http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции /f:"Путь к файлу"

Дополнительные сведения см. в разделе Управление глобальными списками для типов рабочих элементов [witadmin].
Отобразите глобальные списки на сервере Team Foundation Server, введя следующую команду в командной строке и нажав клавишу ВВОД.

witadmin exportgloballist /collection:http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции

Обратите внимание, что отображается только что добавленный список.

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

Запустите witadmin exportwitd для экспорта файла Task.xml. Дополнительные сведения см. в разделе Настройка типов рабочих элементов и управление ими [witadmin].
В Visual Studio в меню Файл выберите команду Открыть и выберите пункт Файл.

Откроется диалоговое окно Открытие файла.
В списке Искать в перейдите к папке, в которую был экспортирован файл.

Если изменение типа рабочего элемента производится для настройки шаблона процесса, перейдите в ту папку, куда загружен шаблон процесса.

Примечание

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

Найдите следующий раздел XML-файла, в котором определяется поле Discipline.

<FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String" reportable="dimension">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES expanditems="true">
    <LISTITEM value="Development" />
    <LISTITEM value="Test" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Architecture" />
    <LISTITEM value="Release Management" />
  </ALLOWEDVALUES>
</FIELD>

Удалите список разрешенных значений, удалив XML-код, выделенный в следующем примере.

<FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES expanditems="true">
    <LISTITEM value="Development" />
    <LISTITEM value="Test" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Architecture" />
    <LISTITEM value="Release Management" />
  </ALLOWEDVALUES>
</FIELD>

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

<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>

Чтобы сохранить изменения в XML-файле, нажмите кнопку Сохранить на панели инструментов.
Импортируйте измененную задачу в Team Foundation Server. Дополнительные сведения см. в разделе Настройка типов рабочих элементов и управление ими [witadmin].
В окне Сред. Командный обозреватель среды Visual Studio щелкните Обновить, чтобы загрузить с сервера последние обновления.

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

Задача создается на основе измененного и импортированного вами типа рабочего элемента.
В форме нового рабочего элемента выделите поле Discipline.

Обратите внимание, что разрешенные значения теперь заполняются из глобального списка Disciplines.
Нажмите кнопку Закрыть, чтобы закрыть новую задачу. При выводе предложения сохранить задачу нажмите кнопку Нет.

Добавление значений в поле без редактирования и импорта XML-файла с типом рабочего элемента

Чтобы добавить значения в поле Discipline без редактирования и повторного импорта файла определения типа рабочего элемента, откройте файл disciplines.xml с помощью Visual Studio и добавьте новые значения, выделенные в следующем примере.
```
<GLOBALLIST name="Disciplines">
  <LISTITEM value="Architecture" />
  <LISTITEM value="Requirements" />
  <LISTITEM value="Development" />
  <LISTITEM value="Release Management" />
  <LISTITEM value="Project Management" />
  <LISTITEM value="Test" />
  <LISTITEM value="Marketing and Sales" />
  <LISTITEM value="General Management" />
  <LISTITEM value="Other" />
</GLOBALLIST>
```
Чтобы сохранить изменения в XML-файле, нажмите кнопку Сохранить на панели инструментов.
Откройте окно командной строки Visual Studio.
Импортируйте глобальный список в коллекцию проектов, введя следующую команду в командной строке и нажав клавишу ВВОД.

witadmin importgloballist /collection:http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции /f:"Путь к файлу"
В окне Сред. Командный обозреватель нажмите кнопку Обновить, чтобы загрузить с сервера последние обновления.

Эти обновления содержат только что импортированные вами изменения. Подождите несколько секунд, пока не загрузятся все узлы. узлы, находящиеся в процессе загрузки, помечаются как выполняется.
Создание задачи. Для этого щелкните правой кнопкой мыши узел Рабочие элементы, укажите пункт Добавить рабочий элемент и выберите тип Задача.
Выберите поле Discipline.

Обратите внимание, что теперь новые значения из глобального списка отображаются в качестве вариантов выбора.

Примечание

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

См. также

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

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

Добавление глобального списка в коллекцию командных проектов

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

Добавление значений в поле без редактирования и импорта XML-файла с типом рабочего элемента

См. также

Ссылки

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

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

Дополнительные ресурсы