Monitoraggio dell’esecuzione dei flussi di lavoro

In questa sezione vengono fornite informazioni su come monitorare l'esecuzione dei flussi di lavoro.

In questa sezione è disponibile anche un esempio di utilizzo per la creazione di un flusso di lavoro che consenta di monitorare lo stato di un set di flussi di lavoro "in pausa", "interrotto" o "con errori".

Inoltre, gli amministratori dell'istanza possono utilizzare la traccia di controllo per controllare le attività e le ultime modifiche apportate ai flussi di lavoro, lo stato dei flussi di lavoro. Per ulteriori informazioni, fare riferimento alla sezione dedicata.

In questa pagina sono disponibili metodi aggiuntivi per monitorare i diversi processi di Campaign.

Visualizzazione dell'avanzamento

È possibile monitorare l'esecuzione visualizzando l'avanzamento utilizzando l'icona appropriata sulla barra degli strumenti.

L'icona Display progress information consente di visualizzare lo stato e il risultato dell'attività nella schermata di esecuzione.

Quando questa opzione è selezionata, le attività eseguite sono visualizzate in blu, le attività in sospeso sono in nero, gli avvisi sono visualizzati in arancione ed gli errori in rosso. Questa opzione mostra anche il risultato delle attività nella transizione in uscita, seguita dall'etichetta del risultato come definito nelle proprietà dell'attività e dalla durata del processo se supera un secondo

Visualizzazione dei registri

Il registro contiene la cronologia o la traccia di controllo del flusso di lavoro. Registra tutte le azioni degli utenti, tutte le operazioni eseguite e gli errori rilevati. Puoi:

  • Selezionate la scheda Tracking nel dettaglio. Questo elenco contiene tutti i messaggi del flusso di lavoro.

  • Filtrare i messaggi di registro per attività. A tale scopo, fare clic su Display the tasks and the log nella barra degli strumenti sopra il diagramma per visualizzare le schede Log e Tasks sotto il diagramma. Selezionate un'attività per visualizzare tutti i messaggi correlati. Questo elenco contiene tutti i messaggi quando non è selezionata alcuna attività.

    NOTA

    Fate clic sullo sfondo del diagramma per deselezionare tutti gli elementi.

  • Visualizzare solo i messaggi collegati a una determinata attività. A questo scopo, selezionate la scheda Tasks, quindi selezionate un'attività nel diagramma per limitare l'elenco. Fare doppio clic su un'attività per visualizzare le informazioni; l'ultima scheda della finestra contiene il registro.

    Il pulsante Details… consente di visualizzare tutte le informazioni aggiuntive sull'esecuzione dell'attività. Ad esempio, è possibile visualizzare l'operatore di convalida e, se applicabile, il commento immesso durante l'approvazione, come nell'esempio seguente:

NOTA

Il registro non viene eliminato al riavvio di un flusso di lavoro. Tutti i messaggi sono conservati. Se si desidera eliminare i messaggi da un'esecuzione precedente, è necessario eliminare la cronologia.

Il registro mostra l'elenco cronologico dei messaggi di esecuzione relativi alle attività del flusso di lavoro di targeting.

  • Registro di una campagna di targeting

    Una volta eseguita una campagna di targeting, fare clic sulla scheda Tracking per visualizzare la traccia di esecuzione.

    Vengono visualizzati tutti i messaggi della campagna: campagne eseguite, nonché avvisi o errori.

  • Registro di un'attività

    Potete inoltre visualizzare il registro di esecuzione e i dettagli di ciascuna attività. Esistono due modi per farlo:

    1. Selezionate l'attività di destinazione e fate clic sull'icona Display the tasks and the log.

      Nella sezione inferiore del diagramma sono visualizzate due schede: Registro e attività.

      Le attività selezionate all'interno del diagramma fungono da filtri nel registro e nell'elenco delle attività.

    2. Fate clic con il pulsante destro del mouse sull'attività di destinazione e selezionate Display logs.

      Il registro viene visualizzato in una finestra separata.

Rimozione dei registri

La cronologia del flusso di lavoro non viene eliminata automaticamente: tutti i messaggi vengono conservati per impostazione predefinita. La cronologia può essere eliminata dal menu File > Actions o facendo clic sul pulsante Actions nella barra degli strumenti sopra l'elenco. Seleziona Purge history. Le opzioni disponibili nel menu Actions sono descritte dettagliatamente nella sezione Azioni della barra degli strumenti.

Tabelle di lavoro e schema del flusso di lavoro

Il flusso di lavoro contiene tabelle di lavoro che possono essere modificate tramite determinate attività. Adobe Campaign consente, tramite le attività di gestione dei dati, di modificare, rinominare e arricchire le colonne delle tabelle di lavoro del flusso di lavoro, ad esempio per allinearle con la nomenclatura in base alle esigenze del cliente, per raccogliere informazioni aggiuntive sul co-beneficiario di un contratto, ecc.

È inoltre possibile creare collegamenti tra diverse dimensioni di lavoro e definire le modifiche di dimensione. Ad esempio, per ogni contratto registrato nella banca dati, rivolgersi al titolare principale e utilizzare i dati del co-titolare nelle informazioni aggiuntive.

Le tabelle di lavoro del flusso di lavoro vengono eliminate automaticamente quando il flusso di lavoro passa. Se si desidera mantenere una tabella di lavoro, salvarla in un elenco tramite l'attività List update (fare riferimento a Aggiornamento elenco).

Gestione degli errori

Quando si verifica un errore, il flusso di lavoro viene messo in pausa e l'attività in esecuzione quando si è verificato l'errore lampeggia in rosso. Nella panoramica del flusso di lavoro (Monitoring universo > Workflows collegamento) potete visualizzare solo i flussi di lavoro con errori, come mostrato di seguito.

In Adobe Campaign Explorer , l'elenco dei flussi di lavoro visualizza una colonna Failed per impostazione predefinita.

Se un flusso di lavoro è in errore, gli operatori appartenenti al gruppo di supervisione del flusso di lavoro ricevono una notifica via e-mail, purché il loro indirizzo e-mail sia elencato nel relativo profilo. Questo gruppo è selezionato nel campo Supervisor(s) delle proprietà del flusso di lavoro.

Il contenuto della notifica è configurato nel modello Workflow manager notification predefinito: Questo modello è selezionato nella scheda Execution delle proprietà del flusso di lavoro. La notifica mostra il nome del flusso di lavoro errori e l’attività interessata.

Esempio di notifica:

Il collegamento consente di accedere alla console Adobe Campaign in modalità Web e di lavorare sul flusso di lavoro degli errori dopo aver effettuato l’accesso.

È possibile configurare il flusso di lavoro in modo che non interrompa e continui l'esecuzione in caso di errori. A tal fine, modificare il flusso di lavoro Properties e, nella sezione Error management, selezionare l'opzione Ignore nel campo In case of error. È quindi possibile specificare il numero di errori consecutivi che possono essere ignorati prima che il processo venga messo in pausa.

In questo caso, l'attività di errore viene interrotta. Questa modalità è particolarmente adatta ai flussi di lavoro progettati per tentare di ripetere la campagna in un secondo momento (azioni periodiche).

NOTA

Potete applicare questa configurazione singolarmente per ogni attività. A questo scopo, modificate le proprietà dell'attività e selezionate la modalità di gestione degli errori nella scheda Advanced.

Per ulteriori informazioni sulla risoluzione dei problemi di esecuzione dei flussi di lavoro, consultare la sezione dedicata.

Errori di elaborazione

Per quanto riguarda le attività, l'opzione Process errors visualizza una transizione specifica che verrà attivata se viene generato un errore. In questo caso, il flusso di lavoro non passa alla modalità di errore e l'esecuzione continua.

Gli errori presi in considerazione sono errori del file system (file non può essere spostato, directory non è stato accessibile, ecc.).

Questa opzione non elabora gli errori relativi alla configurazione dell'attività, ovvero i valori non validi. Gli errori relativi alla configurazione non corretta non consentiranno questa transizione (la directory non esiste, ecc.).

Se un flusso di lavoro viene messo in pausa (manualmente o automaticamente dopo un errore), il pulsante Start riavvia l'esecuzione del flusso di lavoro dove è stato interrotto. L'attività errata (o attività in pausa) verrà nuovamente eseguita. Le attività precedenti non vengono eseguite nuovamente.

Per eseguire nuovamente tutte le attività del flusso di lavoro, utilizzate il pulsante Restart.

Se modificate le attività già eseguite, le modifiche non vengono prese in considerazione al riavvio dell'esecuzione del flusso di lavoro.

Se modificate le attività non eseguite, queste vengono prese in considerazione al riavvio dell'esecuzione del flusso di lavoro.

Se modificate le attività in pausa, le modifiche non possono essere prese in considerazione correttamente al riavvio del flusso di lavoro.

Se possibile, si consiglia di riavviare completamente il flusso di lavoro dopo aver apportato le modifiche.

Sorveglianza istanza

La pagina Instance supervision consente di visualizzare l'attività server Adobe Campaign e visualizzare l'elenco dei flussi di lavoro e delle consegne con errori.

Per accedere a questa pagina, vai all' Monitoring universo e fai clic sul collegamento General view.

Per visualizzare tutti i flussi di lavoro, fai clic sul collegamento Workflows. Utilizzate l'elenco a discesa per visualizzare i flussi di lavoro nella piattaforma in base al loro stato.

Fate clic sul collegamento in un flusso di lavoro con errori per aprirlo e visualizzarne il registro.

Prevenzione simultanea di più esecuzioni

Un singolo flusso di lavoro può avere più esecuzioni allo stesso tempo. In alcuni casi è necessario evitare che ciò accada.

Ad esempio, è possibile avere un pianificatore che attiva l'esecuzione del flusso di lavoro ogni ora, ma a volte l'esecuzione dell'intero flusso di lavoro richiede più di un'ora. È possibile saltare l'esecuzione se il flusso di lavoro è già in esecuzione.

Se all’inizio del flusso di lavoro è attiva un’attività di segnale, è possibile ignorare il segnale se il flusso di lavoro è in esecuzione.

Il principio generale è il seguente:

La soluzione consiste nell’utilizzare una variabile di istanza. Le variabili di istanza sono condivise da tutte le esecuzioni parallele dei flussi di lavoro.

Di seguito è riportato un semplice flusso di lavoro di prova:

Scheduler attiva un evento ogni minuto. La seguente attività Test sta per testare la variabile di istanza isRunning per decidere se continuare o meno l'esecuzione:

NOTA

isRunningè un nome di variabile scelto per questo esempio. Questa non è una variabile incorporata.

L'attività immediatamente successiva alla Test nel ramo yes deve impostare la variabile di istanza nel relativo script di inizializzazione:

instance.vars.isRunning = true

L'ultima attività nel ramo yes deve ripristinare la variabile su false nello script di inizializzazione:

instance.vars.isRunning = false

Si noti che:

  • È possibile controllare il valore corrente della variabile di istanza tramite la scheda Variabili nel flusso di lavoro Proprietà.

  • Le variabili di istanza vengono reimpostate al riavvio di un flusso di lavoro.

  • In JavaScript, un valore non definito è falso in un test, consentendo di verificare la variabile di istanza anche prima di averla inizializzata.

  • È possibile monitorare le attività che non vengono elaborate a causa di questo meccanismo aggiungendo un'istruzione di registrazione allo script di inizializzazione della fine "no".

    logInfo("Workflow already running, parallel execution not allowed.");
    

Un caso di utilizzo è presentato in questa sezione: Coordinare gli aggiornamenti dei dati.

Manutenzione del database

I flussi di lavoro utilizzano molte tabelle di lavoro che occupano spazio e finiscono per rallentare l'intera piattaforma se non viene mantenuta. Per ulteriori informazioni sulla manutenzione del database, fare riferimento a questa sezione .

Il flusso di lavoro Pulizia del database accessibile tramite il nodo Amministrazione > Produzione > Flussi di lavoro tecnici, consente di eliminare i dati obsoleti per evitare la crescita esponenziale del database. Il flusso di lavoro viene attivato automaticamente senza l'intervento dell'utente. Fare riferimento a questa sezione .

È inoltre possibile creare flussi di lavoro tecnici specifici per eliminare lo spazio necessario per i dati. Fare riferimento a questa sezione e a questa pagina.

Gestione dei flussi di lavoro in pausa

Per impostazione predefinita, se un flusso di lavoro viene messo in pausa, le relative tabelle di lavoro non vengono mai eliminate. Dalla build 8880, i flussi di lavoro che sono stati messi in pausa per troppo tempo vengono automaticamente interrotti e i relativi tavoli di lavoro vengono eliminati. Questo comportamento viene attivato come segue:

  • I flussi di lavoro che sono stati messi in pausa da più di 7 giorni vengono visualizzati come un avviso nel dashboard di monitoraggio (e nell’API di monitoraggio) e una notifica viene inviata al gruppo di supervisori.
  • Lo stesso accade ogni settimana, quando viene attivato il cleanupPausedWorkflows flusso di lavoro tecnico. Per ulteriori dettagli sul flusso di lavoro, consultare questa sezione.
  • Dopo 4 notifiche (ovvero un mese in stato di pausa per impostazione predefinita), il flusso di lavoro viene interrotto senza condizioni. Dopo l’arresto, nel flusso di lavoro viene visualizzato un registro. Le tabelle vengono eliminate al flusso di lavoro cleanup di esecuzione successivo

Questi periodi possono essere configurati tramite l'opzione NmsServer_PausedWorkflowPeriod.

I supervisori del flusso di lavoro ricevono una notifica. Vengono notificati anche l’autore e l’ultimo utente che ha modificato il flusso di lavoro. Gli amministratori non ricevono le notifiche.

Filtrare i flussi di lavoro in base al loro stato

L'interfaccia Campaign Classic consente di monitorare lo stato di esecuzione di tutti i flussi di lavoro sull'istanza utilizzando le viste predefinite. Per accedere a queste viste, aprire il nodo Administration / Audit / Workflows Status.

Sono disponibili le seguenti viste:

  • Running: elenca tutti i flussi di lavoro in esecuzione.
  • Paused: elenca tutti i flussi di lavoro in pausa.
  • Failed: elenca tutti i flussi di lavoro con errore.
  • Start Pending: elenca tutti i flussi di lavoro in attesa di essere avviati dal processo operationMgt. Questa visualizzazione è disponibile solo per il pacchetto Campagne marketing (vedere Installazione di pacchetti standard di campagna).

Per impostazione predefinita, queste viste sono accessibili nella cartella Audit. Tuttavia, potete ricrearli nella posizione desiderata nella struttura delle cartelle. In questo modo, saranno disponibili per gli utenti standard senza diritto di amministrazione.

Per eseguire questa operazione:

  1. Fare clic con il pulsante destro del mouse sulla cartella in cui si desidera aggiungere la visualizzazione.
  2. In Add new folder / Administration, selezionare la visualizzazione da aggiungere.
  3. Dopo aver aggiunto la cartella alla struttura, accertatevi di configurarla come visualizzazione, in modo che visualizzi tutti i flussi di lavoro, indipendentemente dalla cartella di origine.Per ulteriori informazioni sulla configurazione delle viste, consultate questa sezione.

Inoltre, potete impostare delle cartelle di filtri che consentono di filtrare l’elenco dei flussi di lavoro in base al relativo stato di esecuzione. Per eseguire questa operazione:

  1. Accedete a una cartella di tipo flusso di lavoro, quindi selezionate il menu Filters / Advanced filter.
  2. Configurate il filtro in modo che il campo @status del flusso di lavoro sia uguale allo stato desiderato.
  3. Salvate e denominate il filtro. Sarà quindi disponibile direttamente dall'elenco dei filtri.

Per ulteriori informazioni, consultare le sezioni seguenti:

In questa pagina