Добавление поля в тип рабочего элемента или удаление поля из этого поля

Чтобы добавить или удалить тип рабочего элемента, необходимо изменить файл определения типа рабочего элемента. Необходимо удалить элементы FIELD из раздела FIELDS, а также макет и элементы управления, определенные в разделе FORM. Сразу после изменения типа рабочего элемента можно импортировать XML-файл и начать использование обновленного типа рабочего элемента.

Важно!

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

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

• Экспорт и открытие файла определения типа рабочего элемента

• Добавление поля

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

• Импорт файла определения типа рабочего элемента

• Проверка отображения изменений в форме рабочего элемента

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

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

Экспорт и открытие файла определения типа рабочего элемента

Экспорт и открытие файла определения типа рабочего элемента

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

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

  1. Выполните witadmin exportwitd для повторного экспорта XML-файла для типа рабочего элемента, который необходимо изменить. Введите следующую команду, заменив свои данные указанными аргументами:

     witadmin exportwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
     

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

  2. В Visual Studio в меню Файл выберите команду Открыть, а затем выберите пункт Файл.

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

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

  При изменении типа рабочего элемента для настройки шаблона процесса:

  1. Найдите папку, в которую был загружен шаблон процесса.

  2. Выберите XML-файл типа рабочего элемента, который нужно обновить, и нажмите кнопку Открыть. При выводе запроса об окончаниях строк нажмите кнопку Нет.

Добавление поля

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

1. Найдите следующий раздел XML-файла:

   <FIELDS>
   

2. Создайте новое поле строки, введя фрагмент XML, выделенный в следующем примере.

   <FIELDS>
   <FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="Dimension">
   </FIELD>
   

   Примечание

   Ссылочное имя, или refname, является программным именем данного поля.Все прочие правила должны ссылаться на это значение refname.Дополнительные сведения см. в разделе Соглашения об именовании объектов отслеживания рабочих элементов.

3. Найдите следующий раздел XML-файла, в котором описывается форма рабочего элемента.

   <FORM>
   

4. Найдите следующие строки в разделе <FORM>.

   <Group Label="Classification">
     <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>
   

5. Вставьте новый элемент управления для отображения поля, добавив следующий код XML, выделенный в следующем примере:

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

6. В меню Файл щелкните Сохранить <имя файла >.xml, чтобы сохранить изменения в XML-файле.

7. Инструкции о импорту нового типа рабочего элемента в единый проект см. в разделе Импорт файла определения типа рабочего элемента. Чтобы добавить тип рабочего элемента в шаблон процесса, см. раздел Добавление определений типов рабочих элементов в шаблон процесса.

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

Удаление поля из формы рабочего элемента

1. Найдите и удалите информацию об определении поля, которое необходимо удалить из типа рабочего элемента. В следующем примере показано поле с именем Issue Level. Для удаления этого поля необходимо удалить следующий раздел поля:

   Примечание

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

   <FIELDS>
   . . .
   <FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="dimension">
   <HELPTEXT>Describes the issue level 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>
   …
   </FIELDS>
   

2. Найдите раздел <Layout>, в котором определен элемент управления для поля рабочего элемента, и удалите соответствующие разделы, чтобы удалить поле. Выделенные ниже разделы являются примерами того, что необходимо найти.

   <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.IssueLevel" Label="IssueLevel" LabelPosition="Left" />
         </Column>
       </Group>
     </Column>
   </Group>
   

3. В меню Файл выберите команду Сохранить <имя_файла> чтобы сохранить изменения в XML-файле.

Импорт файла определения типа рабочего элемента

Импорт файла определения типа рабочего элемента

• Выполните witadmin importwitd для импорта XML-файла для измененного типа рабочего элемента. Введите следующую команду, заменив свои данные указанными аргументами:

  witadmin importwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
  

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

Проверка отображения изменений в форме рабочего элемента

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

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

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

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

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

3. Убедитесь, что изменения отображаются в форме рабочего элемента.

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

См. также

Ссылки

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

Элемент FIELD (определение)

Справка по XML-элементу Control

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

Работа с полями рабочих элементов

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

Определение полей рабочих элементов