Управление сопоставлениями полей для интеграции TFS и Project Server
Можно настраивать способ синхронизируете данных между Team Foundation Server ( Visual Studio Team Foundation Server ) и Microsoft Project Server, изменив файл сопоставления полей. Этот файл определяет поля данных, синхронизированы и их синхронизированы для поддержки интеграции Team Foundation Server и Project Server. Можно управлять этим файлом с помощью следующих параметров инструмента командной строки TfsAdmin ProjectServer:
/DownloadFieldMappings Передача файла сопоставления полей для коллекции командного проекта
/UploadFieldMappings: Проверяет синтаксис XML из файла сопоставления полей и передает его в коллекцию. Для проверки синтаксиса без загрузки файла можно использовать параметр /validateonly.
Примечание
Файл сопоставления полей для интеграции Team Foundation Server и Project Server отличается от файла сопоставления полей для Microsoft Project.Дополнительные сведения о загрузке и отправке второго файла см. в разделе Отправка или скачивание файла сопоставления Microsoft Project [TFSFieldMapping].
Дополнительные сведения о содержимом файла сопоставления полей и его настройке см. в разделах Справочник по XML-элементу сопоставления полей для интеграции TFS и Project Server и Настройка сопоставления полей между 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 необходимо предоставить соответствующие разрешения на взаимодействие с экземпляром Project Web Access или PWA, который будет участвовать в синхронизации данных. Для получения дополнительной информации см. Назначение разрешений для поддержки интеграции TFS и Project Server.
Синтаксис
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://ServerName:Port/VirtualDirectoryName/CollectionName Если не указан виртуальный каталог, необходимо задать URI в следующем формате: http://ServerName:Port/CollectionName |
/filePath:mappingFile |
Задает путь и имя файла XML-определения, содержащего сопоставления полей. Примечание При использовании Windows Vista не обязательно иметь разрешения на доступ к определенным папкам.При попытке экспорта типа рабочего элемента в расположение, к которому отсутствуют права доступа, технология виртуализации реестра автоматически перенаправит экспортируемый файл и сохранит его в виртуальном хранилище.Во избежание перенаправления файл можно экспортировать в расположение, для которого имеются права доступа.Дополнительные сведения см. на следующих страницах веб-сайта Майкрософт: Виртуализация реестров и Общие проблемы виртуализации реестров и файлов в Windows Vista. |
/encoding:encoding |
Задает имя формата кодировки для .NET Framework 2.0. Команда экспортирует или импортирует данные XML в указанный формат кодировки. Например, /e:utf-7 задает кодировку Юникод (UTF-7). Если этот параметр не указан, команда пытается определить кодировку и в случае неудачи использует UTF-8. |
/validateOnly |
Проверяет файл сопоставления, но не передает его. |
/useDefaultFieldMappings |
Передает сопоставления полей по умолчанию вместо пользовательского файла сопоставления. Для получения дополнительной информации см. Справочник по XML-элементу сопоставления полей для интеграции TFS и Project Server. |
/force |
Перезаписывает существующий файл сопоставления. Необходимо указать этот параметр, если указан параметр /useDefaultFieldMappings, когда нужно заменить существующие отображения с различными отображаются. |
Заметки
Можно сопоставить только корпоративные пользовательские поля или поля, встроенные в Project Server. Необходимо задать имя допустимого поля в проекте. Для определения имени встроенного поля удалите пробелы из понятного имени и перед полученным словом поставьте префикс «pj». Например, именем поля для диспетчера состояния является pjStatusManager, а именем поля для Custom 01 — pjCustom01. Ограничения касаются того, как сопоставляются встроенные и пользовательские поля; необходимо сопоставлять типы данных полей. Для получения дополнительной информации см. Ограничения на сопоставление полей Project Server при интеграции TFS и Project 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 убедитесь в соответствии типов данных этих полей.В противном случае при попытке отправить сопоставления полей может появиться следующее сообщение об ошибке:
Индекс (отсчитываемый от нуля) должен быть больше или равен нулю, но меньше размера списка аргументов.
Дополнительные сведения см. в разделе Типы данных и критерии сопоставления полей.
Примеры
Загрузите файл сопоставления полей, определенных для коллекции командных проектов
Следующий пример загружает сопоставления полей, заданные для 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"
См. также
Задачи
Настройка интеграции TFS и Project Server
Основные понятия
Справочник по XML-элементу сопоставления полей для интеграции TFS и Project Server
Ограничения на сопоставление полей Project Server при интеграции TFS и Project Server
Сопоставление компонентов интеграции [TfsAdmin ProjectServer]