Устранение ошибок, полученных при настройке функций

Статья
06/09/2015

Можно устранить ошибки и предупреждения, отображаемые в мастере Настройка компонентов. Эти проблемы возникают, поскольку определения в командном проекте не согласуются с определениями в шаблонах процессов, загруженных в коллекцию командных проектов. Необходимо изменить шаблон процесса для разрешения ошибки и снова запустить мастер. Также можно изменить командный проект и затем запустить мастер заново.

Содержание раздела

Разрешение ошибок, найденных мастером настройки компонентов
- Разрешение ошибок путем изменения шаблона процесса
- Разрешение ошибок путем изменения командного проекта или коллекции командных проектов
- Проблемы и решения
Разрешение предупреждений, найденных мастером настройки компонентов
- Разрешение предупреждений о добавлении оператора ACTION в тип рабочего элемента
- Добавление элемента управления ссылками раскадровки

Примечание

Если у вас возникнут проблемы при выполнении следующих процедур, можно поискать решение на форумах по Team Foundation Server (TFS) и на следующих страницах веб-сайта Майкрософт: Отслеживание рабочих элементов и Шаблоны процессов.

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

Чтобы загружать и добавлять шаблоны процессов, необходимо быть членом группы Администраторы коллекции проектов. Если разрешения безопасности задаются явно, разрешение Управление шаблоном процесса для коллекции командных проектов должно иметь значение Разрешить.
Чтобы запускать средство командной строки witadmin, необходимо входить в одну из следующих групп: Администраторы Team Foundation, Администраторы коллекции проектов или Администраторы проекта для командного проекта.

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

Разрешение ошибок, найденных мастером настройки компонентов

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

Разрешение ошибок путем изменения шаблона процесса

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

Загрузите шаблон процесса из Team Foundation Server. См. раздел Загрузка последней версии шаблонов процессов.
Измените файл определений для типа рабочего элемента, категорий или конфигурации процесса. См. раздел Настройка объектов отслеживания работ для поддержки командных процессов.
Добавьте шаблон процесса на Team Foundation Server. См. раздел Отправка, загрузка и удаление шаблонов процессов для коллекции командных проектов.

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

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

Чтобы разрешить ошибку или предупреждение, можно изменить командный проект или коллекцию командных проектов с помощью команды witadmin. См. раздел witAdmin. Настройка объектов для отслеживания рабочих элементов и управление этими объектами.

Можно экспортировать определение типа, внести изменения в определения полей, а затем по необходимости импортировать определения типа. См. раздел Импорт и экспорт типов рабочих элементов и управление ими [witadmin].

Проблемы и решения

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

Ошибка	Проблема	Разрешение через шаблон процесса	Разрешение через командный проект
TF400613: Тип рабочего элемента "{1}", указанный в категории "{0}", не существует.	В командном проекте не необходимого типа рабочего элемента, поскольку он был переименован, удален или не был добавлен. Переименуйте указанное определение типа рабочего элемента или импортируйте недостающий тип рабочего элемента из последней версии шаблонов процессов, установленных с обновлением TFS.	Измените тип рабочего элемента, определенный в указанной категории, чтобы указать существующий тип рабочего элемента.	Чтобы переименовать тип рабочего элемента, используйте witadmin renamewitd. Чтобы добавить отсутствующий тип рабочего элемента, найдите его в последнем шаблоне процесса и импортируйте с помощью команды witadmin importwitd. См. раздел Импорт и экспорт типов рабочих элементов и управление ими [witadmin].
TF400614: Категория "{0}" не существует.	В файле определения категорий в шаблоне процесса, выбранном для обновления командного проекта, отсутствует необходимая категория. Добавьте недостающую категорию.	Добавьте недостающую категорию в шаблон процесса. См. раздел Использование категорий для группировки типов рабочих элементов.	Добавьте недостающую категорию к командному проекту с помощью команды witadmin importcategories. См. раздел Импорт и экспорт категорий [witadmin].
TF400617: Тип поля "{0}" в типе рабочего элемента "{1}" конфликтует с типом существующего поля.	Тип данных поля, определенный в добавляемом типе рабочего элемента, не соответствует типу данных, определенному в коллекции командных проектов. Исправьте назначение в определении типа рабочего элемента и запустите мастер повторно. Примечание Обновление Visual Studio Team Foundation Server 2012 изменяет поле Описание (System.Description) с типа поля "простой текст" на HTML, чтобы обеспечить поддержку форматирования текста и вставки изображений и гиперссылок.В последней версии Team Foundation Server можно переключаться между типами данных PlainText и HTML.	Загрузите шаблон процесса, откройте определение типа, найдите назначение FIELD, измените атрибут type так, чтобы он соответствовал определению для коллекции, а затем добавьте шаблон процесса. См. раздел Справочник по элементам FIELD (определение). Совет Чтобы определить тип, назначенный полю, выполните команду witadmin listsfields.	Используйте команду witadmin changefield с атрибутом type. См. раздел Управление полями рабочих элементов [witadmin]. Примечание Можно изменить определение типа для коллекции командных проектов, только если тип — PlainText или HTML.
TF400618: Тип отчетов поля "{0}" в типе рабочего элемента "{1}" конфликтует с типом отчетов существующего поля.	Атрибут отчета, назначенный полю в определении типа рабочего элемента, не соответствует атрибуту, определенному в коллекции командных проектов.	Загрузите шаблон процесса, откройте определение типа, найдите назначение FIELD и измените атрибут reportable так, чтобы он соответствовал определению для коллекции. Затем добавьте шаблон процесса. См. раздел Справочник по элементам FIELD (определение).	Используйте команду witadmin changefield с атрибутом reportingtype. См. раздел Управление полями рабочих элементов [witadmin].
TF400619: Атрибут SyncNameChanges поля "{0}" в типе рабочего элемента "{1}" конфликтует с атрибутом SyncNameChanges существующего поля.	Атрибут syncnamechanges, назначенный полю в определении типа рабочего элемента, не соответствует атрибуту, определенному в коллекции командных проектов. Этот атрибут указывает, необходимо ли обновлять поле личного имени, когда это имя изменяется в Active Directory.	Загрузите шаблон процесса, откройте определение типа, найдите назначение FIELD, измените его так, чтобы оно соответствовало определению для коллекции, а затем добавьте шаблон процесса. См. раздел Справочник по элементам FIELD (определение).	Используйте команду witadmin changefield с параметром /syncnamechanges. См. раздел Управление полями рабочих элементов [witadmin].
TF400620: Понятное имя поля "{0}" в типе рабочего элемента "{1}" конфликтует с понятным именем существующего поля.	Понятное имя, назначенное полю в определении типа рабочего элемента, должно соответствовать имени, определенному в коллекции командных проектов.	Загрузите шаблон процесса, откройте определение типа, найдите назначение FIELD и измените его, чтобы оно соответствовало имени, определенному для коллекции. Затем добавьте шаблон процесса.	Чтобы изменить понятное имя для коллекции командных проектов, используйте команду witadmin changefield с параметром /name. См. раздел Управление полями рабочих элементов [witadmin].
TF400621: Имя ссылки поля "{0}" в типе рабочего элемента "{1}" уже используется типом ссылок.	Все ссылочные имена, назначенные полям и типам ссылок, должны быть уникальны в пределах коллекции командных проектов.	Если тип ссылки активен и используется для связывания рабочих элементов, загрузите шаблон процесса, откройте определение типа, найдите назначение FIELD и измените назначениеrefname так, чтобы оно соответствовало определению для коллекции. Затем добавьте шаблон процесса. Совет Чтобы определить, используется ли тип ссылки, создайте запрос прямых ссылок, а затем отфильтруйте его так, чтобы получить все рабочие элементы, связанные с другими рабочими элементами связью этого типа.	Если тип ссылки не активен и не используется для связывания рабочих элементов в пределах коллекции командных проектов, удалите его. Для удаления типа ссылки можно использовать команду witadmin deletelinktype. См. раздел Управление типами связей [witadmin].
TF400624: Понятное имя категории "{0}" конфликтует с категорией "{1}".	Необходимо назначить уникальное ссылочное имя и понятное имя каждой категории командного проекта. Можно разрешить эту ошибку, переименовав существующую категорию "{1}" в шаблоне процесса или в командном проекте.	Загрузите шаблон процесса, переименуйте категорию в файле категорий и затем добавьте шаблон процесса. См. раздел Использование категорий для группировки типов рабочих элементов.	Экспортируйте файл категорий с помощью команды witadmin exportcategories, измените понятное имя, присвоенное категории "{1}", и импортируйте файл. См. раздел Импорт и экспорт категорий [witadmin].
TF400654: Не удалось настроить средства планирования.	Сопоставление, определенное в файле CommonConfiguration, указывает поле или состояние, не существующее в типе рабочего элемента, определенном для командного проекта.	Загрузите шаблон процесса, исправьте сопоставление в файле CommonConfiguration и добавьте шаблон процесса. См. раздел Настройка конфигурации процесса.	Экспортируйте тип рабочего элемента с помощью команды witadmin exportwitd, добавьте отсутствующее поле или состояние, а затем импортируйте тип рабочего элемента. См. раздел Импорт и экспорт типов рабочих элементов и управление ими [witadmin].

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

Разрешение предупреждений, найденных мастером настройки компонентов

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

Предупреждение	Проблема	Решение
TF400609: Не удалось добавить действие "{0}" в тип рабочего элемента "{1}", поскольку состояние "{2}" не существует.	Отсутствует обязательный элемент STATE.	См. раздел Разрешение ошибок при добавлении оператора ACTION в тип рабочего элемента.
TF400610: Не удалось добавить действие "{0}" в тип рабочего элемента "{1}", поскольку переход из состояния "{2}" в состояние "{3}" не существует.	Отсутствует обязательный оператор TRANSITION.	См. раздел Разрешение ошибок при добавлении оператора ACTION в тип рабочего элемента.
Раскадровка: не удалось вставить вкладку в тип рабочего элемента "{1}" в категории "{2}".	В определении типа отсутствует элемент TabGroup.	См. раздел Добавление элемента управления ссылками раскадровки.

Разрешение предупреждений о добавлении оператора ACTION в тип рабочего элемента

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

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

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

Добавление вкладки элемента управления ссылками раскадровки

Раскадровка позволяет связывать рабочие элементы с раскадровками. Для этого необходимо добавить вкладку элемента управления ссылками Раскадровка к определению типа рабочего элемента. Если мастер "Настроить компоненты" не смог добавить вкладку или не добавил ее по другой причине, можно добавить ее вручную. В последних версиях шаблонов процессов, установленных на обновленный сервер TFS, вкладка элемента управления ссылками Storyboard отображается для всех типов рабочих элементов невыполненной работы, например "Список невыполненных работ по продукту", "Пользовательская история" и "Требование".

Примечание

Мастер "Настройка компонентов" не может добавить вкладку элемента управления ссылками Раскадровка, если элемент TabGroup отсутствует в разделе FORM рабочего элемента.В следующей процедуре добавляется только вкладка Раскадровка.Если необходимо добавить стандартный набор вкладок для типа рабочего элемента невыполненной работы, см. определение типа в последней версии шаблона процесса для командного проекта.См. раздел Загрузка последней версии шаблонов процессов.

Для запуска инструмента командной строки witadmin откройте окно командной строки там, где установлено либо Visual Studio, либо Team Explorer, и введите:
```
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
```
В 32-разрядной версии Windows замените %programfiles(x86)% на %programfiles%.

Экспортируйте файл определения типа для элемента невыполненной работы, заменив представленные ниже аргументы своими данными:

witadmin exportwitd  /collection:CollectionURL /p:"ProjectName" /n:"TypeName" /f:"DirectoryPath\FileName.xml"
   
Where:
   CollectionURL specifies the URL of the team project collection
   ProjectName specifies the name of your team project defined within the collection
   TypeName specifies the name of your backlog item, for example User Story or Product Backlog Item.
   
Use the following format for CollectionURL:  http://ServerName:Port/VirtualDirectoryName/CollectionName
For example: http://srvalm:8080/tfs/DefaultCollection.

Откройте файл в текстовом редакторе, например Блокнот.

Добавьте следующий фрагмент кода непосредственно перед закрывающим тегом </Layout> типа невыполненной работы:

<TabGroup>
<Tab Label="Storyboards"> 
   <Control Name="StoryboardsControl" Type="LinksControl"> 
      <LinksControlOptions> 
         <WorkItemLinkFilters FilterType="excludeAll" /> 
         <ExternalLinkFilters FilterType="include"> 
            <Filter LinkType="Storyboard" /> 
         </ExternalLinkFilters> 
         <LinkColumns> 
            <LinkColumn RefName="System.Title" /> 
            <LinkColumn LinkAttribute="System.Links.Comment" /> 
         </LinkColumns> 
      </LinksControlOptions> 
   </Control> 
</Tab> 
</TabGroup>

Сохраните и закройте файл.
Импортируйте файл определения типа. Для этого введите следующую команду, заменив представленные ниже аргументы своими данными:
```
witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\FileName.xml"
```
Убедитесь, что вкладка отображается в элементе невыполненной работы.

См. также

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

Настройка компонентов после обновления TFS

Share via