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

Статья
06/09/2015

Используя глобальные списки в Team Foundation Server (TFS), можно свести к минимуму объем работ по обновлению списка, присутствующего в определения нескольких типов рабочих элементов (WIT). Глобальные списки являются списками выбора, которые можно включить в одно или несколько полей и определений типов рабочих элементов. Глобальный список можно определить в типе рабочих элементов, добавляемом в командный проект, как глобальный список для коллекции командных проектов или в рамках глобального рабочего процесса. Элементы списка могут использоваться разными типами рабочих элементов для коллекции. Для этого необходимо включить элементы списка в один или несколько элементов GLOBALLIST.

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

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

Примечание

В шаблонах процессов по умолчанию, предоставляемых TFS, нет системных или предварительно заданных глобальных списков.

Требования

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

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

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

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

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

Структура синтаксиса

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

Элемент	Синтаксис	Описание
GLOBALLIST	`<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>`	Определяет набор элементов LISTITEM, хранимых для коллекции, которые могут использовать все командные проекты в этой коллекции. globalListName— текстовая строка длиной от 1 до 255 символов. GLOBALLIST— это обязательный дочерний элемент элемента GLOBALLISTS и необязательный дочерний элемент элементов ALLOWEDVALUES, SUGGESTEDVALUES и PROHIBITEDVALUES. Для получения дополнительной информации см. Определение списков выбора.
LISTITEM	`<LISTITEM value="Name" />`	Определяет допустимое значение списка. Примечание Глобальные списки не должны включать группы, область действия которых ограничивается проектом, поскольку они не относятся к проекту. LISTITEM— это обязательный дочерний элемент элемента GLOBALLIST и необязательный дочерний элемент элементов ALLOWEDVALUES, SUGGESTEDVALUES и PROHIBITEDVALUES.

Элемент

Синтаксис

Описание

GLOBALLIST

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

Вопросы и ответы

Вопрос. Существуют ли автоматически заполняемые глобальные списки?

О. Да. Глобальный список с именем **Builds —**ИмяКомандногоПроекта пополняется при каждом выполнении сборки. Со временем список может стать очень большим. Рекомендуется периодически удалять неиспользуемые сборки из списка.

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

См. также

Ссылки

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

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

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

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