post-processing 元素

後處理 Script 有權存取下列物件：

• properties 物件是類別 java.util.Properties 的實例。此變數具有數個特殊內容：exitCode 包含程序結束碼，Status 包含步驟的狀態。 Status 值 Success 表示步驟順利完成。
  此物件與步驟傳回的 Java™ Properties 物件相同。因此，您可以在後處理 Script 中使用 properties 物件，來變更步驟的輸出內容。例如，如果要新增名為 OutputProp1 且值為 value1 的輸出內容，請將下列程式碼新增至後處理 Script：

  properties.put("OutputProp1","value1");

  然後，其他步驟的前置條件 Script 可以存取此內容。 請參閱處理程序步驟前置條件。

  如需此物件的相關資訊，請參閱 java.util.Properties 的 JAVA 參照。

• scanner 物件可以掃描步驟的輸出日誌（掃描作業發生在代理程式上），並根據結果來執行指令。scanner 具有數個公用方法：
  • register(String regex, Function script) 會在符合正規表示式時登錄要呼叫的函數。此函數接受兩個參數：第一個參數是符合正規表示式的行號，第二個參數是符合表示式的文字行。
  • addLOI(Integer lineNumber) 會向相關清單行新增一行，這些相關清單行已在「日誌檢視器」中強調顯示。掃描器會自動將所有相符行新增至此清單，但您可透過呼叫此方法來新增其他行。
  • getLinesOfInterest() 傳回相關行的 java.util.List；可用於移除行。
  • scan() 掃描日誌。在您使用 register() 登錄所有正規表示式後呼叫此方法。如果您不呼叫此方法，則不會執行登錄的比對程式。
• commandOut 物件是類別 java.io.PrintStream 的實例。您可以使用此物件來寫入日誌，如下列範例中所示：

  commandOut.println("Log message.");

  如需此物件的相關資訊，請參閱 java.io.PrintStream 的 JAVA 參照。

後處理 Script 必須設定 Status 內容，以指定 Script 的狀態。Script 可以為 Status 內容指定任何值。例如，若要指定 Script 成功，請在後處理 Script 中執行下列指令：

properties.put("Status","Success");

您可以使用後處理 Script 來設定可在同一程序中的其他步驟內使用的輸出內容，這會啟用複雜工作流程。在後處理（或前置條件）Script 中，請以下列方式參照先前的步驟輸出內容：

properties.get("stepName/propName")

例如，若要設定其值包含在輸出日誌中的內容 myProp，請輸入下列 Script：

var exit = properties.get('exitCode');
 scanner.register("^myProp:", function(lineNumber, line) {     
      properties.put('myProp', line.substring(7))
 });
 if (exit == 0) {
     properties.put('Status', 'Success');
 }
 else{
    properties.put('Status', 'Failure');
 }

在後處理及前置條件 Script 以外的實例中，請以下列方式參照先前的步驟輸出內容：

${p:stepName/propName}