Share via

Proprietà Reason

  • Articolo

Aggiornamento: novembre 2007

Nota importante:

Questa funzionalità è disponibile soltanto nella versione Service Pack 1 di Team Foundation Server 2008.

Nella versione Service Pack 1 di Team Foundation Server 2008, IBuildDetail contiene una proprietà Reason che è un'enumerazione di tipo BuildReason. Questa proprietà indica in che modo la compilazione è stata attivata. Per ulteriori informazioni, vedere Procedura: creare una definizione di compilazione. Segue l'elenco dei valori consentiti:

  • Manual   Questo valore indica che la compilazione è stata avviata manualmente da un utente tramite il comando di menu Accoda nuova compilazione in Team Explorer.

  • IndividualCI   Questo valore indica che la compilazione è stata avviata a causa di un'archiviazione e che la configurazione della definizione di compilazione prevede una compilazione a ogni archiviazione.

  • BatchedCI   Questo valore indica che la compilazione è stata avviata a causa di una o più archiviazioni e che la configurazione della definizione di compilazione prevede l'accumulo delle archiviazioni.

  • Schedule   Questo valore indica che la compilazione è stata avviata in quanto pianificata per un determinato momento e che la configurazione della definizione di compilazione prevede la compilazione secondo una pianificazione regolare in caso di archiviazione di modifiche.

  • ScheduleForced   Questo valore indica che la compilazione è stata avviata in un momento precedentemente impostato e che la configurazione della definizione di compilazione prevede la compilazione secondo una pianificazione regolare indipendentemente dall'archiviazione di modifiche.

La proprietà Reason è riportata nel log di compilazione. Per ulteriori informazioni, vedere la classe Cenni preliminari sui report di generazione.

La proprietà Reason è anche una proprietà di output dell'attività GetBuildDetails e, in quanto proprietà di MSBuild, è disponibile nei file TFSBuild.proj. Questa proprietà può essere utilizzata per modificare i file di compilazione, a seconda del trigger. La proprietà Reason può essere utilizzata per effettuare le operazioni seguenti:

  • Individuare come è stata attivata una compilazione controllata da una determinata definizione di compilazione. È quindi possibile personalizzare gli output di compilazione impostando le varie proprietà di compilazione su valori diversi, a seconda del trigger di compilazione.

  • Distinguere una particolare definizione di compilazione, quando più di una definizione di compilazione è configurata per utilizzare lo stesso file TfsBuild.proj.

Ad esempio, se per la compilazione notturna si desidera generare un numero di compilazione personalizzato, è possibile aggiungere il codice XML seguente nel file TFSBuild.proj:

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

Inoltre, l'attività MyBuildNumberGenerator deve essere registrata e definita. Per ulteriori informazioni, vedere la classe Procedura: personalizzare numeri di generazione.

Vedere anche

Concetti

Informazioni sui file di configurazione di Team Foundation Build

Altre risorse

Utilizzo delle definizioni di compilazione in Team Foundation Build