Практическое руководство. Использование глобального списка

Статья
11/05/2008

Обновлен: Ноябрь 2007

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

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

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

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

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

Использование команд Team Foundation в командной строке

Нажмите кнопку Пуск, последовательно выберите пункты Все программы, Microsoft Visual Studio 2008, Средства Visual Studio, а затем — Командная строка Visual Studio 2008.

В качестве альтернативы можно запустить командный файл vsvars32, находящийся в каталоге установки Visual Studio; обычно это БукваДиска:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools.

Примечание.
Для использования командной строки Visual Studio 2008 необходимо, чтобы была установлена среда Visual Studio 2008.

Добавление глобального списка на 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, у вас может не быть прав доступа к определенным папкам. При попытке сохранения глобального списка в папке, для доступа к которой у вас отсутствуют права, технология виртуализации реестра автоматически перенаправит файл и сохранит его в виртуальном хранилище. Дополнительные сведения см. в разделах https://go.microsoft.com/fwlink/?LinkId=92325 и https://go.microsoft.com/fwlink/?LinkId=92323 (на английском языке). Во избежание перенаправления файл можно сохранить в расположении, для которого имеются права доступа.

Если компьютер работает под управлением Windows Vista, у вас может не быть прав доступа к определенным папкам. При попытке сохранения глобального списка в папке, для доступа к которой у вас отсутствуют права, технология виртуализации реестра автоматически перенаправит файл и сохранит его в виртуальном хранилище. Дополнительные сведения см. в разделах https://go.microsoft.com/fwlink/?LinkId=92325 и https://go.microsoft.com/fwlink/?LinkId=92323 (на английском языке). Во избежание перенаправления файл можно сохранить в расположении, для которого имеются права доступа.

Откройте окно командной строки Visual Studio 2008.

Импортируйте глобальный список на сервер Team Foundation Server, введя следующую команду и нажав клавишу ВВОД.

glimport /f "Путь к файлу" /t "Имя сервера Team Foundation Server"

Примечание.
Поскольку глобальный список оказывает общее воздействие на Team Foundation Server, при выполнении команды glimport не нужно указывать командный проект. Дополнительные сведения см. в разделе glimport.

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

glexport /t "<Имя сервера Team Foundation Server>"

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

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

Запустите witexport для экспорта файла Task.xml. Дополнительные сведения см. в разделе Практическое руководство. Экспортирование типа рабочего элемента из существующего проекта.
В Visual Studio в меню Файл выберите команду Открыть и выберите пункт Файл.

Откроется диалоговое окно Открытие файла.

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

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

Примечание.
Если компьютер работает под управлением Windows Vista, у пользователя могут отсутствовать права доступа к определенным папкам. При попытке экспорта типа рабочего элемента в папку, для доступа к которой у пользователя отсутствуют права, технология виртуализации реестра автоматически перенаправит экспортируемый файл и сохранит его в виртуальном хранилище. Дополнительные сведения см. в разделах https://go.microsoft.com/fwlink/?LinkId=92325 и https://go.microsoft.com/fwlink/?LinkId=92323. Во избежание перенаправления файл можно экспортировать в расположение, для которого имеются права доступа.

Если компьютер работает под управлением Windows Vista, у пользователя могут отсутствовать права доступа к определенным папкам. При попытке экспорта типа рабочего элемента в папку, для доступа к которой у пользователя отсутствуют права, технология виртуализации реестра автоматически перенаправит экспортируемый файл и сохранит его в виртуальном хранилище. Дополнительные сведения см. в разделах https://go.microsoft.com/fwlink/?LinkId=92325 и https://go.microsoft.com/fwlink/?LinkId=92323. Во избежание перенаправления файл можно экспортировать в расположение, для которого имеются права доступа.

Выберите 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. Дополнительные сведения см. в разделе Практическое руководство: импорт типа рабочего элемента в существующий проект.
В окне Сред. Командный обозреватель среды 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.
Импортируйте глобальный список на сервер Team Foundation Server, введя следующую команду в командной строке и нажав клавишу ВВОД.

glimport /f "Путь к файлу" /t "Имя сервера Team Foundation Server"
В окне Сред. Командный обозреватель в Visual Studio, щелкните Обновить, чтобы загрузить с сервера последние обновления.

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

Выберите поле Discipline.

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

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

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

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

См. также

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

Практическое руководство. Использование глобального списка

Использование команд Team Foundation в командной строке

Добавление глобального списка на Team Foundation Server

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

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

См. также

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

Ссылки

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

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