Administrar los tipos de elementos de trabajo disponibles para la sincronización

Para poder sincronizar los datos entre Visual Studio Team Foundation Server 2012 y el Servidor Microsoft Project , debe configurar la integración de los dos productos de servidor.Como parte de las tareas de configuración, debe asociar un plan de proyecto de empresa a un proyecto de equipo, y debe especificar los tipos de elementos de trabajo que participarán en la sincronización.Después de realizar sus configuraciones y asignaciones iniciales, puede cambiar los tipos de elementos de trabajo que están asignados.

Puede administrar los tipos de elementos de trabajo que participan en la sincronización utilizando las siguientes opciones de la herramienta de la línea de comandos TfsAdmin ProjectServer:

• /MapWorkItemTypes: define los tipos de elementos de trabajo que pueden participar en la sincronización de un proyecto de equipo.Aunque puede asignar varios tipos, solo se sincronizan los elementos de trabajo que se envían para publicar.

• /GetMappedWorkItemTypes: devuelve la lista de tipos de elemento de trabajo configurados para participar en la sincronización de un proyecto de equipo.

• /UnmapWorkItemTypes: impide que los tipos de elemento de trabajo participen en la sincronización de un proyecto de equipo.

Para obtener información general sobre cómo integrar los dos productos de servidor, vea Configurar la integración de Team Foundation Server y Project Server.Para obtener información general sobre cómo asociar un proyecto de empresa a un proyecto de equipo, vea Administrar la asociación de proyectos empresariales a proyectos de equipo.

Para utilizar la herramienta de línea de comandos TfsAdmin ProjectServer , 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)%..

Permisos necesarios

Para utilizar estos comandos, el permiso Administrar la integración de Project Server debe estar establecido en Permitir.Asimismo, se deben conceder a la cuenta de servicio de Team Foundation Server los permisos necesarios para interactuar con la instancia de PWA que participará en la sincronización de datos.Para obtener más información, vea Asignar permisos para la integración de Team Foundation Server y Project Server.

[!NOTA]

Incluso si ha iniciado sesión con permisos administrativos, debe abrir una ventana de símbolo del sistema con privilegios elevados para ejecutar esta función en un servidor que ejecute Windows Server 2008.Para abrir una ventana del símbolo del sistema con privilegios elevados, elija Inicio, abra el menú contextual para Símbolo del sistema y, a continuación, elija Ejecutar como administrador.Para obtener más información, vea la página siguiente en el sitio web de Microsoft: Control de cuentas de usuario.

Sintaxis

TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:tpcUrl teamProject:TeamProjectName

TfsAdmin ProjectServer /MapWorkItemTypes /collection:tcpUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/skipUIChanges]

TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:tpcUrl /teamProject:TeamProjectName /workItemTypes:ListOfWorkItemTypes [/force]

Parámetros

Parámetro	Descripción
/collection:tpcUrl	Especifica el localizador uniforme de recursos (URL) de la colección de proyectos de equipo.Especifique la dirección URL con el siguiente formato: http://NombreServidor:Puerto/NombreDirectorioVirtual/NombreColección Si no especifica un directorio virtual, debe especificar la dirección URL con el formato siguiente: http://NombreServidor:Puerto/NombreColección
/teamProject:nombreDeProyectoDeEquipo	Especifica el nombre de un proyecto de equipo definido en la colección de proyectos.
/workItemTypes:ListofWorkItemTypes	Especifica, en una lista delimitada por comas, los nombres de referencia de uno o más tipos de elementos de trabajo.Solo debería especificar los tipos de elementos de trabajo cuyos datos desea seguir en Project Professional.Por ejemplo, puede especificar los siguientes tipos de elementos de trabajo para admitir un proceso de Agile como "Caso de usuario, Tarea" o "Caso de usuario", Tarea.No incluya un espacio después de la coma.
/skipUIChanges	Especifica que la pestaña Project Server del formulario de elemento de trabajo no se debería cambiar para los tipos especificados.Debe incluir este marcador si ha personalizado la pestaña Project Server para los tipos afectados o el comando MapWorkItemTypes no puede completar.Puede actualizar manualmente una definición de tipo.Para obtener más información, vea Elementos XML agregados a la definición del tipo de elemento de trabajo.
/force	Quita todos los vínculos que enlazan elementos de trabajo de los tipos especificados a tareas en Project.Si utiliza esta opción, puede impedir que algunos tipos de elementos de trabajo participen en la sincronización de datos, aun cuando uno o más elementos de trabajo de ese tipo se estén sincronizando actualmente.
/? o help	Muestra información sobre el comando.

Volver al principio

Comentarios

Al ejecutar un comando, aparece un mensaje que indica qué acción se realiza y en qué objeto.Por ejemplo, el siguiente mensaje indica que los casos de usuario y las tareas se están configurando para participar en la sincronización de datos.

Configuring synchronization for the following work item types for team project ProjA: User Story, Task. . . 

Otro mensaje aparece cuando el comando finaliza.Por ejemplo, el siguiente mensaje indica que se han configurado correctamente los casos de usuario y las tareas.

You have successfully configured the following work item types for team project ProjA: User Story, Task.

Además de configurar los tipos de elementos de trabajo que pueden participar en la sincronización, el comando /MapWorkItemTypes realiza las siguientes operaciones:

• Agrega los tipos de elementos de trabajo que especifique al conjunto de tipos que participan en la sincronización de datos.Es decir, el comando no desasigna ningún tipo asignado existente.

• Agrega la pestaña Project Server a los formularios de los tipos de elementos de trabajo especificados.

  Si una pestaña Project Server ya está definida para un tipo de elemento de trabajo especificado, se omite ese tipo y no se realiza ningún cambio en los formularios de los elementos de trabajo de ese tipo.

Si intenta asignar los tipos de elemento de trabajo de un proyecto de equipo que no está asociado a un plan de proyecto de empresa, un error aparece.Solo puede asignar tipos de elemento de trabajo para los proyectos de equipo configurados para participar en la sincronización.Para obtener más información, vea Administrar la asociación de proyectos empresariales a proyectos de equipo.

Si quita la asignación de un tipo de elemento de trabajo, la pestaña Project Server se quita del formulario de ese tipo para el proyecto de equipo no asignado.

Antes desasignar un tipo de elemento de trabajo de un proyecto de equipo, debería eliminar las tareas del plan de proyecto de empresa para quitar todas las asociaciones entre éstas y los elementos de trabajo de Team Foundation.Después de eliminar las tareas del plan de proyecto empresarial, debe publicarlo y esperar la sincronización para completar.Como alternativa, puede especificar la marca /force para quitar todos los vínculos que enlazan elementos de trabajo a tareas del proyecto de equipo.Solo a los elementos de trabajo que son de los tipos especificados se les impide que participen en la sincronización.

Sugerencia
Si elimina las tareas, puede que desee copiarlas primero en otro plan para mantener un registro de ellas.

Volver al principio

Ejemplos

Enumerar los tipos de elemento de trabajo que están asignados

El ejemplo siguiente recupera los tipos de elementos de trabajo configurados para participar en la sincronización del proyecto de equipo de Contoso en DefaultCollection en AdventureWorksServer.

TfsAdmin ProjectServer /GetMappedWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /teamproject:Contoso

Asignar un tipo de elemento de trabajo para un proyecto de equipo

En el siguiente ejemplo se configuran casos de usuario y tareas para participar en la sincronización de datos del proyecto Contoso.

TfsAdmin ProjectServer /MapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:”User Story, Task”

Quitar la asignación de un tipo de elemento de trabajo de un proyecto de equipo

En el siguiente ejemplo se impide que las tareas participen en la sincronización de datos del proyecto Contoso.

TfsAdmin ProjectServer /UnmapWorkItemTypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ /teamProject:Contoso /workitemtypes:Task

Volver al principio

Vea también

Conceptos

Especificar los tipos de elemento de trabajo que se pueden sincronizar

Administrar la integración de Project Server y TfsAdmin ProjectServer

Otros recursos

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