Управление полями рабочих элементов [witadmin]

Статья
08/11/2011

Управление полями типов рабочих элементов, определенными для коллекции командных проектов, осуществляется с помощью следующих команд witadmin:

deletefield: удаляет указанное поле.
listfields: список атрибутов для всех полей или указанного поля.
indexfield: включает или отключает индексирование для указанного поля. Когда индексирование для поля включено, повышается производительность поиска рабочих элементов, если такое поле присутствует в запросе. При добавлении настраиваемого поля, используемого во множестве запросов поиска рабочих элементов, для этого поля можно включить индексирование.
changefield: изменяет один или несколько атрибутов поля, таких как понятное имя поля, атрибутов для отчетности хранилищ данных или возможность синхронизации поля, содержащего имена частных лиц. При включенной синхронизации поле обновляется по мере обновления Active Directory или рабочей группы. Сведения об использовании полей для составления отчетов см. в разделе Работа с полями рабочих элементов.

Важно!

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

Программа командной строки witadmin расположена в каталоге Диск:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE на клиентском компьютере, на котором работает Сред. Командный обозреватель.

Дополнительные сведения о полях см. в разделе Определение полей рабочих элементов.

Примечание

Можно создавать и изменять поля рабочих элементов, используя редактор процесса, автоматический инструмент для Visual Studio.Это средство не поддерживается.Дополнительные сведения см. на следующей странице веб-сайта Майкрософт: Team Foundation Server Power Tools April 2010.

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

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

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

Дополнительные сведения см. в разделах Разрешения Team Foundation Server и Группы по умолчанию, права и роли в Team Foundation Server.

Примечание

Даже если вход в систему выполнен с разрешениями администратора, чтобы выполнить эту функцию на сервере с операционной системой Windows Server 2008, необходимо открыть окно командной строки с повышенными привилегиями.Чтобы открыть окно командной строки с повышенными привилегиями, нажмите кнопку Пуск, щелкните правой кнопкой мыши пункт Командная строка и выберите команду Запуск от имени администратора.Дополнительные сведения см. на веб-сайте корпорации Майкрософт: User Access Control.

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

witadmin indexfield /collection:CollectionURL /n:Name /index:on|off 

witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]

Параметры

Параметр	Описание
/collection:CollectionURL	Задает универсальный код ресурса (URI) коллекции командных проектов. URI имеет следующий формат: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции Если виртуальный каталог не используется, URI имеет следующий формат: http://имя_сервера:порт/имя_коллекции
/n:RefName /n:Name	Ссылочное имя поля типа рабочего элемента.
/index	Указывает включить или отключить индексирование для указанного поля. Укажите on, чтобы включить индексацию, или off, чтобы отключить индексацию.
/name:NewName	Задает новое имя для поля.
/syncnamechanges	Указывает использовать поле рабочего элемента для хранения имен, которые нужно обновлять по мере внесения изменений в Active Directory или в рабочую группу. Этот параметр допустим только в том случае, когда для typename указано поле с типом данных String. Укажите значение true для включения синхронизации поля данных, а для отключения укажите значение false.
/reportingname:ReportingName	Задает имя поля в хранилище данных, которое будет использоваться для создания отчетов.
/reportingrefname:ReportingRefName	Задает имя ссылки поля в хранилище данных, которое будет использоваться для создания отчетов.
/reportingtype:Type	Указывает, как это поле используется в хранилище для отчетности. Допустимы следующие значения. dimension: используется для полей типа Integer, String или DateTime. detail: используется для полей типа Integer, Double, String или DateTime. measure: используется для полей типа Integer и Double. Тип статистической обработки по умолчанию — сумма. Используя параметр formula, можно указать другой тип статистической обработки. disable: используется, чтобы отключить у поля возможность сообщения данных. Дополнительные сведения см. в разделе Работа с полями рабочих элементов.
/reportingformula:Formula	Задает формулу агрегата, которая будет использоваться при сообщении, что поле является measure. Единственная поддерживаемая формула — sum.
/unused	Содержит перечень всех полей, которые не используются никаким командным проектом, заданным в коллекции командных проектов.
/noprompt	Отключает запрос подтверждения.
/? or help	Отображает справку по команде в окне командной строки.

Заметки

При назначении атрибута syncnamechanges для строкового поля оно всегда принимает допустимые имена пользователей. Однако поле не разрешает имена групп, которые хранятся в Team Foundation Server или в Active Directory, хотя бы одно из следующих условий является истинным (true):

Правило VALIDUSER задается для всех типов рабочих элементов
Правило VALIDUSER задается для типа рабочего элемента
Правило ALLOWEDVALUES указывается для типа рабочего элемента, и это правило имеет условие фильтра, которое исключает группы

Дополнительные сведения см. в разделе Справка по всем XML-элементам FIELD.

Сводку по индексированным системным полям см. в разделе Использование системных полей и полей, определенных шаблонами процессов MSF.

Примеры

Если не указано иначе, во всех примерах применяются следующие значения:

URI коллекции командного проекта: http://AdventureWorksServer:8080/AWTeam/Collection1
Имя поля рабочего элемента: AdventureWorks.Field
Кодировка по умолчанию: UTF-8

Список полей

Следующая команда отображает сведения о каждом поле, определенном для Collection1 на сервере AdventureWorksServer:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Следующая команда выводит содержимое указанного поля AdventureWorks.Field, используемого в Collection1:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

Следующая команда отображает все поля, которые не используют Collection1:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /unused

Переименование поля

Следующая команда изменяет понятное имя ссылочного поля AdventureWorks.Field на NewFieldName для Collection1:

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /name:NewFieldName

Изменение отчета как значения для поля

Следующая команда задает в качестве типа возможности создания отчетов для поля типа DateTime AdventureWorks.CreatedOn значение dimension. Данные этого поля передаются в хранилище и базу данных служб аналитики, поэтому они могут использоваться для фильтрации отчетов.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.CreatedOn /reportingtype:dimension

Следующая команда задает в качестве типа возможности создания отчетов для поля типа Double AdventureWorks.Field значение measure. Все показатели проходят статистическую обработку путем суммирования.

witadmin reportfield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /reportingtype:measure

Включение синхронизации настраиваемого поля имени

Следующая команда включает синхронизацию для поля рабочего элемента AW.CustomerName, определенного для Collection1 на AdventureWorksServer.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.CustomerName /syncnamechanges:true

Удаление поля

Следующая команда удаляет поле AdventureWorks.Field из коллекции Collection1:

witadmin deletefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

См. также

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