Compartir a través de

Reason (Propiedad)

  • Artículo

Actualización: noviembre 2007

Nota importante:

Esta funcionalidad solo está disponible con la edición del Service Pack 1 de Team Foundation Server 2008.

La edición de Service Pack 1 de Team Foundation Server 2008, IBuildDetail contiene una propiedad Reason que es una enumeración de tipo BuildReason. Esta propiedad muestra la manera en que se desencadenó la compilación. Para obtener más información, vea Cómo: Crear una definición de compilación. Los valores permitidos son los siguientes:

  • Manual   Este valor indica que un usuario inició manualmente la compilación mediante el comando de menú Poner nueva compilación en cola en Team Explorer.

  • IndividualCI   Este valor indica que la compilación se inició debido a una protección y la definición de compilación está configurada para generarse con cada protección.

  • BatchedCI   Este valor indica que la compilación se inició debido a una o más protecciones y la definición de compilación está configurada para acumular protecciones.

  • Schedule   Este valor indica que la compilación se inició porque fue programada para ello en determinado momento y la definición de compilación está configurada para generarse según una programación periódica en caso de que se protejan cambios.

  • ScheduleForced   Este valor indica que la compilación se inició en un momento establecido y la definición de compilación está configurada para generarse según una programación periódica tanto si se han protegido cambios como si no.

La propiedad Reason aparece en el registro de compilación. Para obtener más información, vea Información general sobre informes de compilación.

La propiedad Reason también es una propiedad de salida de la tarea GetBuildDetails y como propiedad MSBuild está disponible en los archivos TFSBuild.proj. Puede utilizar esta propiedad para modificar los archivos de compilación, en función del desencadenador. Puede utilizar la propiedad Reason para hacer lo siguiente:

  • Distinguir cómo se desencadenó una compilación que está controlada por una definición de compilación determinada. A continuación, puede personalizar además los resultados de la compilación estableciendo varias propiedades de compilación en distintos valores, en función del desencadenador de la compilación.

  • Distinguir una definición de compilación determinada, cuando hay más de una definición de compilación configurada para utilizar el mismo archivo TfsBuild.proj.

Por ejemplo, si desea generar un número de versión de compilación personalizado para su compilación nocturna, puede agregar el XML siguiente al archivo TFSBuild.proj:

<Target Name="BuildNumberOverrideTarget" Condition=" '$(Reason)' == 'Schedule' ">
    <MyBuildNumberGenerator TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)">
      <Output TaskParameter="BuildNumber" PropertyName="BuildNumber" />
    </MyBuildNumberGenerator>
</Target>

Además, se debe registrar y definir la tarea MyBuildNumberGenerator. Para obtener más información, vea Cómo: Personalizar números de versión de compilación.

Vea también

Conceptos

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

Otros recursos

Trabajar con definiciones de compilación en Team Foundation Build