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

Пошаговое руководство. Администрирование полей в типе рабочего элемента

  • Статья

Обновлен: Ноябрь 2007

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

Ниже перечислены процедуры, описанные в этом разделе.

  • Просмотр полей.   В этой процедуре осуществляется вывод полей типа рабочего элемента и их просмотр.

  • Переименование полей.   В этой процедуре изменяется имя поля и просматриваются изменения, возникающие в форме.

  • Удаление полей.   В этой процедуре удаляется поле, добавленное в форму рабочего элемента в предыдущей процедуре.

Обязательные компоненты

Выполните действия, описанные в разделах Пошаговое руководство. Основная настройка типа рабочего элемента и Пошаговое руководство. Расширенная настройка типа рабочего элемента.

Если можно подключиться к серверу Team Foundation Server и для этого имеются соответствующие разрешения, то администрирование полей в типах рабочих элементов можно выполнять из командной строки, пакетного фала или файла сценария. Для этого необходимо воспользоваться служебной программой Командная строка Visual Studio 2008 или задать несколько переменных среды в текущей командной строке с помощью vsvars32, как описано в следующем примере. Дополнительные сведения о присоединении к командному проекту см. в разделе Пошаговое руководство. Присоединение к командному проекту.

Включение команд Team Foundation в командной строке

  • Нажмите кнопку Пуск, последовательно выберите Все программы, Microsoft Visual Studio 2008, Набор средств Visual Studio и щелкните пункт Командная строка Visual Studio 2008.

В качестве альтернативы можно запустить командный файл vsvars32, которых находится в каталоге установки Visual Studio; обычно это буква_диска:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools.

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

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

Просмотр полей

Просмотр полей

  1. Откройте командную строку Visual Studio.

  2. Выведите все поля, определенные на сервере Team Foundation Server, в текстовый файл. Для этого введите в командной строке указанную ниже команду и нажмите клавишу ВВОД.

  3. witfields view /s:"Имя сервера Team Foundation Server"

    В результате, на экране отображается список полей и приводятся указанные ниже сведения.

    Field:

    Имя ссылки поля.

    Name:

    Понятное имя поля.

    Type:

    Тип данных поля.

    Reportable As:

    Параметры отчетов по полю.

    Use:

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

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

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

  1. В командной строке Visual Studio введите следующую команду, после чего нажмите клавишу ВВОД.

    witfields rename /s:"Имя сервера Team Foundation Server" Microsoft.VSTS.Common.Rank Importance

    В результате выполнения этой команды имя поля Ранг изменяется на Важность.

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

    Field renamed.

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

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

  4. Правой кнопкой мыши щелкните узел Рабочие элементы и выберите команду Добавить запрос, чтобы создать новый запрос.

  5. Чтобы добавить новую строку, щелкните область Добавить предложение. Затем выделите пустую ячейку Поле. В ячейке введите Ранг. Обратите внимание на следующее сообщение, которое появляется над списком результатов. Это сообщение указывает, что поле "Ранг" не удалось найти.

    Чтобы просмотреть результаты запроса, следует его выполнить. TF51005: Запрос ссылается на поле, которое не существует. Причина ошибки: <<Ранг>>.

  6. Удалите значение "Ранг" из ячейки Поле и введите в ячейку значение Важность.

  7. В ячейке Оператор выберите <> и введите 1 в ячейку Значение.

  8. В меню Группа щелкните команду Выполнить запрос.

  9. Щелкните правой кнопкой мыши любую строку результатов и выберите пункт Параметры столбца. Прокрутите вниз список Доступные столбцы. Обратите внимание, что поле Ранг теперь отсутствует в списке, а поле Важность присутствует.

  10. Выберите значение Важность в поле Доступные столбцы, а затем нажмите кнопку добавления выбранных столбцов (>). Нажмите кнопку ОК.

    Обратите внимание, что в понятном имени Microsoft.VSTS.Common.Rank значение "Ранг" изменилось на "Важность" и в построителе запросов, и в списке результатов.

  11. Нажмите кнопку Закрыть, чтобы закрыть запрос. При выводе предложения сохранить запрос нажмите кнопку Нет.

  12. Создайте новый рабочий элемент типа "Special Task". Для этого щелкните правой кнопкой мыши узел Рабочие элементы, выберите Добавить рабочий элемент, а затем щелкните SpecialTask.

    Этот рабочий элемент создается на основе измененного и импортированного типа рабочего элемента.

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

    ms195028.alert_note(ru-ru,VS.90).gifПримечание.

    Дополнительные сведения о настройке подписей полей в формах рабочих элементов см. в процедуре "Настройка подписи поля" в разделе Пошаговое руководство. Расширенная настройка типа рабочего элемента.

  14. Нажмите кнопку Закрыть, чтобы закрыть новый элемент "Special Task". При выводе запроса на сохранение рабочего элемента нажмите кнопку Нет.

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

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

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

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

    witfields delete /s:"Имя сервера Team Foundation Server" MyCompany.MyProcess.Category

    В полученном сообщении об ошибке указывается, что поле не может быть удалено, поскольку оно начало использоваться командным проектом.

  2. Введите следующую команду и нажмите клавишу ВВОД.

    witexport /f "Путь к файлу\specialtask.xml" /t "Имя сервера Team Foundation Server" /p WITLab /n "Special Task"

    При этом выполняется повторный экспорт в XML-файл определения типа рабочего элемента Special Task с сервера Team Foundation Server, на котором содержится новое определение поля Microsoft.VSTS.Common.Rank, использующего новое понятное имя после его переименования в процедуре Переименование полей.

    ms195028.alert_note(ru-ru,VS.90).gifПримечание.

    Если компьютер работает под управлением Windows Vista, у пользователя могут отсутствовать права доступа к определенным папкам. При попытке экспорта типа рабочего элемента в папку, для доступа к которой у пользователя отсутствуют права, технология виртуализации реестра автоматически перенаправит экспортируемый файл и сохранит его в виртуальном хранилище. Дополнительные сведения см. в статьях https://go.microsoft.com/fwlink/?LinkId=92325 и https://go.microsoft.com/fwlink/?LinkId=92323. Во избежание перенаправления файл можно экспортировать в расположение, для которого имеются права доступа.

    По завершении операции экспорта отображается следующее сообщение:

    Work item type export complete.

  3. В меню Файл среды Visual Studio выберите команду Открыть и щелкните Файл.

    Откроется диалоговое окно Открытие файла.

    ms195028.alert_note(ru-ru,VS.90).gifПримечание.

    Если файл SpecialTask.xml уже открыт, может быть получено сообщение с запросом на перезагрузку файла в среде Visual Studio. Нажмите кнопку Да, чтобы перезагрузить файл.

  4. В списке Поиск в перейдите к папке, в которую был экспортирован файл.

  5. Щелкните файл specialtask.xml и нажмите кнопку Открыть.

  6. При выводе запроса о завершениях строк нажмите кнопку Нет.

  7. Найдите и удалите определение поля "Категория", показанное в следующем коде XML:

    <FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String" reportable="dimension"><HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT>  <WHEN field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">    <ALLOWEDVALUES>      <LISTITEM value="Planning" />      <LISTITEM value="Review" />    </ALLOWEDVALUES>  </WHEN>  <WHENNOT field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">    <ALLOWEDVALUES>      <LISTITEM value="Process Management" />      <LISTITEM value="Planning" />      <LISTITEM value="Execution" />      <LISTITEM value="Review" />    </ALLOWEDVALUES>  </WHENNOT></FIELD>

  8. В разделе <Layout> найдите показанный ниже код XML и удалите выделенные разделы, чтобы удалить поле.

    <Group Label="Classification">
  <Column PercentWidth="50">    <Group>
      <Column PercentWidth="100">
        <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
        <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
      </Column>
    </Group>  </Column>  <Column PercentWidth="50">    <Group>      <Column PercentWidth="100">        <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" />      </Column>    </Group>  </Column>
</Group>

  9. Нажмите кнопку Сохранить для сохранения изменений в XML-файле.

  10. Импортируйте измененный тип рабочего элемента "Special Task" на сервер Team Foundation Server. Для этого в командной строке Visual Studio введите следующую команду, после чего нажмите клавишу ВВОД.

    witimport /f "Путь к файлу\specialtask.xml" /t "Имя сервера Team Foundation Server" /p WITLab

    Выполняется импорт типа рабочего элемента "specialtask" на сервер Team Foundation Server. По завершении операции импорта отображается следующее сообщение:

    Work item type import complete.

  11. Убедитесь, что поле "Категория" больше не используется каким-либо типом рабочего элемента. Для этого введите в командной строке указанную ниже команду и нажмите клавишу ВВОД.

    witfields view /s:"Имя сервера Team Foundation Server" MyCompany.MyProcess.Category

    Средство witfields показывает, что поле "Категория" больше не используется.

    Field: MyCompany.MyProcess.Category

    Name: Category

    Type: String

    Reportable As: dimension

    Use: Not In Use

  12. Теперь, когда поле "Категория" больше не используется типами рабочих элементов, окончательно удалите это поле с сервера Team Foundation Server. Для этого введите в командной строке указанный ниже текст и нажмите клавишу ВВОД. При выводе запроса на подтверждение введите y.

    witfields delete /s:"Имя сервера Team Foundation Server" MyCompany.MyProcess.Category

См. также

Задачи

Пошаговое руководство. Основная настройка типа рабочего элемента

Пошаговое руководство. Расширенная настройка типа рабочего элемента

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

Настройка типов рабочих элементов