Eigenschaft Reason

  • Artikel

Aktualisiert: November 2007

Wichtiger Hinweis:

Diese Funktionalität ist nur in der Service Pack 1-Edition von Team Foundation Server 2008 verfügbar.

Die Service Pack 1-Edition von Team Foundation Server 2008, IBuildDetail beinhaltet eine Eigenschaft Reason. Hierbei handelt es sich um eine Enumeration des Typs BuildReason. Diese Eigenschaft zeigt an, wie der Build ausgelöst wurde. Weitere Informationen finden Sie unter Gewusst wie: Erstellen einer Builddefinition. Die folgenden Werte sind zugelassen:

  • Manual: Dieser Wert kennzeichnet, dass der Build von einem Benutzer manuell über den Menübefehl Neuen Build in Warteschlange in Team Explorer gestartet wurde.

  • IndividualCI: Dieser Wert kennzeichnet, dass der Build in Folge eines Eincheckvorgangs gestartet wurde und dass die Builddefinition für das Erstellen bei jedem Eincheckvorgang konfiguriert ist.

  • BatchedCI: Dieser Wert kennzeichnet, dass der Build in Folge eines oder mehrerer Eincheckvorgänge gestartet wurde und dass die Builddefinition für das Sammeln von Eincheckvorgängen konfiguriert ist.

  • Schedule: Dieser Wert gekennzeichnet, dass der Build für einen bestimmten Zeitpunkt geplant und zu diesem gestartet wurde. Die Konfiguration der Builddefinition sieht vor, dass der Build regelmäßig erstellt wird, wenn Änderungen eingecheckt wurden.

  • ScheduleForced: Dieser Wert gekennzeichnet, dass der Build zu einem bestimmten Zeitpunkt gestartet wurde. Die Konfiguration der Builddefinition sieht vor, dass der Build regelmäßig erstellt wird, egal ob Änderungen eingecheckt wurden oder nicht.

Die Eigenschaft Reason wird im Buildprotokoll aufgeführt. Weitere Informationen hierzu finden Sie unter Übersicht über Buildberichte.

Die Eigenschaft Reason ist zudem eine Ausgabeeigenschaft der GetBuildDetails-Aufgabe und als MSBuild-Eigenschaft in der Datei TFSBuild.proj verfügbar. Mit dieser Eigenschaft können Sie die Builddateien abhängig vom Trigger bearbeiten. Verwenden Sie das Reason-Eigenschaft für folgende Aufgaben:

  • Ermitteln, wie ein durch eine bestimmte Builddefinition gesteuerter Build ausgelöst wurde. Sie können anschließend die Buildausgaben anpassen, indem Sie abhängig vom Buildtrigger für verschiedene Buildeigenschaften andere Werte festlegen.

  • Ermitteln einer bestimmten Builddefinition, wenn mehr als eine Builddefinition die gleiche Datei TfsBuild.proj verwendet.

Wenn Sie beispielsweise eine benutzerdefinierte Buildnummer für einen nächtlichen Build generieren möchten, können Sie der Datei TFSBuild.proj den folgenden XML-Code hinzufügen:

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

Darüber hinaus muss die MyBuildNumberGenerator-Aufgabe registriert und definiert werden. Weitere Informationen hierzu finden Sie unter Gewusst wie: Anpassen von Buildnummern.

Siehe auch

Konzepte

Team Foundation Build-Konfigurationsdateien

Weitere Ressourcen

Arbeiten mit Builddefinitionen in Team Foundation Build