Compartir a través de


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

Puede personalizar cómo se sincroniza datos entre Visual Studio Team Foundation Server 2012 y Microsoft 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 Cargar o descargar el archivo de asignación de Microsoft Project [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 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, 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 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 /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.

NotaNota
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 en la que tenga permisos. Para obtener más información, vea las páginas siguientes del sitio web de Microsoft: Virtualización del Registro y Problemas comunes de archivos y virtualización del registro en 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 se especifica el modificador /useDefaultFieldMappings cuando reemplaza las asignaciones existentes con diferentes asignaciones.

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 DefaultCollection

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.

Gg412643.collapse_all(es-es,VS.110).gifNotas sobre cómo cargar asignaciones de campos

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.

Nota importanteImportante

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 Data Types and Field Mapping Criteria.

Volver al principio

Ejemplos

Gg412643.collapse_all(es-es,VS.110).gifDescargue 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/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"

Gg412643.collapse_all(es-es,VS.110).gifCargar el archivo de asignación de campos de una colección de proyectos de equipo

El ejemplo siguiente carga AWMappingFile.xml a AdventureWorksCollection.

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

Volver al principio

Vea también

Tareas

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

Conceptos

Administrar las asignaciones de referencias de elementos XML para la integración de Team Foundation Server y Project Server

Restricciones en la asignación de campos de Project Server para la integración con Team Foundation Server

Administrar la integración de Project Server y TfsAdmin ProjectServer

Otros recursos

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