Proprietà Reason
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