Reason, propriété

  • Article

Mise à jour : novembre 2007

Remarque importante :

Ces fonctionnalités sont disponibles uniquement avec l'édition Service Pack 1 de Team Foundation Server 2008.

L'édition Service Pack 1 de Team Foundation Server 2008, IBuildDetail contient une propriété Reason qui est une énumération de type BuildReason. Cette propriété affiche la façon dont la build a été déclenchée. Pour plus d'informations, consultez Comment : créer une définition de build. Les valeurs autorisées sont les suivantes :

  • Manual   Cette valeur indique que la build a été démarrée manuellement par un utilisateur par le biais de la commande de menu Mettre en file d'attente une nouvelle build de Team Explorer.

  • IndividualCI   Cette valeur indique que la build a été démarrée en raison d'un archivage et la définition de build est configurée pour générer une build à chaque archivage.

  • BatchedCI   Cette valeur indique que la build a été démarrée en raison d'un ou de plusieurs archivages et la définition de build est configurée pour accumuler les archivages.

  • Schedule   Cette valeur indique que la build a été démarrée car cela a été planifié à une heure particulière et la définition de build est configurée pour générer une build à intervalle régulier si des modifications ont été archivées.

  • ScheduleForced   Cette valeur indique que la build a été démarrée à une heure définie et la définition de build est configurée pour générer une build à intervalle régulier que des modifications aient été archivées ou non.

La propriété Reason est indiquée dans le journal de génération. Pour plus d'informations, consultez Vue d'ensemble des rapports de build.

La propriété Reason est également une propriété de sortie de la tâche GetBuildDetails, et comme propriété MSBuild disponible dans vos fichiers TFSBuild.proj. Vous pouvez utiliser cette propriété pour modifier les fichiers de génération, selon le déclencheur. Vous pouvez utiliser la propriété Reason pour effectuer les opérations suivantes :

  • Déterminer comment a été déclenchée une build contrôlée par une définition de build particulière. En outre, vous pouvez personnaliser les sorties de build en affectant à plusieurs propriétés de build différentes valeurs, selon le déclencheur de build.

  • Distinguer une définition de build particulière, lorsque plusieurs définitions de build sont configurées pour utiliser le même fichier TfsBuild.proj.

Par exemple, si vous souhaitez générer un numéro de build personnalisée pour votre build nocturne, vous pouvez ajouter le code XML suivant dans votre fichier TFSBuild.proj :

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

En outre, la tâche MyBuildNumberGenerator doit être enregistrée et définie. Pour plus d'informations, consultez Comment : personnaliser des numéros de build.

Voir aussi

Concepts

Présentation des fichiers de configuration de Team Foundation Build

Autres ressources

Utilisation de définitions de build dans Team Foundation Build