完了したビルドにわかりやすい名前を付けるためにビルド番号を使用

ビルド処理を定義すると、完了した各ビルドの名前に有用なデータを含めることができます。

• 例

• トークン

• Q&A

  • ビルド番号はどこで指定しますか。

  • BuildID とは何ですか。

  • Rev とは何ですか。

例

次に例を示します。

• チーム プロジェクトの名前は FabrikamCore です。

• ビルド定義の名前は CIBuild です。

• ビルド ID は 4 です。

• 日付は 2009 年 8 月 24 日です。

• 時刻は午後 9:50:43 です。

• ビルドは今日 1 回実行されました。

既定のビルド プロセスを定義し、BuildNumberFormat を次のように設定します。

$(BuildDefinitionName)_$(Date:yyyyMMdd)$(Rev:.r)

この場合、この日 2 番目に完了したビルドの名前は次のようになります。

CIBuild_20090824.2

トークン

次の表に、前の例に基づいて各トークンがどのように解決されるかを示します。

トークン	このセクションで前述した例に基づく置換値
$(BuildDefinitionName)	CIBuild
$(BuildID)	4 ビルド ID とは何ですか。
$(DayOfMonth)	24
$(DayOfYear)	236
$(Hours)	09
$(Minutes)	50
$(Month)	08
$(Rev:.rr)	02 (この日の次のビルドは 03、というように続きます) Rev とは何ですか。
$(Date:MMddyy)	082409
$(Seconds)	50
$(TeamProject)	FabrikamCore
$(Year:yy)	09
$(year:yyyy)	2009

Q&A

ビルド番号はどこで指定しますか。

次の操作を行うことができます。

• 既定のテンプレートを使用し、[ビルド番号形式] パラメーターを変更します。 「ビルド プロセスに既定のテンプレートを使用」を参照してください。

• カスタム ビルド プロセス テンプレートを開発し、UpdateBuildNumber アクティビティを使用します。 「Team Foundation ビルド アクティビティ: UpdateBuildNumber」を参照してください。

BuildID とは何ですか。

$(BuildID) は、変更できない内部 ID です。

Rev とは何ですか。

$(Rev:.rr) は、完了したすべてのビルドの名前を一意にするために使用します。 ビルドが 1 つ完了すると、Rev の整数値が 1 だけインクリメントされます (ビルド番号にその他の変化がない場合)。