Personalizar el archivo de asignación de campos de Microsoft Project

Artículo
06/09/2015

Puede personalizar la forma en que los campos de elemento de trabajo que están definidos en Team Foundation se asignan a los campos de Microsoft Project, y puede cambiar cómo se publican campos específicos. Microsoft Project incluye campos predefinidos, como el de nombre de tarea, y campos personalizados. Al publicar o actualizar los datos de elemento de trabajo en Microsoft Project, la asignación de campo determina qué campos de la base de datos de elementos de trabajo coinciden con los campos de Microsoft Project.

Para obtener información sobre el uso de Project y TFS para el seguimiento de trabajo, consulte Crear un registro de trabajo pendiente y tareas mediante Project.

Para modificar las asignaciones de campos de un proyecto de equipo, el archivo de asignación de Microsoft Project se exporta y se importa mediante la herramienta de línea de comandos TFSFieldMapping.

elemento Mapping

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

Use 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 usa luego para especificar una asignación de campo.

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

Atributos

En la siguiente tabla se describen los atributos que también pueden usarse con el elemento Mapping.

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 en Microsoft Project. Especifique los nombres de campos predefinidos agregando el prefijo "pj" al nombre, como pjTaskName para la columna de nombre de la tarea. Especifique los campos personalizados, como pjTaskText, seguidos de un número, como pjTaskText11.

ProjectName

Opcional. Especifica el nombre que aparece como el nombre de columna en Microsoft Project. Si no se especifica este atributo, se usa el nombre del campo del tipo de elemento de trabajo.

ProjectUnits

Opcional. Especifica el tipo de unidades que se usa al asignar un tipo de campo a Microsoft Project. Puede especificar los siguientes valores: pjMinute, pjHour, pjDay, pjWeek y pjMonthUnit.

Nota
ProjectUnits solo se puede especificar para campos que indican la duración de tiempo u otras unidades de tiempo.

PublishOnly

Opcional. Si se establece en true, indica que el campo se publica en la base de datos de elementos de trabajo, pero no se actualiza. Este valor se usa normalmente para los campos calculados que no deben actualizarse en Team Explorer. Si se establece en 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 cuyo atributo PublishOnly está establecido en true son Fecha de inicio y Fecha de finalización.

IfSummaryRefreshOnly

Opcional. Si se establece en true, indica que el campo nunca se publica en la base de datos de elementos de trabajo, pero sí se actualiza en esa base de datos cuando se cumple lo siguiente:

La fila correspondiente al campo es una tarea de resumen de Office Project.
La tarea de resumen tiene los valores de publicación y actualización 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 nunca se guarda en la base de datos. Este atributo se usa normalmente para campos de resumen que, si se publican en la base de datos de elementos de trabajo, dan lugar a incoherencias de los datos.

Si se establece en false, indica que el campo puede publicarse y actualizarse. El valor predeterminado cuando no se especifica es false.

Nota
El valor que se asigna al atributo IfSummaryRefreshOnly reemplaza al valor que se asigna a PublishOnly.Para obtener más información, consulte Campos que afectan a la publicación y 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 nombre de tarea de Microsoft Project:

<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. Dado que es un campo calculado, se especifica que se publique pero sin actualizarse; así se evitan los errores debidos a las actualizaciones de Team Explorer.

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

Nota
Como práctica recomendada, asigne campos calculados de Microsoft Project a campos de solo lectura de Team Foundation.Esto ayuda a evitar confusiones para que los miembros del equipo no intenten cambiar los campos calculados.

Elemento ReservedField

El elemento ReservedField es opcional y sirve para admitir vínculos jerárquicos definidos entre las tareas.

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

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 una 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 asignación de campos de Microsoft Project. Use la sintaxis XML siguiente para especificar qué campo es el campo de sincronización. Para especificar un campo de sincronización, use el elemento SyncField. El atributo ProjectField debe establecerse en un campo válido de Office Project.

<SyncField ProjectField="" />

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

<SyncField ProjectField="pjTaskText25" />

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

Elemento ResourceNameSeparator

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

Este elemento es opcional. Si no se especifica en la asignación, Microsoft Project separa los nombres de los recursos mediante el uso de las asignaciones predeterminadas que se definen en la tabla siguiente:

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

Si desea especificar un carácter distinto de los enumerados en la tabla anterior, puede definir ResourceNameSeparator mediante la sintaxis siguiente:

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

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

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

Tipo de vínculo de jerarquía

Al crear 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 usa el valor predeterminado System.LinkTypes.Hierarchy para crear estos vínculos.

Tipo de vínculo de dependencia

Cuando cree vínculos entre las tareas de Microsoft Project, cree también un vínculo dependiente entre las tareas. A la tarea predecesora se le asigna un vínculo de predecesor y a la tarea sucesora se le asigna un vínculo de sucesor. Estas son las designaciones predeterminadas que se definen para el tipo de vínculo System.LinkTypes.Dependency.

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 se publica o se actualiza un valor de un elemento de trabajo:

El valor de Publicar y actualizar para cada elemento de trabajo.
El valor del atributo PublishOnly para 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 principal.

Una tarea principal es la que tiene al menos una tarea secundaria publicada en Team Foundation Server.

Para elementos de trabajo que no son tareas de resumen

En la tabla siguiente se indica si un elemento de trabajo que no es una tarea de resumen o principal se publica o se actualiza en función de los atributos del campo de asignación y la asignación que se realiza en 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 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 PublishOnly. En la tabla siguiente se indica si una tarea de resumen o principal se publica o se actualiza según la asignación que se realiza en su valor Publicar y actualizar en los atributos de 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í

Vea también

Conceptos

Referencia de elemento de tipo de vínculo

Agregar o cambiar la asignación de campos de Project a campos de TFS

Compartir a través de