startBuildActivity

startBuildActivity 作業會啟動一項建置的新建置活動。 一項建置隨時可能有多個活動在進行中。 您可以在階層中組織活動。 當啟動活動時,您可以指定一個現有的母項活動給它。 活動可以明確地完成(請參閱 completeBuildActivity),如果設定了 autoComplete 屬性,也可以自動完成。

下表說明 startBuildActivity 作業屬性。

屬性 說明 必要

buildResultUUID

要更新之建置結果的 UUID。 這個屬性的值通常是 ${buildResultUUID},因為在使用 Jazz Build Engine 時,內容是內建的。

repositoryAddress

要用的團隊儲存庫的位址。 這個屬性的值通常是 ${repositoryAddress},因為使用 Jazz Build Engine 時,內容是內建的。

userId

要用的使用者 ID。

label

如果是 startBuildActivity,則為說明建置活動的標籤。 如果沒有指定,便會利用 activityID 值作為標籤。

activityIdProperty

儲存新啟動之活動的唯一 ID。 只有在呼叫端想要利用 completeBuildActivity 作業來明確完成這個活動時,或這個活動是用來作為子項活動的母項時,才需要。

autoComplete

如果是 startBuildActivity 作業,指定在任何下列狀況中,是否自動完成活動: 母項活動完成、下一對等活動啟動,或建置完成。預設值是 false。

failOnError

如果是 true(預設值),當發生錯誤時,作業會失敗。 如果是 false,會忽略某些錯誤,並完成作業。

parentActivityID

用來作為母項之現有活動的 ID。 這個 ID 的活動必須存在,且尚未完成。

password

使用者 ID 的密碼,除非另有指定,否則,預設為零長度的字串。

passwordFile

連線所用的密碼檔。 您可以利用 -createPasswordFile 引數呼叫 Jazz Build Engine 來建立適當的密碼檔。 您只能指定一個密碼檔。

verbose

指定輸出其他更多的訊息。預設值是 false。

範例

<startBuildActivity repositoryAddress="${repositoryAddress}"
		                    userId="${userId}"
		                    password="${password}"
		                    activityIdProperty="activityId"
		                    label="compiling"
		                    autoComplete="false"
		                    verbose="true"
		                    buildResultUUID="${buildResultUUID}" />

意見

以上說明對您有幫助嗎?您可以在 Jazz.net 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤