Share via

Обновление настраиваемого шаблона процесса для доступа к новым компонентам

  • Статья

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

  • Вариант А. Добавьте компоненты в свой настроенный шаблон процесса, а затем запустите мастер настройки компонентов

    Выполните следующие действия: Шаг 1, Шаг 2, Шаг 4 и Шаг 5

    Выберите этот параметр после внесения расширенных настроек в свой шаблон процесса.

  • Вариант Б. Примените требуемые настройки к самому новому шаблону процесса, а затем запустите мастер настройки компонентов

    Выполните следующие действия: Шаг 1, Шаг 3, Шаг 4 и Шаг 5.

    Выберите этот параметр после внесения незначительных настроек в свой шаблон процесса.

  • Вариант В. Вручную обновите командный проект, чтобы добавить компоненты

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

  • Вариант Г: программное обновление нескольких командных проектов. Сначала выберите вариант А или вариант Б, чтобы обновить настраиваемый шаблон процесса. После этого выполните пакетное обновление всех командных проектов, определенных для коллекции командных проектов, используя следующие сведения и ресурсы: How to Configure Features for dozens of team projects и Features4tfs CodePlex solution.

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

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

1.Загрузка самого нового шаблона процесса

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

  1. При обновлении шаблона процесса, основанного на версии, более ранней, чем MSF 6.0 или Visual Studio Scrum 2.0, сначала примените обновления, перечисленные в версии этого раздела для Visual Studio 2012.

    Сведения о версии можно найти в файле ProcessTemplate.xml.

  2. Если вы еще не обновили сервер уровня приложения до версии TFS, содержащей требуемые вам компоненты, сделайте это сейчас. Скачайте файл и Обновление Team Foundation Server.

  3. Если не являетесь членом группы «Администраторы коллекции проектов», станьте им. Для загрузки шаблонов процессов и управления ими требуется разрешение Управление шаблоном процесса со значением «Разрешить».

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

    См. раздел Загрузите последнюю версию шаблонов процессов.

    Для загрузки или отправки шаблонов процессов необходимо подключиться к TFS 2013 из Visual Studio 2013 или из Team Explorer 2013.

  5. Скопируйте шаблон процесса в новую папку для последующего применения требуемых настроек (вариант Б) либо скопируйте определения XML, чтобы добавить новые компоненты в существующий шаблон процесса (вариант В).

2.Добавление компонентов в настроенный шаблон проекта (вариант А)

Шаг 2   Обновите настроенный шаблон процесса, добавив следующие типы рабочих элементов:

Скопируйте или добавьте файлы из папки загруженной последней версии шаблона процесса в соответствующую папку, содержащую настроенные определения шаблонов процессов.

Добавление поддержки невыполненной работы компонентов и портфеля (требуется TFS 2013)

  1. Скопируйте файл Feature.xml из папки WorkItem Tracking/TypeDefinitions в соответствующую папку настроенного шаблона процесса.

  2. Добавьте Feature Category в файл Categories, расположенный в папке WorkItem Tracking.

    <CATEGORY name="Feature Category" refname="Microsoft.FeatureCategory">
    <DEFAULTWORKITEMTYPE name="Feature" />
  </CATEGORY>

  3. Откройте файл подключаемого модуля WorkItems, расположенный в папке WorkItem Tracking.

    1. Добавьте задачу для передачи типа рабочего элемента «компонент» в раздел <WORKITEMTYPES>.

      <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Feature.xml" />

    2. Замените две задачи конфигурации процессов в элементе PROCESSCONFIGURATION…

      <PROCESSCONFIGURATION>
   <CommonConfiguration fileName="WorkItem Tracking\Process\CommonConfiguration.xml"/>
   <AgileConfiguration fileName="WorkItem Tracking\Process\AgileConfiguration.xml"/>
</PROCESSCONFIGURATION>

      .. одноэлементным оператором, ссылающимся на файл ProcessConfiguration.

      <PROCESSCONFIGURATION>
   <ProjectConfiguration fileName="WorkItem Tracking\Process\ProcessConfiguration.xml"/>
</PROCESSCONFIGURATION>

  4. Скопируйте файл ProcessConfiguration из папки WorkItem Tracking/Process загруженного шаблона процесса в папку настроенного шаблона в том же расположении.

    Все изменения, внесенные в файлы AgileConfiguration или CommonConfiguration, необходимо включить в ProcessConfiguration. Дополнительные сведения см. в Справочнике по XML-элементам конфигурации процесса.

  5. Удалите файлы AgileConfiguration и CommonConfiguration из папки WorkItem Tracking/Process.

    Теперь конфигурация процессов поддерживается одним файлом ProcessConfiguration.

  6. Замените файлы Backlog/Stories/Requirement Overview.rdl и Stories/Requirements Progress.rdl в папке Reports внутри папки настроенного шаблона файлами загруженного шаблона процесса в том же расположении.

    Эти обновления отражают изменения, необходимые в связи с появлением типа рабочего элемента «компонент» для невыполненной работы портфеля, которые рассмотрены в следующей статье: Update your Overview and Progress reports to support the Portfolio backlogs.

  7. Замените папку Process Guidance, расположенную в папке Windows SharePoint Services, содержимым последней папки.

    Эти файлы предоставляют прямые ссылки на последнее содержимое руководства по процессам.

Добавление поддержки общих параметров (требуется TFS 2013.2)

  1. Скопируйте файл SharedParameter.xml из папки WorkItem Tracking/TypeDefinitions в соответствующую папку настроенного шаблона процесса.

  2. Добавьте Shared Parameter Category в файл Categories, расположенный в папке WorkItem Tracking.

    <CATEGORY name="Shared Parameter Category" refname="Microsoft.SharedParameterCategory">
    <DEFAULTWORKITEMTYPE name="Shared Parameter" />
  </CATEGORY>

  3. Добавьте Shared Parameter в Hidden Types Categories.

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Request" />
    <WORKITEMTYPE name="Code Review Response" />
    <WORKITEMTYPE name="Feedback Request" />
    <WORKITEMTYPE name="Feedback Response" />
    <WORKITEMTYPE name="Shared Steps" />
    <WORKITEMTYPE name="Shared Parameter" />  </CATEGORY>

  4. Откройте файл подключаемого модуля WorkItems, расположенный в папке WorkItem Tracking.

  5. Добавьте задачу для отправки типа рабочего элемента «Общий параметр» в раздел <WORKITEMTYPES>.

    <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedParameter.xml" />

Добавление плана тестирования и типов рабочих элементов наборов тестов (требуется TFS 2013.3)

При обновлении сервера уровня приложений до версии TFS 2013.3 мастер обновления TFS автоматически обновляет существующие командные проекты для поддержки объектов отслеживания рабочих элементов плана тестирования и наборов тестов.

Изменения вносятся только в командный проект, все существующие настроенные шаблоны процессов не затрагиваются. Тем не менее, их можно обновить вручную. Одной из причин для обновления является поддержка будущих обновлений TFS, которые требуют использования мастера настройки компонентов, или если вы планируете создать командные проекты с настроенными шаблонами процессов на обновленном сервере. Необходимо вручную добавить эти объекты в настроенные шаблоны процессов.

  1. Скопируйте файлы TestPlan.xml и TestSuite.xml из папки WorkItem Tracking/TypeDefinitions в соответствующую папку настроенного шаблона процесса.

  2. Добавьте Test Plan Category и Test Suite Category в файл Categories, расположенный в папке WorkItem Tracking.

    <CATEGORY name="Test Plan Category" refname="Microsoft.TestPlanCategory">
    <DEFAULTWORKITEMTYPE name="Test Plan" />
  </CATEGORY>
  <CATEGORY name="Test Suite Category" refname="Microsoft.TestSuiteCategory">
    <DEFAULTWORKITEMTYPE name="Test Suite" />
  </CATEGORY>

  3. Добавьте Test Plan Category и Test Suite Categoryв Hidden Types Categories.

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Request" />
    <WORKITEMTYPE name="Code Review Response" />
    <WORKITEMTYPE name="Feedback Request" />
    <WORKITEMTYPE name="Feedback Response" />
    <WORKITEMTYPE name="Shared Steps" />
    <WORKITEMTYPE name="Shared Parameter" />
    <WORKITEMTYPE name="Test Plan" />
    <WORKITEMTYPE name="Test Suite" />
  </CATEGORY>

  4. Откройте файл подключаемого модуля WorkItems, расположенный в папке WorkItem Tracking.

  5. Добавьте задание для загрузки плана тестирования и типов рабочих элементов наборов тестов (WIT) в раздел <WORKITEMTYPES>.

    <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestPlan.xml" />
<WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestSuite.xml" />

3.Применение настроек к шаблону процесса (вариант Б)

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

  1. Примените настройки, заданные для новой папки шаблона процесса:

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

    • Добавьте пользовательские типы рабочих элементов в папку отслеживания рабочих элементов и при необходимости обновите файл определения WorkItems. См. раздел Добавление определений типов рабочих элементов в шаблон процесса.

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

    • Примените настройки к файлу определений Categories.

    • Примените настройки к файлу определений ProcessConfiguration. Убедитесь, что требуемые типы рабочих элементов представлены в правильных категориях, а все состояния рабочего процесса сопоставлены с метасостояниями.

    • Скопируйте дополнительные файлы настроенных шаблонов процессов в соответствующую папку шаблонов процессов. Полный список файлов шаблонов процессов и сведения об их настройке см. в разделе Общие сведения о файлах шаблонов процессов.

  2. Проверьте изменения по данному контрольному списку, чтобы убедиться, что применены все требуемые настройки:

    Настройка

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

    Обновление или проверка определений конфигурации процесса

    Добавление объекта WIT в категорию требований

    (Объект WIT может относиться только к категории требований или категории задач, но не обеим одновременно).

    Включить следующие поля:

    • Значение поля, назначенное для type=Order в файле конфигурации процесса (приоритет журнала невыполненных работ в Scrum, ранг стека в Agile или CMMI)

    • Значение поля, назначенное для type=Effort в файле конфигурации процесса (трудозатраты (Scrum), баллы истории (Agile) или размер (CMMI))

    • Путь к области или значение поля, назначенное для type=Team в файле конфигурации процесса.

    • Все поля в разделе AddPanel файла конфигурации процесса (поля должны быть определены в разделе FIELDS, но не должны водить в раздел FORM.

    Для хранения необходимых сопоставлений метасостояний в разделе RequirementBacklog:

    • Сопоставьте начальные состояния каждого WIT в категории требований с type="Proposed"

    • Сопоставьте каждое промежуточное состояние рабочего процесса, которое нужно отобразить на доске Канбан type="InProgress"

    • Сопоставьте окончание каждого состояния рабочего процесса type="Complete"

      У вас может быть несколько состояний, сопоставляемых с type="Complete"

    Чтобы задать запись для определения цветовых кодов, связанных с типами рабочих элементов (WIT). Например:

    <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />

    Изменение рабочего процесса типов рабочих элементов (WIT) в категории требований

    Н/Д

    Чтобы хранить необходимые сопоставления метасостояний, как описано выше, для добавления типов рабочих элементов (WIT) в категорию требований.

    Добавление объекта WIT в категорию задач

    Включить следующие поля:

    • Значение поля, назначенное для type=Order в файле конфигурации процесса (приоритет журнала невыполненных работ в Scrum, ранг стека в Agile или CMMI)

    • Значение поля, назначенное для type=Activity в файле конфигурации процесса (действие (Scrum или Agile) или дисциплина (CMMI))

    • Путь области или значение поля, присвоенного type=Team в файле конфигурации процесса

    • Значение поля, назначенное для type=RemainingWork в файле конфигурации процесса (Оставшаяся работа)

    • (необязательно) Исходная работа и Завершенная работа (только Agile и CMMI)

    Для хранения необходимых сопоставлений метасостояний в разделе TaskBacklog:

    • Сопоставьте начальные состояния каждого WIT в категории задач с type="Proposed"

    • Сопоставьте каждое промежуточное состояние рабочего процесса, которое нужно отобразить на доске задач type="InProgress"

    • Сопоставьте окончание каждого состояния рабочего процесса type="Complete"

      У вас может быть несколько состояний, сопоставляемых с type="Complete"

    Чтобы задать запись для определения цветовых кодов, связанных с типами рабочих элементов (WIT). Например:

    <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />

    Измените рабочий процесс типов рабочих элементов (WIT) в категории задач

    Н/Д

    Чтобы задать необходимые сопоставления метасостояний, как описано выше, для добавления типов рабочих элементов (WIT) в категорию задач.

    Добавьте WIT в категорию ошибок или измените рабочий процесс для WIT в категории ошибок (только Agile и CMMI) (см. примечание «а»)

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

    • Значение поля, назначенное для type=Order в файле конфигурации процесса (приоритет журнала невыполненных работ в Scrum, ранг стека в Agile или CMMI)

    • Значение поля, назначенное для type=Effort в файле конфигурации процесса (трудозатраты (Scrum), баллы истории (Agile) или размер (CMMI))

    Для хранения необходимых сопоставлений метасостояний в разделе BugWorkItems:

    • Сопоставьте начальные состояния каждого WIT в категории ошибок с type="Proposed"

    • Сопоставьте каждое промежуточное состояние рабочего процесса, которое должно отображаться на доске канбана или в разделе «Моя работа» с type="InProgress"

    • Сопоставьте окончание каждого состояния рабочего процесса type="Complete"

      У вас может быть несколько состояний, сопоставляемых с type="Complete"

    Дополнительные сведения см. в разделе Поддержка обновления статусов ошибок с использованием страницы «Моя работа».

    Удаление типа рабочих элементов (WIT) из категории требований или категории задач

    Н/Д

    Чтобы удалить любые сопоставления метасостояний, которые связаны только с этим типом рабочего элемента

    Удаление WIT

    Удаление WIT из файла категорий

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

    Переименование объекта WIT

    Обновление файла категорий новыми именами

    Обновление файла конфигурации процесса новыми именами

    Примечания.

    1. Если вы обновили версию до TFS 2013.4, см. раздел Добавление ошибок в невыполненную работу или на доску задач. В TFS 2013.4 добавлен параметр, позволяющий каждой команде просматривать ошибки в своем журнале невыполненных работ и на доске канбана. Эта функция ссылается на сопоставления метасостояний, сделанные в разделе BugWorkItems.

4.Переименование и отправка шаблона процесса в TFS

Шаг 4   Чтобы мастер настройки компонентов выбрал самую новую версию шаблона процесса, следует обновить оператор version, чтобы обеспечить отличие версии обновленного шаблона процесса от предыдущих версий.

  1. Откройте файл подключаемого модуля ProcessTemplate, расположенный в верхней папке.

    1. Обновите имя, чтобы отразить внесенные изменения версии. Например:

      <name>MyCompany Custom Scrum 2013.3  </name>

    2. Обновите фрагмент кода после элемента description. Увеличьте дополнительный номер версии, чтобы указать на внесение обновлений в имеющийся шаблон процесса и обеспечить его отличие от шаблона процесса TFS по умолчанию.

      Выбор фрагмента кода зависит от того, какая категория шаблонов обновляется:

      Категория

      Оператор версии

      Agile

      		 
      <version type="ADCC42AB-9882-485E-A3ED-7678F01F66BC" major="7" minor="20"/>

      CMMI

      		 
      <version type="27450541-8E31-4150-9947-DC59F998FC01" major="7" minor="10"/>

      Scrum

      		 
      <version type="6B724908-EF14-45CF-84F8-768B5384DA45" major="3" minor="10"/>

  2. Отправьте шаблон процесса на.

    Чтобы проверить внесенные изменения, создайте тестовый проект. См. раздел Создание командного проекта.

5.Запуск мастера настройки компонентов

Шаг 5Когда вы убедитесь, что шаблон процесса поддерживает ваши изменения, запустите мастер настройки компонентов, чтобы обновить имеющиеся командные проекты. См. раздел Настройка компонентов после обновления TFS.

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

Вопрос. Какие типы изменений не позволяют мастеру настройки компонентов обновить командный проект?

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

  • Переименованные или перемещенные типы WIT, которые относятся к категории требований или категории задач.

  • Переименованные состояния или пользовательские состояния рабочего процесса, определенные для типов рабочих элементов (WIT), которые относятся к категории требований или категории задач. Метасостояния определяют, как средства планирования обрабатывают каждое из состояний рабочего процесса. Хотя бы одно состояние рабочего процесса должно быть сопоставлено с метасостояниями InProgress и Completed

  • Удаление полей, определенных для типов рабочих элементов (WIT), которые относятся к категории требований или категории задач. Эти поля определены в файле определений ProcessConfiguration и включают в себя поля, используемые для управления приоритетом невыполненной работы, трудозатратами, действием или дисциплиной задачи, а также оставшимися трудозатратами.

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

Вопрос. Как используется оператор версии в шаблонах процессов?

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

Если оператор version отсутствует, мастер настройки компонентов не может выбрать шаблон процесса для обновления командного проекта. Кроме того, если в TFS передано несколько шаблонов процессов, в которых указан один и тот же наибольший номер версии, ни один из этих шаблонов процессов не может быть выбран для обновления командного проекта.

Вопрос. Я впервые работаю с шаблонами процессов.Что мне следует знать о внесении обновлений вручную?

Ответ. При изменении файлов шаблонов процессов руководствуйтесь следующими принципами:

  • Обзор шаблонов процессов, а также их файлов и папок см. в разделах Настройка шаблона процессаОбщие сведения о файлах шаблонов процессов.

  • Удаляйте файл или задачу для отправки файла только в том случае, если вы хорошо представляете себе, что это за файл, и уверены, что он вам не понадобится.

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

  • Можно выполнить поиск элемента dependency по всем файлам подключаемых модулей, чтобы узнать, какие задачи зависят от других задач, которые выполняются в настоящее время. Например, для Microsoft Test Manager и Lab Management требуются типы рабочих элементов SharedSteps и TestCase, категории и типы ссылок SharedSteps и TestedBy. См. раздел Определение зависимостей для групп задач и задач в файлах подключаемых модулей.

Вопрос. Как переименовать тип рабочих элементов?

Ответ. Используйте команду witadmin renamewitd для изменения имени, а затем обновите файл определения категорий. Дополнительные сведения см. в разделе Изменение или добавление пользовательского типа рабочего элемента (WIT).

Вопрос. Что если я хочу использовать несколько уровней невыполненной работы портфеля?

Ответ. Можно добавить до пяти списков невыполненных работ портфеля. Это включает элемент невыполненной работы по умолчанию для элемента «Функция». Добавлять их можно в пользовательский шаблон процесса или после обновления командного проекта. Для начала см. раздел Добавление невыполненной работы портфеля.

Вопрос. Где можно больше узнать о том, в какие файлы определений необходимо вносить изменения?

Ответ. Дополнительные сведения см. в следующих разделах:

В. Куда можно обратиться с другим вопросом?

Ответ. Можно разместить вопрос или поискать ответы на одном из следующих форумов: Team Foundation Server - Work Item Tracking или Team Web Access.