Управление сопоставлениями полей для интеграции Team Foundation Server и Project Server

Статья
08/11/2011

Можно настроить способ синхронизации данных между Visual Studio Team Foundation Server 2010 и Project Server, изменяя файл сопоставления полей. Этот файл определяет поля данных для синхронизации и способ их синхронизации для поддержки интеграции Team Foundation Server и Project Server. Можно управлять этим файлом с помощью следующих параметров инструмента командной строки TFSAdmin ProjectServer:

/DownloadFieldMappings Передача файла сопоставления полей для коллекции командного проекта
/UploadFieldMappings: Проверяет синтаксис XML из файла сопоставления полей и передает его в коллекцию. Для проверки синтаксиса без загрузки файла можно использовать параметр /validateonly.

Примечание

Файл сопоставления полей для интеграции Team Foundation Server и Project Server отличается от файла сопоставления полей для Microsoft Project.Дополнительные сведения о загрузке и отправке второго файла см. в разделе TFSFieldMapping.

Дополнительные сведения о содержимом файла сопоставления полей и его настройке см. в разделах Справка по XML-элементу сопоставления полей для интеграции Team Foundation Server и Project Server и Настройка сопоставления полей между Project Server и Team Foundation Server.

Чтобы использовать инструмент командной строки TFSAdmin ProjectServer, откройте окно командной строки на компьютере с запущенным Сред. Командный обозреватель и пакетом обновления 1 (SP1) Visual Studio Team Foundation Server 2010. Запустите инструмент из следующей папки: диск:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE. На 64-разрядных компьютерах это средство находится в папке Диск:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

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

Для использования этих команд разрешению Администрирование интеграции Project Server должно быть присвоено значение Разрешить для коллекции командного проекта. Кроме того, учетной записи службы Team Foundation Server необходимо предоставить соответствующие разрешения на взаимодействие с экземпляром Project Web Access или PWA, который будет участвовать в синхронизации данных. Дополнительные сведения см. в разделе Назначение разрешений для поддержки интеграции Project Server и Team Foundation Server.

Примечание

Даже если вход в систему выполнен с разрешениями администратора, чтобы выполнить эту функцию на сервере с операционной системой Windows Server 2008, необходимо открыть окно командной строки с повышенными привилегиями.Чтобы открыть окно командной строки с повышенными привилегиями, нажмите кнопку Пуск, щелкните правой кнопкой мыши пункт Командная строка и выберите команду Запуск от имени администратора.Дополнительные сведения см. на следующей странице веб-сайта Майкрософт: Контроль учетных записей.

Синтаксис

TFSAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filepath:mappingFile [/encoding:encoding]

TFSAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:mappingFile [/encoding:encoding] [/validateOnly] [/useDefaultFieldMappings] [/force]

Параметры

Параметр	Описание
/collection:tpcURL	Задает URL-адрес коллекции командного проекта. Для указания URL-адреса применяется следующий формат: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции Если не указан виртуальный каталог, необходимо задать URI в следующем формате: http://имя_сервера:порт/имя_коллекции
/filePath:mappingFile	Задает путь и имя файла XML-определения, содержащего сопоставления полей. Примечание При использовании Windows Vista не обязательно иметь разрешения на доступ к определенным папкам.При попытке экспорта типа рабочего элемента в расположение, к которому отсутствуют права доступа, технология виртуализации реестра автоматически перенаправит экспортируемый файл и сохранит его в виртуальном хранилище.Во избежание такого перенаправления можно экспортировать файл в расположение, где действуют разрешения. Дополнительные сведения см. на следующих страницах веб-сайта корпорации Майкрософт: Registry Virtualization и Типовые проблемы виртуализации файлов и реестра в Windows Vista.
/encoding:encoding	Задает имя формата кодировки для .NET Framework 2.0. Команда экспортирует или импортирует данные XML в указанный формат кодировки. Например, /e:utf-7 задает кодировку Юникод (UTF-7). Если этот параметр не указан, команда пытается определить кодировку и в случае неудачи использует UTF-8.
/validateOnly	Проверяет файл сопоставления, но не передает его.
/useDefaultFieldMappings	Передает сопоставления полей по умолчанию вместо пользовательского файла сопоставления. Дополнительные сведения см. в разделе Справка по XML-элементу сопоставления полей для интеграции Team Foundation Server и Project Server.
/force	Перезаписывает существующий файл сопоставления. Необходимо указать этот параметр при замене существующих сопоставлений другими сопоставлениями.

К началу

Примечания

Можно сопоставить только корпоративные пользовательские поля или поля, встроенные в Project Server. Необходимо задать имя допустимого поля в проекте. Для определения имени встроенного поля удалите пробелы из понятного имени и перед полученным словом поставьте префикс «pj». Например, именем поля для диспетчера состояния является pjStatusManager, а именем поля для Custom 01 — pjCustom01. Ограничения касаются того, как сопоставляются встроенные и пользовательские поля; необходимо сопоставлять типы данных полей. Дополнительные сведения см. в разделе Ограничения на сопоставление полей Project Server при интеграции с Team Foundation Server.

При выполнении команды TFSAdmin ProjectServer сообщение указывает выполняемое действие и его объект. Например следующее сообщение показывает, что загружается файл сопоставления полей:

Download field mappings from Collection0

После завершения действия команды появится еще одно сообщение. Например если был загружен файл сопоставления полей, появляется следующее сообщение:

You have downloaded field mappings to C:MappingFile. . . Done.

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

При запуске команды /UploadFieldMappings происходит следующее.

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

Если файл сопоставления полей передан успешно происходят следующие изменения:

Каждое зеркальный поле в Team Foundation настраивается в соответствии с сопоставленные поля.
Для типов рабочих элементов, сопоставленных для коллекции или командного проекта, новые сопоставления отображаются на вкладке Project Server формы рабочего элемента.

Важно!

При сопоставлении поля в Team Foundation Server с полем в Project Server убедитесь в соответствии типов данных этих полей.В противном случае при попытке отправить сопоставления полей может появиться следующее сообщение об ошибке:

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

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

К началу

Примеры

Загрузка файла сопоставления полей, определенного для коллекции командного проекта

Следующий пример загружает сопоставления полей, заданные для AdventureWorksCollection в файле AWMappingFile.xml.

TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Передача файла сопоставления полей для коллекции командного проекта

В следующем примере передает AWMappingFile.xml в AdventureWorksCollection и перезаписывает все сопоставления полей, которые были ранее определены.

TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml" /force

К началу