Supervisione dei flussi di lavoro

Questo caso d’uso descrive in dettaglio la creazione di un flusso di lavoro che consente di monitorare lo stato di un set di flussi di lavoro che vengono "messi in pausa", "interrotti" o "con errori".

Il suo scopo è:

  • Utilizza un flusso di lavoro per monitorare un gruppo di flussi di lavoro aziendali.
  • Invia un messaggio a un supervisore tramite un'attività di "consegna".

Per monitorare lo stato di un set di flussi di lavoro, è necessario effettuare le seguenti operazioni:

  1. Crea il flusso di lavoro di monitoraggio.
  2. Scrivere il codice JavaScript per determinare se i flussi di lavoro vengono messi in pausa, interrotti o con errori.
  3. Create l'attività Test.
  4. Preparate il modello di consegna.
NOTA

Oltre al flusso di lavoro, Campaign Workflow Heatmap consente di analizzare in dettaglio i flussi di lavoro attualmente in esecuzione. Per ulteriori informazioni, fare riferimento alla sezione dedicata.

Per ulteriori informazioni su come monitorare l'esecuzione dei flussi di lavoro, consultare questa sezione.

Passaggio 1: Creazione del flusso di lavoro di monitoraggio

La cartella del flusso di lavoro che verrà monitorata è la cartella "CustomWorkflows" memorizzata nel nodo Amministrazione > Produzione > Flussi di lavoro tecnici. Questa cartella contiene un set di flussi di lavoro aziendali.

Il flusso di lavoro di monitoraggio viene memorizzato nella directory principale della cartella Technical Workflows. L'etichetta utilizzata è "Monitoring".

Lo schema seguente mostra la sequenza di attività:

Questo flusso di lavoro è composto da:

  • un'attività "Start".
  • un'attività "codice JavaScript" responsabile dell'analisi della cartella dei flussi di lavoro aziendali.
  • un'attività "Test" per inviare una consegna al supervisore o riavviare il flusso di lavoro.
  • un'attività "Delivery" responsabile del layout dei messaggi.
  • un'attività "Wait" che controlla i tempi di lead tra le iterazioni del flusso di lavoro.

Passaggio 2: Scrittura di JavaScript

La prima parte del codice JavaScript coincide con una query (queryDef) che consente di identificare i flussi di lavoro con uno stato "pause" (@state == 13), "error" (@failure == 1) o "stop" (@state == 20).

Il nome interno della cartella del flusso di lavoro da monitorare è indicato nella seguente condizione:

<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(); 

La seconda parte del codice JavaScript consente di visualizzare un messaggio per ogni flusso di lavoro in base allo stato recuperato durante la query.

NOTA

Le stringhe create devono essere caricate nelle variabili evento del flusso di lavoro.

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;

Passaggio 3: Creazione dell'attività 'Test'

L'attività "Test" consente di determinare se una consegna deve essere inviata o se il flusso di lavoro di monitoraggio deve eseguire un altro ciclo in base all'attività "Wait".

Una consegna viene inviata al supervisore se almeno una delle tre variabili evento "vars.strWorkflowError", "vars.strWorkflowPaused" o "vars.strWorkflowStop" non è nulla.

L'attività "Wait" può essere configurata per riavviare il flusso di lavoro di monitoraggio a intervalli regolari. In questo caso di utilizzo, il tempo di attesa è impostato su un'ora.

Passaggio 4: Preparazione della consegna

L'attività "Consegna" si basa su un modello di consegna memorizzato nel nodo Risorse > Modelli > Modelli di consegna.

Questo modello deve includere:

  • l'indirizzo e-mail del supervisore.

  • Contenuto HTML per l'inserimento di testo personalizzato.

    Le tre variabili dichiarate (WF_Stop, WF_Paused, WF_Error) corrispondono alle tre variabili di evento del flusso di lavoro.

    Queste variabili devono essere dichiarate nella scheda Variabili delle proprietà del modello di consegna.

    Per recuperare il contenuto delle variabili evento del flusso di lavoro, è necessario dichiarare le variabili specifiche per la consegna che verranno inizializzate con i valori restituiti dal codice JavaScript.

    Il modello di consegna include il contenuto seguente:

Una volta creato e approvato il modello, è necessario configurare l'attività Delivery per:

  • collegate l'attività "Consegna" al modello di consegna creato in precedenza.
  • collegate le variabili evento del flusso di lavoro a quelle specifiche per il modello di consegna.

Fare doppio clic sull'attività Consegna e selezionare le seguenti opzioni:

  • Consegna: selezionate Nuovo, creato da un modello, quindi selezionate il modello di consegna creato in precedenza.

  • Per i campi Destinatari e Contenuto, selezionare Specificato nella consegna.

  • Azione da eseguire: selezionare Prepara e inizia.

  • Deselezionare l'opzione Errori di processo.

  • Andate alla scheda Script dell'attività Delivery, aggiungete tre variabili di tipo stringa di caratteri tramite il menu del campo di personalizzazione.

    Le tre variabili dichiarate sono:

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

Dopo l’avvio del flusso di lavoro di monitoraggio, invia il seguente riepilogo al destinatario:

In questa pagina