Импорт и экспорт конфигурации процесса [witadmin]

Вы можете настроить конфигурацию процесса, чтобы изменить отображение страниц средств планирования Agile, просматриваемые в Team Web Access (TWA). Для сопоставления состояний рабочего процесса и метасостояний потребуется использовать некоторые дополнительные средства.

Обзор настройки этих средств планирования Agile см. в разделе Настройка средств планирования Agile для командного проекта.

Примечание

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

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

• exportprocessconfig: экспортирует определение конфигурации процесса в XML-файл или окно командной строки.

• importprocessconfig: импортирует XML-файл определения конфигурации процесса.

Для запуска инструмента командной строки witadmin откройте окно командной строки там, где установлено либо Visual Studio, либо Team Explorer, и введите:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

В 32-разрядной версии Windows замените %programfiles(x86)% на %programfiles%.

Требования

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

• Для импорта определений конфигурации процесса необходимо быть участником следующих групп безопасности: Администраторы Team Foundation или Администраторы проектов.

Для получения дополнительной информации см. Справочник по разрешениям Team Foundation Server.

witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName [/f:FileName] [/e:encoding] 

witadmin importprocessconfig /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:encoding] [/v]

Параметры

Параметр	Описание
/collection:CollectionURLx	Обязательный. Задает URL-адрес коллекции. URI необходимо указать в следующем формате: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции. Если вы не указываете виртуальный каталог, URI необходимо задать в следующем формате: http://ИмяСервера:Порт/ИмяКоллекции.
/p:ProjectName	Обязательный. Определяет командный проект, для которого вы хотите экспортировать или импортировать конфигурацию процесса. Этот командный проект должен быть определен в коллекции, которую вы указали с помощью параметра /collection. Если вы указали параметр командной строки /v, командный проект указывать не нужно.
/f:FileName	Имя экспортируемого и импортируемого XML-файла определения для конфигурации процесса и путь к нему. Примечание Если на клиентском компьютере выполняется Windows Vista, у вас может не быть разрешений на доступ к некоторым файлам.Если вы попытаетесь экспортировать глобальный список в расположение, на доступ к которому у вас нет прав, компонент виртуализации реестра автоматически перенаправит экспортированный файл и сохранит его в виртуальном хранилище.Дополнительные сведения см. в указанных ниже статьях на веб-сайте корпорации Microsoft. Виртуализация реестра и Проблемы общих файлов и виртуализации реестра в Windows Vista.Чтобы избежать этого перенаправления, можно экспортировать файл в расположение, на доступ к которому у вас есть разрешения.
/e:Encoding	Необязательно. Имя формата кодирования .NET Framework 2,0. Указанное кодирование будет использоваться для экспорта или импорта XML-данных. Например, /e utf-7 задает кодировку Юникод (UTF-7). Если этот параметр не указан, witadmin пытается определить кодировку, а в случае неудачи использует UTF-8.
/v	Необязательно. Проверяет XML-файл, определяющий конфигурацию проекта, но не импортирует файл определения.
/? или help	Отображает справку по команде в окне командной строки.

Заметки

Примечание

Установка Visual Studio TFS 2013 приводит к обновлению существующих командных проектов.Они будут использовать файл конфигурации процесса, который сочетает файлы конфигурации Agile и общие файлы конфигурации, поддерживаемые в TFS 2012.Следующие команды witadmin стали нерекомендуемыми вместе с соответствующими им файлами конфигурации:

• exportagileprocessconfig

• exportcommonprocessconfig

• importagileprocessconfig

• importcommonprocessconfig

Сведения об обновлении обновленного командного проекта см. в разделе Настройка компонентов после обновления TFS.

Если у вас возникли проблемы с доступом к существующие планам тестирования и наборам тестов после обновления до TFS 2013.3, см. Обновление командного проекта вручную для поддержки управления тестированием.

Примеры

В каждом примере применяются следующие значения:

• URL-адрес коллекции: http://AdventureWorksServer:8080/tfs/DefaultCollection

• Командный проект: Contoso

• Номер порта для веб-сайта сервера: 8080

Добавление поля на панель быстрого добавления

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

На этой панели отображаются только поля, включенные в раздел FIELDS определения типа рабочего элемента для выбранного типа. Например, при выборе типа рабочего элемента «Ошибка» отображается только название, поскольку «ценность для бизнеса» для ошибок не определена. Чтобы добавить на панель другой тип рабочего элемента, добавьте его в категорию требований согласно описанию, приведенному здесь.

1. Если у вас нет прав администратора для командного проекта, получите их.

2. Откройте окно командной строки там, где установлены Visual Studio или Team Explorer, и введите следующее:

   cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
   

   В 32-разрядной версии Windows замените %programfiles(x86)% на %programfiles%. Team Explorer можно загрузить бесплатно.

3. Экспортируйте файл конфигурации процесса.

   witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
   

   Пример CollectionURL— http://MyServer:8080/tfs/TeamProjectCollectionName.

4. Добавьте ссылочное имя поля в раздел AddPanel.

   Например, следующий синтаксис добавляет на панель элемент Приоритет.

   <AddPanel>
      <Fields>
         <Field refname="System.Title" />
         <Field refname="Microsoft.VSTS.Common.BusinessValue" />
      </Fields>
   </AddPanel>
   

   Советы

   • Поиск ссылочного имени поля можно осуществлять с помощью указателя.

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

5. Импортируйте файл конфигурации процесса.

   witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
   

6. Обновите страницу невыполненной работы, чтобы просмотреть обновленную панель.

Обновление сопоставлений метасостояний для поддержки Test Manager

В случае внесения изменений в раздел WORKFLOW плана тестирования или набора тестов необходимо провести сопоставление состояний и метасостояний. Это делается для поддержки клиентов Test Manager из состава Visual Studio 2013.2 или более ранних версий.

В следующем примере рабочий процесс плана тестирования был обновлен для использования состояний Разработка, Тестирование и Утверждение. В целях обеспечения обратной совместимости добавлены TestPlanWorkItems в раздел ProjectProcessConfigurationопределений конфигурации процесса.

WORKFLOW

Сопоставления метасостояний

<WORKFLOW>       <STATES>         <STATE value="Design" />         <STATE value="Testing" />         <STATE value="Signed Off" />       </STATES>       <TRANSITIONS>         <TRANSITION from="" to="Design">           <REASONS>             <DEFAULTREASON value="New test plan" />           </REASONS>         </TRANSITION>      <TRANSITION from="Design" to="Testing">           <REASONS>             <DEFAULTREASON value="Authoring complete" />           </REASONS>         </TRANSITION>             <TRANSITION from="Testing" to="Signed Off">           <REASONS>             <DEFAULTREASON value="Signed Off testing" />           </REASONS>         </TRANSITION>         <TRANSITION from="Signed Off" to="Design">           <REASONS>             <DEFAULTREASON value="Reactivating to authoring phase" />           </REASONS>         </TRANSITION>         <TRANSITION from="Signed Off" to="Testing">           <REASONS>             <DEFAULTREASON value="Reactivating to run tests" />           </REASONS>         </TRANSITION>         <TRANSITION from="Testing" to="Design">           <REASONS>             <DEFAULTREASON value="Back to authoring" />           </REASONS>         </TRANSITION>       </TRANSITIONS>     </WORKFLOW>

<TestPlanWorkItems category="Microsoft.TestPlanCategory" pluralName="Test Plans" singularName="Test Plan">     <States>       <State type="InProgress" value="Design" />       <State type="InProgress" value="Testing" />       <State type="Complete" value="Signed Off" />     </States>   </TestPlanWorkItems> <TestSuiteWorkItems category="Microsoft.TestSuiteCategory" pluralName="Test Suites" singularName="Test Suite">     <States>       <State type="Proposed" value="In Planning" />       <State type="InProgress" value="In Progress" />       <State type="Complete" value="Completed" />     </States>   </TestSuiteWorkItems>

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

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

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

Ответ. Вы можете настроить панель быстрого добавления. Мастер настройки компонентов обновит командные проекты, и вы сможете получить доступ к компонентам последней версии.

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

Вопрос: Когда необходимо сопоставлять состояния рабочего процесса и метасостояния?

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

• Типы рабочих элементов, относящиеся к категории требований или категории задач: Сопоставление метасостояний поддерживает отображение средств планирования Agile:

• Типы рабочих элементов, относящиеся к категории ошибок: Сопоставление метасостояний поддерживает средство Моя работа (для командных проектов на основе Agile и CMMI).

• План тестирования и набор тестов: Обновления рабочего процесса для этих типов рабочих элементов должны быть сопоставлены только тогда, когда вы поддерживаете членов команды с подключением к TFS версии Test Manager из состава Visual Studio 2013.2 или более ранних версий.

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

  Обновляйте сопоставление метасостояний, в противном случае вы можете столкнуться с ошибкой Приложение обнаружило неожиданную ошибку при подключении к командному проекту.

  

Как устранить ошибки, связанные с конфигурацией процессов?

Ответ: При внесении любого из следующих изменений в командном проекте необходимо обновить определения для типов рабочих элементов, категорий или конфигурации процесса. Во избежание ошибок, всегда вносите изменения в следующем порядке: (1) типы рабочих элементов, (2) категории, и (3) конфигурации процесса.

Настройка	Обновление или проверка определений типов рабочих элементов	Обновление или проверка определений конфигурации процесса
Добавление объекта WIT в категорию требований (Объект WIT может принадлежать только одной из категорий, требований или задач, но не обеим одновременно).	Включить следующие поля: Приоритет невыполненной работы (Scrum) или ранг стека (Agile или CMMI) (должно совпадать со значением поля, присвоенного type=Order в файле конфигурации процесса) Баллы истории (Agile), трудозатраты (Scrum) или размер (CMMI) (должно совпадать со значением поля, присвоенного type=Effort в файле конфигурации процесса) Путь области или значение поля, присвоенного type=Team в файле конфигурации процесса Все поля в разделе AddPanel файла конфигурации процесса (поля должны быть определены в разделе FIELDS, но не должны водить в раздел FORM.	Чтобы задать необходимые сопоставления метасостояний: Сопоставьте начало каждого состояния рабочего процесса type="Proposed" Сопоставьте каждое промежуточное состояние рабочего процесса, которое нужно отобразить на доске Канбан type="InProgress" Сопоставьте окончание каждого состояния рабочего процесса type="Complete" Можно сопоставить только одно состояние type="Complete" Чтобы задать запись для определения цветовых кодов, связанных с типами рабочих элементов (WIT). Например: <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />
Измените рабочий процесс типов рабочих элементов (WIT) в категории требований.	Н/Д	Чтобы задать необходимые сопоставления метасостояний, как описано выше для добавления типов рабочих элементов (WIT) в категорию требований.
Добавление объекта WIT в категорию задач	Включить следующие поля: Приоритет невыполненной работы (Scrum) или ранг стека (Agile или CMMI) Действие (Agile или Scrum) или дисциплина (CMMI) (должно совпадать со значением поля, присвоенного type=Activity в файле конфигурации процесса) Оставшаяся работа (должно совпадать со значением поля, присвоенного type=RemainingWork в файле конфигурации процесса) Путь области или значение поля, присвоенного type=Team в файле конфигурации процесса (необязательно) Исходная работа и Завершенная работа (только Agile и CMMI)	Чтобы задать необходимые сопоставления метасостояний: Сопоставьте начало каждого состояния рабочего процесса type="Proposed" Сопоставьте каждое промежуточное состояние рабочего процесса, которое нужно отобразить на доске задач type="InProgress" Сопоставьте окончание каждого состояния рабочего процесса type="Complete" Можно сопоставить только одно состояние type="Complete" Чтобы задать запись для определения цветовых кодов, связанных с типами рабочих элементов (WIT). Например: <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />
Измените рабочий процесс типов рабочих элементов (WIT) в категории задач	Н/Д	Чтобы задать необходимые сопоставления метасостояний, как описано выше для добавления типов рабочих элементов (WIT) в категорию задач.
Добавление типов рабочих элементов (WIT) в категорию ошибок (только Agile и CMMI) Изменение рабочего процесса типов рабочих элементов (WIT) в категории ошибок (только Agile и CMMI)	Н/Д	Чтобы задать необходимые сопоставления метасостояний: Сопоставьте начало каждого состояния рабочего процесса type="Proposed" Сопоставьте каждое промежуточное состояние рабочего процесса, которое нужно отобразить на странице "Моя работа" type="InProgress" Сопоставьте окончание каждого состояния рабочего процесса type="Complete" Можно сопоставить только одно состояние type="Complete" Дополнительные сведения см. в разделе Поддержка состояния обновления ошибки с помощью функции "Моя работа".
Удаление типов рабочих элементов, относящиеся к категории требований или категории задач	Н/Д	Чтобы удалить любые сопоставления метасостояний, которые связаны только с этим типом рабочего элемента
Удалить тип рабочих элементов из командного проекта	Чтобы удалить тип рабочих элементов из файла категорий.	Чтобы удалить сопоставления метасостояний, которые связаны только с удаленным типом рабочего элемента и WorkItemColorэлементом, который определяет цветовые коды для удаленных типов рабочих элементов.

Вопрос. Как настроить другие функции, отображаемые в средствах гибкого планирования в TWA?

Ответ. Некоторые настройки можно выполнить через пользовательский интерфейс. В других случаях необходимо изменять конфигурацию процесса или других объектов командного проекта. Для получения общих сведений см. Настройка средств планирования Agile для командного проекта.

Вопрос. Можно ли работать с несколькими невыполненными работами портфеля?

Ответ. По умолчанию среда поддерживает один уровень невыполненной работы портфеля. Можно добавить до 5 уровней согласно описанию в разделе Добавление невыполненной работы в управление портфелем Agile.

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

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