Administrar las asignaciones de campos para la integración de Team Foundation Server y Project Server

Artículo
08/10/2011

Puede personalizar cómo se sincronizan los datos entre Visual Studio Team Foundation Server 2010 y Project Server modificando el archivo de asignación de campos. Este archivo define los campos de datos que se sincronizan y cómo se sincronizan para admitir la integración de Team Foundation Server y Project Server. Puede administrar este archivo utilizando las siguientes opciones de la herramienta de la línea de comandos TFSAdmin ProjectServer:

/DownloadFieldMappings: descarga el archivo de asignación de campos que se define para una colección de proyectos de equipo.
/UploadFieldMappings: valida la sintaxis XML del archivo de asignación de campos y lo carga en una colección. Para validar la sintaxis pero no cargar el archivo, puede utilizar la opción /validateonly.

Nota

El archivo de asignación de campos para la integración de Team Foundation Server y Project Server es distinto del archivo de asignación de campos de Microsoft Project. Para obtener información sobre cómo descargar o cargar el segundo archivo, vea TFSFieldMapping.

Para obtener más información sobre el contenido del archivo de asignación de campos y cómo personalizarlo, vea Administrar las asignaciones de referencias de elementos XML para la integración de Team Foundation Server y Project Server y Personalizar las asignaciones de campos entre Team Foundation Server y Project Server.

Para utilizar la herramienta de la línea de comandos TFSAdmin ProjectServer, abra una ventana del símbolo del sistema en un equipo que ejecute Team Explorer y Visual Studio Team Foundation Server 2010 Service Pack 1. Ejecute la herramienta desde el siguiente directorio: Unidad:\Program Files\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.

Permisos necesarios

Para utilizar estos comandos, su permiso Administrar la integración de Project Server debe estar establecido en Permitir para la colección de proyectos de equipo. Asimismo, se deben conceder a la cuenta de servicio de Team Foundation Server los permisos necesarios para interactuar con la instancia de Project Web Access o Project Web App (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 de símbolo del sistema con permisos elevados, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en 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 /DownloadFieldMappings /collection:tpcUrl /filepath:mappingFile [/encoding:encoding]

TFSAdmin ProjectServer /UploadFieldMappings /collection:tpcUrl /filePath:mappingFile [/encoding:encoding] [/validateOnly] [/useDefaultFieldMappings] [/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 el identificador URI con el formato siguiente: http://NombreServidor:Puerto/NombreColección
/filePath:mappingFile	Especifica la ruta de acceso y el nombre de archivo del archivo de definición XML que contiene las asignaciones de campos. Nota Si usa Windows Vista, es posible que no tenga permisos para acceder a determinadas carpetas.Si intenta exportar el tipo de elemento de trabajo a una ubicación para la que no tiene permisos, la tecnología de virtualización del Registro redirige automáticamente el archivo exportado y lo guarda en el almacén virtual.Para evitar esta redirección, puede exportar el archivo a una ubicación para la que tenga permisos. Para obtener más información sobre la virtualización del Registro, vea las siguientes páginas del sitio web de Microsoft: Virtualización del Registro y Common file and registry virtualization issues in Windows Vista.
/encoding:encoding	Especifica el nombre de un formato de codificación de .NET Framework 2.0. El comando exporta o importa los datos XML en el formato de codificación especificado. Por ejemplo, /e:utf-7 especifica la codificación Unicode (UTF-7). Si no especifica este parámetro, el comando intenta detectar la codificación y utiliza UTF-8 si se produce un error en la detección.
/validateOnly	Valida el archivo de asignación pero no lo carga.
/useDefaultFieldMappings	Carga las asignaciones de campos predeterminadas en lugar de un archivo de asignación personalizado. 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.
/force	Sobrescribe el archivo de asignación existente. Debe especificar esta opción si está reemplazando las asignaciones existentes por asignaciones diferentes.

Volver al principio

Comentarios

Solo puede asignar campos personalizados de empresa o campos que están integrados en Project Server. Debe especificar el nombre de un campo válido en Project. Para determinar el nombre de un campo integrado, quite cualquier espacio del nombre descriptivo y agregue el prefijo "pj" al resultado. Por ejemplo, el nombre de campo para Status Manager es pjStatusManager y el nombre de campo para Custom 01 es pjCustom01. Existen restricciones sobre cómo puede asignar campos personalizados e integrados, y debe hacer coincidir los tipos de datos de los campos. 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.

Al ejecutar un comando TFSAdmin ProjectServer, un mensaje indica la acción que se realiza y el objeto afectado. Por ejemplo, el siguiente mensaje indica que se descarga el archivo de asignación de campos:

Download field mappings from Collection0

Otro mensaje aparece una vez completadas las acciones de comando. Por ejemplo, el siguiente mensaje aparece cuando se ha descargado el archivo de asignación de campos:

You have downloaded field mappings to C:MappingFile. . . Done.

Notas sobre cómo cargar asignaciones de campos

Las siguientes acciones se producen al ejecutar la opción /UploadFieldMappings:

Si no se define ninguna asignación de campos para la colección de proyectos de equipo y no especifica la opción /useDefaultFieldMappings, un mensaje le solicita que cree una asignación de campos predeterminada.
Si existen asignaciones de campos y especifica la opción /useDefaultFieldMappings, un mensaje le pide que confirme si desea sobrescribir las asignaciones existentes.
Debe especificar la opción /force si desea sobrescribir las asignaciones de campos cargadas previamente en una colección.
El archivo de asignación de campos se valida antes de cargarse. Si tiene un error de sintaxis o si especificó un campo que es no válido, aparece un mensaje de error.

Si se carga un archivo de asignación de campos correctamente, se realizan las siguientes modificaciones:

Cada campo de reflejo de Team Foundation se configura para cumplir con los campos asignados.
Para los tipos de elemento de trabajo asignados para una colección o un proyecto de equipo, las nuevas asignaciones aparecen en la pestaña Project Server del formulario del elemento de trabajo.

Importante
Al asignar un campo de Team Foundation Server a Project Server, asegúrese de que coincide con los tipos de datos de esos campos. De lo contrario, el siguiente error podría producirse cuando intentar cargar las asignaciones de campos: El índice (basado en cero) debe ser mayor o igual a cero y menor que el tamaño de la lista de argumentos. Para obtener más información, vea Tipos de datos y criterios de asignación de campos.

Al asignar un campo de Team Foundation Server a Project Server, asegúrese de que coincide con los tipos de datos de esos campos. De lo contrario, el siguiente error podría producirse cuando intentar cargar las asignaciones de campos:

El índice (basado en cero) debe ser mayor o igual a cero y menor que el tamaño de la lista de argumentos.

Para obtener más información, vea Tipos de datos y criterios de asignación de campos.

Volver al principio

Ejemplos

Descargue el archivo de asignación de campos que se define para una colección de proyectos de equipo.

En el siguiente ejemplo se descargan las asignaciones de campos definidas para AdventureWorksCollection a AWMappingFile.xml.

TfsAdmin ProjectServer /DownloadFieldMappings /collection:http://AdventureWorksServer:8080/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Cargar el archivo de asignación de campos de una colección de proyectos de equipo

El siguiente ejemplo carga AWMappingFile.xml en AdventureWorksCollection y sobrescribe cualquier asignación de campos que se definiera previamente.

TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/Collection0/AdventureWorksCollection /filePath:"C:AWMappingFile.xml" /force

Volver al principio