關於專案

專案是可執行的步驟集,內含步驟的環境群組及伺服器內容。

除了專案,您還可以建立程式庫。程式庫與專案相似,但沒有選取元可用來判斷執行步驟的位置。

關於「專案」畫面

您可以使用「專案」畫面來建立新專案,並檢視或編輯現有的專案。若要存取「專案」畫面,請在左側功能表中按一下專案

「專案」畫面提供下列標籤:

「詳細資料」標籤

在「詳細資料」標籤中,您可以指定專案的各種內容。
「專案」畫面中的「專案詳細資料」標籤的螢幕影像
名稱
專案名稱。系統使用此名稱來參照清單與資料庫中的專案。

執行專案時,可使用專案名稱來建構專案目錄。由於專案可能包含在不同作業系統上執行的步驟,因此請避免在專案名稱中使用特殊字元和符號。如果專案名稱必須使用會產生無效目錄名稱的字元,請將這些字元新增至「無效相對目錄字元」系統配置設定。在建立專案目錄時,此設定中列出的字元會轉換成底線 (_)。使用 & 符號可能會不小心在專案名稱中產生 HTML 實體。

存取
容許檢視並使用專案的存取群組。存取 內容和許可權一起使用,以判斷使用者可採取哪些動作。例如,如果要啟動工作,您必須是指定給專案的存取群組成員,同時也必須是具有「執行工作」許可權的群組成員。如需存取群組的相關資訊,請參閱「存取」概觀
停用
請選取這個勾選框來停用專案。當使用者嘗試執行已停用的專案時,Rational Build Forge 會顯示一則訊息,指出專案不在作用中,且不會執行專案。
執行緒上限
專案可以啟動之平行處理的最大數量。請使用這個欄位,以避免專案使用太多系統資源。每一個具有執行緒能力的步驟和任何列入專案(它們本身可啟動具有執行緒能力的步驟)都可能導致平行處理程序,但那些處理程序將都不會計算在母專案的上限中。當系統達到「執行緒數目上限」值時,就不會再啟動新的平行處理程序,並會等到該專案的平行處理程序數目降到「執行緒數目上限」值以下,才會繼續。如需執行緒作業的相關資訊,請參閱執行緒作業:平行執行步驟
執行限制
執行限制內容設定允許同步執行的專案工作數目上限。
  • 如果您啟動專案,而且作用中的工作數目等於「執行限制」,則新工作會停留在「等待」 佇列,直到至少一項工作完成為止。
  • 如果排程試圖啟動專案時,作用中的工作數目等於「執行限制」,且「強迫執行限制」系統配置設定的值為「是」,則系統不會啟動新工作。如果「強迫執行限制」設為「否」,系統會忽略排程建置的「執行限制」設定。
  • 透過列入啟動的專案不被視為原始專案的實例,因此不會算在「執行限制」內。
類別
每個專案都必須指派給一個類別,而此類別會將廣域內容指派給工作群組。如需相關資訊,請參閱類別
選取元
在選擇專案的伺服器時,要使用的選取器名稱。 對於專案內未指定本身之選取元的所有步驟,系統都會指定這個選取元來作為預設值。請參閱選取元。如果未指定選取元,則會將專案新增至「程式庫」畫面,而非「專案」畫面。程式庫會使用呼叫端步驟的選取器;如果步驟沒有選取器,程式庫會使用呼叫端專案的選取器。
通過鏈、失敗鏈
選取在專案建置通過或失敗時執行的專案。在專案層次設定通過/失敗鏈可讓您根據專案的通過/失敗狀態,呼叫個別的通過/失敗動作。這項功能類似於在專案中的步驟層次,設定通過/失敗動作。 在專案層次,通過/失敗動作是由專案執行狀態而非步驟狀態所觸發。
環境
在「伺服器」環境之後、在「步驟」環境之前套用的環境。如需這些環境共同運作之方式的相關資訊,請參閱關於變數
固定
啟用「固定」勾選框可將使用預設專案選取器之專案步驟,全數強制停留在相同的伺服器上,而伺服器如果忙碌中,則會等到伺服器可供使用為止。如需這個選項的相關資訊,請參閱將步驟固定在伺服器中
啟動通知、通過通知、失敗通知
在其中一個或全部欄位中選取存取群組,以便使用這些欄位來指示系統在專案啟動、通過和/或失敗時,傳送通知電子郵件。

「標籤」標籤

使用「標籤」標籤來管理專案的建置標籤。
標籤格式
為一字串,使用純文字和標籤變數參照來定義專案的標籤。如需標籤格式的相關資訊,請參閱在工作期間變更建置標籤
標籤同步化
同步化兩個專案的標籤變數。選取您要將哪個專案的標籤變數,與現行專案進行同步化。兩個專案同步化之後,就會從相同的儲存區提取其變數,因此當它們依序執行時,其中一個專案會取得值 1,下一個專案則會取得值 2,依此類推。如需相關資訊,請參閱同步化標籤
標籤名稱
變數名稱。當您在標籤格式中使用標籤變數時,請使用 $<Tag Name> 格式來參照其名稱。例如,如果要建立使用 MainVer 和 B 變數的標籤,請使用標籤格式 "Build_$MainVer.$B" 來取得像 Build_005.1 這樣的標籤。
起始值
設定標籤變數的值。如果您不使用自動增量 選項,變數會保留這個值,直到您加以變更為止。
填補
如果您選取填補值而非「無」,當變數值用於標籤時,為使其位數等於填補值,系統會在值之前補上零。例如,如果現行變數是 2,而「填補」為 3,則系統會以 002 來呈現這個值。填補範圍介於 1 到 8 之間。
自動增量
如果設定為「是」,系統會針對專案的每個工作,將變數值以 1 遞增。

「暫存器」標籤

使用專案暫存器來儲存持續跨建置的資訊。
暫存器
專案暫存器的名稱。
內容
暫存器的值。

如需相關資訊,請參閱專案暫存器

「附註」標籤

使用「附註」標籤來儲存專案的重要項目。

對於每一個附註,此標籤會顯示:

  • 使用者建立附註的日期和時間
  • 輸入附註的使用者
  • 附註

Snapshot 標籤

專案 Snapshot 是專案的實例。Snapshot 標籤提供了 Snapshot 的名稱。

請使用這個標籤來檢視或變更 Snapshot 名稱以及 Snapshot 的相關註解。


意見