Переименование поля типа рабочего элемента

Статья
08/11/2011

Используя средство командной строки witadmin changefield, можно изменить понятное имя поля рабочего элемента в соответствии с требованиями соглашения о наименовании, которое используется в команде. Обратите внимание, что новое имя применяется ко всем типам рабочего элемента, которые ссылаются на измененное поле во всех командных проектах в коллекции проектов. Понятное имя отображается при определении условия отбора в запросе рабочего элемента. Имя, которое отображается на форме рабочего элемента, может отличаться от понятного имени, которое задано для поля.

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

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

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

В этом разделе

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

Переименование понятного имени поля рабочего элемента

Выполнение переименования поля рабочего элемента

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

cd ..Диск:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE
Чтобы переименовать поле рабочего элемента, введите следующую команду и нажмите клавишу ВВОД.
```
witadmin changefield /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /n:typename /name:newname
```
Примеры.
```
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"
```
В этом примере осуществляется изменение имени поля Microsoft.VSTS.Common.Rank на Important Rank.
В командной строке введите y, а затем нажмите клавишу ВВОД. Дождитесь получения следующего сообщения:

Field renamed.

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

Проверьте в командном обозревателе внесенные изменения

Проверка изменений, импортированных в отдельный проект

В Сред. Командный обозреватель щелкните правой кнопки мыши узел командного проекта, который содержит тип рабочего элемента с переименованным полем, затем выберите пункт Обновить.

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

Чтобы просмотреть результаты запроса, следует его выполнить. TF51005: Запрос ссылается на поле, которое не существует. Причина ошибки: <<Ранг>>.
Удалите значение "Ранг" из ячейки Поле и введите в ячейку значение "Ранг важности".
Выберите <> в ячейке Оператор и введите "1" в ячейку Значение.
На панели инструментов Запрос нажмите кнопку Выполнить.
Щелкните правой кнопкой мыши любую строку результатов и выберите пункт Параметры столбца. Прокрутите вниз список Доступные столбцы. Обратите внимание, что поле Ранг теперь отсутствует, но присутствует поле Ранг важности.
Выберите значение Ранг важности в поле Доступные столбцы, а затем нажмите кнопку добавления выбранных столбцов (>). Нажмите кнопку ОК.

Обратите внимание, что в понятном имени Microsoft.VSTS.Common.Rank значение "Ранг" изменилось на "Ранг важности" и в построителе запросов, и в списке результатов.
Нажмите кнопку Закрыть, чтобы закрыть запрос. При выводе предложения сохранить запрос нажмите кнопку Нет.
Создайте новый рабочий элемент типа "Задача". Для этого щелкните правой кнопкой мыши узел Рабочие элементы, укажите пункт Добавить рабочий элемент и выберите тип Задача.

Этот рабочий элемент создается на основе измененного и импортированного вами типа рабочего элемента.
Обратите внимание, что в поле Состояние подпись переименованного поля (Ранг) не изменилась. Дело в том, что подписи полей в формах рабочих элементов зависят от родительского командного проекта и не зависят от имени поля, только что измененного на сервере.

Примечание

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