Определение типов рабочих элементов, доступных для синхронизации
Перед тем как синхронизировать данные между Team Foundation Server ( Visual Studio Team Foundation Server ) и сервер Microsoft Project необходимо настроить интеграцию 2 серверных продуктов. Как часть задач по настройке, план проекта предприятия необходимо связать с командным проектом, и необходимо указать типы рабочих элементов, которые будут участвовать в синхронизации. После выполнения начальной конфигурации и сопоставления можно изменить типы рабочих элементов, которые сопоставлены.
Можно управлять типами рабочих элементов, участвующих в синхронизации, с помощью следующих параметров инструмента командной строки TfsAdmin ProjectServer:
/MapWorkItemTypes. Определяет типы рабочих элементов, которые могут участвовать в синхронизации для командного проекта. Несмотря на то что можно сопоставить несколько типов, синхронизируются только тех рабочих элементов, которые будут отправлены для публикации.
/GetMappedWorkItemTypes. Возвращает список типов рабочих элементов, настроенных для участия в синхронизации для командного проекта.
/UnmapWorkItemTypes: Удаляет типы рабочий элементов из участия в синхронизации для командного проекта.
Обзор по интеграции этих двух серверных продуктов см. в разделе Настройка интеграции TFS и Project Server. Общие сведения об установке связи проекта предприятия и командного проекта см. в разделе Управление связыванием корпоративных проектов с командными проектами.
Для использования программы командной строки TfsAdmin ProjectServer, чтобы открыть окно командной строки, Visual Studio или Team Explorer устанавливаются, введите:
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
В 32-разрядной версии Windows замените %programfiles(x86)% на %programfiles%..
Требования
Для использования этих команд необходимо задать для разрешения Администрирование интеграции с Project Server значение Разрешить. Кроме того, учетной записи службы Team Foundation Server необходимо предоставить соответствующие разрешения на взаимодействие с экземпляром PWA, который будет участвовать в синхронизации данных. Для получения дополнительной информации см. Назначение разрешений для поддержки интеграции TFS и Project Server.
Синтаксис
TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:tpcUrl teamProject:TeamProjectName
TfsAdmin ProjectServer /MapWorkItemTypes /collection:tcpUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/skipUIChanges]
TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:tpcUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/force]
Параметры
Параметр |
Описание |
|---|---|
/collection:tpcUrl |
Задает URL-адрес коллекции командного проекта. Для указания URL-адреса применяется следующий формат: http://ServerName:Port/VirtualDirectoryName/CollectionName Если не указан виртуальный каталог, необходимо задать URL в следующем формате: http://ServerName:Port/CollectionName |
/teamProject:TeamProjectName |
Указывает имя командного проекта, определенного в коллекции проекта. |
/workItemTypes:ListofWorkItemTypes |
Указывает ссылки на имена одного или нескольких типов рабочих элементов в список с разделителями запятыми. Необходимо указать только те типы рабочих элементов, данные которых требуется отслеживать в приложении Project Professional. Например, можно указать следующие типы рабочих элементов для поддержки гибкий процесс как “User Story,Task” или “User Story”,Task. Не добавляйте пробел после запятой. |
/skipUIChanges |
Указывает, вкладка Project Server в форме рабочего элемента не должна изменяться для указанных типов. Необходимо включить этот флажок, если вы настраивали вкладку Project Server для соответствующих типов или команда MapWorkItemTypes не может выполнить. Можно вручную обновить определение типа. Для получения дополнительной информации см. XML-элементы, добавленные в определение типа рабочего элемента. |
/force |
Удаляет все ссылки, связывающие рабочие элементы указанных типов с задачами в проекте. Если этот параметр применить, можно удалить типы рабочих элементов из участия в синхронизации данных, даже если один или несколько рабочих элементов этого типа в настоящее время синхронизируются. |
/? или help |
Отображает информацию о команде. |
Заметки
При выполнении команды возникающее сообщение указывает, какое действие к какому объекту применяется. Например следующие сообщение указывает, что заметки пользователей и задачи настраиваются для участия в синхронизации данных.
Configuring synchronization for the following work item types for team project ProjA: User Story, Task. . .
После завершения работы команды появится еще одно сообщение. Например следующее сообщение указывает, что заметки пользователей и задачи были успешно настроены.
You have successfully configured the following work item types for team project ProjA: User Story, Task.
В дополнение к настройке типов рабочих элементов, которые могут участвовать в синхронизации, команда /MapWorkItemTypes выполняет следующие операции:
Добавляет заданные типы рабочих элементов в набор типов, участвующих в синхронизация данных. То есть, команда не отменяет сопоставление существующих сопоставленных типов.
Добавляет вкладку Project Server в формы для заданных типов рабочих элементов.
Если вкладка Project Server уже определена для типа рабочего элемента, который вы задаете,этот тип игнорируется, изменений в формах рабочих элементов данного типа не происходит.
При попытке сопоставления типов рабочих элементов для командного проекта, который не связан с планом проекта предприятия, появляется сообщение об ошибке. Можно сопоставлять типы рабочих элементов только для командных проектов, настроенных участвовать в синхронизации. Для получения дополнительной информации см. Управление связыванием корпоративных проектов с командными проектами.
Если удалить сопоставление для типа рабочего элемента, вкладка Project Server будет удалена из формы для данного типа для командного проекта, для которого удаляется сопоставление.
Прежде чем удалить сопоставление типа рабочего элемента для командного проекта, следует удалить задачи из плана проекта предприятия, чтобы удалить все связи между ними и рабочие элементы в Team Foundation. После удаления задачи из корпоративных проектов расписание необходимо публиковать его и ожидать синхронизации для выполнения. В качестве альтернативы можно указать флаг /force, чтобы удалить все ссылки, связывающие рабочие элементы и задачи командного проекта. Только рабочие элементы указанных вами типов будут удалены из участия в синхронизации.
Совет
Если требуется удалить задачи, можно сперва скопировать их в другой план, чтобы сохранить их копию.
Примеры
Типы рабочих элементов, сопоставленных списка
В следующем примере извлекаются типы рабочих элементов, которые настроены для участия в синхронизации для командного проекта в Contoso DefaultCollection на сервере AdventureWorksServer.
TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /teamproject:Contoso
Сопоставление типа рабочего элемента для командного проекта
В следующем примере настраиваются пользовательские описания функциональности и задачи для участия в синхронизации данных для проекта Contoso.
TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:”User Story, Task”
Удалите сопоставление типа рабочего элемента для командного проекта
Следующий пример удаляет задания из участвующих в синхронизации данных для проекта Contoso.
TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:Task
См. также
Основные понятия
Задание типов рабочих элементов для синхронизации
Сопоставление компонентов интеграции [TfsAdmin ProjectServer]