Отправка или скачивание файла сопоставления Microsoft Project [TFSFieldMapping]

Статья
11/18/2015

Команда TFSFieldMapping используется для отправки и загрузки файла сопоставления Microsoft Project. Этот файл контролирует, каким образом Microsoft Project публикует задачи в командном проекте, который подключается к локальному развертыванию Team Foundation Server (TFS). Например, можно изменить файл, чтобы поддерживать поля, добавленные в типы рабочих элементов, или изменить способ публикации и обновления существующих полей.

Можно указать, какие поля TFS будут сопоставляться с полями Project. Кроме того, можно контролировать поведение публикации с помощью атрибута PublishOnly и назначить специальные поля, такие как поле контекста. Полный синтаксис XML-файла сопоставления см. в разделе Настройка файла сопоставления полей Microsoft Project. Это тот же файл, который был определен в шаблоне процесса, который использовался для создания командного проекта. См. раздел Сопоставление полей Microsoft Project полям Team Foundation.

Программа командной строки TFSFieldMapping работает только применительно к локальному развертыванию TFS. Для запуска программы откройте окно командной строки там, где установлена среда Visual Studio или Team Explorer, и введите:

cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\14.0

Примечание

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

Требования

Для использования команды TFSFieldMapping нужно быть членом группы безопасности Администраторы Team Foundation или Администраторы проекта. Дополнительные сведения см. в разделе Справочник по разрешениям Team Foundation Server.

TFSFieldMapping upload | download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

Параметры

Аргумент	Описание
upload \| download	Задает отправку или загрузку файла сопоставления полей.
/collection:CollectionURL	Задает URI коллекции командных проектов в следующем формате: http://ИмяСервера:Порт/ИмяВиртуальногоКаталога/ИмяКоллекции. Если не указывать используемый виртуальный каталог, необходимо использовать следующий формат: http://ИмяСервера:Порт/ИмяКоллекции. Если подключение к этому серверу уже выполнялось, вместо URI можно указать понятное имя сервера.
/teamproject: ProjectName	Задает имя командного проекта, параметры сопоставления которого требуется изменить. Если имя содержит пробелы, следует заключить его в кавычки.
/mappingfile: MappingFile	Задает имя и путь к файлу сопоставления.

Изменение способа сопоставления полей рабочих элементов с проектом

Откройте окно командной строки на компьютере, где установлен Microsoft Project и Team Explorer или TFS, и введите:
```
cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\12.0
```
Совет

Компонент Microsoft Project не требуется для загрузки файла сопоставления, однако он необходим для его отправки.
Введите следующую команду, чтобы загрузить файл сопоставления.
```
TFSFieldMapping download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile
```
Совет

Если имя содержит пробелы, заключите его в кавычки.
Откройте файл сопоставления в текстовом редакторе или в редакторе XML.
Добавьте новые или измените существующие сопоставления, используя следующий формат:
```
<Mapping WorkItemTrackingFieldReferenceName="System.Id" 
   ProjectField=""
   ProjectName=""
   ProjectUnits=""
   PublishOnly=""
   IfSummaryRefreshOnly=""/>
```
Например, чтобы добавить дополнительные поля планирования в командный проект, созданный на основе шаблона процесса Scrum, добавьте следующие сопоставления:
```
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.FinishDate" ProjectField="pjTaskFinish" PublishOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.OriginalEstimate" ProjectField="pjTaskBaselineWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
```
Шаблон Scrum по умолчанию включает сопоставление только одного поля "Оставшаяся работа" с Project.

Примечание

Полный список всех значений полей Office Project для атрибута ProjectField см. в разделе Сопоставление полей в Microsoft Project.
(Дополнительно) укажите, что поле подлежит публикации, но не обновлению. Добавьте атрибут PublishOnly в раздел сопоставлений для этого поля и задайте для него значение true. Этот атрибут можно использовать, чтобы разрешить членам команды просматривать значение поля, но не изменять его в Team Foundation.
(Дополнительно) укажите, каким образом сводные задачи будут обновляться в Project. Добавьте атрибут fSummaryRefreshOnly="true", чтобы указать, что поле не публикуется в базе данных рабочих элементов, однако обновляется из базы данных рабочих элементов, если строка для этого поля представляет собой сводную задачу в Project, для сводной задачи задано значение Publish and Refresh=Yes и она содержит по крайней мере одну дочернюю задачу, публикуемую в TFS.

Сохраните и отправьте файл:

TFSFieldMapping upload /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

См. также

Ссылки

Сопоставление полей в Microsoft Project

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

Настройка файла сопоставления полей Microsoft Project

Поделиться через