Сопоставление полей Microsoft Project полям Team Foundation

Статья
08/11/2011

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

В отличие от Microsoft Excel в приложении Microsoft Project используется ограниченный набор столбцов, включающих предопределенные столбцы, такие как "Название задачи", и пользовательские поля. Когда пользователь публикует или обновляет данные рабочего элемента в файле приложения Microsoft Project, с помощью сопоставления полей определяется, какие поля в базе данных рабочих элементов соответствуют столбцам в приложении Microsoft Project.

Сопоставления можно настраивать, например, для поддержки созданного поля или сопоставления полей предопределенным столбцам (а не пользовательским). Полная документация по файлу сопоставления полей Microsoft Project содержится в разделе Настройка сопоставления полей Microsoft Project.

Можно настроить сопоставление, изменив файл FileMapping.xml. В следующей таблице приведены имена файла, папки и подключаемого модуля для шаблонов процессов Microsoft Solutions Framework (MSF). Подключаемый модуль содержит определение задачи, отправляющей файл в коллекцию командного проекта.

Имя файла:

FileMapping.xml

Имя папки:

Классификация

Имя подключаемого модуля:

Microsoft.ProjectCreationWizard.Classification

Дополнительные сведения см. в разделе Определение начальных областей и итераций в подключаемом модуле классификации.

В этом разделе

Задание способа сопоставления полей
Задание полей, используемых для синхронизации, ссылок и приложений
Сопоставления полей по умолчанию

Задание способа сопоставления полей

Сопоставляемые поля задаются с использованием элемента Mapping и следующей синтаксической структуры.

<Mappings>
   <Mapping WorkItemTrackingFieldReferenceName="System.Id" 
            ProjectField=""
            ProjectName=""
         ProjectUnits=""
         PublishOnly=""
         IfSummaryRefreshOnly=""/>
</Mappings>

В следующей таблице описаны атрибуты элемента Mapping.

Атрибут	Описание
WorkItemTrackingFieldReferenceName	Обязательный. Задает ссылочное имя поля в типе рабочего элемента.
ProjectField	Обязательный. Задает имя столбца в Microsoft Project. Имена предопределенных столбцов следует указывать с помощью префикса «pj», например «pjTaskName» для столбца «Название задачи». Пользовательские поля необходимо задавать в виде pjTaskText, за которым следует число, например pjTaskText11.
ProjectName	Необязательный. Определяет имя, отображаемое для пользователя как имя столбца. Если данный атрибут не задан, используется имя поля в типе рабочего элемента.
ProjectUnits	Необязательный. Задает тип единиц, используемых при сопоставлении типа поля приложению Microsoft Project. Допустимые значения: pjMinute, pjHour, pjDay, pjWeek и pjMonthUnit.
PublishOnly	Необязательный. Если для этого атрибута задано значение true, поле публикуется в базе данных рабочих элементов, но не обновляется. Данное значение обычно используется для вычисляемых полей, которые не должны обновляться в средстве Сред. Командный обозреватель. Если для этого атрибута установлено значение false, поле и публикуется, и обновляется в базе данных рабочих элементов. По умолчанию для этого атрибута задано значение false. По умолчанию значение true задано только для данного атрибута свойств Дата начала и Дата окончания.
IfSummaryRefreshOnly	Необязательный. Если атрибуту задано значение true, это означает, что поле не публикуется в базе данных рабочих элементов, но обновляется из базы данных рабочих элементов, если соблюдены следующие условия. Строка для поля представляет собой суммарную задачу в Microsoft Project. Атрибуты Publish и Refresh суммарной задачи имеют значение Yes. Суммарная задача включает, как минимум, одну дочернюю задачу, связанную с Team Foundation Server. Любые обновления или вычисления, выполняемые Microsoft Project, могут переписать значение, обновляемое из базы данных рабочих элементов плана проекта. Однако измененное значение в базе данных рабочих элементов не сохраняется. Этот атрибут, как правило, используется для сводных полей, которые при публикации в базе данных рабочих элементов приводят к несогласованности данных. Если для этого атрибута установлено значение false, поле может быть и опубликовано, и обновлено в базе данных рабочих элементов. По умолчанию для этого атрибута задано значение false. Примечание Значение атрибута IfSummaryRefreshOnly заменяет значение атрибута PublishOnly.Дополнительные сведения см. в разделе Файл сопоставления полей Microsoft Project. По умолчанию атрибут IfSummaryRefreshOnly имеет значение true для полей Исходная оценка, Оставшиеся трудозатраты и Завершенная работа.

Задание полей, используемых для синхронизации, ссылок и приложений

Способ синхронизации полей и поле, поддерживающее ссылки и вложения, определяется еще двумя элементами, помимо Mapping.

Элемент SyncField задает, какой столбец используется в качестве поля синхронизации. Поле синхронизации имеет название "Опубликовать и обновить" и позволяет пользователю указать, является ли строка задач публикуемой или только обновляемой.

Следующий XML-синтаксис используется, чтобы указать, какой столбец сопоставляется с полем синхронизации. Для атрибута ProjectField необходимо задать действительный столбец в Microsoft Project.

<SyncField ProjectField="" />

Элемент LinksField задает столбец с ссылками и вложениями. Столбец ссылок и вложений позволяет пользователям указывать, существуют ли ссылки или вложения в определенной строке задач.

Следующий XML-синтаксис используется для того, чтобы задать, какой столбец сопоставляется с полем ссылок и вложений. Для атрибута ProjectField необходимо задать действительный столбец в Microsoft Project.

<LinksField ProjectField="" />

Сопоставления полей по умолчанию

В следующем примере показано, как в шаблоне процесса MSF для гибкой разработки программного обеспечения поля рабочих элементов сопоставляются столбцам в приложении Microsoft Project.

<?xml version="1.0" encoding="utf-8"?>
<MSProject>
  <Mappings>
    <Mapping WorkItemTrackingFieldReferenceName="System.AreaPath" ProjectField="pjTaskOutlineCode9" />
    <Mapping WorkItemTrackingFieldReferenceName="System.AssignedTo" ProjectField="pjTaskResourceNames" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Id" ProjectField="pjTaskText10" ProjectName="Work Item ID" />
    <Mapping WorkItemTrackingFieldReferenceName="System.IterationPath" ProjectField="pjTaskOutlineCode10" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Reason" ProjectField="pjTaskText14" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Rev" ProjectField="pjTaskText23" />
    <Mapping WorkItemTrackingFieldReferenceName="System.State" ProjectField="pjTaskText13" ProjectName="State" />
    <Mapping WorkItemTrackingFieldReferenceName="System.Title" ProjectField="pjTaskName" />
    <Mapping WorkItemTrackingFieldReferenceName="System.WorkItemType" ProjectField="pjTaskText24" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.Priority" ProjectField="pjTaskText19" ProjectName="Work Item Priority" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.StackRank" ProjectField="pjTaskNumber1" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="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.RemainingWork" ProjectField="pjTaskRemainingWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true" />
    <LinksField ProjectField="pjTaskText26" />
    <SyncField ProjectField="pjTaskText25" />
  </Mappings>
</MSProject>

См. также

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

Определение начальных областей и итераций в подключаемом модуле классификации

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

Настройка функциональных областей внутри шаблона процесса

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

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

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