El archivo de asignaciones de campo en Microsoft Project
Actualización: noviembre 2007
El archivo de asignaciones de campo de Microsoft Project define las asignaciones de campos entre los campos de Team Foundation y de Microsoft Project. A diferencia de Microsoft Excel, Microsoft Project utiliza un conjunto limitado de campos que incluyen campos predefinidos como Nombre de tarea y los 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 campo se utiliza para determinar los campos de la base de datos de elementos de trabajo que coinciden con los de Microsoft Project.
El archivo de asignaciones de campos se especifica por proyecto de equipo. Para recuperar este archivo de asignaciones de campos, debe descargarlo de un proyecto de equipo. Después de realizar los cambios, lo carga en el proyecto de equipo y los cambios se aplican a todos los usuarios de ese proyecto de equipo. Para obtener más información sobre cómo descargar o cargar el archivo de asignaciones de campos de Microsoft Project, vea Cómo: Descargar o cargar un archivo de asignaciones de campo en Microsoft Project.
Asignaciones de campos
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 campos.
<Mapping WorkItemTrackingFieldReferenceName=""
ProjectField=""
ProjectName=""
ProjectUnits=""
PublishOnly=""/>
Asignar atributos
La tabla siguiente describe los atributos que se pueden utilizar con el elemento Asignación.
Atributo |
Descripción |
|---|---|
WorkItemTrackingFieldReferenceName |
Obligatorio. Especifica el nombre de referencia de un campo de tipo de elemento de trabajo. |
ProjectField |
Obligatorio. 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 se va a mostrar como el nombre de columna al usuario. Si no se 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. Los valores validos son pjMinute, pjHour, pjDay, pjWeek y pjMonthUnit. |
PublishOnly |
Opcional. Si se establece el valor en true, se indica que el campo se publica en la base de datos de elementos de trabajo, pero no se actualiza. Este valor se suele usar para campos calculados que no se deben actualizar en Team Explorer. Si se establece el valor en no, se indica que el campo se publica y actualiza. El valor genérico cuando no se especifica es no. |
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"/>
.gif "Nota") Nota: |
|---|
Como procedimiento recomendado, debe asignar los campos calculados de Microsoft Project a campos de sólo lectura de Team Foundation. De esta forma, ayuda a evitar confusiones para que los miembros del equipo no intenten cambiar los campos calculados. |
Campo de contexto
El campo de contexto es un campo de tipo de elemento de trabajo que muestra información sobre la relación jerárquica de una tarea con las tareas de resumen. El campo de contexto se muestra en Team Explorer para que los usuarios que no estén usando Microsoft Project puedan seguir viendo las tareas de resumen a las que pertenece una subtarea.
Cuando una tarea es una subtarea, el campo de contexto contendrá el nombre de texto de la tarea y el nombre de texto de su tarea de resumen. Por ejemplo, si la tarea "Plan de prueba de desarrollo" es una subtarea de "Tareas planeadas", en el campo de contexto se leería "Tareas de planeación > Plan de prueba de desarrollo". Si una tarea tiene más de 1 tarea de resumen por encima de ella, todas las tareas de resumen se muestran en el campo de contexto hasta el límite de número máximo de caracteres.
Utilice la sintaxis XML siguiente para especificar el campo de tipo de elemento de trabajo que es el campo de contexto. El elemento ContextField se utiliza para especificar un campo de contexto. El valor del atributo WorkItemTrackingFieldReferenceName se debe establecer en un nombre de referencia válido de un campo de tipo de elemento de trabajo existente.
<ContextField WorkItemTrackingFieldReferenceName="" />
En el siguiente ejemplo, se muestra cómo especificar Microsoft.VSTS.Scheduling.TaskHierarchy como el campo de contexto.
<ContextField WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.TaskHierarchy" />
Vínculos y campo de datos adjuntos
Los vínculos y el campo de datos adjuntos constituyen un campo de sólo lectura que indica si existen vínculos y datos adjuntos para una tarea. El campo muestra Sí o No en función de si hay vínculos y datos adjuntos. El campo se muestra como columna con el título Vínculos y datos adjuntos cuando use la vista Hoja de tareas de Team System.
Utilice la sintaxis XML siguiente para especificar el campo de Microsoft Project que debe mostrar los vínculos y la información de los datos adjuntos. El elemento LinksField se utiliza para especificar un campo de vínculo. El valor del atributo ProjectField se debe establecer en un campo de Microsoft Project válido. Especificar un campo de vínculo es opcional en el archivo de asignaciones de campos de Microsoft Project.
<LinksField ProjectField="" />
En el siguiente ejemplo, se muestra cómo especificar pjTaskText26 como el campo de vínculos y archivos adjuntos:
<LinksField ProjectField="pjTaskText26" />
Campo de sincronización
El campo de sincronización permite controlar la publicación y actualizar el comportamiento de cada tarea. El campo se muestra como columna con el título Publicar y actualizar cuando use la vista Hoja de tareas de Team System. Para obtener más información sobre cómo utilizar el campo de sincronización de Microsoft Project, vea Cómo: Habilitar o deshabilitar la publicación de elementos de trabajo en Microsoft Project.
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. El elemento SyncField se utiliza para especificar un campo de sincronización. El valor del atributo ProjectField se debe establecer en un campo de Microsoft Project válido.
<SyncField ProjectField="" />
En el ejemplo siguiente, se muestra cómo especificar pjTaskText25 como el campo de sincronización:
<SyncField ProjectField="pjTaskText25" />