用例:监控工作流

此用例详细介绍了如何创建工作流,以便您监视“已暂停”、“已停止”或“有错误”的一组工作流的状态。

其目的是:

  • 使用工作流监视一组业务工作流。
  • 通过“投放”活动向主管发送消息。

要监视一组工作流的状态,您需要执行以下步骤:

  1. 创建监控工作流。
  2. 编写JavaScript以确定工作流是暂停、停止还是出错。
  3. 创建 Test 活动。
  4. 准备投放模板。
注意

除了工作流之外,Campaign 工作流热图 允许您详细分析当前运行的工作流。 有关更多信息,请参阅 专用部分.

有关如何操作的更多信息 监控工作流的执行,请参阅 此部分.

步骤1:创建监控工作流

我们要监视的工作流文件夹是 "CustomWorkflows" 存储在 管理>生产>技术工作流 节点。 此文件夹包含一组业务工作流。

监控工作流 存储在技术工作流文件夹的根目录中。 使用的标签为 "监测".

以下架构显示了活动的顺序:

此工作流由以下部分组成:

  • a "开始" 活动。
  • a "JavaScript代码" 活动,负责分析业务工作流文件夹。
  • a "测试" 活动向主管发送投放或重新启动工作流。
  • a "投放" 活动负责消息布局。
  • a "等待" 活动,可控制工作流迭代之间的提前期。

步骤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”中的至少一个事件变量为非void。

可以将“等待”活动配置为定期重新启动监控工作流。 对于此用例, 等待时间设置为1小时.

步骤4:准备投放

“投放”活动基于 投放模板 存储在 “资源”>“模板”>“投放模板” 节点。

此模板必须包括:

  • 主管的电子邮件地址.

  • HTML内容 用于插入个性化文本。

    声明的三个变量(WF_Stop、WF_Paused、WF_Error)与三个工作流事件变量匹配。

    必须在 变量 选项卡。

    恢复 工作流事件变量的内容,您需要声明特定于投放的变量,这些变量将使用JavaScript代码返回的值进行初始化。

    投放模板具有以下内容:

创建并批准模板后,您需要配置 投放 活动:

  • 将“投放”活动链接到之前创建的投放模板。
  • 将工作流的事件变量链接到特定于投放模板的事件变量。

双击 投放 活动,然后选择以下选项:

  • 投放:选择 新建,从模板创建,然后选择之前创建的投放模板。

  • 对于 收件人和内容 字段,选择 在投放中指定.

  • 要执行的操作:选择 准备和开始.

  • 取消选中 处理错误 选项。

  • 转到 脚本 选项卡 投放 活动,添加三 字符串 通过个性化字段菜单键入变量。

    声明的三个变量为:

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

启动此监控工作流后,它会向收件人发送以下摘要:

在此页面上