Tareas de Team Foundation Build

Actualización: noviembre 2007

Las tareas de MSBuild están incluidas en destinos. Estas tareas proporcionan el código que se ejecuta durante el proceso de compilación. MSBuild proporciona una biblioteca de tareas comunes. Para obtener más información, vea Referencia de tareas de MSBuild.

El archivo .targets de MSBuild para Team Foundation Build, Microsoft.TeamFoundation.Build.targets, define varias tareas de Team Foundation Build predeterminadas que puede personalizar estableciendo las propiedades en el archivo TfsBuild.proj. Por ejemplo, el destino CoreGet contiene una tarea Get que permite recuperar un conjunto de cambios específico para un tipo de compilación. De forma predeterminada, la tarea Get recupera los archivos más recientes. Para obtener más información sobre los archivos .targets, vea Archivos .Targets de MSBuild.

Lista de tareas predeterminadas de Microsoft.TeamFoundation.Build.targets

Las tareas siguientes se pueden personalizar modificando sus propiedades.

Tarea de Team Foundation Build	Destino asociado
Get (Tarea) Sincroniza los orígenes en el equipo de compilación. También provoca eventos de registro para informar al registrador de cada archivo y versión recuperados en el área de trabajo local.	Get
Label (Tarea) Etiqueta todos los archivos de código fuente de un área de trabajo especificada.	Label
GenCheckinNotesUpdateWorkItems (Tarea) Genera la lista de todos los conjuntos de cambios y elementos de trabajo que se crearon o resultaron afectados durante una compilación. Las etiquetas se utilizan para etiquetar una compilación determinada.	Si la compilación se realiza correctamente, se invoca al destino GetChangeSetsAndUpdateWorkitems. Si la compilación no se realiza correctamente, se invoca al destino GetChangeSetsOnBuildBreak.
CreateNewWorkItem (Tarea) Crea un nuevo elemento de trabajo para los errores que se producen durante el proceso de compilación. Asimismo, actualiza el campo Found In del elemento de trabajo con un vínculo al número de versión de compilación específico.	CreateWorkItem
CreateWorkspaceTask (Tarea) Crea una nueva área de trabajo en el equipo de compilación.	InitializeWorkspace
DeleteWorkspaceTask (Tarea) Elimina el área de trabajo creada durante la ejecución de la compilación. Los archivos reales no se eliminan del equipo de compilación. Si el área de trabajo especificada no existe, DeleteWorkspaceTask envía una advertencia.	InitializeWorkspace
UpdateBuildNumberDropLocation (Tarea) Crea una carpeta en una ubicación especificada para almacenar los archivos generados. Además, actualiza el número de versión de compilación.	InitializeEndToEndIteration
TestToolsTask (Tarea) Ejecuta un conjunto de pruebas durante la compilación y publica los resultados.	RunTestWithConfiguration
BuildStep (Tarea) Inserta los pasos de compilación en la compilación.	None
GetBuildProperties (Tarea) Genera los valores iniciales de las propiedades de compilación.	InitializeBuildProperties
SetBuildProperties (Tarea) Establece todas las propiedades que se pueden establecer en la compilación.	None
WorkspaceItemConverterTask (Tarea) Convierte los elementos del servidor del control de versiones en elementos del área de trabajo locales, y los elementos locales en elementos del servidor del control de versiones.	ResolveSolutionPathsForEndToEndIteration y ResolveTestFilesForEndToEndIteration

Modificar las tareas de Team Foundation Build

Para modificar las tareas definidas en el archivo de definición Microsoft.TeamFoundation.Build.targets, examine las propiedades de la tarea que desea modificar y, a continuación, especifique dichas propiedades en el archivo TfsBuild.proj para el tipo de compilación de Team Foundation Build. La tarea CreateNewWorkItem se define de la manera siguiente.

<!-- Create WorkItem for build failure -->
    <CreateNewWorkItem
          BuildId="$(BuildNumber)"
          Description="$(WorkItemDescription)"
          TeamProject="$(TeamProject)"
          TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
          Title="$(WorkItemTitle)"
          WorkItemFieldValues="$(WorkItemFieldValues)"
          WorkItemType="$(WorkItemType)"
          ContinueOnError="true" />

Para personalizar el elemento de trabajo que se crea en caso de un error de compilación, establezca WorkItemFieldValues en el archivo TFSBuild.proj:

Nota:
En el ejemplo siguiente se asume que se han establecido también las propiedades Areapath e IterationPath.

<WorkItemFieldValues>Area Path=$(AreaPath);Iteration Path=$(IterationPath);Severity=1;Priority=0;Symptom=build break;Steps To Reproduce=Start the build using Team Build;Source=Development;How Found=Build Break;Assigned To=Active</WorkItemFieldValues>

Vea también

Tareas

Cómo: Utilizar variables de entorno al generar

Conceptos

Introducción a los archivos de configuración de Team Foundation Build

Propiedades personalizables de Team Foundation Build

Destinos personalizables de Team Foundation Build