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

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

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

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

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

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

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

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

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

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

Для использования этих команд разрешению Администрирование интеграции 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 не обязательно иметь разрешения на доступ к определенным папкам.При попытке экспорта типа рабочего элемента в расположение, к которому отсутствуют права доступа, технология виртуализации реестра автоматически перенаправит экспортируемый файл и сохранит его в виртуальном хранилище.Во избежание перенаправления файл можно экспортировать в расположение, для которого имеются права доступа. Дополнительные сведения см. на страницах Виртуализация реестра (страница может быть на английском языке) и Типовые проблемы виртуализации файлов и реестра в Windows Vista (страница может быть на английском языке) веб-сайта корпорации Microsoft.
/encoding:encoding	Задает имя формата кодировки для .NET Framework 2.0.Команда экспортирует или импортирует данные XML в указанный формат кодировки.Например, /e:utf-7 задает кодировку Юникод (UTF-7).Если этот параметр не указан, команда пытается определить кодировку и в случае неудачи использует UTF-8.
/validateOnly	Проверяет файл сопоставления, но не передает его.
/useDefaultFieldMappings	Передает сопоставления полей по умолчанию вместо пользовательского файла сопоставления.Дополнительные сведения см. в разделе Справка по XML-элементу сопоставления полей для интеграции Team Foundation Server и Project Server.
/force	Перезаписывает существующий файл сопоставления.Необходимо указать этот параметр, если указать параметр, /useDefaultFieldMappings, когда необходимо заменить существующие сопоставления с различными сопоставлениями.

К началу

Заметки

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

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

Download field mappings from DefaultCollection

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

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

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

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

• Каждое зеркальный поле в Team Foundation настраивается в соответствии с сопоставленные поля.

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

Важно

При сопоставлении поля в Team Foundation Server с полем в Project Server убедитесь в соответствии типов данных этих полей.В противном случае при попытке отправить сопоставления полей может появиться следующее сообщение об ошибке: Индекс (отсчитываемый от нуля) должен быть больше или равен нулю, но меньше размера списка аргументов. Дополнительные сведения см. в разделе Data Types and Field Mapping Criteria.

К началу

Примеры

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

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

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

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

В следующем примере передает AWMappingFile.xml к AdventureWorksCollection.

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

К началу

См. также

Задачи

Настройка интеграции Team Foundation Server и Project Server

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

Справка по XML-элементу сопоставления полей для интеграции Team Foundation Server и Project Server

Ограничения на сопоставление полей Project Server при интеграции с Team Foundation Server

Управление интеграцией Project Server с помощью программы TfsAdmin ProjectServer

Другие ресурсы

Настройка сопоставления полей между Project Server и Team Foundation Server