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 en Visual Studio Team Foundation Server 2012 con los campos de Microsoft Project Server.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 (TFS) 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

[!NOTA]

Para obtener un vídeo de la demostración, vea la siguiente página en el sitio Web de Microsoft: Administrar las asignaciones de campos para la integración de Team Foundation Server y 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 elementos de trabajo utilizan campos basados en plantillas de proceso predeterminadas que TFS proporciona.No debe modificar estas asignaciones si está asignando a un proyecto de equipo creado a partir de una plantilla de proceso basada en Agile o el proceso Process Integration (CMMI) de Maturity model la capacidad.Si está asignando a un proyecto de equipo que se creó con la plantilla de procesos scrum, necesitará crear algunas modificaciones mientras el Los cambios necesarios para crear Cuando que asignaba a un proyecto de equipo Que se creó a partir de la plantilla de procesos scrum se describe 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.

Campo de Team Foundation	Campo de Project Server	Campo Cola de estado	Tipos de elemento de trabajo de Agile	Tipos de elemento de trabajo de CMMI	Tipos de elemento de trabajo de Scrum
Título	Nombre de tarea	Título	Todos	Todos	Todos
Asignado a	Recursos	Recursos	Todos	Todos	Todos
Trabajo completado	Trabajo real de la tarea	Trabajo real del recurso	Tarea	Tarea	None
Trabajo restante	Trabajo restante de la tarea	Trabajo restante del recurso	Tarea	Tarea	Tarea
Estimación original	Trabajo de línea base		Tarea	Error, solicitud de cambio, problema, requisito, riesgo y tarea	None
Fecha de inicio	Inicio de la tarea	Inicio del recurso	Tarea y caso de usuario	Tarea y requisito	None
Fecha de fin	Fin de la tarea	Fin del recurso	Tarea y caso de usuario	Tarea y requisito	None

Volver al principio

Cambios necesarios para crear cuando asigna a un proyecto de equipo que se creó con la plantilla de procesos scrum

Hay dos cambios que debe realizar para habilitar el flujo de datos de un proyecto de equipo creado de un scrum 2,0 o una plantilla de procesos scrum 1,0.Debe agregar el trabajo completado y campos estimación original del tipo de elemento de trabajo de tarea, y se deben quitar los elementos que requieren el campo trabajo restante estar vacío cuando un miembro del equipo cambia el estado a Hecho o a Quitado.

Para actualizar la definición de tipo de tarea de scrum

1. Abra una ventana símbolo del sistema donde Visual Studio o Team Explorer se instala y activa:

   cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
   

   En una edición de 64 bits de Windows, reemplace %programfiles% con %programfiles(x86)%.

2. Para exportar la definición de tipo para la tarea, escriba el comando siguiente, sustituya los datos de los argumentos que se muestran aquí, donde CollectionURL especifica la dirección URL de una colección de proyectos de equipo, ProjectName especifican el nombre de un proyecto de equipo definido en la colección, y “DirectoryPath \FileName .xml” especifica el nombre y la ubicación para el archivo exportar.A continuación Entrar.

   witadmin exportwitd /collection: /p:"ProjectName" /n:"Task" /f:"DirectoryPath\FileName.xml"
   

3. En un editor de texto o en Visual Studio, abra el archivo exportado.

4. Dentro de la sección de definición de FIELDS, agregue este fragmento de código antes del elemento para el trabajo restante:

   <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>
   

5. Dentro de la sección de <WORKFLOW>, quite el siguiente fragmento de código de <STATE value="Done"> y las definiciones de <STATE value="Removed">:

   <FIELD refname="Microsoft.VSTS.Scheduling.RemainingWork">
      <EMPTY />
   </FIELD>
   

6. Dentro de la sección de <FORM>, agregue los siguientes elementos de Control:

   <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" />
   

7. Guarde y cierre el archivo.

8. Importe el archivo, sustituyendo sus datos por los argumentos que se muestran.

   witadmin importwitd /collection: /p:"ProjectName" /f:"DirectoryPath\FileName.xml"
   

9. Actualice el proyecto de equipo o la página de elementos de trabajo de comprobar los cambios.

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 Referencia de campos de elementos de trabajo para Visual Studio ALM 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 Field Elements and Attributes.

• 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 personalizado en Team Foundation, MyCompany.MyOrg.DevTeamName de la cadena, se asigna a un campo de texto personalizado en Project Server, el nombre de empresa de equipo de la compañía.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>
   <target provider="ProjectServerStatusQueue" name=" My Company Team Name" />
   </tfsToTarget>
   <targetToTfs>
      <target provider="ProjectServerPublished" name=" My Company Team Name" />
   </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 Team Foundation Server 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="true" displayTfsMirror="true">
           <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

[!NOTA]

Solo puede descargar las asignaciones de una colección de proyectos de equipo en la que se han cargado.Si desea descargar las asignaciones predeterminadas en un archivo, debe cargar primero las asignaciones predeterminadas, tal como se describe en Para cargar las asignaciones predeterminadas, más adelante en este tema.Como alternativa, puede copiar el contenido de las asignaciones predeterminadas.Para obtener más información, vea Default Field Mappings.

Para descargar las asignaciones en un archivo

1. Para ejecutar la herramienta de línea de comandos TfsAdmin, abra una ventana de símbolo del sistema donde Visual Studio o Team Explorer está instalado y escriba:

   cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
   

   En una edición de 64 bits de Windows, reemplace %programfiles% con %programfiles(x86)%..

2. Escriba el siguiente comando, y 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:

   DescargandoMappingFileen la colección de proyectos de equipotpcUrl.

   Se ha descargado correctamente el archivo de asignación de camposMappingFileen la colección de proyectos de equipotpcUrl.

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 el símbolo del sistema, escriba el siguiente comando 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 enCollectionUri.

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

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:

   CargandoMappingFileen la colección de proyectos de equipotpcUrl.

   Se ha cargado correctamente el archivo de asignación de camposMappingFileen la colección de proyectos de equipotpcUrl.

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, vea Elementos XML agregados a la definición del tipo de elemento de trabajo.

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

Tareas

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

Conceptos

Especificar los tipos de elemento de trabajo que se pueden sincronizar

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