為步驟的日誌輸出建立標籤

建立標籤,以便在步驟日誌中,將步驟的輸入列在其自己的種類中。

開始之前

這項作業假設您已經建立選取元、伺服器和專案。它也假設您使用的伺服器是與接受 echo 指令的作業系統(例如 Windows、Linux 或 UNIX)搭配使用。

關於這項作業

您可以在輸出中任何一行的起始處,加入一個大寫的標籤。標籤會一直用到步驟結束或遇到新的標籤為止。

標籤具有下列語法:

您可以在步驟中使用 echo 指令來建立標籤。系統會將 echo 指令的第一個引數辨識為標籤(如果它遵循標籤語法)。

註: 系統會將任何建置輸出中的行首文字辨識為標籤(如果它遵循語法),即使該文字不是 echo 指令的引數亦然。
如範例所示,您可以將標籤設為現有的輸出標籤名稱,也可以設為新名稱。

程序

  1. 在專案中建立新的步驟。 以本例來說,專案的名稱為 Say_hi
  2. 將步驟命名為 LabeledLogOutput
  3. 在「指令」欄位中輸入下列文字:
    echo SPACESHIPS: Voyager I
    echo Voyager II
    echo EXEC: You can add text to existing categories as well
  4. 執行專案。
  5. 當工作完成時,請檢視日誌。

結果

請注意種類標頭中的 SPACESHIPS 勾選框,以及輸出中標籤名稱為 SPACESHIPS 的第 354 行與第 355 行。
79	    7/9/10 10:24 AM	EXEC	    Locale set to 'English_United States.1252'
250	  7/9/10 10:24 AM	EXEC	    Locale set to 'English_United States.1252'
349	  7/9/10 10:24 AM	EXEC	    Performing variable expansion on command line
353	  7/9/10 10:24 AM	EXEC	    start [C:\data\BuildForge\buildforge_projects\Say_hi\BUILD_1@RBF-14]
354	  7/9/10 10:24 AM	SPACESHIPS	      Voyager I
355	  7/9/10 10:24 AM	SPACESHIPS	      Voyager II
356	  7/9/10 10:24 AM	EXEC	     You can add text to existing categories as well
357	  7/9/10 10:24 AM	EXEC	    end [C:\data\BuildForge\buildforge_projects\Say_hi\BUILD_1@RBF-14]

註: 您可以選取或清除 SPACESHIPS 勾選框,以顯示或隱藏種類。
註: 將文字新增至 EXEC 種類時,務必要避免使用特殊字元(例如括弧)。在部分系統上,如果用引號括住,則這些用法都可行,但一般而言,最好只使用純文字。

意見