Reason プロパティ

[アーティクル]
09/11/2008

更新 : 2007 年 11 月

重要 :
この機能は、Team Foundation Server 2008 Service Pack 1 エディションでのみ使用できます。

Team Foundation Server 2008 Service Pack 1 エディションでは、IBuildDetail に BuildReason 型の列挙体である Reason プロパティが格納されます。このプロパティにより、ビルドがどのようにトリガされたかが表示されます。詳細については、「方法 : ビルド定義を作成する」を参照してください。使用できる値は次のとおりです。

Manual ユーザーがチームエクスプローラの [新しいビルドをキューに配置] メニューコマンドを使用して、ビルドを手動で開始したことを示します。
IndividualCI チェックインによってビルドが開始されたことを示します。ビルド定義は、チェックインごとにビルドを実行するよう構成されています。
BatchedCI 1 つ以上のチェックインによってビルドが開始されたことを示します。ビルド定義は、チェックインを蓄積するよう構成されています。
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 タスクを登録および定義する必要があります。詳細については、「方法 : ビルド番号をカスタマイズする」を参照してください。

次の方法で共有

Reason プロパティ

参照

概念

その他の技術情報

その他のリソース