監督工作流程

此使用案例詳細說明如何建立工作流程,讓您監視「暫停」、「停止」或「有錯誤」之工作流程集的狀態。

其目的是:

  • 使用工作流程來監控一組商業工作流程。
  • 透過「傳送」活動傳送訊息給主管。

若要監控一組工作流程的狀態,您必須遵循下列步驟:

  1. 建立監控工作流程。
  2. 撰寫JavaScript以判斷工作流程是暫停、停止或有錯誤。
  3. 建立​Test​活動。
  4. 準備傳送範本。
注意

除了工作流程外,Campaign Workflow Heatmap​還可讓您詳細分析目前執行的工作流程。 有關詳細資訊,請參閱專用部分

有關如何​監控工作流的執行​的詳細資訊,請參閱本節

步驟1:建立監視工作流

我們要監視的工作流資料夾是儲存在​管理>生產>技術工作流​節點中的​"CustomWorkflows"​資料夾。 此資料夾包含一組商業工作流程。

監控工作流​儲存在「技術工作流」資料夾的根目錄中。 使用的標籤為​「監控」

下列結構模式顯示活動的序列:

此工作流由以下幾部分組成:

  • a 「開始」​活動。
  • a "JavaScript code"​活動,負責分析業務工作流資料夾。
  • a "Test"​活動,以傳送傳送給主管或重新啟動工作流。
  • a 「傳送」​活動,負責訊息配置。
  • a "Wait"​活動,用於控制工作流迭代之間的提前期。

步驟2:編寫JavaScript

JavaScript程式碼的第一部分與​查詢(queryDef)​一致,可讓您以"pause"(@state == 13)、"error"(@failed == 1)或"stopped"(@state == 20)狀態來識別工作流程。

要監視的工作流資料夾的​內部名稱​在以下情況下提供:

<condition boolOperator="AND" expr="[folder/@name] = 'Folder20'" internalId="1"/>
var strError = "";
var strPaused = "";
var strStop = "";

var queryWkfError = xtk.queryDef.create(
  <queryDef schema="xtk:workflow" operation="select">
    <select>
      <node expr="@internalName"/>
      <node expr="@state"/>
      <node expr="@label"/>
      <node expr="@failed"/>
      <node expr="@state"/>   
    </select>
    <where id="12837805386">
      <condition boolOperator="AND" expr="[folder/@name] = 'Folder20'" internalId="1"/>
        <condition boolOperator="AND" internalId="2">
          <condition boolOperator="OR" expr="@state = 20" internalId="3"/>
          <condition expr="@state = 13" internalId="4"/>
        </condition>  
    </where>
  </queryDef>
);
var ndWkfError = queryWkfError.ExecuteQuery(); 

JavaScript程式碼的第二部分可讓您根據查詢期間復原的狀態,顯示每個工作流程的訊息​

注意

所建立的字串必須載入工作流程的事件變數中。

for each ( var wkf in ndWkfError.workflow ) 
{
  if ( wkf.@state == 13 )  // Status 13 = paused
  {
    if ( wkf.@failed == 1 )
      strError += "<li>Workflow '" + wkf.@internalName + "' with the label '" + wkf.@label + "'</li>";
    else
      strPaused += "<li>Workflow '" + wkf.@internalName + "' with the label '" + wkf.@label + "'</li>";
  }
  
  if ( wkf.@state == 20 )  // Status 20 = stop
    strStop += "<li>Workflow '" + wkf.@internalName + "' with the label '" + wkf.@label + "'</li>";
}

vars.strWorkflowError = strError;
vars.strWorkflowPaused = strPaused;
vars.strWorkflowStop = strStop;

步驟3:建立「測試」活動

「測試」活動可讓您根據「等待」活動判斷是否需要傳送傳送,或監控工作流程是否需要執行另一個週期。

如果三個事件變數"vars.strWorkflowError"、"vars.strWorkflowPaused"或"vars.strWorkflowStop"中至少有一個是無效的,則傳送給主管​

「等待」活動可配置為以定期間隔重新啟動監視工作流。 對於此使用案例,等待時間設為1小時

步驟4:準備傳送

「傳送」活動基於儲存在​資源>模板>傳送模板​節點中的​傳送模板

此範本必須包含:

  • 主管的電子郵件地址

  • HTML內 容,以插入個人化文字。

    聲明的三個變數(WF_Stop、WF_Paused、WF_Error)與三個工作流事件變數匹配。

    這些變數必須在傳送範本屬性的​Variables​標籤中宣告。

    若要復原工作流程事件變數​的內容,您必須聲明特定於傳送的變數,這些變數將會以JavaScript程式碼傳回的值進行初始化。

    傳送範本包含下列內容:

在建立並核准範本後,您必須將​Delivery​活動設定為:

  • 將「傳送」活動連結至先前建立的傳送範本。
  • 將工作流程的事件變數連結至特定於傳送範本的事件變數。

連按兩下​Delivery​活動,並選取下列選項:

  • 傳送:選擇​新建,從模板​建立,並選擇以前建立的交付模板。

  • 對於​收件者和內容​欄位,選擇​在交貨​中指定。

  • 要執行的動作:選擇​準備並啟動

  • 取消選中​處理錯誤​選項。

  • 前往​Delivery​活動的​Script​標籤,透過個人化欄位選單新增三個​字元字串​類型變數。

    宣告的三個變數為:

    delivery.variables._var[0].stringValue = vars.strWorkflowError;
    delivery.variables._var[1].stringValue = vars.strWorkflowPaused;
    delivery.variables._var[2].stringValue = vars.strWorkflowStop; 
    

啟動此監控工作流程後,會傳送下列摘要給收件者:

本頁內容