Administrar las asignaciones de campos para la integración de TFS y Project Server
Puede personalizar la forma en que se sincronizan los datos entre Visual Studio Team Foundation Server (TFS) y Microsoft Project Server si modifica 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 TFS y Project Server. Puede administrar este archivo con las siguientes opciones de la herramienta de línea de comandos TfsAdmin ProjectServer:
/DownloadFieldMappings: descarga el archivo de asignación de campos definido 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 Referencia de elementos XML de asignación de campos para la integración de TFS y Project Server y Personalizar la asignación de campos entre TFS y Project Server.
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 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 TFS y Project Server.
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 formato siguiente: http://ServerName:Port/VirtualDirectoryName/CollectionName Si no especifica un directorio virtual, especifique el URI con el siguiente formato: http://ServerName:Port/CollectionName |
/filePath:mappingFile |
Especifica la ruta de acceso y el nombre del archivo de definición XML que contiene las asignaciones de campos. Nota Si usa Windows Vista, es posible que no tenga permisos de acceso para 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 del sitio web de Microsoft acerca de la virtualización del Registro y acerca de los problemas comunes de virtualización de archivos y 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 Referencia de elementos XML de asignación de campos para la integración de TFS y Project Server. |
/force |
Sobrescribe el archivo de asignación existente. Debe especificar esta opción si especifica el modificador /useDefaultFieldMappings cuando reemplaza las asignaciones existentes con diferentes asignaciones. |
Comentarios
Solo se pueden asignar los campos empresariales personalizados o los campos 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 asignar campos personalizados e integrados, y es necesario que los tipos de datos de los campos coincidan. Para obtener más información, vea Restricciones en la asignación de campos de Project Server para la integración de TFS y Project Server.
Al ejecutar un comando de TFSAdmin ProjectServer, un mensaje indica la acción que se realiza y el objeto al que afecta. Por ejemplo, el siguiente mensaje indica que se está descargando el archivo de asignación de campos:
Download field mappings from DefaultCollection
Aparece otro mensaje una vez completadas las acciones del 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
Si se carga un archivo de asignación de campos correctamente, se realizan las siguientes modificaciones:
Cada campo espejo 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.
Ejemplos
Descargar el archivo de asignación de campos definido para una colección de proyectos de equipo
En el siguiente ejemplo se descargan las asignaciones de campos definidas para AdventureWorksCollection en 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
En el ejemplo siguiente se carga AWMappingFile.xml en AdventureWorksCollection.
TfsAdmin ProjectServer /UploadFieldMappings /collection:http://AdventureWorksServer:8080/AdventureWorksCollection /filePath:"C:AWMappingFile.xml"
Vea también
Tareas
Configurar la integración de TFS y Project Server
Conceptos
Referencia de elementos XML de asignación de campos para la integración de TFS y Project Server
Asignar componentes de integración [TfsAdmin ProjectServer]
Otros recursos
Personalizar la asignación de campos entre TFS y Project Server