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


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

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

В файле сопоставления задайте поля для каждого командного проекта.Чтобы извлечь файл сопоставления, необходимо загрузить его из командного проекта.После внесения изменений файл отправляется в командный проект, и изменения применяются ко всем пользователям этого проекта.Дополнительные сведения см. в разделе Изменение сопоставления полей с Microsoft Project.

Содержание раздела

  • Элемент сопоставления

  • Элемент ReservedField

  • Элемент SyncField

  • Элемент ResourceNameSeparator

  • Иерархический тип связи

  • Тип связи зависимости

  • Атрибуты элемента Mapping, влияющие на публикацию и обновление

Элемент сопоставления

Для определения сопоставления между полем рабочего элемента и столбцом проекта используется элемент Mapping.

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

<Mapping WorkItemTrackingFieldReferenceName="" 
         ProjectField=""
         ProjectName=""
         ProjectUnits=""
         PublishOnly="">
         IfSummaryRefreshOnly=""/>

ms404686.collapse_all(ru-ru,VS.110).gifАтрибуты

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

Атрибут

Описание

WorkItemTrackingFieldReferenceName

Обязательное.Задает ссылочное имя поля в типе рабочего элемента.

ProjectField

Обязательное.Определяет имя поля Microsoft Project.Имена предварительно определенных полей следует указывать с помощью префикса "pj". Так, например, для столбца "Имя поля" имя поля будет "pjTaskName".Пользовательские поля необходимо задавать в виде pjTaskText, за которым следует число, например pjTaskText11.

ProjectName

Необязательный параметр.Определяет имя, отображаемое как имя столбца в Microsoft Project.Если данный атрибут не задан, используется имя поля типа рабочего элемента.

ProjectUnits

Необязательный параметр.Определяет тип единиц, используемых при сопоставлении типа поля с приложением Microsoft Project.Можно указать следующие значения: pjMinute, pjHour, pjDay, pjWeek и pjMonthUnit.

ПримечаниеПримечание
Атрибут ProjectUnits можно задавать только для полей, указывающих продолжительность времени и другие единицы измерения времени.

PublishOnly

Необязательный параметр.Если для этого атрибута установлено значение true, поле публикуется в базе данных рабочих элементов, но не обновляется.Данное значение обычно используется для вычисляемых полей, которые не должны обновляться в средстве Team Explorer.Если для этого атрибута установлено значение false, поле и публикуется, и обновляется в базе данных рабочих элементов.Значение по умолчанию — false.

В файле сопоставления по умолчанию два поля, имеющие атрибут PublishOnly со значением true, — это Дата начала и Дата окончания.

IfSummaryRefreshOnly

Необязательный параметр.Если атрибуту задано значение true, это означает, что поле не публикуется в базе данных рабочих элементов, но обновляется из базы данных рабочих элементов, когда следующие атрибуты также имеют значение true:

  • Строка для поля представляет собой суммарную задачу в Office Project.

  • Атрибуты Publish и Refresh суммарной задачи имеют значение Yes.

  • Суммарная задача включает, как минимум, одну дочернюю задачу, связанную с Team Foundation Server.

Любые обновления или вычисления, выполняемые Microsoft Project, могут переписать значение, обновляемое из базы данных рабочих элементов плана проекта. Однако измененное значение в базе данных рабочих элементов не сохраняется.Этот атрибут, как правило, используется для сводных полей, которые при публикации в базе данных рабочих элементов приводят к несогласованности данных.

Если для этого атрибута установлено значение false, поле может быть и опубликовано, и обновлено в базе данных рабочих элементов.Если атрибут не указывается, по умолчанию используется значение false.

ПримечаниеПримечание
Значение, присвоенное атрибуту IfSummaryRefreshOnly, вытесняет значение, присвоенное атрибуту PublishOnly.Дополнительные сведения см. в подразделе Поля, влияющие на публикацию и обновление ниже.

В файле сопоставления по умолчанию атрибут IfSummaryRefreshOnly имеет значение true для полей Исходная оценка, Оставшиеся затраты и Завершенная работа.

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

<Mapping WorkItemTrackingFieldReferenceName="System.Title" 
         ProjectField="pjTaskName"/>

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

<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true"/>
ПримечаниеПримечание

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

К началу

Элемент ReservedField

Элемент ReservedField обеспечивает поддержку иерархических связей, определенных между задачами и дополнительным элементом.

Если этот элемент не указан в сопоставлении, то Microsoft Project использует поле pjNumber20, определенное по умолчанию.

К началу

Элемент SyncField

Поле синхронизации позволяет управлять поведением публикации и обновления для каждой задачи.Если используется представление Лист задач Team System, это поле отображается в виде столбца с заголовком Публикация и обновление.

Указание поля синхронизации в файле сопоставления полей Microsoft Project является обязательным.Используйте следующий синтаксис XML, чтобы определить, какое поле является полем синхронизации.Для указания поля синхронизации используйте элемент SyncField.Атрибут ProjectField должен задаваться для допустимого поля Office Project.

<SyncField ProjectField="" />

В следующем примере показано, как задать pjTaskText25 в качестве поля синхронизации.

<SyncField ProjectField="pjTaskText25" />

Дополнительные сведения об использовании поля синхронизации в Office Project см. в разделе Публикация или обновление рабочих элементов в Office Project.

К началу

Элемент ResourceNameSeparator

С помощью ResourceNameSeparator можно определить символ, разделяющий имена ресурсов в строке.Пользователи и ресурсы Team Foundation синхронизируются с пользователями службы каталогов Active Directory.Имена пользователей и ресурсов могут включать разделители, например, запятые, отделяющие имя, фамилию и отчество ресурса.

Это необязательный элемент.Если элемент не указан в сопоставлении, то Microsoft Project разделяет имена ресурсов с помощью сопоставлений, заданных по умолчанию, которые описаны в следующей таблице:

Если в Active Directory и списке командного проекта используется разделитель...

он в Office Project заменяется на...

,

;

;

:

.

:

Чтобы указать другой символ, не указанный в таблице, определите параметр ResourceNameSeparator с помощью следующего синтаксиса:

<ResourceNameSeparator WorkItemTrackingCharacter="" ProjectCharacter=""/>

В следующем примере показано, как задать символ "*" (звездочка) в качестве разделителя в Office Project, когда в Team Foundation используется символ "-" (дефис):

<ResourceNameSeparator WorkItemTrackingCharacter="-" ProjectCharacter="*"/>

К началу

Иерархический тип связи

При создании суммарных задач в Microsoft Project создаются древовидные связи между суммарной задачей, родительской задачей и подчиненными или дочерними задачами.Для создания данных связей Office Project по умолчанию использует System.LinkTypes.Hierarchy.

К началу

Тип связи зависимости

При создании связей между задачами в Microsoft Project между ними создаются зависимые связи.Задаче-предшественнику присваивается ссылка Predecessor, а задаче-последователю присваивается ссылка Successor.Существуют назначения по умолчанию, определенные для типа связи System.LinkTypes.Dependency.

К началу

Атрибуты элемента Mapping, влияющие на публикацию и обновление

Следующие поля сопоставления и значения полей Microsoft Project определяют, публикуется рабочий элемент или обновляется:

  • Значение Публикация и обновление для каждого рабочего элемента.

  • Значение атрибута PublishOnly для конкретного поля сопоставления.

  • Значение атрибута IfSummaryRefreshOnly для конкретного поля сопоставления.

  • Классификация задачи как сводной или родительской.

    Родительская задача — это задача, имеющая минимум одну дочернюю задачу, опубликованную в Team Foundation Server.

Для рабочих элементов, не являющихся сводными задачами

В следующей таблице указано, выполняется ли публикация или обновление рабочего элемента, не являющегося сводным или родительским, на основании атрибутов полей сопоставления и значении, присвоенном полю Публикация и обновление данного элемента.

Публикация и обновление

(уровень задачи)

Атрибут PublishOnly

Поле опубликовано?

Поле обновлено?

Нет

True или False.

Нет

Нет

Только обновление

True или False.

Нет

Да

Да

True

Да

Нет

Да

False

Да

Да

Для рабочих элементов, являющихся сводными задачами

Если условия суммарных задач выполняются и атрибут IfSummaryRefreshOnly имеет значение true, его значение вытесняет значение PublishOnly.В следующей таблице указано, выполняется ли публикация или обновление сводной или родительской задачи на основании атрибутов поля сопоставления и значения, присвоенного полю Публикация и обновление.

Публикация и обновление

(уровень задачи)

Атрибут PublishOnly

IfSummaryRefreshOnly

Атрибут

Поле опубликовано?

Поле обновлено?

Нет

True или False.

True или False.

Нет

Нет

Только обновление

True

True

Нет

Да

Только обновление

True

False

Нет

Да

Только обновление

False

True или False.

Нет

Да

Да

True или False.

True

Нет

Да

Да

True

False

Да

Нет

Да

False

False

Да

Да

К началу

См. также

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

Справочник по элементу "Тип ссылки"

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