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. .gif "Nota") 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 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.
.gif "Gg412643.collapse_all(es-es,VS.110).gif")
Notas 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.
.gif "Nota importante") 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 Data Types and Field Mapping Criteria. |
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/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"
Cargar 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 la integración de Project Server y TfsAdmin ProjectServer
Otros recursos
Personalizar las asignaciones de campos entre Team Foundation Server y Project Server