Asignar campos de Microsoft Project a campos de Team Foundation

Puede personalizar la manera en que se asignan los campos de elementos de trabajo almacenados en Team Foundation a los campos definidos para Microsoft Project.Puede cambiar la manera en que se publican campos específicos y designar el tipo de vínculo predeterminado que se usará al crear vínculos de jerarquía o de árbol y vínculos de dependencia.

A diferencia de Microsoft Excel, Microsoft Project utiliza un conjunto limitado de columnas, que incluyen columnas predefinidas, como Nombre de tarea, y campos personalizados.Cuando un usuario publica o actualiza los datos de los elementos de trabajo de un archivo de Microsoft Project, la asignación de campos determina qué campos de la base de datos de elementos de trabajo se corresponden con las columnas de Microsoft Project.

Se pueden personalizar las asignaciones, por ejemplo, para admitir un campo creado por el usuario o para asignar campos a columnas predefinidas en lugar de asignarlos a columnas personalizadas.Para obtener la documentación completa sobre el archivo de asignación de campos de Microsoft Project, vea Personalizar las asignaciones de campos en Microsoft Project.

Para personalizar la asignación, se debe modificar el archivo FileMapping.xml.En la siguiente tabla se resumen los nombres del archivo, la carpeta y el complemento de las plantillas de proceso de Microsoft Solutions Framework (MSF).El complemento contiene la definición de la tarea que carga el archivo en la colección de proyectos de equipo.

En este tema

• Especificar cómo se asignan los campos

• Especificar los campos utilizados para la sincronización, los vínculos y los datos adjuntos

• Asignaciones de campos predeterminadas

Especificar cómo se asignan los campos

Para especificar los campos asignados, se utilizan el elemento Mapping y la siguiente estructura sintáctica:

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

En la tabla siguiente, se describen los atributos del elemento Mapping.

Atributo	Descripción
WorkItemTrackingFieldReferenceName	Requerido.Especifica el nombre de referencia de un campo en un tipo de elemento de trabajo.
ProjectField	Requerido.Especifica el nombre de una columna de Microsoft Project.Especifique los nombres de columna predefinidos prefijando "pj" al nombre, como pjTaskName para la columna Nombre de tarea.Especifique los campos personalizados, como pjTaskText, seguidos de un número, como pjTaskText11.
ProjectName	Opcional.Especifica el nombre que se va a mostrar al usuario como el nombre de columna.Si no se especifica este atributo, se utiliza el nombre del campo en el tipo de elemento de trabajo.
ProjectUnits	Opcional.Especifica el tipo de unidades que se van a usar al asignar un tipo de campo a Microsoft Project.Los valores válidos son pjMinute, pjHour, pjDay, pjWeek y pjMonthUnit.
PublishOnly	Opcional.Si su valor es true, este atributo indica que el campo se publica en la base de datos de elementos de trabajo, pero no se actualiza.Este valor suele usarse para los campos calculados que no deben actualizarse en Team Explorer.Si su valor es false, indica que el campo se publica y se actualiza.De forma predeterminada, este atributo está establecido en false. De forma predeterminada, solo Fecha de inicio y Fecha de fin tienen este atributo establecido en true.
IfSummaryRefreshOnly	Opcional.Si su valor es true, este atributo indica que el campo no se publica nunca en la base de datos de elementos de trabajo pero se actualiza desde esta base de datos cuando se cumplen las siguientes condiciones: La fila del campo es una tarea de resumen en Microsoft Project. La tarea de resumen tiene los valores de Publicar y actualizar establecidos en Yes. La tarea de resumen contiene al menos una tarea secundaria que se enlaza a Team Foundation Server. Las actualizaciones o los cálculos que Microsoft Project realiza pueden sobrescribir el valor que se actualiza desde la base de datos de elementos de trabajo en el plan del proyecto.Sin embargo, el valor modificado no se guarda en la citada base de datos.Este atributo se utiliza normalmente en los campos de resumen que, si se publican en la base de datos de elementos de trabajo, producen incoherencias de los datos. Si su valor es false, indica que el campo se puede publicar y actualizar.De forma predeterminada, este atributo está establecido en false. Nota El atributo IfSummaryRefreshOnly reemplaza el atributo PublishOnly.Para obtener más información, vea El archivo de asignaciones de campo en Microsoft Project. De forma predeterminada, el atributo IfSummaryRefreshOnly está establecido en true para los campos Estimación original, Trabajo restante y Trabajo completado.

Especificar los campos para la sincronización, vínculos y datos adjuntos

Además del elemento Mapping, otros dos elementos determinan cómo se van a sincronizar los campos y qué campo va a admitir vínculos y datos adjuntos.

El elemento SyncField especifica qué columna actúa como campo de sincronización.El campo de sincronización se denomina "Publicar y actualizar" y permite al usuario indicar si se publica o solamente se actualiza una fila de la tarea.

Se usa la sintaxis XML siguiente para especificar qué columna se asigna al campo de sincronización.Se establece el atributo ProjectField en una columna válida de Microsoft Project.

<SyncField ProjectField="" />

El elemento LinksField especifica la columna de vínculos y datos adjuntos.Mediante esta columna, los usuarios pueden indicar si una fila concreta de la tarea tiene vínculos o datos adjuntos.

Se usa la sintaxis XML siguiente para especificar qué columna se asigna al campo de vínculos y datos adjuntos.Se establece el atributo ProjectField en una columna válida de Microsoft Project.

<LinksField ProjectField="" />

Asignaciones de campos predeterminadas

En el ejemplo siguiente, se muestra cómo la plantilla de proceso de MSF for Agile Software Development asigna los campos de los elementos de trabajo a columnas de 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>

Vea también

Conceptos

Definir las áreas e iteraciones iniciales en el complemento de clasificación

Personalizar las asignaciones de campos en Microsoft Project

El archivo de asignaciones de campo en Microsoft Project

Personalizar las áreas funcionales en una plantilla de proceso