Compartir a través de

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

  • Artículo

Para poder sincronizar los datos entre Visual Studio Team Foundation Server (TFS) y Microsoft Project Server, 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 empresarial 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 la configuración y las 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 mediante las siguientes opciones de la herramienta de 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 enviados 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 TFS y Project Server. Para obtener información general sobre cómo asociar un proyecto empresarial a un proyecto de equipo, vea Administrar la asociación de proyectos empresariales a proyectos de equipo.

Para usar la herramienta de línea de comandos TfsAdmin ProjectServer, abra una ventana del símbolo del sistema donde se haya instalado Visual Studio o Team Explorer y escriba:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

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

Requisitos

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 TFS y Project Server.

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 formato siguiente:

http://ServerName:Port/VirtualDirectoryName/CollectionName

Si no especifica un directorio virtual, especifique la dirección URL con el siguiente formato:

http://ServerName:Port/CollectionName

/teamProject:TeamProjectName

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 ágil como “User Story,Task” o “User Story”,Task. No incluya un espacio después de la coma.

/skipUIChanges

Establece que la pestaña Project Server del formulario de elemento de trabajo no se debe cambiar para los tipos especificados. Debe incluir esta marca si ha personalizado la pestaña Project Server correspondiente a los tipos afectados; de lo contrario, el comando MapWorkItemTypes no se 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 los 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, aunque uno o más elementos de trabajo de ese tipo se estén sincronizando actualmente.

/? o help

Muestra información sobre el comando.

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

Aparece otro mensaje 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 empresarial, se produce un error. Solo puede asignar los tipos de elemento de trabajo de los proyectos de equipo que estén 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 cuya asignación ha anulado.

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

Sugerencia

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

Ejemplos

Hacer una lista de los tipos de elemento de trabajo asignados

En el siguiente ejemplo se recuperan los tipos de elementos de trabajo configurados para participar en la sincronización del proyecto de equipo Contoso de 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 los casos de usuario y las tareas para que participen 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

Vea también

Conceptos

Especificar los tipos de elementos de trabajo que se van a sincronizar

Asignar componentes de integración [TfsAdmin ProjectServer]

Otros recursos

Personalizar la asignación de campos entre TFS y Project Server