Compartir a través de

Cargar o descargar el archivo de asignación de Microsoft Project [TFSFieldMapping]

  • Artículo

Use TFSFieldMapping para cargar y descargar el archivo de asignación de Microsoft Project. Este archivo controla la forma en que Microsoft Project publica tareas en un proyecto de equipo que se conecta a un servidor de Team Foundation Server (TFS) local. Por ejemplo, se puede modificar el archivo para que admita los campos que se hayan agregado a tipos de elemento de trabajo, o se puede modificar el modo de publicación y actualización de los campos existentes.

Se puede especificar qué campos de TFS se asignan a los campos de Project. También se puede controlar el comportamiento de publicación mediante el atributo PublishOnly y designar campos especiales como, por ejemplo, el campo de contexto. Para ver la sintaxis XML completa del archivo de asignaciones, vea el Personalizar el archivo de asignación de campos de Microsoft Project. Este archivo es el mismo que se definió en la plantilla de proceso utilizada para crear el proyecto de equipo. Vea Asignar campos de Microsoft Project a campos de Team Foundation.

La herramienta de línea de comandos TFSFieldMapping solo funciona cuando se ejecuta en un servidor de TFS local. Para ejecutar la herramienta, abra una ventana del símbolo del sistema donde se haya instalado Visual Studio o Team Explorer y escriba:

cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\14.0

Nota

Incluso si ha iniciado sesión con permisos administrativos, debe abrir un símbolo del sistema con privilegios elevados para ejecutar esta función en un servidor Windows Server 2008.Para abrir un símbolo del sistema con privilegios elevados, elija Inicio, abra el menú contextual de Símbolo del sistema y después elija Ejecutar como administrador.Para obtener más información, vea el sitio web de Microsoft.

Requisitos

Para usar el comando TFSFieldMapping, hay que ser miembro del grupo de seguridad Team Foundation Administrators o Project Administrators. Para obtener más información, vea Referencia de permisos para Team Foundation Server.

TFSFieldMapping upload | download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

Parámetros

Argumento

Descripción

upload | download

Especifica si se carga o se descarga el archivo de asignación de campos.

/collection:CollectionURL

Especifica el URI de la colección de proyectos de equipo con el siguiente formato: http://nombreDeServidor: puerto/nombreDeDirectorioVirtual/nombreDeColección.

Si no especifica que se use un directorio virtual, utilice el formato siguiente:

http://NombreDeServidor:Puerto/NombreDeColección

Si se ha conectado al servidor con anterioridad, puede especificar el nombre descriptivo del servidor en lugar del URI.

/teamproject: NombreDelProyecto

Especifica el nombre del proyecto de equipo cuyos parámetros de asignación se desean modificar. Si el nombre contiene espacios, escríbalo entre comillas.

/mappingfile: ArchivoDeAsignación

Especifica el nombre y la ruta del archivo de asignación.

Para cambiar el modo en que se asignan los campos de elementos de trabajo a Project

  1. Abra una ventana de símbolo del sistema donde se haya instalado Project y Team Explorer o TFS, y escriba:

    cd %programfiles%\Common Files\microsoft shared\Team Foundation Server\12.0

    Sugerencia

    No es necesario que Project descargue el archivo de asignación, pero, en cambio, sí es necesario que lo cargue.

  2. Escriba el comando siguiente para descargar el archivo de asignación:

    TFSFieldMapping download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

    Sugerencia

    Si un nombre contiene espacios, escríbalo entre comillas.

  3. Abra el archivo de asignación en un editor de texto o en un editor de XML.

  4. Use el formato siguiente para agregar asignaciones nuevas o editar las existentes:

    <Mapping WorkItemTrackingFieldReferenceName="System.Id" 
   ProjectField=""
   ProjectName=""
   ProjectUnits=""
   PublishOnly=""
   IfSummaryRefreshOnly=""/>

    Por ejemplo, para agregar campos de programación adicionales a un proyecto de equipo que se haya creado con una plantilla de proceso Scrum, agregue las asignaciones siguientes:

    <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.FinishDate" ProjectField="pjTaskFinish" PublishOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.OriginalEstimate" ProjectField="pjTaskBaselineWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />
<Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" />

    La plantilla Scrum predeterminada solo asigna el campo Trabajo restante a Project.

    Nota

    Para ver una lista completa de todos los valores de campo de Office Project correspondientes al atributo ProjectField, vea Asignaciones de campos en Microsoft Project.

  5. (Opcional) Indique si el campo se va a publicar sin actualizarse. Agregue el atributo PublishOnly a la sección de asignación de ese campo y establezca el atributo en true. Este atributo se puede usar para permitir que los miembros del equipo puedan ver un valor de campo, pero no modificarlo en Team Foundation.

  6. (Opcional) Indique cómo se van a actualizar las tareas de resumen en Project. Agregue el atributo fSummaryRefreshOnly="true" para indicar que el campo no se publica nunca en la base de datos de elementos de trabajo, pero sí se actualiza desde esa base de datos cuando la fila del campo es una tarea de resumen en Project, y dicha tarea tiene Publish and Refresh=Yes y contiene al menos una tarea secundaria que se publica en TFS.

  7. Guarde y cargue el archivo:

    TFSFieldMapping upload /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile

Vea también

Referencia

Asignaciones de campos en Microsoft Project

Conceptos

Personalizar el archivo de asignación de campos de Microsoft Project