Personalizar las asignaciones de campos entre Team Foundation Server y Project Server

Para sincronizar los datos entre un plan de proyecto empresarial y un proyecto de equipo, debe asociar los campos de elemento de trabajo de Visual Studio Team Foundation Server 2010 a los campos de Microsoft Project Server 2007 o Project Server 2010. Puede agregar campos y especificar cómo se sincronizan si personaliza las asignaciones de campos. Puede asignar campos de Project integrados y personalizados. Por ejemplo, puede compartir los datos no relacionados con las programaciones (como centros de costos, nombres de equipo o estado de mantenimiento) si agrega los campos que almacenan estos tipos de datos a las asignaciones.

Se mantiene un conjunto de asignaciones de campos para cada colección de proyectos de equipo que hospeda los proyectos de equipo que desea sincronizar con Project Server. Debe definir las asignaciones de campos para cada colección de proyectos de equipo que ha asignado a una instancia de Project Web Access o Project Web App (PWA). Puede cargar las asignaciones predeterminadas o puede personalizar un archivo de asignación y cargarlo. Para cargar las asignaciones predeterminadas, vea Cargar asignaciones, más adelante en este tema.

Precaución
Las asignaciones para la integración de Team Foundation Server y Project Server son distintas de la asignación de archivos de Microsoft Project. Para obtener más información, vea El archivo de asignaciones de campo en Microsoft Project.

Tal como muestra la siguiente ilustración, las asignaciones se personalizan en cinco pasos:

Personalizar las asignaciones de campos entre Team Foundation Server y Project Server

Importante
Puede actualizar el archivo de asignación tan a menudo como desee. Los campos que aparecen en la pestaña Project Server se actualizan para cada tipo de elemento de trabajo que participa en la sincronización de datos. No debe cambiar manualmente las definiciones de la pestaña Project Server. Para obtener más información, vea Personalizar la pestaña Project Server, más adelante en este tema.

En este tema

• Asignaciones predeterminadas

• Determinar los campos adicionales que se van a asignar

• Descargar las asignaciones en un archivo

• Actualizar las asignaciones

• Cargar las asignaciones

• (Opcional) Personalizar la pestaña Project Server

Permisos necesarios

Para completar los procedimientos de este tema, debe tener el permiso Administrar la integración de Project Server establecido en Permitir. Además, se debe conceder el permiso Administrar la integración de Project Server a la cuenta de servicio de Team Foundation Server. Para obtener más información, vea Asignar permisos para la integración de Team Foundation Server y Project Server.

Asignaciones predeterminadas

Las asignaciones determinan qué campos se sincronizan cuando un usuario actualiza información en Team Foundation o Project Server. Cada uno de los siguientes tipos de sincronización tiene su propio conjunto de asignaciones:

• En la sincronización de la publicación, los datos de Project Server actualizan los datos de Team Foundation. Use el elemento de targetToTfs para especificar el campo de Project Server que actualice el campo de Team Foundation.

• En la sincronización de estado, los datos de Team Foundation se envían a la cola de estado de Project Server. Puede usar el elemento tfsToTarget para especificar el campo que actualiza el campo de cola de estado en Project Server.

Para obtener más información acerca de estos dos tipos de sincronización, vea Información general sobre el proceso de sincronización para la integración de Team Foundation Server y Project Server.

En la siguiente tabla se hace una lista del conjunto predeterminado de campos asignados entre Team Foundation y Project Server. La tabla también indica qué tipos de elemento de trabajo utilizan los campos basados en las tres plantillas de proyecto para Microsoft Solutions Framework (MSF). No debe modificar estas asignaciones si está asignando a un proyecto de equipo que se creó utilizando una plantilla de proceso basada en Agile Software Development v5.0 o Capability Maturity Model Integration (CMMI) Process Improvement v5.0. Si está asignando a un proyecto de equipo que se creó utilizando la plantilla de procesos Scrum 1.0, tendrá que hacer algunas modificaciones como se describe en Modificar las asignaciones de campos cuando se asignan a un proyecto de equipo que se creó con la plantilla de procesos Scrum 1.0 más adelante en este tema.

Para obtener más información sobre las asignaciones y el proceso de sincronización, vea Administrar las asignaciones de referencias de elementos XML para la integración de Team Foundation Server y Project Server.

Volver al principio

Agregar los campos a los tipos de elemento de trabajo al asignar a un proyecto de equipo que se creó a partir de la plantilla de proceso de Scrum 1.0.

Porque la plantilla de proceso Scrum 1.0 no utiliza el Trabajo completado y estimado, debe agregar estos campos a los tipos de elemento de trabajo que desea que tomen parte en la sincronización de datos. Por ejemplo, puede agregar los campos no usados al tipo de elemento de trabajo de tarea.

Para agregar estos campos, debe exportar el tipo de elemento de trabajo de tarea del proyecto de equipo, y para cada campo, agregue un elemento FIELD en la sección FIELDS. También puede agregar un elemento Control en la sección FORM. Puede agregar los elementos FIELD siguientes:

<FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum">
   <HELPTEXT>The number of units of work that have been spent on this task</HELPTEXT>
</FIELD>
<FIELD name="Original Estimate" refname="Microsoft.VSTS.Scheduling.OriginalEstimate" type="Double" reportable="measure" formula="sum">
   <HELPTEXT>Initial value for Remaining Work - set once, when work begins. </HELPTEXT>
</FIELD>

Puede agregar los elementos Control siguientes:

<Control FieldName="Microsoft.VSTS.Scheduling.OriginalEstimate" Type="FieldControl" Label="Original Estimate:" LabelPosition="Left" />
<Control FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Type="FieldControl" Label="Completed:" LabelPosition="Left" />

Para obtener más información, vea Exportar e importar tipos de elemento de trabajo desde un proyecto existente, Definir campos de elementos de trabajo y Diseñar y personalizar un formulario de elementos de trabajo.

Volver al principio

Determinar los campos adicionales que se van a asignar

Determine la siguiente información para cada campo que desea sincronizar además de los campos predeterminados:

• Nombre de referencia del campo en Team Foundation. Si desea sincronizar un campo en Project Server con un campo que debe crear en Team Foundation, primero cree el campo en cada tipo de elemento de trabajo que vaya a sincronizar. Para obtener más información, vea Usar campos del sistema y campos definidos por las plantillas de proceso de MSF y Definir campos de elementos de trabajo.

• Nombre del campo de Project Server que actualizará el campo de Team Foundation. Para obtener una lista de campos disponibles, vea Restricciones en la asignación de campos de Project Server para la integración con Team Foundation Server.

• Se actualizará el nombre del campo que va a actualizarse en Project Server y el nombre del campo en Project Server que actualizará el campo reflejo en Team Foundation Server.

• Si desea mostrar los campos del formulario de elemento de trabajo. Establezca el valor del atributo displayTfsField en true para los campos que desea que aparezcan en el formulario del elemento de trabajo. Tiene que establece el valor del atributo displayTfsMirror en true para el formulario.

• Si desea resolver los conflictos de datos permitiendo que el valor del campo de Team Foundation sobrescriba el valor del campo de Project Server, o mantener ambos valores. Esta decisión determina el valor del atributo onConflict. Cuando se establece onConflict=”PsWins”, el valor de campo en Project Server sobrescribe el valor de campo en Team Foundation. Para obtener más información, vea Elementos y atributos de campos.

• Valores adicionales que debe definir para admitir listas de selección o tablas de búsqueda personalizadas en Project Server.

Volver al principio

Restricciones en los datos que puede asignar

Después de determinar qué desea asignar, tenga en cuenta las siguientes restricciones:

• Solo puede enviar la información de la capa de tarea, campos pjTask *, de Project Server a Team Foundation Server.

• Solo puede enviar la información de la capa de recurso, campos pjResource *, de Team Foundation Server a la cola de estado de Project Server.

• El campo Título es el único campo que puede enviar tanto a Team Foundation Server como a la cola de estado.

• El consolidado se calcula automáticamente para los campos Asignado a, Trabajo completado y Trabajo restante. No puede asignar campos adicionales y calcular su consolidado. Para obtener más información, vea Trabajar con consolidación de recursos en planes de proyectos empresariales asignados a proyectos de equipo.

• Debe asegurarse de que los tipos de datos o las unidades de cada campo que asigna cumplen los criterios de la asignación de campos para los campos de empresa estándar y personalizados. Para obtener más información, vea "Tipos de datos y criterios de asignación de campos" en Restricciones en la asignación de campos de Project Server para la integración con Team Foundation Server.

• Puede asignar los campos que están asociados a listas de selección en Team Foundation. Sin embargo, debe crear tablas en Project Server que coincidan con las listas de selección. No puede sincronizar automáticamente listas de selección y tablas de búsqueda.

Para obtener más información, vea Restricciones en la asignación de campos de Project Server para la integración con Team Foundation Server.

Volver al principio

Ejemplo: Asignar el nombre del equipo para mostrarlo en Project

En el siguiente ejemplo, el campo de cadena personalizado de Team Foundation, MyCompany.MyOrg.DevTeamName, está asignado a un campo de texto personalizado de empresa en Project Server, pjMyCompanyTeamName. Puede utilizar este ejemplo para mostrar en Project Professional el nombre del equipo que está asociado a una tarea.

<field tfsName="MyCompany.MyOrg.DevTeamName" tfsMirrorName="Mirror.MyCompany.MyOrg.DevTeamName" displayTfsField="false" displayTfsMirror="false" onConflict="DoNothing">
   <tfsToTarget>
   v<target provider="ProjectServerStatusQueue" name=" pjMyCompanyTeamName" />
   </tfsToTarget>
   <targetToTfs>
      <target provider="ProjectServerPublished" name=" pjMyCompanyTeamName" />
   </targetToTfs>
</field>

Ninguno de estos campos aparece en el formulario de elemento de trabajo. Además, si los valores no coinciden, cada campo retiene su propio valor.

Volver al principio

Ejemplo: Mostrar las rutas de acceso de iteración y área en Project

Puede asignar los campos de Área (System.AreaPath) e Iteración (System.IterationPath) de Team Foundation para que estén visibles en los planes del proyecto. Dado que estos campos de ruta de acceso de árbol sufren cambios frecuentes, debe asignarlos como campos de texto de Project. Los administradores de proyecto que utilizan estos campos deben escribir la ruta de acceso del área o la ruta de acceso de iteración manualmente.

Importante

La implementación actual de la integración de Visual Studio Team Foundation Server 2010 y Project Server no admite la sincronización automática de listas de valores permitidas, listas de selección, listas globales o listas de rutas de acceso de árbol que se definen para los campos asignados entre los dos productos de servidor. Para que la experiencia sea óptima, debe realizar entradas manuales en el plan del proyecto que coincidan con las de Team Foundation. Si especifica una entrada que es no válida, aparecerá un cuadro de diálogo de validación al publicar el plan.

Para agregar los campos Área e Iteración a un plan de proyecto, realice las siguientes acciones:

1. Agregue dos campos de empresa de cliente a Project Server y etiquételos como Área (TFS) e Iteración (TFS).

   Para obtener más información, vea la siguiente página del sitio web de Microsoft: Creating Lookup Tables and Enterprise Custom Fields.

2. Exporte las asignaciones de campos de la colección de proyectos de equipo donde se definen los proyectos de equipo.

   Para obtener más información, vea Descargar las asignaciones en un archivo más adelante en este tema.

3. Agregue el código siguiente al archivo:

   <field tfsName="System.AreaPath" tfsMirrorName="Mirror.System.AreaPath" displayTfsField="true" displayTfsMirror="true">
           <tfsToTarget>
             <target provider="ProjectServerStatusQueue" name="Area (TFS)" />
           </tfsToTarget>
           <targetToTfs>
             <target provider="ProjectServerPublished" name="Area (TFS)" />
           </targetToTfs>
         </field>
         <field tfsName="System.IterationPath" tfsMirrorName="Mirror.System.IterationPath" displayTfsField="false" displayTfsMirror="false">
           <tfsToTarget>
             <target provider="ProjectServerStatusQueue" name="Iteration (TFS)" />
           </tfsToTarget>
           <targetToTfs>
             <target provider="ProjectServerPublished" name="Iteration (TFS)" />
           </targetToTfs>
         </field>
   

4. Importe el archivo de asignaciones de campos actualizado como se describe en Actualizar asignaciones más adelante en este tema.

5. Sincronice el plan del proyecto con Project Server.

6. Agregue las dos nuevas columnas para los nuevos campos, Área (TFS) e Iteración (TFS), al plan del proyecto

Los cambios realizados en los campos Área e Iteración en Team Foundation se sincronizarán con estos campos en el plan del proyecto. También puede actualizar estos campos en Project y publicar los cambios en Team Foundation si especifica valores que se han definido en Team Foundation.

Volver al principio

Descargar las asignaciones en un archivo

Para descargar las asignaciones en un archivo

1. En un equipo que ejecute Team Explorer y tenga instalado el Service Pack 1 para Visual Studio Team Foundation Server 2010, abra una ventana del símbolo del sistema y cambie al directorio que contiene la herramienta de la línea de comandos TFSAdmin.

   De forma predeterminada, la herramienta se encuentra en Unidad:\Archivos de programa\Microsoft Visual Studio 10.0\Common7\IDE. En equipos de 64 bits, la herramienta se encuentra en Unidad:\Archivos de programa (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

2. En un símbolo del sistema, escriba el comando siguiente y, a continuación, presione ENTRAR.

   TfsAdmin ProjectServer /DownloadFieldMappings /collection:tpcUrl /filepath:MappingFile 
   

   Reemplace tpcUrl con el localizador uniforme de recursos (URL) de la colección de proyectos de equipo y reemplace MappingFile con la ruta de acceso y el nombre del archivo que va a personalizar.

3. Espere hasta que aparezcan los mensajes siguientes:

   Descargando MappingFile en la colección de proyectos de equipo tpcUrl.

   Se ha descargado correctamente el archivo de asignación de campos MappingFile en la colección de proyectos de equipo tpcUrl.

Volver al principio

Actualizar las asignaciones

Para cada campo que desea agregar al archivo de asignación, especifique el elemento field y sus subelementos y atributos. Para obtener más información, vea Administrar las asignaciones de referencias de elementos XML para la integración de Team Foundation Server y Project Server.

Volver al principio

Cargar las asignaciones

Las asignaciones se cargan mediante el comando UploadFieldMappings. Puede cargar las asignaciones predeterminadas mediante la opción /usedefaultfieldmapping. De lo contrario, debe especificar un archivo que contenga los elementos de asignación.

Para cargar las asignaciones predeterminadas

1. En un símbolo del sistema, escriba el comando siguiente y, a continuación, presione ENTRAR.

   TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /usedefaultfieldmappings
   

   Reemplace tpcUrl con la dirección URL de la colección de proyectos de equipo.

2. Espere hasta que aparezcan los mensajes siguientes:

   Cargando las asignaciones de campos predeterminadas en CollectionUri.

   Se han cargado correctamente las asignaciones de campos en la colección CollectionUri.

Para cargar las asignaciones de un archivo

1. En el símbolo del sistema, escriba el siguiente comando y, a continuación, presione ENTRAR.

   TfsAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filepath:MappingFile /force
   

   Reemplace tpcUrl con la dirección URL de la colección de proyectos de equipo y reemplace MappingFile con la ruta de acceso y el nombre del archivo de asignación personalizado. Especifique /force si va a actualizar las asignaciones existentes.

2. Espere hasta que aparezcan los mensajes siguientes:

   Cargando MappingFile en la colección de proyectos de equipo tpcUrl.

   Se ha cargado correctamente el archivo de asignación de campos MappingFile en la colección de proyectos de equipo tpcUrl.

Volver al principio

Personalizar la pestaña Project Server

Al asociar un plan de proyecto empresarial a un proyecto de equipo, la pestaña Project Server se agrega al formulario de elemento de trabajo, tal como muestra la siguiente ilustración. La pestaña solo se agrega a aquellos tipos de elemento de trabajo que se hayan especificado para participar en la sincronización de datos. Para personalizar esta pestaña establezca los atributos displayTfsField o displayTfsMirror en true para esos campos que desea que aparezcan en el formulario.

Pestaña Project Server

Importante

Las asignaciones de campos que se definen para la colección de proyectos de equipo determinan los campos que aparecen en la pestaña Project Server. Una vez agregada esta pestaña a un tipo de elemento de trabajo para un proyecto de equipo, se puede actualizar si se modifican las asignaciones de campos de la colección. Si personaliza el formulario de elemento de trabajo manualmente agregando los campos a la pestaña Project Server o cambiando su ubicación en el formulario, la pestaña no puede ser automáticamente actualizada con cambios futuros que haga en las asignaciones de campos. Si esta condición se produce, puede modificar la pestaña manualmente.

Para obtener más información sobre cada campo predeterminado que aparece en la pestaña Project Server, vea Campos de Project Server agregados para admitir la sincronización de datos.

Volver al principio

Vea también

Otros recursos

Especificar los tipos de elementos de trabajo que se pueden sincronizar

Configurar la integración de Team Foundation Server y Project Server

Administrar la integración de Team Foundation Server y Project Server