startTeamBuild

startTeamBuild 作業會從現有或新的建置要求啟動團隊建置。在這項作業完成之後，會在 Ant 中自動定義建置定義中的所有內容。

下表說明 startTeamBuild 作業屬性。

屬性	說明	必要
repositoryAddress	要用的團隊儲存庫的位址。這個屬性的值通常是 ${repositoryAddress}，因為使用 Jazz Build Engine 時，便內建了這個內容。	是
resultUUIDProperty	用來儲存建置結果 UUID 的內容。	是
userId	要用的使用者 ID。	是
autoComplete	對於 startTeamBuild 作業，指定建置是否應該自動完成。預設值是 true。如果這個屬性是 true，當啟動 Ant 時，您必須使用 -listener com.ibm.team.build.ant.listener.TeamBuildListener 參數。	否
buildDefinitionId	對於 startTeamBuild 作業，這是要啟動之建置的建置定義。如果未指定 requestUUID，便屬必要。	否
engineId	對於 startTeamBuild 作業，這是執行建置之建置引擎的 ID。如果未指定 requestUUID，便是必要。	否
failOnError	如果是 true（預設值），當發生錯誤時，作業會失敗。如果是 false，會忽略某些錯誤，並完成作業。	否
label	建置所用的標籤。	否
password	使用者 ID 的密碼，除非另有指定，否則，預設為零長度的字串。	否
passwordFile	連線所用的密碼檔。您可以利用 -createPasswordFile 引數呼叫 Jazz Build Engine 來建立適當的密碼檔。您只能指定一個密碼檔。	否
requestUUID	指定在啟動建置時所用的現有建置要求。如果指定的話，便不能指定 buildDefinitionID 和 engineID。	否
resultUUIDFile	用來儲存建置結果的檔案。這個路徑可以是建置檔基本目錄的相對路徑，也可以是完整路徑。檔案採用 java.util.Properties 格式，含有 resultUUIDProperty 屬性指定名稱的內容。	否
verbose	指定輸出其他更多的訊息。預設值是 false。	否

範例

<startTeamBuild repositoryAddress="${repositoryAddress}"
		                userId="${userId}"
		                password="${password}"
		                requestUUID="${requestUUID}"
		                resultUUIDProperty="buildResultUUID"
		                label="test build"
		                autoComplete="false"
		                verbose="true" />

<fail message="Did not start a build as expected."
		      unless="buildResultUUID" />
<echo message="result UUID = ${buildResultUUID}" />