關於專案

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

除了專案,您還可以建立程式庫。與專案不同,程式庫沒有選取元可決定輸入步驟的位置。

關於「專案」畫面

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

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

「詳細資料」標籤

您可以在「詳細資料」標籤上指定各種專案內容。

工作控制器
選擇適合專案引擎類型的工作控制器。選項為 Java 主要工作控制器或「Perl 引擎」。系統會使用 Java 主要工作控制器來執行主要工作控制器專案。系統只會使用 Perl 引擎來執行 Perl 引擎專案。如需引擎類型的相關資訊,請參閱系統配置設定主題中的使用 Java 主要工作控制器作為工作執行引擎設定。您也可以參閱管理 Perl 引擎小節中的主題。
名稱
專案名稱。系統使用此名稱來參照清單與資料庫中的專案。

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

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

「標籤」標籤

使用「標籤」標籤來管理專案的建置標籤。

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

「暫存器」標籤

使用專案暫存器可儲存持續跨建置的資訊。

暫存器
專案暫存器的名稱。
內容
暫存器的值。

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

「附註」標籤

使用「附註」標籤可儲存專案的相關項目。

對於每一個附註,此標籤會顯示下列資訊:

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

Snapshot 標籤

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

使用這個標籤可檢視、變更及新增註解至 Snapshot 名稱。


意見