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

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

  • Статья

С помощью глобальных списков в team foundation server ( Team Foundation Server ), можно свернуть работы, необходимой для обновления списка, общая папка различных типов рабочих элементов.Глобальные списки представляют собой списки выбора, которые можно включать в одно или более полей и типов рабочих элементов.Глобальный список можно определить в типе рабочего элемента, добавляемые в командный проект, в качестве глобального списка коллекции командных проектов или в глобальном рабочем процессе.В коллекции элементы списка можно совместно использовать со множеством типов рабочих элементов, включив элементы списка в один или несколько элементов GLOBALLIST.

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

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

ПримечаниеПримечание

Нет системных или предварительно определенных глобальных списков глобальных списков в шаблонах процессов по умолчанию, которые предоставляет team foundation server.

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

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

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

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

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

ПримечаниеПримечание

Для добавления или изменения глобального списка можно использовать программу командной строки witadmin, чтобы импортировать и экспортировать определение глобальных списков.Дополнительные сведения см. в разделе Управление глобальными списками для типов рабочих элементов [witadmin].Для использования глобальных списков добавьте его в определение FIELD в типе рабочего элемента.Дополнительные сведения см. в разделе Справка по всем XML-элементам FIELD.

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

Глобальный список — это набор элементов 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]

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

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

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

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

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