Поделиться через

Свойство Reason

  • Статья

Обновлен: Ноябрь 2007

Cc716772.alert_caution(ru-ru,VS.90).gifВажное примечание.

Эта возможность доступна только в пакете обновления 1 для Team Foundation Server 2008.

Пакет обновления 1 Team Foundation Server 2008, IBuildDetail содержит свойство Reason, которое является перечислением типа BuildReason. Данное свойство отображает способ запуска построения. Дополнительные сведения см. в разделе Создание определения построения. Допустимы следующие значения:

  • Manual   Данное значение показывает, что построение было запущено вручную командой меню Поставить в очередь новое построение Сред. Командный обозреватель.

  • IndividualCI   Данное значение показывает, что построение было запущено по причине возврата и в определении сборки задано выполнять сборку при каждом возврате.

  • BatchedCI   Данное значение показывает, что построение было запущено по причине одного или нескольких возвратов и в определении сборки задано накапливать возвраты.

  • Schedule   Данное значение показывает, что построение было запущено, так как его запуск был запланирован на определенное время и в определении построения задано выполнять его в соответствии с расписанием при условии, что никакие изменения не были возвращены.

  • ScheduleForced   Данное значение показывает, что построение было запущено в установленное время и в определении сборки задано выполнять сборку в соответствии с расписанием, вне зависимости от того, были ли возвращены какие-либо изменения.

Свойство Reason перечисляется в журнале построения. Дополнительные сведения см. в разделе Общие сведения об отчетах о построениях.

Свойство Reason также является выходным свойством задачи GetBuildDetails и, являясь свойством MSBuild, доступно в файлах TFSBuild.proj. Это свойство можно использовать для изменения файлов построения в зависимости от триггера. Свойство Reason можно использовать для выполнения следующих задач.

  • Определение способа запуска построения, контролируемого конкретным определением построения. Можно дополнительно настроить выходные данные построения, задав различные свойства построения в зависимости от триггера построения.

  • Выявление конкретного определения сборки, когда несколько определений построения используют один и тот же файл TfsBuild.proj.

Например, если требуется создать номер построения для регулярного вечернего построения, можно добавить следующий XML-код в файл TFSBuild.proj:

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

Кроме того, задача MyBuildNumberGenerator должна быть зарегистрирована и определена. Дополнительные сведения см. в разделе Настройка номеров построений.

См. также

Основные понятия

Описание файлов конфигурации Team Foundation Build

Другие ресурсы

Работа с определениями построений в Team Foundation Build