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

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

  • Статья

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

Примечание

Прежде чем можно будет определить глобальный проект, соответствующий компонент необходимо включить на сервере уровня приложений.Поэтому на сервере должна быть запущена версия Visual Studio Team Foundation Server, поддерживающая этот компонент, например Team Foundation Server 2010 с пакетом обновления 1 (SP1).Пакет обновления можно загрузить на следующей странице веб-сайта Майкрософт: Service Pack 1 of Visual Studio Team Foundation Server 2010, Beta.Дополнительные сведения см. в разделе Настройка глобального рабочего процесса.

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

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

Примечание

В шаблонах процессов Microsoft Solutions Framework (MSF) нет системных или предварительно определенных глобальных списков.

Содержание раздела

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

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

  • Структура синтаксиса глобальных списков, добавляемых в определение типа рабочих элементов или в глобальный рабочий процесс

  • Синтаксическая структура глобальных списков коллекции

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

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

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

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

  • коллекции командных проектов. Глобальные списки, определенные для коллекции командных проектов, можно экспортировать, изменять, удалять и импортировать. Эти глобальные списки доступны во всех командных проектах коллекции;

  • определение типа рабочего элемента. В определение типа рабочего элемента можно добавить глобальные списки, которые должны быть доступны для этого типа;

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

К началу

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

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

Элемент

Синтаксис

Описание

GLOBALIST

 
<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

Определяет набор элементов LISTITEM, который сохранен для коллекции и может использоваться во всех командных проектах коллекции.

globalListName. Текстовая строка длиной от 1 до 255 знаков.

GLOBALLIST является обязательным дочерним элементом элемента GLOBALLISTS и необязательным дочерним элементом элементов ALLOWEDVALUES, SUGGESTEDVALUES и PROHIBITEDVALUES. Дополнительные сведения см. в разделе Определение списков выбора.

LISTITEM

 
<LISTITEM value="Name" />

Определяет допустимое значение элемента списка.

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

LISTITEM является обязательным дочерним элементом элемента GLOBALLIST и необязательным дочерним элементом элементов ALLOWEDVALUES, SUGGESTEDVALUES и PROHIBITEDVALUES.

К началу

Структура синтаксиса глобальных списков, добавляемых в определение типа рабочих элементов или в глобальный рабочий процесс

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

<GLOBALLISTS>
    <GLOBALLIST name="name of global list">
        <LISTITEM value="List item 1" />
        <LISTITEM value="List item 2" />
        <LISTITEM value="List item 3" />
        <LISTITEM value="List item 4" />
        . . .
        <LISTITEM value="List item n" />
    </GLOBALLIST>
</GLOBALLISTS>

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

<GLOBALLISTS>
   <GLOBALLIST name=" name of global list 1" />
   <GLOBALLIST name=" name of global list 2" />
   . . .
   <GLOBALLIST name=" name of global list n" />
</GLOBALLISTS>

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

К началу

Структура синтаксиса глобальных списков коллекции проектов

Чтобы добавить в коллекцию проектов глобальный список, можно импортировать следующий синтаксис с помощью команды witadmin importgloballist:

<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">
    <GLOBALLIST name="NameOfGlobalList">
        <LISTITEM value="ListItem1" />
        <LISTITEM value="ListItem2" />
        <LISTITEM value="ListItem3" />
        <LISTITEM value="ListItem4" />
        . . .
        <LISTITEM value="ListItemN" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

Глобальный список не может быть пустым. Каждый элемент GLOBALLIST должен иметь по крайней мере один определенный элемент LISTITEM.

К началу

См. также

Задачи

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

Ссылки

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

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

Настройка данных отслеживания, форм, рабочего процесса и других объектов для проекта

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

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

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

Журнал изменений

Дата

Журнал

Причина

Январь 2011

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

Улучшение информации.