監督工作流程

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

其目的是：

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

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

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

步驟1:建立監控工作流

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

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

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

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

• a 「開始」活 動。
• 負責 分析業務工作流程資料夾的 「JavaScript程式碼」活動。
• 「測 試」活動 ，以傳送傳送給主管或重新啟動工作流。
• a "Delivery" activity for message layout.
• 「等 待」活動 ，可控制工作流迭代之間的提前期。

步驟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"中至少有一個未失效，則傳送給主管。

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

步驟4:準備傳送

「傳送」活動以儲存在「資源 >範本> 傳送範本 」節點 中的傳送範本為基礎。

此範本必須包含：

• 主管的電子郵件地址。

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

  

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

  這些變數必須在傳送範本屬 性的 「變數」索引標籤中宣告。

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

  傳送範本包含下列內容：

  

建立並核准範本後，您必須將「傳送」活動設 定為 :

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

連按兩下「 傳送 」活動，並選取下列選項：

• 傳送：選 取「新建」、從範本建立，並選取先前建立的傳送範本。

• 對於「收件 者」和「內容 」欄位，選 取「在傳送中指定」。

• 要執行的動作：選擇 準備並開始。

• 取消選中「 Process errors （處理錯誤）」選項。

  

• 前往「傳送 」活動的「指令碼 」標籤，透過個人化欄 ​​​ 位選單新增三個字元字串類型變數。

  

  

  宣告的三個變數為：

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

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