El archivo de asignaciones de campo en Microsoft Project

Puede personalizar la correspondencia entre los campos definidos para los elementos de trabajo de Team Foundation y los campos de Microsoft Project, y puede cambiar el modo en que se publican determinados campos.En el archivo de asignación de campos para Microsoft Project, puede definir la correspondencia entre los campos de Team Foundation y Microsoft Project.Microsoft Project incluye campos predefinidos, como Nombre de tarea, y campos personalizados.Cuando se publican o actualizan los datos de los elementos de trabajo de un archivo de Microsoft Project, la asignación de campos determina la correspondencia entre los campos de la base de datos de elementos de trabajo y los campos de Microsoft Project.

En el archivo de asignación se especifican los campos de cada proyecto de equipo.Para recuperar el archivo de asignación de campos, debe descargarlo de un proyecto de equipo.Después de modificar el archivo, puede cargarlo en el proyecto de equipo; los cambios se aplican a todos los usuarios de ese proyecto de equipo.Vea Cambiar el método de asignación de campos a Microsoft Project.

En este tema

• Asignar elementos

• Elemento ReservedField

• Elemento SyncField

• Elemento ResourceNameSeparator

• Tipo de vínculo de jerarquía

• Tipo de vínculo de dependencia

• Asignación de atributos que afectan a la publicación y la actualización

Asignar elementos

Para especificar una asignación entre un campo de elemento de trabajo y una columna de proyecto, utilice el elemento Mapping.

Utilice la sintaxis XML siguiente para especificar una asignación entre un campo de tipo de elemento de trabajo y un campo de Microsoft Project.El elemento Mapping se utiliza para especificar una asignación de campo.

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

Atributos

En la siguiente tabla se describen los atributos que se pueden usar con el 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 un campo de Microsoft Project.Especifique los nombres de los campos predefinidos mediante el prefijo "pj" colocado delante del 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 aparecerá como nombre de columna en Microsoft Project.Si no especifica este atributo, se utiliza el nombre de campo del 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.Puede especificar los siguientes valores: pjMinute, pjHour, pjDay, pjWeek y pjMonthUnit. Nota Solamente puede especificar ProjectUnits en los campos que especifican duración de tiempo u otras unidades de tiempo.
PublishOnly	Opcional.Si su valor es true, 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.El valor predeterminado es false. En el archivo de asignación predeterminado, los dos campos con el atributo PublishOnly establecido en true son Fecha de inicio y Fecha de finalización.
IfSummaryRefreshOnly	Opcional.Si su valor es true, 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 Office Project. La tarea de resumen tiene los valores 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.El valor predeterminado cuando no se especifica es false. Nota El valor que se asigna al atributo IfSummaryRefreshOnly reemplaza el valor que se asigna a PublishOnly.Para obtener más información, vea Campos que afectan a la publicación y la actualización más adelante en este tema. En el archivo de asignación predeterminado, el atributo IfSummaryRefreshOnly está establecido en true para los campos Estimación original, Trabajo restante y Trabajo completado.

En el ejemplo siguiente, se muestra cómo asignar el campo de tipo de elemento de trabajo que contiene el título al campo de Microsoft Project de nombre de tarea:

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

La sintaxis XML siguiente muestra un ejemplo más complejo de cómo asignar el campo de tipo de elemento de trabajo que tiene la fecha de inicio al campo de fecha de inicio de Microsoft Project.Puesto que se calcula el campo, se especifica para publicar, pero no para actualizar con el fin de evitar que las actualizaciones de Team Explorer introduzcan errores.

<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true"/>

[!NOTA]

Como procedimiento recomendado, debe asignar los campos calculados de Microsoft Project a campos de solo lectura de Team Foundation.De esta forma, ayuda a evitar confusiones para que los miembros del equipo no intenten cambiar los campos calculados.

Volver al principio

Elemento ReservedField

El elemento ReservedField se usa para admitir los vínculos de jerarquía definidos entre las tareas y es un elemento opcional.

Si este elemento no se especifica en la asignación, Microsoft Project utiliza el campo pjNumber20 predeterminado.

Volver al principio

Elemento SyncField

El campo de sincronización permite controlar el comportamiento de publicación y actualización de cada tarea.El campo se muestra como columna con el título Publicar y actualizar cuando se usa la vista Hoja de tareas de Team System.

Debe especificar un campo de sincronización en el archivo de asignaciones de campos de Microsoft Project.Utilice la sintaxis XML siguiente para especificar el campo que es el campo de sincronización.Para especificar un campo de sincronización, utilice el elemento SyncField.El valor del atributo ProjectField se debe establecer en un campo de Office Project válido.

<SyncField ProjectField="" />

En el ejemplo siguiente, se muestra cómo especificar pjTaskText25 como el campo de sincronización:

<SyncField ProjectField="pjTaskText25" />

Para obtener más información sobre cómo utilizar el campo de sincronización de Office Project, vea Publicar o actualizar los elementos de trabajo en Office Project.

Volver al principio

Elemento ResourceNameSeparator

Puede utilizar ResourceNameSeparator para definir el carácter que distinguirá los nombres de recurso incluidos en una cadena.Los usuarios y los recursos de Team Foundation se sincronizan con los usuarios del servicio de directorio de Active Directory.Los nombres de usuarios y recursos pueden incluir un delimitador, como una coma, para separar el apellido, el nombre y la inicial de un recurso.

Es un elemento opcional.Si no se especifica este elemento en la asignación, Microsoft Project separa los nombres del recurso utilizando las asignaciones predeterminadas definidas en la siguiente tabla:

Si en Active Directory y en el proyecto de equipo el separador de lista es	Reemplazar en Office Project con
,	;
;	:
.	:

Si desea especificar un carácter diferente a los que se incluyen en la tabla anterior, puede definir ResourceNameSeparator utilizando la siguiente sintaxis:

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

En el siguiente ejemplo se muestra cómo especificar el carácter "*" como separador que se usará en Office Project cuando el carácter de Team Foundation es "-":

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

Volver al principio

Tipo de vínculo de jerarquía

Cuando se crean tareas de resumen en Microsoft Project, se crea un vínculo de árbol entre la tarea de resumen, el elemento primario y las tareas subordinadas o secundarias.Office Project utiliza la jerarquía predeterminada System.LinkTypes.Hierarchy para crear estos vínculos.

Volver al principio

Tipo de vínculo de dependencia

Cuando se crean vínculos entre las tareas en Microsoft Project, se crea un vínculo dependiente entre ellas.En la tarea predecesora se asigna un vínculo predecesor y la tarea sucesora un vínculo sucesor.Estas son las designaciones predeterminadas que se definen para el tipo de vínculo System.LinkTypes.Dependency.

Volver al principio

Asignación de atributos que afectan a la publicación y la actualización

Los siguientes campos de asignación y valores de campo de Microsoft Project determinan si el valor de un elemento de trabajo se publica o se actualiza:

• El valor de Publicar y actualizar de cada elemento de trabajo.

• El valor del atributo PublishOnly en un campo de asignación específico.

• El valor de IfSummaryRefreshOnly para un campo de asignación específico.

• La clasificación de la tarea como una tarea de resumen o primaria.

  Una tarea primaria es una tarea que tiene al menos una tarea secundaria que se publica en Team Foundation Server.

Para los elementos de trabajo que no son tareas de resumen

En la siguiente tabla se indica si un elemento de trabajo que no es una tarea de resumen ni primaria se publica o se actualiza en función de los atributos del campo de asignación y de la asignación que recibe el valor Publicar y actualizar del elemento.

Publicar y actualizar (nivel de tarea)	Atributo PublishOnly	¿Se publica el campo?	¿Se actualiza el campo?
No	True o False	No	No
Solo actualizar	True o False	No	Sí
Sí	True	Sí	No
Sí	False	Sí	Sí

Para los elementos de trabajo que son tareas de resumen

Si se cumplen los criterios de la tarea de resumen e IfSummaryRefreshOnly es true, su valor reemplaza al valor de PublishOnly.En la siguiente tabla se indica si una tarea de resumen o primaria se publica o se actualiza en función de la asignación que recibe su valor Publicar y actualizar y de los atributos del campo de asignación.

Publicar y actualizar (nivel de tarea)	Atributo PublishOnly	IfSummaryRefreshOnly Atributo	¿Se publica el campo?	¿Se actualiza el campo?
No	True o False	True o False	No	No
Solo actualizar	True	True	No	Sí
Solo actualizar	True	False	No	Sí
Solo actualizar	False	True o False	No	Sí
Sí	True o False	True	No	Sí
Sí	True	False	Sí	No
Sí	False	False	Sí	Sí

Volver al principio

Vea también

Conceptos

Referencia de elemento de tipo de vínculo

Personalizar las asignaciones de campos en Microsoft Project