Файл сопоставления полей Microsoft Project
Обновлен: Ноябрь 2007
Файл сопоставления полей Microsoft Project определяет сопоставления полей Team Foundation с полями Microsoft Project. В отличие от Microsoft Excel, в приложении Microsoft Project используется ограниченный набор полей, включающих предварительно определенные поля, такие как "Название задачи", и пользовательские поля. Если пользователь публикует или обновляет данные рабочего элемента в файле Microsoft Project, то с помощью сопоставления полей определяется, какие поля в базе данных рабочих элементов соответствуют полям в приложении Microsoft Project.
Файл сопоставления полей создается для каждого командного проекта. Чтобы извлечь файл сопоставления полей, необходимо загрузить его из командного проекта. После внесения изменений файл отправляется в командный проект, и изменения применяются ко всем пользователям этого проекта. Дополнительные сведения о загрузке и отправке файла сопоставления полей Microsoft Project см. в разделе Практическое руководство. Загрузка и отправка файла сопоставления полей Microsoft Project..
Сопоставления полей
Для определения сопоставления между полем рабочего элемента и столбцом проекта используется элемент Mapping.
Используйте следующий синтаксис XML, чтобы определить сопоставление между полем типа рабочего элемента и полем Microsoft Project. Для определения сопоставления полей используется элемент Mapping.
<Mapping WorkItemTrackingFieldReferenceName=""
ProjectField=""
ProjectName=""
ProjectUnits=""
PublishOnly=""/>
Атрибуты элемента "Mapping"
В следующей таблице описаны атрибуты, которые можно использовать с элементом Mapping.
Атрибут |
Описание |
|---|---|
WorkItemTrackingFieldReferenceName |
Обязательный. Определяет ссылочное имя поля типа рабочего элемента. |
ProjectField |
Обязательный. Определяет имя поля Microsoft Project. Имена предварительно определенных полей следует указывать с помощью префикса "pj". Так, например, для столбца "Имя поля" имя поля будет "pjTaskName". В конце имен пользовательских полей, таких как pjTaskText, указывайте номер (например, pjTaskText11). |
ProjectName |
Необязательный. Определяет имя столбца, отображаемое для пользователя. Если данный атрибут не определен, используется имя поля типа рабочего элемента. |
ProjectUnits |
Необязательный. Определяет тип единиц, используемых при сопоставлении типа поля с полями Microsoft Project. Допустимые значения: pjMinute, pjHour, pjDay, pjWeek и pjMonthUnit. |
PublishOnly |
Необязательный. Если для этого атрибута установлено значение true, поле публикуется в базе данных рабочих элементов, но не обновляется. Данное значение обычно используется для вычисляемых полей, которые не должны обновляться в Сред. Командный обозреватель. Если для этого атрибута установлено значение no, поле и публикуется, и обновляется в базе данных рабочих элементов. Если атрибут не указывается, по умолчанию используется значение no. |
В следующем примере кода показано, как сопоставить поле типа рабочего элемента, содержащее заголовок, с полем названия задачи Microsoft Project.
<Mapping WorkItemTrackingFieldReferenceName="System.Title"
ProjectField="pjTaskName"/>
Следующий синтаксис XML представляет более сложный пример того, как сопоставить поле типа рабочего элемента, содержащее дату начала, с полем даты начала Microsoft Project. Поскольку данное поле является вычисляемым, оно указывается для публикации, но не обновления, чтобы избежать ошибок, вызванных обновлениями Сред. Командный обозреватель.
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true"/>
.gif "Примечание") Примечание. |
|---|
Рекомендуется сопоставлять вычисляемые поля Microsoft Project с полями Team Foundation, предназначенными только для чтения. Это позволяет избежать путаницы, возникающей, когда участники группы пытаются изменять вычисляемые поля. |
Поле контекста
Поле контекста — это поле типа рабочего элемента, в котором отображаются данные об иерархической связи задачи со сводными задачами. Поле контекста отображается в Сред. Командный обозреватель, чтобы пользователи, которые не используют приложение Microsoft Project, все же могли определять, каким сводным задачам принадлежит та или иная подзадача.
Если задача является подзадачей, в поле контекста будут содержаться текстовое название задачи и текстовое название сводной задачи. Например, если задача "Разработка плана тестирования" является подзадачей "Задач планирования", в поле контекста будет отображаться следующий текст: "Задачи планирования > Разработка плана тестирования". Если задача принадлежит нескольким сводным задачам, в поле контекста будут перечислены все сводные задачи в пределах ограничения на число знаков.
Используйте следующий синтаксис XML, чтобы определить, какое поле типа рабочего элемента является полем контекста. Для указания на поле контекста используется элемент ContextField. Для атрибута WorkItemTrackingFieldReferenceName необходимо установить допустимое ссылочное имя существующего поля типа рабочего элемента.
<ContextField WorkItemTrackingFieldReferenceName="" />
В следующем примере показано, как задать поле Microsoft.VSTS.Scheduling.TaskHierarchy в качестве контекстного поля.
<ContextField WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.TaskHierarchy" />
Поле ссылок и вложений
Поле ссылок и вложений предназначено только для чтения. В нем указывается, предусмотрены ли для задачи ссылки и вложения. В зависимости от наличия ссылок и вложений, в этом поле отображаются значения Да или Нет. Если используется представление Лист задач Team System, это поле отображается в виде столбца с заголовком Ссылки и вложения.
Используйте следующий синтаксис XML, чтобы определить, в каком поле Microsoft Project должны отображаться сведения о ссылках и вложениях. Для указания на поле ссылок используется элемент LinksField. Атрибут ProjectField должен устанавливаться для допустимого поля Microsoft Project. Указание поля ссылок в файле сопоставления полей Microsoft Project является необязательным.
<LinksField ProjectField="" />
В следующем примере показано, как задать pjTaskText26 в качестве поля ссылок и вложений.
<LinksField ProjectField="pjTaskText26" />
Поле синхронизации
Поле синхронизации позволяет управлять поведением публикации и обновления для каждой задачи. Если используется представление Лист задач Team System, это поле отображается в виде столбца с заголовком Публикация и обновление. Дополнительные сведения об использовании поля синхронизации в Microsoft Project см. в разделе Пошаговое руководство. Включение и отключение публикации рабочих элементов в Microsoft Project.
Указание поля синхронизации в файле сопоставления полей Microsoft Project является обязательным. Используйте следующий синтаксис XML, чтобы определить, какое поле является полем синхронизации. Для указания на поле синхронизации используется элемент SyncField. Атрибут ProjectField должен устанавливаться для допустимого поля Microsoft Project.
<SyncField ProjectField="" />
В следующем примере показано, как задать pjTaskText25 в качестве поля синхронизации.
<SyncField ProjectField="pjTaskText25" />