Сопоставление полей Microsoft Project полям Team Foundation
Можно настроить способ сопоставления полей рабочих элементов, хранящихся в 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, поле публикуется в базе данных рабочих элементов, но не обновляется.Данное значение обычно используется для вычисляемых полей, которые не должны обновляться в средстве Team Explorer.Если для этого атрибута установлено значение false, поле и публикуется, и обновляется в базе данных рабочих элементов.По умолчанию для этого атрибута задано значение false. По умолчанию значение true задано только для данного атрибута свойств Дата начала и Дата окончания. |
IfSummaryRefreshOnly |
Необязательный.Если атрибуту задано значение true, это означает, что поле не публикуется в базе данных рабочих элементов, но обновляется из базы данных рабочих элементов, если соблюдены следующие условия.
Любые обновления или вычисления, выполняемые 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